The default conventions

Benefits

Example 1 (Dispatcher Pattern)

/* The Action */
package example;

public class CustomerAction extends ActionDispatcher implements ConfigInterface
{
  public void config(ActionConfig struts) {
    struts.addForward("/customer_view.jsp");
  }
  
  ...
}

/* Optional ActionForm Class (is found by classname matching) */
package example;

public class CustomerActionForm extends ActionForm
{
  ...
}

/* The Action */
package example;

public class CustomerEditAction extends Action implements ConfigInterface
{
  public void config(ActionConfig struts) {
    struts.addForward("/customer_view.jsp");
  }
}

/* Optional ActionForm Class */
package example;

public class CustomerEditActionForm extends ActionForm
{
  ...
}

or

public class CustomerActionForm extends ActionForm
{
  ...
}

Behind the scenes: Equivalent configuration (Dispatcher Pattern):

<form-beans>
    <form-bean name="CustomerActionForm" type="example.CustomerActionForm" />
</form-beans>

<action-mappings>
    <action name="CustomerActionForm"
            type="example.CustomerAction"
            parameter="action"
            scope="session"
            path="/customer">
            <forward name="view" path="/customer_view.jsp" />
    </action>
</action-mappings>

Installation
Strutter Config is implemented as Struts Plugin. To setup with default configuration just add the stutter.jar and htmlparser.jar to your WEB-INF/lib and add the following tag to your struts-config.xml.

<plug-in className="strutter.config.ActionPlugin" />

Customize conventions
You can change some of default behavier.

<plug-in className="strutter.config.ActionPlugin">
    	<set-property property="packageroot"  value="action"/>
    	<set-property property="aliasaction"  value="Action"/>
    	<set-property property="aliasform"    value="ActionForm"/>
    	<set-property property="aliasview"    value="view,list,update,create"/>
    	<set-property property="pathformat"   value="{PATH}"/>
    	<set-property property="pathlower"    value="0"/>
    	<set-property property="parameter"    value="action"/>
    	<set-property property="scope"        value="session"/>
    	<set-property property="views"        value="views"/>

    	<set-property property="encoding"     value="UTF-8"/>
    	<set-property property="viewer"       value="1"/>
    	<set-property property="keepalive"    value="1"/>
    	<set-property property="script"       value="1"/>
    	<set-property property="template"     value="1"/>

    	<set-property property="packageby"    value="layer"/>
   
</plug-in>

Optional configuration
The following functions you can overwrite the configuration generated by the plugin.

  struts.addForward("view", "/customer_view.jsp", [redirect:false]);
  struts.addForward("/customer_view.jsp", [redirect:false]);

  struts.addGlobalForward("view", "/customer_view.jsp", [redirect:false]);
  struts.addGlobalForward("/customer_view.jsp", [redirect:false]);

  struts.setPackageby(ActionConfig.PACKAGEBY_FEATURE);
  struts.setForm(CustomerActionForm.class);
  struts.setValidate(false);
  struts.setInput("/customer_input.jsp");
  struts.setParameter("action");
  struts.setPath("/customer");
  struts.setScope("session");
  struts.setUnknown(false);
  struts.setRoles("role1,role2");

Strutter View

Example 1

  <form action="sample.do">

    <select name="anrede">
      <option id="anreden" />
    </select>

    <input type="text" name="firstname">

    <input type="button" onclick="subber('update')" value="OK">

  </form>

Error Handler
There is a simple extention to handle error messages:

<input type="text" name="firstname" error="behind">

The error message for each control is identified by the controls name.

div / span
Show form/request/session property with id label.name:

<span type="text" id="label.name"/>

<span type="resource" id="label.name"/>

<div type="messages" />

<div type="errors" />

<div type="error" id="firstname"/>

Installation
Strutter View is implemented as Filter. To get it running in just add the stutter.jar and htmlparser.jar to your WEB-INF/lib and add the following tag to your web.xml.

<filter>
  <filter-name>strutterview</filter-name>
  <filter-class>strutter.view.PageFilter</filter-class>
</filter>

<filter-mapping>
  <filter-name>strutterview</filter-name>
  <url-pattern>*.do</url-pattern>
</filter-mapping>

Strutter Extentions

ActionHelper
The ActionHelper provides direct access to the request context.
The following static functions are provided:

To add an error or message to your request just call the addError(...) or addMessage(...) function. You do not need to take care about the ArrayList handling you normaly have to.

Plain Action

Subclass your Action class from one of the above classes allows you to use a simpler Action Method.
It has no parameter instead of the four standard Struts parameter. (mapping, actionform, request, response)

They still can be accessed via ActionHelper see above.

If the action has both Action Method with and without parameter. The one with parameter will have priority one.

Formless Action

Implement the FormlessInterface in your ActionClass. Your Action will behave like a ActionForm. All Form attributes can be included directly in the action. The implementation is thread safe! You can access the form in the JSP like any other form.
Traditional Struts Tag are working properly.

If you provide an ActionForm the Formless funcionality is disabled automaticaly and the ActionForm will be filled instead!

/* The Action */
package example;

public class CustomerAction extends PlainDispatchAction implements ConfigInterface, FormlessInterface
{
  public void config(ActionConfig struts) {
    struts.addForward("/customer_view.jsp");
  }

  public void reset() {
  }

  public ActionForward view() {

    //...
    
	  ActionHelper.getRequest();  // ThreadLocal access to environment	
    
    //...

    return ActionHelper.findForward("view");
  }

  String memo; // add some form attributes (They are handled Thread Safe)
  
  //... getter and setter for "memo" ...
}