Struts 7 (Basics)

Inhalt:

Konfiguration

• caffeine-3.1.8.jar
• commons-fileupload2-core-2.0.0-M2.jar
• commons-lang3-3.14.0.jar
• commons-text-1.12.0.jar
• freemarker-2.3.33.jar
• javassist-3.29.0-GA.jar
• ognl-3.3.5.jar
• struts2-core-7.0.0-M9.jar

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns="https://jakarta.ee/xml/ns/jakartaee" 
    xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-app_6_0.xsd" 
    version="6.0">
  
  <display-name>StrutsBasics</display-name>
  <welcome-file-list>
    ...
  </welcome-file-list>
  <filter>
    <filter-name>struts</filter-name>
    <filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
  </filter>
  <filter-mapping>
    <filter-name>struts</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>
</web-app>

  <filter>
    <filter-name>struts</filter-name>
    <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
  </filter>
  <filter-mapping>
    <filter-name>struts</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>

  <filter>
    <filter-name>struts</filter-name>
    <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>
  </filter>
  <filter-mapping>
    <filter-name>struts</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>

Action "GeometricModelAction"

import org.apache.struts2.action.SessionAware;
import org.apache.struts2.interceptor.parameter.StrutsParameter;
import com.opensymphony.xwork2.ActionSupport;

public class GeometricModelAction extends ActionSupport implements SessionAware
{
  private Map<String, Object> session;

  @Override
  public void withSession(Map<String, Object> session)
  {
    this.session = session;
  }
  
  ...
} 

  @Override
  public void setSession(Map<String, Object>  session)
  {
    ...
  }

  public void withSession(Map<String, Object> session)
  {
    ...
  }

  private Double dblA = 0;
  private Double dblB = 0;
  private Double dblC = 0;
  
  public Double getA()
  {
    return dblA;
  }
  @StrutsParameter
  public void setA(Double dblA)
  {
    this.dblA = dblA;
  }

  public Double getB()
  {
    return dblB;
  }
  @StrutsParameter
  public void setB(Double dblB)
  {
    this.dblB = dblB;
  }

  public Double getC()
  {
    return dblC;
  }
  @StrutsParameter
  public void setC(Double dblC)
  {
    this.dblC = dblC;
  } 

<struts>
   <constant name="struts.parameters.requireAnnotations" value="false"/>
   ..
</struts>

  private double dblOberflaeche = 0;
  private double dblVolumen = 0;
  
  private Historie historieGesamt = new Historie();

  public Historie getHistorieGesamt()
  {
    if (this.session == null)
    {
      throw new NullPointerException("session nicht gesetzt !");
    }
    if (this.session.get("historieGesamt") == null)
    {
      this.session.put("historieGesamt", new Historie() );
    }
    this.historieGesamt = (Historie) this.session.get("historieGesamt");
    return this.historieGesamt;
  }
  
  public double getVolumen()
  {
    return this.dblVolumen;
  }
  
  public double getOberflaeche()
  {
    return this.dblOberflaeche;
  } 

  @Override
  public String execute() throws Exception
  {
    if (this.dblA != null && this.dblB != null && this.dblC != null)
    {
      //Ausrechnen:
      this.dblVolumen = this.dblA * this.dblB * this.dblC;
      this.dblOberflaeche = 2 * (this.dblA * this.dblB) + 2 * (this.dblA * this.dblC) + 2 * (this.dblB * this.dblC);
    
      //Zufügen zur Historie !
      Seitenlaengen seitenlaengeAktuell = new Seitenlaengen();
      seitenlaengeAktuell.setA(this.dblA);
      seitenlaengeAktuell.setB(this.dblB);
      seitenlaengeAktuell.setC(this.dblC);
    
      //Die Historie per Get-Methode abrufen damit sie bei Bedarf erzeugt wird.
      this.getHistorieGesamt().addSeitenlaenge( seitenlaengeAktuell );
    }
    return Action.SUCCESS;
  } 

public class GeometricModelAction extends ActionSupport implements ServletRequestAware
{
  private HttpServletRequest request;

  public void withServletRequest(HttpServletRequest httpServletRequest)
  {
    this.request = httpServletRequest;
  }
  
  ...
}

struts.xml

<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 6.0//EN"
    "http://struts.apache.org/dtds/struts-6.0.dtd">
<struts>
    <constant name="struts.devMode" value="true"/>
    <constant name="struts.allowlist.classes" value="de.hsrm.jakartaee.knauf.strutsbasics.Historie"/>
	
    <package name="strutsbasics" extends="struts-default">
        <default-action-ref name="geometricmodel" />
        <action name="geometricmodel" class="de.hsrm.jakartaee.knauf.strutsbasics.actions.GeometricModelAction">
            <result>/geometricmodel.jsp</result>
            <result name="input">/geometricmodel.jsp</result>
        </action>
    </package>
</struts> 

   <result name="success">/geometricmodel.jsp</result>

   <result name="input">/geometricmodel.jsp</result>

18:37:38,728 ERROR [org.apache.struts2.dispatcher.Dispatcher] (default task-1) Could not find action or result: /StrutsBasics/: There is no Action mapped for 
    namespace [/] and action name [] associated with context path [/StrutsBasics]. - [unknown location]
	at deployment.StrutsBasics.war//com.opensymphony.xwork2.DefaultActionProxy.prepare(DefaultActionProxy.java:183)
	at deployment.StrutsBasics.war//org.apache.struts2.factory.StrutsActionProxy.prepare(StrutsActionProxy.java:57)
	at deployment.StrutsBasics.war//org.apache.struts2.factory.StrutsActionProxyFactory.createActionProxy(StrutsActionProxyFactory.java:32)
	at deployment.StrutsBasics.war//com.opensymphony.xwork2.DefaultActionProxyFactory.createActionProxy(DefaultActionProxyFactory.java:60)
	at deployment.StrutsBasics.war//org.apache.struts2.dispatcher.Dispatcher.createActionProxy(Dispatcher.java:781)
	at deployment.StrutsBasics.war//org.apache.struts2.dispatcher.Dispatcher.prepareActionProxy(Dispatcher.java:767)
	at deployment.StrutsBasics.war//org.apache.struts2.dispatcher.Dispatcher.serviceAction(Dispatcher.java:730)
	at deployment.StrutsBasics.war//org.apache.struts2.dispatcher.ExecuteOperations.executeAction(ExecuteOperations.java:79)
	at deployment.StrutsBasics.war//org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter.handleRequest(StrutsPrepareAndExecuteFilter.java:163)
	at deployment.StrutsBasics.war//org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter.tryHandleRequest(StrutsPrepareAndExecuteFilter.java:146)
	at deployment.StrutsBasics.war//org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter.doFilter(StrutsPrepareAndExecuteFilter.java:134)
	at io.undertow.servlet@2.3.15.Final//io.undertow.servlet.core.ManagedFilter.doFilter(ManagedFilter.java:67)

No result defined for action de.hsrm.jakartaee.knauf.strutsbasics.actions.GeometricModelAction and result input

18:30:02,073 WARN  [com.opensymphony.xwork2.ognl.SecurityMemberAccess] (default task-1) Declaring class [class de.hsrm.jakartaee.knauf.strutsbasics.Historie] of member type 
  [public int de.hsrm.jakartaee.knauf.strutsbasics.Historie.getSize()] is not allowlisted!

<constant name="struts.allowlist.enable" value="false"/>

JSP

<?xml version="1.0" encoding="ISO-8859-1" ?>
<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
    pageEncoding="ISO-8859-1"%>
<%@ taglib prefix="s" uri="/struts-tags" %>
<!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=ISO-8859-1" />
<title>Test für Struts2</title>
</head>
<body>

  <s:form action="geometricmodel">
    <s:if test="volumen > 0.0">
      Volumen: <s:property value="volumen"/> <br/>
      Oberfläche: <s:property value="oberflaeche"/> <br/>
    </s:if>
  
    <s:textfield name="a" label="Kante a"></s:textfield> <br/>
    <s:textfield name="b" label="Kante b"></s:textfield> <br/>
    <s:textfield name="c" label="Kante c"></s:textfield> <br/>
    <br/>
    <s:submit value="Berechnen"></s:submit>
  </s:form>
  
  <%--Historie ausgeben: --%>
  <s:if test="historieGesamt.size > 0">
    Historie:<br/>
    <s:iterator value="historieGesamt.iterator" status="currentStatus">
      <s:property value="#currentStatus.index"/>: a=<s:property value="a"/>, b=<s:property value="b"/>, c=<s:property value="c"/> <br/>
    </s:iterator>
  </s:if>

</body>
</html>

• Es wird die Struts-Taglibrary eingebunden:
  

    <%@ taglib prefix="s" uri="/struts-tags" %>

  Die Doku zur Taglib findet man übrigens im Verzeichnis "docs\struts2-core\apidocs\org\apache\struts2\components" des Struts-Pakets.
  
  
• Es wird ein HTML-Form deklariert, das beim Submit auf die Action mit dem Namen "geometricModel" verweist:
  

      <s:form action="geometricmodel">
        ...
      </s:form> 

• Zuallererst wird geprüft ob beim aktuellen Aufruf der Seite eine Berechnung durchgeführt wurde. Hierzu wird das Struts-Tag s:if genutzt. Im Attribut "test" können wir einen EL-ähnlichen Ausdruck nutzen, den Struts allerdings wohl selbst parst. Obwohl wir hier außerhalb der Form sind, steht uns die Action und deren gesamte Felder zur Verfügung.
  Die Ausgabe der einzelnen Properties wird mittels des Tags s:property gesteuert, hier gibt das Attribut value an, welcher Wert der Action ausgegeben werden soll.
  

      <s:if test="volumen > 0.0">
        Volumen: <s:property value="volumen"/> <br/>
        Oberfläche: <s:property value="oberflaeche"/> <br/>
      </s:if>

  
  
• Jetzt folgt das eigentliche Formular. Zuerst drei Ein-/Ausgabefelder. Diese werden mit den Properties a, b und c der Action verdrahtet, d.h. beim Erzeugen der HTML-Seite werden die aktuellen Werte in die Felder geschrieben, und beim Auswerten des Requests werden die Request-Parameter "a", "b" und "c" (durch das Attribut name definiert) in die entsprechenden Felder geschrieben.

      <s:textfield name="a" label="Kante a"></s:textfield> <br/>
      <s:textfield name="b" label="Kante b"></s:textfield> <br/>
      <s:textfield name="c" label="Kante c"></s:textfield> <br/> 

  Durch das Attribut "label" können wir einen Text angeben der direkt vor dem Feld ausgegeben wird (einschließlich angehängtem ":").
  
  Der Submit-Button wird durch ein Element s:submit abgebildet.
  

  &<s:submit value="Berechnen"></s:submit>

  
  
• Die Ausgabe der Historie erfolgt nur, wenn überhaupt Werte berechnet sind.
  

    <s:if test="historieGesamt.size > 0">
      Historie:<br/>
      <s:iterator value="historieGesamt.iterator" status="currentStatus">
        <s:property value="#currentStatus.index"/>: a=<s:property value="a"/>, b=<s:property value="b"/>, c=<s:property value="c"/> <br/>
      </s:iterator>
    </s:if>

  Das Tag s:iterator läuft über eine Liste oder einen Iterator. Mittels dem Attribut status können wir eine Statusvariable vom Typ org.apache.struts2.views.jsp.IteratorStatus (https://struts.apache.org/maven/struts2-core/apidocs/org/apache/struts2/views/jsp/IteratorStatus.html) deklarieren, die uns z.B. den aktuellen Iterator-Index liefert (wird hier genutzt, um eine laufende Nummer an den Anfang der Zeile zu setzen).
  Eine Besonderheit ist hier, dass dem Wert von value ein # vorangestellt wird. Dies ist in diesem Fall nötig, eine Begründung kann ich leider nicht liefern.
  
  Für die Ausgabe der Seitenlängen a, b und c wird wieder ein s:property-Tag genutzt. Dieses sucht sich hier automatisch ein Objekt mit Properties a, b und c, und landet da scheinbar als erstes beim aktuellen Iterator-Element (das beim Iterator-Lauf auf einem Struts-internen Stack landet und dort gefunden wird).
  
  

Anwendung starten