com.tenduke.services.objectmodel.formhandler
Class AbstractObjectModelFormHandler<T extends SerializableObject>

java.lang.Object
  extended by com.tenduke.services.objectmodel.formhandler.AbstractObjectModelFormHandler<T>
Type Parameters:
T - Type parameter for object type to parse from form.
All Implemented Interfaces:
FormDataHandler
Direct Known Subclasses:
CompanyFormHandler

public abstract class AbstractObjectModelFormHandler<T extends SerializableObject>
extends java.lang.Object
implements FormDataHandler

Abstract FormDataHandler class that declares signature for parsing and creating object model objects from client HTTP requests.

This base class provides a Map to hold form parameters. The form parameters are put into the map in method handleParameterPart(java.lang.String, java.lang.String). Parameters that have not null name and value are stored.


Constructor Summary
AbstractObjectModelFormHandler()
           
 
Method Summary
protected  T getFirstResultObject()
          Gets first object read from client HTTP request.
 javax.servlet.http.HttpServletRequest getRequest()
          Gets handle to client HTTP request object.
 java.util.Map<java.lang.String,java.lang.String> getRequestParameters()
          Gets map with request parameters stored in handleParameterPart(java.lang.String, java.lang.String).
protected abstract  java.util.List<T> getResultObjects()
          Gets list of objects read from client HTTP request.
 void handleParameterPart(java.lang.String parameterName, java.lang.String parameterValue)
          Store single form field as a key-value entry to the hash map.
 java.util.List<T> parse(javax.servlet.http.HttpServletRequest request)
          Parse a request and create object model objects based on form data.
 T parseFirst(javax.servlet.http.HttpServletRequest request)
          Parse a request and create object model object based on form data.
 void setRequest(javax.servlet.http.HttpServletRequest request)
          Sets handle to client HTTP request.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.tenduke.networking.http.FormDataHandler
beginHandling, endHandling, getPathForFileWrite, handleFilePart, handleHeader
 

Constructor Detail

AbstractObjectModelFormHandler

public AbstractObjectModelFormHandler()
Method Detail

getFirstResultObject

protected T getFirstResultObject()
Gets first object read from client HTTP request.

Returns:
first object read from client HTTP request.

getRequest

public javax.servlet.http.HttpServletRequest getRequest()
Gets handle to client HTTP request object.

Returns:
handle to client HTTP request object.

getRequestParameters

public java.util.Map<java.lang.String,java.lang.String> getRequestParameters()
Gets map with request parameters stored in handleParameterPart(java.lang.String, java.lang.String).

Returns:
the request parameters Map.

getResultObjects

protected abstract java.util.List<T> getResultObjects()
Gets list of objects read from client HTTP request.

Returns:
list of objects read from client HTTP request.

handleParameterPart

public void handleParameterPart(java.lang.String parameterName,
                                java.lang.String parameterValue)
Store single form field as a key-value entry to the hash map. If either parameter name or value is null, no entries are stored.

Specified by:
handleParameterPart in interface FormDataHandler
Parameters:
parameterName - Parameter name
parameterValue - Parameter value

parse

public java.util.List<T> parse(javax.servlet.http.HttpServletRequest request)
                                                   throws java.io.IOException
Parse a request and create object model objects based on form data.

Parameters:
request - Client HTTP request to read data from.
Returns:
List of object model objects.
Throws:
java.io.IOException - For errors parsing request.

parseFirst

public T parseFirst(javax.servlet.http.HttpServletRequest request)
                                        throws java.io.IOException
Parse a request and create object model object based on form data.

Parameters:
request - Client HTTP request to read data from.
Returns:
First object model object found in request.
Throws:
java.io.IOException - For errors parsing request.

setRequest

public void setRequest(javax.servlet.http.HttpServletRequest request)
Sets handle to client HTTP request.

Parameters:
request - handle to client HTTP request.