Class DefaultAddHandler

java.lang.Object

ch.autumo.beetroot.server.HTTPServer.DefaultStreamHandler

ch.autumo.beetroot.server.HTTPServer.DefaultHandler

ch.autumo.beetroot.handler.BaseHandler

ch.autumo.beetroot.handler.DefaultAddHandler

All Implemented Interfaces:

Handler, HTTPServer.UriResponder

Direct Known Subclasses:

PropertiesAddHandler, RolesAddHandler, TasksAddHandler, UsersAddHandler

public abstract class DefaultAddHandler
extends BaseHandler

Default handler for 'web/html/<entity>/add.html' templates. This one must be overwritten, because of mandatory db fields that might not be show on the GUI. The values to insert into database must be all defined if they are not nullable!

Nested Class Summary

Nested classes/interfaces inherited from class BaseHandler

BaseHandler.IfSectionHandler

Modifier and Type	Class	Description
protected final class	BaseHandler.IfSectionHandler	State handler for role, entity and action "IFs" for the overall, the template and the template sub-resource layer.

Field Summary

Fields inherited from class BaseHandler

action, columns, emptyBean, entity, htmlData, htmlHead, initialValues, insertServletNameInTemplateRefs, MSG_TYPE_ERR, MSG_TYPE_INFO, MSG_TYPE_WARN, PRECISION_INPUT_TYPES, serverName, servletName, TAG_PREFIX_LANG, transientFields, uniqueFields

Modifier and Type	Field	Description
protected String	action	Current action to process.
protected TreeMap<Integer,String>	columns	Column data map holding the columns.cfg-data of the current processing entity.
protected Entity	emptyBean	Empty bean, used for creating an new entity instance.
protected String	entity	Current entity to process.
protected String	htmlData	HTML table data content.
protected String	htmlHead	HTML head content.
protected Map<String,String>	initialValues	Column data map holding the columns.cfg-data for initial fields used by the add-template.
protected boolean	insertServletNameInTemplateRefs	Insert servlet name inzo template references (links)? Necessary when oparting beetRoot within a servlet container.
static final int	MSG_TYPE_ERR	Message type error.
static final int	MSG_TYPE_INFO	Message type info.
static final int	MSG_TYPE_WARN	Message type warning.
protected static final List<String>	PRECISION_INPUT_TYPES	Precision HTML input types.
protected String	serverName	Server name.
protected String	servletName	Servlet name.
static final String	TAG_PREFIX_LANG	Langiage tag prefix.
protected List<String>	transientFields	Column data list holding the columns.cfg-data for transient fields.
protected String[]	uniqueFields	Column data array holding the columns.cfg-data for unique fields.

Constructor Summary

Constructors

Constructor	Description
DefaultAddHandler(String entity)	Creates the handler for the given entity.
DefaultAddHandler(String entity, String errMsg)	Creates the handler for the given entity.

Method Summary

Modifier and Type	Method	Description
String	extractCustomSingleInputDiv(BeetRootHTTPSession session, String val, ResultSetMetaData rsmd, String columnName, String guiColName, int idx)	Overwrite this method, if you need to add a custom field (HTML 'div'); e.g.
protected String	extractSingleInputDiv(BeetRootHTTPSession session, ResultSetMetaData rsmd, String columnName, String guiColName, int idx)	Extract one single input div with label and input tags from result set standing at current row.
protected String	extractSingleInputDiv(BeetRootHTTPSession session, Map<String,String> data, ResultSetMetaData rsmd, String columnName, String guiColName, int idx)	Extract one single input div with label and input tags from result set standing at current row.
String	formatSingleValueForDB(BeetRootHTTPSession session, String val, String columnname)	Format single value before update / insert into DB.
abstract Map<String,Object>	getAddMandatoryFields()	Get additional mandatory fields of the table that are not present and mandatory fields in the GUI.
Class<?>	getBeanClass()	Get bean entity class that has been generated trough PLANT, self-written or null (then null in extract calls too).
String	getResource()	Get web resource file as it lies on the file system relatively to the started server process.
protected String[]	getSelectValues(String columnName)	Get values for column name
protected boolean	isSelect(String columnName)	Is this column a HTML select field?
HandlerResponse	readData(BeetRootHTTPSession session, int id)	Read data from DB that must be filled when the template is parsed.
HandlerResponse	saveData(BeetRootHTTPSession session)	Save data to DB.

Methods inherited from class BaseHandler

addCheckBox, addErrorMessage, addHtmlDataLine, addHtmlHeadLine, addSuccessMessage, addWarningMessage, columns, columnsSize, deleteData, get, getColumn, getColumnsForSql, getColumnsForSql, getCurrentEntityDbId, getCurrentSession, getCustomizedExceptionInformation, getData, getEmptyBean, getEntity, getHandlerClass, getHtmlData, getHtmlHead, getInsertValues, getLayout, getMessageType, getMimeType, getNewScanner, getNewScanner, getPaginator, getRedirectHandler, getSimpleManagementUserRoles, getStatus, getTableExport, getTemplateEngineErrorMessage, getTemplateEngineErrorTitle, getText, getText, getTitle, getTransientFields, getUpdateSetClause, getUpdateSetClause, hasAccess, hasExternalLinks, hasNoColumnsConfig, initialize, initialValue, initValuesSize, isCurrentUserUpdate, isCustomResponse, isNoContentResponse, isNoContentResponseButRoute, isPrecisionInputType, isRetryCall, loginMarker, parseAssociatedEntities, parseUnassociatedEntities, patchInputValue, readSnippetResource, redirectedMarker, refreshUserRoles, registerDisplayField, registerRoutes, render, renderAll, setCurrentEntityDbId, setMessageType, setVar, setVarAll, showLangMenu, showMenu, uniqueFields, uniqueTest, updateData

Modifier and Type	Method	Description
protected void	addCheckBox(BeetRootHTTPSession session, String columnName)	Add proper logic for check-boxes.
void	addErrorMessage(String message)	Add an error message to show.
void	addHtmlDataLine(String line)	Get HTML data.
void	addHtmlHeadLine(String line)	Get HTML head if there's any.
void	addSuccessMessage(String message)	Add a success message to show.
void	addWarningMessage(String message)	Add a warning message to show.
SortedMap<Integer,String>	columns()	Get columns map.
int	columnsSize()	Amount of columns,
HandlerResponse	deleteData(BeetRootHTTPSession session, int id)	Delete data from DB.
final org.nanohttpd.protocols.http.response.Response	get(HTTPServer.UriResource uriResource, Map<String,String> urlParams, org.nanohttpd.protocols.http.IHTTPSession session)	MAIN method for base handler.
String[]	getColumn(int idx)	Access column values.
String	getColumnsForSql()	Get SQL fields, e.g.
String	getColumnsForSql(boolean forModification)	Get SQL fields, e.g.
final int	getCurrentEntityDbId()	Get current DB id of entity processed, for 'index.html' pages or other pages not showing an existing entity it is '-1'.
final BeetRootHTTPSession	getCurrentSession()	Get current HTTP session process.
protected String[]	getCustomizedExceptionInformation(Session userSession)	Overwrite this method, if you want to have a customized handler exception title and message.
final InputStream	getData()	Get data input stream.
final Entity	getEmptyBean()	Get an ampty bean of the entity type that is processed in this handler.
String	getEntity()	Get web entity (use plural, e.g.
final Class<?>	getHandlerClass(String handlerName)	Get a handler class by handler name.
String	getHtmlData()	Get HTML data.
String	getHtmlHead()	Get HTML head if there's any.
String	getInsertValues(BeetRootHTTPSession session)	Get SQL insert values.
String	getLayout(Session userSession)	Overwrite if you want to have a special layout for this handler.
int	getMessageType()	Get set message type, default it is info/success type.
String	getMimeType()	MIME type of the streamed data.
protected Scanner	getNewScanner(String resource)	Getting a new scanner for a web resource (HTML template) to parse.
protected Scanner	getNewScanner(String resource, String originalResource)	Getting a new scanner for a web resource (HTML template) to parse.
String	getPaginator(BeetRootHTTPSession session)	Get HTML paginator code.
Class<?>	getRedirectHandler()	Overwrite to get the right re-route/redirect index handler after modifying data.
String[]	getSimpleManagementUserRoles()	Retrieve user roles for simple user role management.
org.nanohttpd.protocols.http.response.IStatus	getStatus()	HTTP status of the response.
String	getTableExport(BeetRootHTTPSession session)	Get HTML table export code.
protected String	getTemplateEngineErrorMessage(Session userSession, String resource)	Get message for general template engine error.
protected String	getTemplateEngineErrorTitle(Session userSession, String resource)	Get title for general template engine error.
final String	getText()	Text or HTML content returned by this handler.
String	getText(BeetRootHTTPSession session, int origId)	Process handlers to get the whole HTML page.
String	getTitle(Session userSession)	Page title show left above the navigation area.
List<String>	getTransientFields()	Get transient fields
String	getUpdateSetClause(BeetRootHTTPSession session)	Get SQL update set clause.
String	getUpdateSetClause(BeetRootHTTPSession session, String onOffMapName)	Get SQL update set clause.
boolean	hasAccess(Session userSession)	Overwrite this method, to specifically extend handler authorization, e.g.
boolean	hasExternalLinks()	Overwrite if this handler serves templates with external links (starting with 'http' or 'https').
protected boolean	hasNoColumnsConfig()	Overwrite this if your handler has no columns config configuration.
void	initialize(BeetRootHTTPSession session)	Every handler MUST be initialized!
protected String	initialValue(String colName)	Holds initial add values from 'columns.cfg'.
protected int	initValuesSize()	Return size of initial value list for add template.
protected boolean	isCurrentUserUpdate(BeetRootHTTPSession session)	Is the current user being updated?
protected boolean	isCustomResponse()	Overwrite this if your handler has a custom response; e.g., a JSON response without any further HTML content.
protected boolean	isNoContentResponse()	Overwrite this if your handler doesn't have an output.
protected String	isNoContentResponseButRoute(Session userSession)	Overwrite this if your handler doesn't have an output.
protected boolean	isPrecisionInputType(String inputType)	Is the given HTML input type a precision input type? They are allowed to have a 'maxLength' attribute.
boolean	isRetryCall(BeetRootHTTPSession session)	Is it a retry call?
protected void	loginMarker(boolean redirectLogin)	Login marker method.
protected void	parseAssociatedEntities(StringBuilder snippet, List<Model> list, BeetRootHTTPSession session)	Parse associated list.
protected void	parseUnassociatedEntities(StringBuilder snippet, List<Model> list, BeetRootHTTPSession session)	Parse un-associated list.
static String	patchInputValue(String text, String id, String newValue)	This replaces a value in a HTML element with a specific ID.
protected StringBuilder	readSnippetResource(String resource, Session userSession)	Read snippet resource; e.g., 'web/html/:lang/users/snippets/roles.html'.
protected void	redirectedMarker(boolean redirected)	Mark this handler as it has been redirected from a data modifying handler.
protected final void	refreshUserRoles(int currentUserId, BeetRootHTTPSession session)	Refresh user roles and permissions for current user.
void	registerDisplayField(String displayNameValue)	Register a display name value to be show where defined in template.
static void	registerRoutes(List<Route> routes)	Routes registration method.
void	render(BeetRootHTTPSession session)	Overwrite to set your template variables.
void	renderAll(BeetRootHTTPSession session)	Overwrite to set your variables for the whole HTML page.
final void	setCurrentEntityDbId(int origId)	Set current DB id of entity processed, for 'index.html' pages or other pages not showing an existing entity it is '-1'.
void	setMessageType(int messageType)	Set message type.
final void	setVar(String variable, Object replacement)	Set a template variable.
final void	setVarAll(String variable, Object replacement)	Set a global variable.
boolean	showLangMenu(Session userSession)	Show language menu?
boolean	showMenu(Session userSession)	Show template menu?
String[]	uniqueFields()	Get unique fields.
HandlerResponse	uniqueTest(BeetRootHTTPSession session, String preSql, String operation)	Check if unique fields are unique.
HandlerResponse	updateData(BeetRootHTTPSession session, int id)	Update data in DB.

Methods inherited from class HTTPServer.DefaultStreamHandler

delete, other, post, put

Modifier and Type	Method	Description
org.nanohttpd.protocols.http.response.Response	delete(HTTPServer.UriResource uriResource, Map<String,String> urlParams, org.nanohttpd.protocols.http.IHTTPSession session)	Handles an HTTP DELETE request.
org.nanohttpd.protocols.http.response.Response	other(String method, HTTPServer.UriResource uriResource, Map<String,String> urlParams, org.nanohttpd.protocols.http.IHTTPSession session)	Handles any other HTTP method.
org.nanohttpd.protocols.http.response.Response	post(HTTPServer.UriResource uriResource, Map<String,String> urlParams, org.nanohttpd.protocols.http.IHTTPSession session)	Handles an HTTP POST request.
org.nanohttpd.protocols.http.response.Response	put(HTTPServer.UriResource uriResource, Map<String,String> urlParams, org.nanohttpd.protocols.http.IHTTPSession session)	Handles an HTTP PUT request.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DefaultAddHandler

public DefaultAddHandler(String entity)

Creates the handler for the given entity.

Parameters:

entity - the entity name

DefaultAddHandler

public DefaultAddHandler(String entity,
 String errMsg)

Creates the handler for the given entity.

Parameters:

entity - the entity name

errMsg - the error message

Method Details

readData

public HandlerResponse readData(BeetRootHTTPSession session,
 int id)
                         throws Exception

Description copied from class: BaseHandler

Read data from DB that must be filled when the template is parsed. Used by index and view handlers.

Overrides:

readData in class BaseHandler

Parameters:

session - HTTP session

id - db record id > 0 if a single record should be read otherwise < 0;

Returns:

response or null, null means success, response's status must be checked!

Throws:

Exception - exception

saveData

public HandlerResponse saveData(BeetRootHTTPSession session)
                         throws Exception

Description copied from class: BaseHandler

Save data to DB. Override for add handlers.

Overrides:

saveData in class BaseHandler

Parameters:

session - HTTP session

Returns:

response or null, null means success, response's status must be checked and must hold the id of the saved record!

Throws:

Exception - exception

extractSingleInputDiv

protected String extractSingleInputDiv(BeetRootHTTPSession session,
 ResultSetMetaData rsmd,
 String columnName,
 String guiColName,
 int idx)
                                throws Exception

Extract one single input div with label and input tags from result set standing at current row. NOTE: Never call "set.next()" !

Parameters:

session - HTTP session

rsmd - result set meta data

columnName - column name as configured in 'web/<entity>/columns.cfg'

guiColName - GUI column name as configured in 'web/<entity>/columns.cfg'

idx - SQL result set column index

Returns:

html data extract <div>...</div>

Throws:

Exception - exception

extractSingleInputDiv

protected String extractSingleInputDiv(BeetRootHTTPSession session,
 Map<String,String> data,
 ResultSetMetaData rsmd,
 String columnName,
 String guiColName,
 int idx)
                                throws Exception

Extract one single input div with label and input tags from result set standing at current row. NOTE: Never call "set.next()" ! Called in the retry case; 'data' contains cached data from previous user input.

Parameters:

session - HTTP session

data - repost data (retry data)

rsmd - result set meta data

columnName - column name as configured in 'web/<entity>/columns.cfg'

guiColName - GUI column name as configured in 'web/<entity>/columns.cfg'

idx - SQL result set column index

Returns:

html data extract <div>...</div>

Throws:

Exception - exception

extractCustomSingleInputDiv

public String extractCustomSingleInputDiv(BeetRootHTTPSession session,
 String val,
 ResultSetMetaData rsmd,
 String columnName,
 String guiColName,
 int idx)
                                   throws Exception

Overwrite this method, if you need to add a custom field (HTML 'div'); e.g. when multiple user roles are used; in this case the 'div' is more likely consisting of 2 role assignment boxes instead of a simple input-'div' or use it for any custom 'div'. The 'div' is guaranteed to be inserted in the column-order as defined in the 'columns.cfg'.

The return value of this method is essential:

• Returns the data (including an empty character string): The HTML data is inserted into the template and further parsing of the columns for the HTML input elements is completed.
• If 'null' is returned, the search for matching input elements for the current columns is continued, even if it is a transient column! Transient columns should be parsed in this method!

Parameters:

session - HTTP session

val - repost data (only available in retry case)

rsmd - result set meta data

columnName - column name as configured in 'web/<entity>/columns.cfg'

guiColName - GUI column name as configured in 'web/<entity>/columns.cfg'

idx - SQL result set column index

Returns:

html data extract <div>...</div>

Throws:

Exception - exception

isSelect

protected boolean isSelect(String columnName)

Is this column a HTML select field?

Parameters:

columnName - column name

Returns:

true if so

getSelectValues

protected String[] getSelectValues(String columnName)

Get values for column name

Parameters:

columnName - column name

Returns:

select values

formatSingleValueForDB

public String formatSingleValueForDB(BeetRootHTTPSession session,
 String val,
 String columnname)

Description copied from class: BaseHandler

Format single value before update / insert into DB. This method is useful if you want to store null values for date, time or time-stamp in the database. In the HTML user interface, the value would be displayed as '' (empty string), which is not a valid value in the database; in this case, it would need to be set to null. This is rarely the case, as date/time values are normally set or, if they are mandatory, should be set in the getAddMandatoryFields() method when creating a new record. It is therefore only possible for updates.

Overrides:

formatSingleValueForDB in class BaseHandler

Parameters:

session - HTTP session

val - value

columnname - column name

Returns:

formatted value

getAddMandatoryFields

public abstract Map<String,Object> getAddMandatoryFields()

Get additional mandatory fields of the table that are not present and mandatory fields in the GUI. They are usually the DB NOT NULL fields. Return the column/value pair within a map. The value must be an object that is representable as a string!

Returns:

column/value pair map

getResource

public String getResource()

Description copied from class: BaseHandler

Get web resource file as it lies on the file system relatively to the started server process.

Specified by:

getResource in interface Handler

Specified by:

getResource in class BaseHandler

Returns:

web resource

getBeanClass

public Class<?> getBeanClass()

Get bean entity class that has been generated trough PLANT, self-written or null (then null in extract calls too).

Overrides:

getBeanClass in class BaseHandler

Returns:

bean entity class