atg.svc.ui.formhandlers
Class ServiceFormHandler

java.lang.Object
  atg.nucleus.logging.VariableArgumentApplicationLoggingImpl
      atg.nucleus.GenericService
          atg.droplet.EmptyFormHandler
              atg.droplet.GenericFormHandler
                  atg.droplet.TransactionalFormHandler
                      atg.web.formhandlers.ApplicationFormHandler
                          atg.svc.ui.formhandlers.ServiceFormHandler

All Implemented Interfaces:

atg.droplet.DropletFormHandler, atg.naming.NameContextBindingListener, atg.naming.NameContextElement, atg.naming.NameResolver, atg.nucleus.AdminableService, atg.nucleus.logging.ApplicationLogging, atg.nucleus.logging.ApplicationLoggingSender, atg.nucleus.logging.TraceApplicationLogging, atg.nucleus.logging.VariableArgumentApplicationLogging, atg.nucleus.naming.ComponentNameResolver, atg.nucleus.Service, atg.nucleus.ServiceListener, FormHandlerConstants, java.util.EventListener

Direct Known Subclasses:

FrameworkBaseFormHandler, RatingFormHandler

public class ServiceFormHandler
extends atg.web.formhandlers.ApplicationFormHandler
implements FormHandlerConstants

Base FormHandler for service applications that adds some additional error handling and transaction management. By default transactions are enabled for all setters/handle method calls on the form. The transaction encapsulates all setter and handle calls together and then ends the transaction in afterSet. Also, by default transactions are not rolled back.

Field Summary

static java.lang.String	CLASS_VERSION Class version string
static java.lang.String	PERFMON_OP_FORM_HANDLER

Fields inherited from class atg.web.formhandlers.ApplicationFormHandler

EQUALS, PARAM_DELIMITER, QUERY_DELIMITER, STATUS_ERROR_REDIRECT, STATUS_ERROR_STAY, STATUS_SUCCESS

Fields inherited from class atg.droplet.GenericFormHandler

PARAM_DEFER_FORWARD_OR_REDIRECT, PARAM_USE_FORWARDS

Fields inherited from class atg.nucleus.GenericService

SERVICE_INFO_KEY

Fields inherited from interface atg.svc.ui.formhandlers.FormHandlerConstants

OPTIONS_ANSWER_DISPLAY, OPTIONS_ANSWER_DISPLAY_CURRENT_WINDOW, OPTIONS_ANSWER_DISPLAY_MULTIPLE_WINDOWS, OPTIONS_ANSWER_DISPLAY_SINGLE_WINDOW, OPTIONS_FILTER_BY_DOC_SET, OPTIONS_FILTER_BY_FORMAT, OPTIONS_FILTER_BY_SOURCE, OPTIONS_FILTER_BY_TITLE, OPTIONS_FILTER_OR_GROUPING_FILTER, OPTIONS_FILTER_OR_GROUPING_GROUP, OPTIONS_FILTER_OR_GROUPING_NONE, OPTIONS_QUERY_LANGUAGE, OPTIONS_RESULT_LANGUAGE, OPTIONS_SHOW_ANSWERS_AS, OPTIONS_SHOW_ANSWERS_BY_DOC, OPTIONS_SHOW_ANSWERS_INDIVIDUAL, OPTIONS_SHOW_FAQS_AS_QUESTIONS, OPTIONS_SHOW_FAQS_AS_QUESTIONS_AND_ANSWERS, PARAM_SITE_ID

Fields inherited from interface atg.nucleus.logging.TraceApplicationLogging

DEFAULT_LOG_TRACE_STATUS

Fields inherited from interface atg.nucleus.logging.ApplicationLogging

DEFAULT_LOG_DEBUG_STATUS, DEFAULT_LOG_ERROR_STATUS, DEFAULT_LOG_INFO_STATUS, DEFAULT_LOG_WARNING_STATUS

Constructor Summary

ServiceFormHandler()

Method Summary

void	handleUncheckedFormException(java.lang.Throwable exception, atg.servlet.DynamoHttpServletRequest pRequest, atg.servlet.DynamoHttpServletResponse pResponse) Logs all unhandled exceptions if the formhandler is configured to do so in the loggingUncheckedError property.
boolean	isLoggingUncheckedException() Gets the value of the loggingUncheckedException property.
boolean	isRollbackTransactionOnFormError() Gets the isRollbackTransactionOnFormError property.
protected boolean	isTransactionMarkedAsRollback() Returns true if there has been a form error or unchecked exception thrown in the handle method so that the transaction can be been marked for rollback.
void	processException(java.lang.Exception pException, java.lang.String pMsgId, atg.servlet.DynamoHttpServletRequest pRequest, atg.servlet.DynamoHttpServletResponse pResponse) Override processException to force all exceptions to be logged if isLoggingError=true
void	processException(java.lang.Exception pException, java.lang.String pMsgId, atg.servlet.DynamoHttpServletRequest pRequest, atg.servlet.DynamoHttpServletResponse pResponse, java.lang.Object[] pParam) Override processException to force all exceptions to be logged if isLoggingError=true
void	setLoggingUncheckedException(boolean pLoggingUncheckedException) Sets the value of the loggingUncheckedException property.
void	setRollbackTransactionOnFormError(boolean pRollbackTransactionOnFormError) Set the isRollbackTransactionOnFormError property.

Methods inherited from class atg.web.formhandlers.ApplicationFormHandler

addParameterToURLString, beforeGet, beforeSet, checkFormError, checkFormRedirect, checkFormSuccess, formHandlerBeforeGet, formHandlerBeforeSet, formHandlerInit, getErrorURL, getRedirectDelayMS, getString, getString, getString, getSuccessURL, getUserMessagesResourceBundle, handleCancel, processException, processException, processExceptionAndLog, processExceptionAndLog, redirect, setErrorURL, setRedirectDelayMS, setSuccessURL, setUserMessagesResourceBundle

Methods inherited from class atg.droplet.TransactionalFormHandler

afterSet, commitTransaction, getTransactionDemarcation, getTransactionStatus, isEnsureTransaction, isRollbackTransaction, isRollbackTransactionOnUnhandledException, setEnsureTransaction, setRollbackTransaction, setRollbackTransactionOnUnhandledException, setTransactionDemarcation

Methods inherited from class atg.droplet.GenericFormHandler

addFormException, addUncheckedFormException, createFormSubmissionMessage, getCancelURL, getCheckForValidSession, getFormError, getFormExceptions, getFormName, getMessagePort, getMessageSource, getMessageType, getPropertyExceptions, getSendMessages, getUncheckedFormExceptions, handleFormException, hasUncheckedFormExceptions, isDeferForwardsAndRedirects, isRestorableForm, isUseForwards, isValidSession, redirectOrForward, resetFormExceptions, setCancelURL, setCheckForValidSession, setDeferForwardsAndRedirects, setFormName, setMessagePort, setMessageSource, setMessageType, setRestorableForm, setSendMessages, setUseForwards

Methods inherited from class atg.droplet.EmptyFormHandler

afterGet

Methods inherited from class atg.nucleus.GenericService

addLogListener, createAdminServlet, doStartService, doStopService, getAbsoluteName, getAdminServlet, getLoggingForVlogging, getLogListenerCount, getLogListeners, getName, getNameContext, getNucleus, getRoot, getServiceConfiguration, getServiceInfo, isLoggingDebug, isLoggingError, isLoggingInfo, isLoggingTrace, isLoggingWarning, isRunning, logDebug, logDebug, logDebug, logError, logError, logError, logInfo, logInfo, logInfo, logTrace, logTrace, logTrace, logWarning, logWarning, logWarning, nameContextElementBound, nameContextElementUnbound, removeLogListener, resolveName, resolveName, resolveName, resolveName, sendLogEvent, setLoggingDebug, setLoggingError, setLoggingInfo, setLoggingTrace, setLoggingWarning, setNucleus, setServiceInfo, startService, stopService

Methods inherited from class atg.nucleus.logging.VariableArgumentApplicationLoggingImpl

vlogDebug, vlogDebug, vlogDebug, vlogDebug, vlogError, vlogError, vlogError, vlogError, vlogInfo, vlogInfo, vlogInfo, vlogInfo, vlogTrace, vlogTrace, vlogTrace, vlogTrace, vlogWarning, vlogWarning, vlogWarning, vlogWarning

Methods inherited from class java.lang.Object

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

Field Detail

CLASS_VERSION

public static java.lang.String CLASS_VERSION

Class version string

PERFMON_OP_FORM_HANDLER

public static final java.lang.String PERFMON_OP_FORM_HANDLER

See Also:

Constant Field Values

Constructor Detail

ServiceFormHandler

public ServiceFormHandler()

Method Detail

isRollbackTransactionOnFormError

public boolean isRollbackTransactionOnFormError()

Gets the isRollbackTransactionOnFormError property.

Returns:

true if the transaction should rollback when there are form errors.

setRollbackTransactionOnFormError

public void setRollbackTransactionOnFormError(boolean pRollbackTransactionOnFormError)

Set the isRollbackTransactionOnFormError property.

Parameters:

pRollbackTransactionOnFormError - true if the transaction should rollback when there are form errors.

isLoggingUncheckedException

public boolean isLoggingUncheckedException()

Gets the value of the loggingUncheckedException property.

Returns:

true if unchecked exceptions passed to handleUncheckedException should be logged.

setLoggingUncheckedException

public void setLoggingUncheckedException(boolean pLoggingUncheckedException)

Sets the value of the loggingUncheckedException property.

Parameters:

pLoggingUncheckedException - true if unchecked exceptions passed to handleUncheckedException should be logged.

handleUncheckedFormException

public void handleUncheckedFormException(java.lang.Throwable exception,
                                         atg.servlet.DynamoHttpServletRequest pRequest,
                                         atg.servlet.DynamoHttpServletResponse pResponse)

Logs all unhandled exceptions if the formhandler is configured to do so in the loggingUncheckedError property.

Specified by:

handleUncheckedFormException in interface atg.droplet.DropletFormHandler

Overrides:

handleUncheckedFormException in class atg.droplet.GenericFormHandler

Parameters:

exception - The unchecked exception to log.

pRequest - The request

pResponse - The response

processException

public void processException(java.lang.Exception pException,
                             java.lang.String pMsgId,
                             atg.servlet.DynamoHttpServletRequest pRequest,
                             atg.servlet.DynamoHttpServletResponse pResponse)

Override processException to force all exceptions to be logged if isLoggingError=true

Parameters:

pException -

pMsgId -

pRequest -

pResponse -

processException

public void processException(java.lang.Exception pException,
                             java.lang.String pMsgId,
                             atg.servlet.DynamoHttpServletRequest pRequest,
                             atg.servlet.DynamoHttpServletResponse pResponse,
                             java.lang.Object[] pParam)

Override processException to force all exceptions to be logged if isLoggingError=true

Parameters:

pException -

pMsgId -

pRequest -

pResponse -

pParam -

isTransactionMarkedAsRollback

protected boolean isTransactionMarkedAsRollback()

Returns true if there has been a form error or unchecked exception thrown in the handle method so that the transaction can be been marked for rollback.

Overrides:

isTransactionMarkedAsRollback in class atg.droplet.TransactionalFormHandler

Returns:

True if the transaction is marked for rollback.