|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object shared.HelperBaseCh4 shared.HelperBaseCh5 shared.HelperBaseCh6 ch6.complexInit.ControllerHelper
public class ControllerHelper
Uses complex form elements. Creates a map of values that have been selected by the user. This map can be accessed in the JSP to simplify initialising the complex elements.
The complex form elements in the bean use annotations to indicate if they are initialised with 'checked' or 'selected'.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class shared.HelperBaseCh4 |
---|
HelperBaseCh4.SessionData |
Field Summary |
---|
Fields inherited from class shared.HelperBaseCh6 |
---|
checked, selected |
Fields inherited from class shared.HelperBaseCh4 |
---|
logger, request, response |
Constructor Summary | |
---|---|
ControllerHelper(javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response)
The only constructor for this class has parameters for the request and response objects. |
Method Summary | |
---|---|
java.lang.String |
confirmMethod()
The method that preforms the actions associated with the confirm button. |
void |
copyFromSession(java.lang.Object sessionHelper)
Most of the details for retrieving data from the session are implemented in the helper base class. |
protected void |
doGet()
This method will be called by the controller to finish processing the request. |
protected void |
doPost()
This method will be called by the controller to finish processing the request. |
java.lang.String |
editMethod()
The method that preforms the actions associated with the edit button. |
java.lang.Object |
getData()
Accessor that returns the bean. |
protected java.lang.String |
jspLocation(java.lang.String page)
Generates the full path to a JSP. |
java.lang.String |
processMethod()
The method that preforms the actions associated with the process button. |
void |
resetNullable()
Certain form elements might not place data in the query string, if the user does not specify a value. |
Methods inherited from class shared.HelperBaseCh6 |
---|
addChecked, addChoice, addSelected, clearMaps, clearProperty, getChecked, getSelected, invokeGetter, setCheckedAndSelected, setCheckedAndSelected |
Methods inherited from class shared.HelperBaseCh5 |
---|
getErrors, isValid, isValidProperty, setErrors |
Methods inherited from class shared.HelperBaseCh4 |
---|
addHelperToSession, addHelperToSession, executeButtonMethod, executeButtonMethod, fillBeanFromRequest, invokeButtonMethod, populateThrow, writeError |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public ControllerHelper(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
request
- The object that encapsulates the request
information that is needed to communicate
with the browser.response
- The object that encapsulates the response
information that is needed to communicate
with the browser.Method Detail |
---|
public java.lang.Object getData()
public void copyFromSession(java.lang.Object sessionHelper)
copyFromSession
in class HelperBaseCh4
sessionHelper
- The object that represents the controller helper that
was added to the session in the previous request.
During each request, the controller helper is placed in the session. Before that happens, the controller helper from the previous request can be retrieved from the session. This object is retrieved in the helper base class and sent to the implementation of this abstract method.
public void resetNullable()
Use this method to call the setters for all nullable fields and clear any old values.
protected java.lang.String jspLocation(java.lang.String page)
page
- The name of the JSP. This will be appended to the
path of the directory that contains the JSPs. Using
this method forces all the JSPs to be in the same
directory.
public java.lang.String editMethod()
public java.lang.String confirmMethod()
If the data is valid, then the next page will be the confirm page. If the data is not valid, then the next page will be the edit page.
If there are errors, they will be displayed in the edit page.
Nullable fields must be cleared before new data is entered by the user. The nullable form elements are radio, checkbox and multiple select lists.
Call the helper base method setCheckedAndSelected to create a map of values that have been chosen by the user. The key will be the user's selection, the value will be either 'checked' or 'selected'. This map will simplify the initialisation of complex elements in the JSP.
public java.lang.String processMethod()
protected void doGet() throws javax.servlet.ServletException, java.io.IOException
GET requests will be treated as first requests to the application. Previous data will not be retrieved from the session and the edit page will always be displayed.
doGet
in class HelperBaseCh4
javax.servlet.ServletException
- A servlet exception is a severe error
and means that processing cannot continue.
java.io.IOException
- An IO exception is a severe error
and means that processing cannot continue.protected void doPost() throws javax.servlet.ServletException, java.io.IOException
POST requests will implement the controller logic that has been in all previous controllers.
doPost
in class HelperBaseCh4
javax.servlet.ServletException
- A servlet exception is a severe error
and means that processing cannot continue.
java.io.IOException
- An IO exception is a severe error
and means that processing cannot continue.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |