Package com.boylesoftware.cb2.presentation.servlet

Presentation Level framework for web-applications based on Apache Struts.

See:
Description

Interface Summary

PresentationElement

CB2 presentation elements implement this interface.

Class Summary

ActionContext	Represents context of a CB2 action execution within a request processing.
CB2Action	Abstract parent class for CB2/Struts action handlers.
CB2Application	This web-application wide singleton represents this CB2 based application.
CB2PlugIn	Struts plugin to enable CB2 presentation level for a Struts module.
CB2RequestProcessor	CB2 Struts request processor.
EmptyForm	An empty form bean.
InsertTag	Implementation of the <cb2:insert> JSP tag.
InsertTei	Tag Extra Info class for the <cb2:insert> JSP tag.
RequestProcessingContext	Request processor creates an instance of this class and keeps it as a request attribute during the whole request processing procedure.
ShowPageAction	This special action processes requests to pages mapped in the pages-config.xml configuration file.
UIState	General purpose Java bean intended to keep session-scope presentation level state data.

Exception Summary

InvalidParamValueException	This exception is thrown by the ShowPageAction when an presentation element input parameter has an invalid value.
NoRequiredParamException	This exception is thrown by the ShowPageAction when it can't find a required presentation element input parameter in the scope while setting it up.

Package com.boylesoftware.cb2.presentation.servlet Description

Presentation Level framework for web-applications based on Apache Struts.

This framework extends basic Struts elements like actions and form beans with the notion of pages, that can be assembled from individual page components, and presentation elements, that can be used for rendering dynamic content.

To start using this presentation level framework you should install CB2PlugIn class as Struts plug-in for every Struts module, in which you would like to use it. It can be done like this in the struts-config.xml file:

...

<plug-in className="com.boylesoftware.cb2.presentation.servlet.CB2PlugIn">
  <set-property property="pages-config" value="/WEB-INF/pages-config.xml"/>
</plug-in>

...

Note the pages-config.xml file, which is the central presentation level configuration file. See CB2PlugIn class description for more plug-in properties that you can configure.

The plug-in maintains one single instance of CB2Application for the whole web-application and it also installs CB2RequestProcessor, or your own class derived from it, as the request processor for the Struts module.

This presentation level framework cannot coexist with some other Struts extentions like Tiles. Fortunately, it provides all the functionality of Tiles and far beyond it.

Part of this framework is also a JSP custom tag library defined by cb2.tld file. The library introduces <cb2:insert> tag, which allows inserting page attribtues and page components into other page components.