Struts-2-struts-tiles

提供:Dev Guides
移動先:案内検索

Struts 2とタイルの統合

この章では、TilesフレームワークをStruts2と統合する手順を説明します。 Apache Tilesは、Webアプリケーションユーザーインターフェイスの開発を簡素化するために構築されたテンプレートフレームワークです。

まず、https://tiles.apache.org/[Apache Tiles] Webサイトからタイルjarファイルをダウンロードする必要があります。 次のjarファイルをプロジェクトのクラスパスに追加する必要があります。

  • tiles-api-x.y.z.jar
  • tiles-compat-x.y.z.jar
  • tiles-core-x.y.z.jar
  • tiles-jsp-x.y.z.jar
  • tiles-servlet-x.y.z.jar

上記に加えて、 WEB-INF/lib のstruts2ダウンロードから次のjarファイルをコピーする必要があります。

  • commons-beanutils-x.y.zjar
  • commons-digester-x.y.jar
  • struts2-tiles-plugin-x.y.z.jar

次に、以下に示すように、Struts-Tiles統合用の web.xml をセットアップしましょう。 ここで注意すべき2つの重要なポイントがあります。 最初に、タイル構成ファイル tiles.xml の場所をタイルに指示する必要があります。 この例では、 /WEB-INF フォルダーの下にあります。 次に、Struts2ダウンロードに付属するTilesリスナーを初期化する必要があります。

<?xml version = "1.0" Encoding = "UTF-8"?>
<web-app xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
   xmlns = "http://java.sun.com/xml/ns/javaee"
   xmlns:web = "http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
   xsi:schemaLocation = "http://java.sun.com/xml/ns/javaee
   http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
   id = "WebApp_ID" version = "2.5">
   <display-name>Struts2Example15</display-name>

   <context-param>
      <param-name>
         org.apache.tiles.impl.BasicTilesContainer.DEFINITIONS_CONFIG
      </param-name>

      <param-value>
        /WEB-INF/tiles.xml
      </param-value>
   </context-param>

   <listener>
      <listener-class>
         org.apache.struts2.tiles.StrutsTilesListener
      </listener-class>
   </listener>

   <filter>
      <filter-name>struts2</filter-name>
      <filter-class>
         org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter
      </filter-class>
   </filter>

   <filter-mapping>
      <filter-name>struts2</filter-name>
      <url-pattern>/*</url-pattern>
   </filter-mapping>

   <welcome-file-list>
      <welcome-file>index.jsp</welcome-file>
   </welcome-file-list>
</web-app>

次に、/WEB-INFフォルダーに tiles.xml を作成し、次の内容を含めます-

<?xml version = "1.0" Encoding = "UTF-8" ?>

<!DOCTYPE tiles-definitions PUBLIC
   "-//Apache Software Foundation//DTD Tiles Configuration 2.0//EN"
   "http://tiles.apache.org/dtds/tiles-config_2_0.dtd">

<tiles-definitions>

   <definition name = "baseLayout" template="/baseLayout.jsp">
      <put-attribute name = "title"  value = "Template"/>
      <put-attribute name = "banner" value = "/banner.jsp"/>
      <put-attribute name = "menu"   value = "/menu.jsp"/>
      <put-attribute name = "body"   value = "/body.jsp"/>
      <put-attribute name = "footer"   value = "/footer.jsp"/>
   </definition>

   <definition name = "tiger" extends = "baseLayout">
      <put-attribute name = "title"  value = "Tiger"/>
      <put-attribute name = "body"   value = "/tiger.jsp"/>
   </definition>

   <definition name = "lion" extends = "baseLayout">
      <put-attribute name = "title"  value = "Lion"/>
      <put-attribute name = "body"   value = "/lion.jsp"/>
   </definition>

</tiles-definitions>

次に、 baseLayout.jsp で基本的なスケルトンレイアウトを定義します。 5つの再利用可能/オーバーライド可能な領域があります。 つまり、 title、banner、menu、body 、および footer です。 baseLayoutのデフォルト値を提供してから、デフォルトレイアウトから拡張する2つのカスタマイズを作成します。 tigerレイアウトは、基本レイアウトに似ていますが、本文として tiger.jsp を使用し、タイトルとしてテキスト「Tiger」を使用する点が異なります。 同様に、ライオンレイアウトは基本レイアウトに似ていますが、本文として lion.jsp を使用し、タイトルとしてテキスト「ライオン」を使用する点が異なります。

個々のjspファイルを見てみましょう。 以下は、 baseLayout.jsp ファイルの内容です-

<%@ taglib uri = "http://tiles.apache.org/tags-tiles" prefix = "tiles"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
   "http://www.w3.org/TR/html4/loose.dtd">

<html>
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset = UTF-8">
      <title>
         <tiles:insertAttribute name = "title" ignore="true"/>
      </title>
   </head>

   <body>
      <tiles:insertAttribute name = "banner"/><br/>
      <hr/>
      <tiles:insertAttribute name = "menu"/><br/>
      <hr/>
      <tiles:insertAttribute name = "body"/><br/>
      <hr/>
      <tiles:insertAttribute name = "footer"/><br/>
   </body>
</html>

ここでは、タイル属性を持つ基本的なHTMLページをまとめました。 必要な場所にタイル属性を挿入します。 次に、次の内容を持つ banner.jsp ファイルを作成しましょう-

<img src="http://www.finddevguides.com/images/tp-logo.gif"/>
*menu.jsp* ファイルには、TigerMenu.actionおよびLionMenu.action strutsアクションへのリンクである次の行が含まれます。
<%@taglib uri = "/struts-tags" prefix = "s"%>

<a href = "<s:url action = "tigerMenu"/>" Tiger</a><br>
<a href = "<s:url action = "lionMenu"/>" Lion</a><br>
*lion.jsp* ファイルには次の内容があります-
<img src="http://upload.wikimedia.org/wikipedia/commons/d/d2/Lion.jpg"/>
The lion
*tiger.jsp* ファイルには次の内容があります-
<img src="http://www.freewebs.com/tigerofdarts/tiger.jpg"/>
The tiger

次に、次を含むアクションクラスファイル MenuAction.java を作成します-

package com.finddevguides.struts2;

import com.opensymphony.xwork2.ActionSupport;

public class MenuAction extends ActionSupport {
   public String tiger() { return "tiger"; }
   public String lion() { return "lion"; }
}

これは非常に単純なクラスです。 結果としてそれぞれtigerとlionを返すtiger()とlion()の2つのメソッドを宣言しました。 すべてを struts.xml ファイルにまとめてみましょう-

<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>
   <package name = "default" extends = "struts-default">
      <result-types>
         <result-type name = "tiles"
         class="org.apache.struts2.views.tiles.TilesResult"/>
      </result-types>

      <action name = "*Menu" method = "{1}"
         class = "com.finddevguides.struts2.MenuAction">
         <result name = "tiger" type = "tiles">tiger</result>
         <result name = "lion" type = "tiles">lion</result>
      </action>

   </package>
</struts>

上記のファイルで行ったことを確認しましょう。 まず、ビューテクノロジにプレーンjspの代わりにタイルを使用しているため、「タイル」と呼ばれる新しい結果タイプを宣言しました。 Struts2はTiles View結果タイプをサポートしているため、結果タイプ「tiles」を作成して「org.apache.struts2.view.tiles.TilesResult」クラスにします。

次に、リクエストが/tigerMenu.actionに対するものである場合、ユーザーをtigerタイルページに移動し、リクエストが/lionMenu.actionに対するものである場合、ライオンタイルページに移動します。

これを実現するには、少し正規表現を使用します。 アクション定義では、パターン「 *Menu」に一致するものはすべてこのアクションで処理されると言います。 一致するメソッドはMenuActionクラスで呼び出されます。 つまり、tigerMenu.actionはtiger()を呼び出し、lionMenu.actionはlion()を呼び出します。 次に、結果の結果を適切なタイルページにマップする必要があります。

次に、プロジェクト名を右クリックし、[エクスポート]> [WARファイル]* をクリックして、WARファイルを作成します。 次に、このWARをTomcatのwebappsディレクトリにデプロイします。 最後に、Tomcatサーバーを起動して、URL http://localhost:8080/HelloWorldStruts2/tigerMenu.jsp にアクセスしてみます。 これにより、次の画面が生成されます-

ストラットとタイルの統合

同様に、lionMenu.actionページに移動すると、同じタイルレイアウトを使用するライオンページが表示されます。