Integracja Struts 2 i płytek

W tym rozdziale przyjrzyjmy się krokom związanym z integracją frameworka Tiles z Struts2. Apache Tiles to platforma szablonów zbudowana w celu uproszczenia tworzenia interfejsów użytkownika aplikacji internetowych.

Przede wszystkim musimy pobrać pliki jar kafelków ze strony Apache Tiles . Musisz dodać następujące pliki jar do ścieżki klas projektu.

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

Oprócz powyższego musimy skopiować następujące pliki jar z pliku struts2 do pobrania w pliku WEB-INF/lib.

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

Teraz skonfigurujmy web.xmldo integracji Struts-Tiles, jak podano poniżej. Należy tu zwrócić uwagę na dwie ważne kwestie. Najpierw musimy powiedzieć kafelkom, gdzie znaleźć plik konfiguracyjny kafelkówtiles.xml. W naszym przypadku będzie poniżej/WEB-INFteczka. Następnie musimy zainicjować odbiornik Tiles, który jest dostarczany wraz z pobieraniem Struts2.

<?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>

Następnie stwórzmy tiles.xml w folderze / WEB-INF z następującą zawartością -

<?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>

Następnie definiujemy podstawowy układ szkieletu w baseLayout.jsp. Ma pięć obszarów wielokrotnego użytku / nadających się do zastąpienia. Mianowicietitle, banner, menu, body i footer. Podajemy domyślne wartości dla baseLayout, a następnie tworzymy dwa dostosowania, które wykraczają poza domyślny układ. Układ tygrysa jest podobny do układu podstawowego, z wyjątkiem tego, że używa rozszerzeniatiger.jspjako jego treść i tekst „Tiger” jako tytuł. Podobnie układ lwa jest podobny do układu podstawowego, z wyjątkiem tego, że wykorzystuje rozszerzenielion.jsp jako jego treść i tekst „Lew” jako tytuł.

Przyjrzyjmy się poszczególnym plikom jsp. Poniżej znajduje się treśćbaseLayout.jsp plik -

<%@ 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>

Tutaj po prostu utworzyliśmy podstawową stronę HTML, która ma atrybuty kafelków. Wstawiamy atrybuty kafelków w miejscach, w których są potrzebne. Następnie stwórzmy plikbanner.jsp plik o następującej treści -

<img src="http://www.tutorialspoint.com/images/tp-logo.gif"/>

Plik menu.jsp plik będzie miał następujące wiersze, które są linkami - do akcji TigerMenu.action i 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>

Plik lion.jsp plik będzie miał następującą zawartość -

<img src="http://upload.wikimedia.org/wikipedia/commons/d/d2/Lion.jpg"/>
The lion

Plik tiger.jsp plik będzie miał następującą zawartość -

<img src="http://www.freewebs.com/tigerofdarts/tiger.jpg"/>
The tiger

Następnie stwórzmy plik klasy akcji MenuAction.java który zawiera następujące -

package com.tutorialspoint.struts2;

import com.opensymphony.xwork2.ActionSupport;

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

To dość prosta klasa. Zadeklarowaliśmy dwie metody tiger () i lion (), które zwracają odpowiednio tygrysa i lwa jako wyniki. Połączmy to wszystko razem wstruts.xml plik -

<!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.tutorialspoint.struts2.MenuAction">
         <result name = "tiger" type = "tiles">tiger</result>
         <result name = "lion" type = "tiles">lion</result>
      </action>

   </package>
</struts>

Sprawdźmy, co zrobiliśmy w powyższym pliku. Przede wszystkim zadeklarowaliśmy nowy typ wyniku o nazwie „kafelki”, ponieważ w technologii widoku używamy teraz kafelków zamiast zwykłego pliku jsp. Struts2 obsługuje typ wynikowy Tiles View, więc tworzymy typ wyniku „tiles” jako klasy „org.apache.struts2.view.tiles.TilesResult”.

Następnie chcemy powiedzieć, czy żądanie dotyczy /tigerMenu.action, przenosi użytkownika na stronę kafelków tygrysa, a jeśli żądanie dotyczy /lionMenu.action, przenosi użytkownika na stronę kafelków lwa.

Osiągamy to za pomocą wyrażenia regularnego. W naszej definicji akcji mówimy, że wszystko, co pasuje do wzorca „* Menu”, będzie obsługiwane przez tę akcję. Metoda dopasowania zostanie wywołana w klasie MenuAction. Oznacza to, że tigerMenu.action wywoła funkcję tiger (), a lionMenu.action - lion (). Następnie musimy zmapować wynik wyniku na odpowiednich stronach kafelków.

Teraz kliknij prawym przyciskiem myszy nazwę projektu i kliknij Export > WAR Fileaby utworzyć plik wojny. Następnie wdróż tę WAR w katalogu webapps serwera Tomcat. Na koniec uruchom serwer Tomcat i spróbuj uzyskać dostęp do adresu URLhttp://localhost:8080/HelloWorldStruts2/tigerMenu.jsp. Spowoduje to wyświetlenie następującego ekranu -

Podobnie, jeśli wejdziesz na stronę lionMenu.action, zobaczysz stronę lwa, która używa tego samego układu kafelków.