Expresso 5-6

Uses of Class
com.jcorporate.expresso.core.controller.ControllerException

Packages that use ControllerException
com.jcorporate.expresso.core.controller This package contains the object defining the "Controller" object, an important component of Expresso that should be used to encapsulate all user interaction sequences.  
com.jcorporate.expresso.core.dbobj Ancestor objects for all Database Objects and Schemas.  
com.jcorporate.expresso.core.misc Miscellaneous objects for file manipulation, running OS processes, etc 
com.jcorporate.expresso.core.misc.upload Classes to assist in parsing multi-part upload requests 
com.jcorporate.expresso.core.servlet.viewhandler Servlets to render the View.  
com.jcorporate.expresso.core.utility Package to contain all of the 'utility' programs in Expresso - these are applications that run from the command line (e.g. not servlets) 
com.jcorporate.expresso.ext.controller Controllers that are optional to Expresso.  
com.jcorporate.expresso.ext.struts.taglib This package contains tag libraries that correspond to the Struts Library tags.  
com.jcorporate.expresso.ext.xml.controller Contains a controller object for importing and export DBObject data into XML formats. 
com.jcorporate.expresso.services.controller.configuration   
com.jcorporate.expresso.services.controller.dbmaint This package contains the various State objects that make up the "Model" of the DBMaint controller.  
com.jcorporate.expresso.services.controller.ui Objects that provide an automatic user interface rendering capability to the system 
com.jcorporate.expresso.services.validation This package provides for a 'validation framework'.  
 

Uses of ControllerException in com.jcorporate.expresso.core.controller
 

Methods in com.jcorporate.expresso.core.controller that throw ControllerException
 void Block.removeNested(ControllerElement elementToRemove)
          Remove an element from the nested elements for this item
static ControllerElement Block.fromXML(org.w3c.dom.Node n)
          Return a controller element based upon the xml fragment
 void Block.setForm(String isForm)
          Set whether this form is true or not.
 void Block.setFormEncoding(String encoding)
          Set the encoding attribute for the block form
 void Block.setFormMethod(String method)
          Set the form method.
 void Block.setFormTransition(Transition a)
          Sets the form transition
protected  void Controller.addPromptTransitions(State nextState, ControllerResponse response)
          If nextState is a prompt state (as determined by the addStatePairing method) then add a 'next' and 'previous' transitions as required.
protected  org.apache.struts.action.ActionForm Controller.findControllerForm(ControllerRequest request)
          Return the Struts ActionForm associated with this controller as specified in the Struts config file.
protected  void Controller.addRequestedURLtoSession(HttpServletRequest req, ControllerRequest creq)
           
protected  void Controller.addRegDomainParamtoSession(HttpServletRequest req, ControllerRequest creq, String regDomain)
          ???????????????????????
static Controller Controller.instantiate(String className)
          Factory method to create an Controller from it's name Do not call this function directly!
protected  StateForm Controller.loadStateForm(State nextState, org.apache.struts.action.ActionForm controllerForm)
          Return the state's form with data from the controller's form.
 ControllerResponse Controller.newState(String newState, ControllerRequest myRequest)
          This is the method where all of the real work of the controller is done.
protected  void Controller.prePerform(State nextState, ControllerRequest request, ControllerResponse response)
          Template Method, allowing a subclass to do an action after any state in this controller is performed.
protected  void Controller.postPerform(State nextState, ControllerRequest request, ControllerResponse response)
          Template Method, allowing a subclass to into actions after the invocation of any state in this controller.
protected  org.apache.struts.action.ActionForward Controller.getActionForward(ServletControllerRequest req, org.apache.struts.config.ActionConfig mapping, ControllerResponse res)
          Determine the forward appropriate for this controller/state, either from parameters or from configuration files, or from remapping based on past extensions like .xsl
protected  org.apache.struts.config.ForwardConfig Controller.remapFromExtension(org.apache.struts.config.ForwardConfig fwd, org.apache.struts.config.ActionConfig mapping, ServletControllerRequest req)
          if the extension in the current forward is ".xsl" or ".xslt", remap the forward to "xml", and set a parameter for the xsl style sheet.
protected  void Controller.populateStateForm(StateForm stateForm, ControllerRequest request)
          Populate the state form with any matching request parameters.
protected  void Controller.processRequestTransitions(State nextState, ControllerRequest request)
          

This method picks up the following routing parameters from the current request and builds transition objects from them before the state is invoked.

protected  Transition Controller.processTransitions(ControllerRequest request, ControllerResponse response, State nextState)
          This method is the traffic cop that determines which transition to execute after a state completes.
 ControllerResponse Controller.setCurrentState(String newState, ControllerRequest params)
          Convenience method to be able to access the state as a property from a JSP.
protected  void Controller.setupReturnToSender(State nextState, ControllerRequest request)
          This method is called before a state executes.
 boolean Controller.stateAllowed(String newState, ControllerRequest params)
          Is this state allowed for the current user?
protected  void Controller.transition(String newState, ControllerRequest req, ControllerResponse res)
           
protected  void Controller.transition(String newState, Class externalController, ControllerRequest req, ControllerResponse res)
          convenience method for transition to other controller
protected  void Controller.transition(String newState, ControllerRequest req, ControllerResponse res, boolean clear)
          Transition to an internal state.
protected  void Controller.unloadStateForm(StateForm stateForm, org.apache.struts.action.ActionForm controllerForm)
          Move the state's form data back into the controller's form.
static ServletControllerRequest ServletControllerRequest.parseParamsMultiPart(org.apache.struts.upload.MultipartRequestHandler mp, org.apache.struts.action.ActionMapping mapping, org.apache.struts.action.ActionForm form, HttpServletRequest request, HttpServletResponse response, Controller controller)
          Static constructor for creating an servlet controller request with all the acoutrements of the Struts Action execution signature.
static ServletControllerRequest ServletControllerRequest.parseParams(org.apache.struts.action.ActionMapping mapping, org.apache.struts.action.ActionForm form, HttpServletRequest request, HttpServletResponse response, Controller controller)
          Parse a regular servlet request for parameters (e.g. not multipart)
 Controller DefaultControllerFactory.getController(String className)
          Retrieve the Action controller that matches the class name
 Controller DefaultControllerFactory.getController(String moduleName, String className)
          Retrieve the Action controller that matches the class name The moduleName is ignored for this implementation.
 Controller DefaultControllerFactory.getController(ControllerRequest request)
          Retrieve the Action controller that matches the class name The Struts 1.1 modules are ignored for this implementation.
 void ControllerRequest.setFileParameter(String paramName, String paramValue, String fileName)
           
 void ControllerRequest.setParameter(String paramName, String paramValue)
           
 void ControllerRequest.setObjectParameter(String paramName, Object paramValue)
          Set a parameter as an object
 Object ControllerRequest.getObjectParameter(String paramName)
           
 void ControllerRequest.setSession(PersistentSession newSession)
          Provide the controller with a PersitentSession object, which it can use to hold values between invokations.
 PersistentSession ControllerRequest.getSession()
          Returns the Persistant Session Wrapper object to store requests between environments.
 void ControllerRequest.populate(DBObject myDBObj)
          Convenience method to populate a dbobject from the parameters supplied, by looking for parameters with the same name as the field name in the db object
 ErrorCollection ControllerRequest.getErrorCollection()
          Returns the Error collection that exists in the current session.
 void ControllerRequest.validateDBObject(DBObject oneObject, ErrorCollection ec)
          Convenience method that retrieves parameters/field values and populates a specified db object.
 void ControllerRequest.validateDBField(String dbFieldName, DBObject oneObject, ErrorCollection ec)
          Convenience method that retrieves the validates against that one database object field.
 void ControllerRequest.validateField(String dbFieldName, String reqFieldName, DBObject oneObject, ErrorCollection ec)
          Convenience method that retrieves the validates against that one database object field.
 void ControllerResponse.setAttribute(String attrib, String val)
          Set the named attribute of this Controller to the given value
 String ControllerResponse.getAttribute(String attrib)
          Retrieve an attribute as specified from the request
 void ControllerResponse.setAttributes(Map attributes)
          Set the attribute Map
 Map ControllerResponse.getAttributes()
          Get the attribute Map
 Block ControllerResponse.getBlock(String blockName)
          Get a specific block.
 void ControllerResponse.setDBName(String newDBName)
          Set the db name of this ControllerResponse
 String ControllerResponse.getDBName()
          Get the database from the request, if there is a request available
 String ControllerResponse.getDataContext()
          Get the database from the request, if there is a request available
 void ControllerResponse.setFormCache()
          Automatically find all input fields and put them in the formCache.
 void ControllerResponse.setFormCache(String fieldName, String fieldValue)
          Save a name/value pair to the formCache.
 Hashtable ControllerResponse.getFormCache()
          Get the entire formResponseCache Hashtable Creation date: (7/19/00 7:18:51 PM) author: Adam Rossi, PlatinumSolutions
 String ControllerResponse.getFormCache(String fieldName)
          Fetch the requested field from the response cache.
 void ControllerResponse.setFormCacheAttribute(String fieldName, Object fieldAttribute)
          Allows the generic setting of form attributes.
 Object ControllerResponse.getFormCacheAttribute(String fieldName)
          Gets the saved cache attribute.
 Locale ControllerResponse.getLocale()
          Retrieve the Locale for the request
 Map ControllerResponse.getNamedInputs()
          Retrieve the Inputs as a map so that JSTL can cope with navigating the ControllerResponse through a named fashion
 Output ControllerResponse.getOutput(String outputName)
          Get a specific output item.
 String ControllerResponse.getOutputContent(String outputName)
          Get the contents of a particular Output item.
 Output ControllerResponse.getOutputRequired(String outputName)
          Get the named output, but throw if it's not found.
 ErrorCollection ControllerResponse.getErrors()
          Retrieve the error collection for this response
 String ControllerResponse.getParameter(String paramName)
          Retrieve the parameter
 void ControllerResponse.setRequest(ControllerRequest newRequest)
          Set the controller request - this is done as part of the processing of the controller so that the response has access to all of the request fields
 String ControllerResponse.getString(String stringCode, Object[] args)
          retrieve an appropriate localized string from the correct Schema object.
 String ControllerResponse.getString(String stringCode)
          Convenience version of the above with no arguments.
 String ControllerResponse.getString(String stringCode, String string1)
          Convenience method of getString(String,Object[]) where first (and only) param of args will be string1
 String ControllerResponse.getString(String stringCode, String string1, String string2)
          Convenience method to retrieve the string with two formatting parameters
 String ControllerResponse.getString(String stringCode, String string1, String string2, String string3)
          Retrieve a localized string with 3 formatting parameters
 String ControllerResponse.getString(String stringCode, String string1, String string2, String string3, String string4)
          Retrieve a localized string with 4 formatting parameters
static ControllerResponse ControllerResponse.fromXML(org.w3c.dom.Node n)
          Assemble a ControllerResponse from an xml document (may be document fragment).
 Transition ControllerResponse.getTransition(String transitionName)
          Get a specific transition item.
 Map ControllerResponse.getNamedBlocks()
          Retrieve the Blocks as a map so that JSTL can cope with navigating the ControllerResponse through a named fashion
 Map ControllerResponse.getNamedOutputs()
          Retrieve the Outputs as a map so that JSTL can cope with navigating the ControllerResponse through a named fashion
 Map ControllerResponse.getNamedTransitions()
          Retrieve the Transitions as a map so that JSTL can cope with navigating the ControllerResponse through a named fashion
 void ControllerResponse.setUser(String newUser)
          Set the user string value
 String ControllerResponse.getUser()
          Get the database from the request, if there is a request available
 void ControllerResponse.add(ControllerElement t)
          Convenience method to allow us to add any ControllerElement to this controllers inputs, outputs or transitions
 void ControllerResponse.addAutoInput(String fieldName, String friendlyName, String defaultValue, int displayLength, int maxLength, Vector validValues)
          addAutoInput is a convenience method that creates a new Input object based on the specified field parameters and adds the input object to this controller object.
 void ControllerResponse.addAutoInput(String fieldName, DBObject dbobj, String defaultValue)
          addAutoInput is a convenience method that creates a new Input object based on the specified field parameters and adds the input object to this controller object.
 void ControllerResponse.addAutoInput(String fieldName, String dbClassName, String defaultValue)
          addAutoInput is a convenience method that creates a new Input object based on the specified field parameters and adds the input object to this controller object.
 void ControllerResponse.addAutoInput(DBObject myDBObj)
          Convenience method to add an input for every non-secret field in a db object to the current response, using the default values and valid values provided by the db object itself
 void ControllerResponse.addAutoInput(String fieldName, String friendlyName, String dbClassName, String defaultValue)
          addAutoInput is a convenience method that creates a new Input object based on the specified field parameters and adds the input object to this controller object.
 void ControllerResponse.addAutoInput(String fieldName, String friendlyName, String defaultValue, int displayLength, int maxLength, Vector validValues, String fieldType)
          addAutoInput is a convenience method that creates a new Input object based on the specified field parameters and adds the input object to this controller object.
 void ControllerResponse.addAutoInputRenameField(String fieldName, String renameFieldTo, DBObject dbobj, String defaultValue)
          addAutoInputRenameField is a convenience method that creates a new Input object based on the specified field parameters and adds the input object to this controller object.
 void ControllerResponse.addBlock(Block newBlock)
          Adds a Block to the response that will be formatted by the controller handler
 void ControllerResponse.addError(String errorMessage)
           
 void ControllerResponse.addError(String errorMessage, Object arg)
          add an error code, and an associated arg for translating that error code
 void ControllerResponse.addError(String errorMessage, Object[] args)
          add an error code, and associated args for translating that error code
 void ControllerResponse.addError(String propName, String errorMessage)
          Deprecated. 7/04 v5.5 expresso uses only one property name, the default; use addError(String errmsg) instead
 void ControllerResponse.addInput(Input newInput)
          Add an Input to the ControllerResponse
 void ControllerResponse.addOutput(Output newOutput)
          Add an Output to the controller response object
 void ControllerResponse.addTransition(Transition newTransition)
          Add a Transition to this ControllerResponse
 void ControllerResponse.autoValidate(String checkClassName, ErrorCollection errorCollection)
          AutoValidate is a quick way to validate the fields of a specified dbobj.
 void ControllerResponse.autoValidate(String checkClassName, ErrorCollection errorCollection, Vector requiredFields)
          AutoValidate is a quick way to validate the fields of a specified dbobj.
 void ControllerResponse.clearFormCache()
          Completely clear the internal formResponseCache Creation date: (7/19/00 6:53:58 PM) author: Adam Rossi, PlatinumSolutions
 boolean ControllerResponse.hasErrors()
          determine whether response has errors
 boolean ControllerResponse.hasErrors(String label)
          determine whether response has errors of the particular label
 void ControllerResponse.restoreForm()
          Restore the controller form
 void ControllerResponse.saveErrors(ErrorCollection errorCollection)
          This method saves an ErrorCollection object to the request attributes collection.
 String ControllerResponse.toXML()
          Convert the controller response to an xml document fragment.
protected  DefaultForm ControllerResponse.getDefaultForm()
          Retrieve the DefaultForm object
 Map ControllerResponse.getNestedMap()
          Useful for JSTL iteration of all items in response.
 boolean DBController.stateAllowed(String newState, ControllerRequest myRequest)
          For database controllers, we check if the new state is allowed against the database objects for that purpose
 void Transition.enableReturnToSender(ControllerResponse response)
          Call this method when the state/controller being transitioned to should return control back to the calling state once it has 'completed' successfully.
protected  ControllerResponse Transition.newStateDispatch(ControllerRequest request)
          This method invokes a new controller by dispatching to it rather than calling it directly.
static Transition Transition.fromXML(String newTransition)
          Return a Transition based upon the String based xml fragment
static ControllerElement Transition.fromXML(org.w3c.dom.Node n)
          Return a controller element based upon the xml fragment
 String Transition.getTheUrl(boolean resolveControllerReference)
          Internal use for retrieving the URL that this transition points to.
 String Transition.getUrl()
          Returns a URL reference for this transition.
 String Transition.getFullUrl()
          Similar to getURL but also includes the context path.
 String Transition.getMapping()
          This function returns the mapping of the Struts action (including the .do part) but without a context prepended to the mapping.
 ControllerResponse Transition.transition(ControllerRequest req, ControllerResponse res)
          Run this transition - e.g. transition to the new state of the specified controller object immediately, setting the specified response to the response of this new controller/state, discarding any previous response
 void Transition.redirectTransition(ControllerRequest request, ControllerResponse response)
          Transition to a new controller and state by issuing a Redirect request to the browser.
 ControllerResponse Transition.transition(ControllerRequest req, ControllerResponse res, boolean clear)
          Run this transition - e.g. transition to the new state of the specified controller object immediately, setting the specified response to the response of this new controller/state, discarding any previous response (if "clear" is specified)

NB: all parameters in the original request are discarded, except those that are explicit params added to this Transition.

 void State.setController(Controller newController)
          Set the 'parent' controller
protected  void State.setResponse(ControllerResponse res)
          Set the ControllerResponse object associated with this state
 Controller State.getController()
          retrieve the controller instance that is associated with this state
protected  DBController State.getDBController()
          Deprecated. 4/04 v5.5 use getController and cast.
 void State.run(ControllerRequest newRequest, ControllerResponse newResponse)
          A state may implement a "run" method to actually perform it's logic by overriding this method.
 void State.perform(StateForm stateForm, ControllerRequest newRequest, ControllerResponse newResponse)
          A state may implement a "perform" method to actually perform it's logic by overriding this method.
protected  void State.add(ControllerElement t)
          Convenience method to allow us to add any ControllerElement to this controllers inputs, outputs or transitions
 void State.addTransition(Transition newTransition)
          Adds a transition to the controller response associated with a state.
protected  void State.addBlock(Block newBlock)
          Adds a block to the controller response associated with this state.
protected  void State.addAutoInput(String fieldName, String friendlyName, String defaultValue, int displayLength, int maxLength, Vector validValues)
          addAutoInput is a convenience method that creates a new Input object based on the specified field parameters and adds the input object to this controller object.
protected  void State.addInput(Input newInput)
          Adds an input object to the controller response
protected  void State.addOutput(Output newOutput)
          Adds an output object to the controller response
protected  void State.addAutoInput(String fieldName, String dbClassName, String defaultValue)
          addAutoInput is a convenience method that creates a new Input object based on the specified field parameters and adds the input object to this controller object.
protected  void State.addAutoInput(String fieldName, String friendlyName, String dbClassName, String defaultValue)
          addAutoInput is a convenience method that creates a new Input object based on the specified field parameters and adds the input object to this controller object.
protected  void State.autoValidate(String checkClassName, ErrorCollection errorCollection)
          AutoValidate is a quick way to validate the fields of a specified dbobj.
protected  void State.autoValidate(String checkClassName, ErrorCollection errorCollection, Vector requiredFields)
          AutoValidate is a quick way to validate the fields of a specified dbobj.
 Object State.getObjectParameter(String paramName)
          ?
 String State.getParameter(String paramCode)
          Fetch the value for the given parameter.
protected  void State.saveErrors(ErrorCollection e)
          Deprecated. 3/4/04 [v5.5] Use response.saveErrors instead.
protected  void State.setFormCache()
          To the form cache in the controller response
protected  void State.clearFormCache()
          Clears the form cache in the controller response
protected  String State.getFormCache(String fieldName)
          Retrieve the form cash value
protected  boolean State.isParameter(String paramName)
           
protected  void State.transition(String newState, ControllerRequest req, ControllerResponse res)
           
 PersistentSession State.getSession()
           
protected  int State.getUid()
          Retrieve the State user ID.
 void State.checkParamMasks()
          If any parameters for this state have an associated regular expression "mask", verify that the value for the parameter matches the mask.
 ErrorCollection State.getErrors()
          Returns the errors collection of this current request and current state.
 void State.addError(String newError)
          Adds an error to this controllerResponse's Error Collection
protected  void State.checkMask(String paramName, String paramValue, org.apache.oro.text.regex.Pattern compiledRegExp)
          Checks a parameter given to the controller against a defined regular expression mask.
protected  String State.getString(String key, Object[] args)
          Convenience method - simply passes the request for a string on to the ControllerResponse object associated with this State
protected  String State.getString(String key)
          Convenience method - simply passes the request for a string on to the ControllerResponse object associated with this State
 Controller ControllerFactory.getController(String className)
          Dumb construction method.... just tries to create the controller.
 Controller ControllerFactory.getController(String module, String className)
          Dumb construction method.... just tries to create the controller.
 Controller ControllerFactory.getController(ControllerRequest request)
          This method is similar to getController(className) except that it may try to route the construction call to the appropriate servlet constructor IF the request is a HttpServletControllerRequest AND the implementation chooses to accept this mission.
 void TilesController.execute(org.apache.struts.tiles.ComponentContext context, ControllerRequest request, ControllerResponse response, ServletContext servletContext)
          This method will be called by the perform() method.
 boolean SecureIfSetController.stateAllowed(String newState, ControllerRequest params)
          Similar to DBController's EXCEPT that if there is no installed Database connections then the state is allowed.
 boolean Output.hasNested(String nestedName)
          Does this output have a nested item with the given name?
static ControllerElement Output.fromXML(org.w3c.dom.Node n)
          Return a controller element based upon the xml fragment
static ControllerElement Input.fromXML(org.w3c.dom.Node n)
          Return a controller element based upon the xml fragment [Factory Method]
 void Input.setDefaultValue(ControllerResponse response)
          Convenience method to quickly set the default value from the form cache.
 Controller ExpressoActionServlet.getController(String className)
          Struts compatible version of the controller factory.
 Controller ExpressoActionServlet.getController(String moduleName, String className)
          Struts compatible version of the controller factory.
 Controller ExpressoActionServlet.getController(ControllerRequest request)
          This method is similar to getController(className) except that it may try to route the construction call to the appropriate controlling servlet
static ControllerElement ControllerElement.fromXML(org.w3c.dom.Node n)
          Base Class 'deserialization' from XML given a DOM Node N.
protected static ControllerElement ControllerElement.fromXML(org.w3c.dom.Node n, ControllerElement ce)
          Return a controller element based upon the xml fragment
 void ControllerElement.remove()
          Remove this item from the "nested" items of it's parent.
 void ControllerElement.removeNested(ControllerElement elementToRemove)
          Remove an element from the nested elements for this item
 ControllerElement ControllerElement.getNested(String nestedName)
          Return a specific Element nested within this Element
 void DefaultForm.saveForm(ControllerRequest req)
           
 void DefaultForm.restoreForm(ControllerRequest req)
           
 void DefaultForm.setField(String fieldName, String fieldValue)
           
 void DefaultForm.setUsingHashtableParameters(Hashtable parameters)
           
 Object DefaultForm.getAttribute(String fieldName)
          Returns the attribute that has been set for a particular field OR null if it doesn't exist.
 String DefaultForm.getField(String fieldName)
           
 org.apache.struts.action.ActionMapping ServletControllerResponse.getMapping()
          Gets the ActionMapping associated with the controller .
 org.apache.struts.action.ActionForward ServletControllerResponse.findForward(String forwardName)
          Searches for the action forward associated with the action mapping (controller).
 org.apache.struts.action.ActionForward ServletControllerResponse.findForwardStore(String forwardName)
          Searches for the action forward associated with the action mapping (controller), with the side-effect of storing the action forward in the controller response.
 

Uses of ControllerException in com.jcorporate.expresso.core.dbobj
 

Methods in com.jcorporate.expresso.core.dbobj that throw ControllerException
 Controller Schema.getLoginController()
          Retrieve the login controller for your schema.
 Controller Schema.getRegistrationController()
          Retrieve the registration controller.
 

Uses of ControllerException in com.jcorporate.expresso.core.misc
 

Methods in com.jcorporate.expresso.core.misc that throw ControllerException
 void RecordPaginator.setPageNumber(ControllerRequest request)
          Sets the page number based upon the controller request object.
 

Uses of ControllerException in com.jcorporate.expresso.core.misc.upload
 

Methods in com.jcorporate.expresso.core.misc.upload that throw ControllerException
 void Uploader.parseRequest(HttpServletRequest req, ParameterParser params, String path)
          Processes an RFC 1867 compliant multipart/form-data stream.
 

Uses of ControllerException in com.jcorporate.expresso.core.servlet.viewhandler
 

Methods in com.jcorporate.expresso.core.servlet.viewhandler that throw ControllerException
 void XMLViewHandler.handleView(ControllerResponse con, HttpServletRequest req, HttpServletResponse res)
          Handle the Controller by producing XML output, transforming via a specified XSL stylesheet Creation date: (8/3/00 5:22:58 PM)
 void DefaultViewHandler.handleView(ControllerResponse con, HttpServletRequest req, HttpServletResponse res)
          Display the response from a controller with a "default" view generated in HTML
protected  void DefaultViewHandler.printDisplay(ControllerResponse con, HttpServletRequest request, HttpServletResponse response, Page p)
          Separate to allow overriding for different types of rendering.
abstract  void ViewHandler.handleView(ControllerResponse con, HttpServletRequest req, HttpServletResponse res)
          The ViewHandler implementation must implement only this method
protected  void ExcelViewHandler.printDisplay(ControllerResponse con, HttpServletRequest request, HttpServletResponse response, Page p)
          Separate to allow overriding for different types of rendering.
 void JSPViewHandler.handleView(ControllerResponse con, HttpServletRequest req, HttpServletResponse res)
          Process a Controller with an explicitly specified "view"
 

Uses of ControllerException in com.jcorporate.expresso.core.utility
 

Methods in com.jcorporate.expresso.core.utility that throw ControllerException
static void ControllerRun.doController(String conName, Hashtable commandArgs)
          Perform the named Controller
 

Uses of ControllerException in com.jcorporate.expresso.ext.controller
 

Methods in com.jcorporate.expresso.ext.controller that throw ControllerException
 ControllerResponse RunTests.newState(String newState, ControllerRequest params)
          Transition to a new state
protected  ControllerResponse ServeTextFile.runServeTextFileState(ControllerRequest request, ControllerResponse response)
          Serves up a basic text file as specified by the parameter.
protected  ControllerResponse ServeTextFile.runServeJavaFileState(ControllerRequest request, ControllerResponse response)
          Serves up a java source file as specified by the parameter.
protected  ControllerResponse ComponentManager.runListState(ControllerRequest request, ControllerResponse response)
          Lists the currently installed Schemas
protected  ControllerResponse ComponentManager.runPromptAddState(ControllerRequest request, ControllerResponse response)
           
protected  ControllerResponse ComponentManager.runProcessAddState(ControllerRequest request, ControllerResponse response)
           
protected  ControllerResponse ComponentManager.runComponentDetailsState(ControllerRequest request, ControllerResponse response)
          Lists the details of a particular schema component.
protected  ControllerResponse ComponentManager.runPromptDeleteState(ControllerRequest request, ControllerResponse response)
           
protected  void ComponentManager.runVerifyInstallState(ControllerRequest request, ControllerResponse response)
           
protected  ArrayList ComponentManager.parseMarkedClassNames(ControllerRequest request, ControllerResponse response)
           
protected  ControllerResponse ComponentManager.runProcessDeleteState(ControllerRequest request, ControllerResponse response)
           
 void RunSQL.runPromptState(ControllerRequest request, ControllerResponse response)
          Present a form requesting the SQL to be executed
 void RunSQL.runGetDefinitionState(ControllerRequest request, ControllerResponse response)
          Prints the definition of a given table.
 void RunSQL.runRunState(ControllerRequest req, ControllerResponse res)
          Receive the SQL request from the client & send it to the database for execution.
protected  DownloadFiles Download.getThisDownloadFile(ControllerRequest request, User u)
          Convenience method to retrieve the download file based upon the file parameter
protected  ControllerResponse Download.runBeginState(ControllerRequest request, ControllerResponse response)
          Starts a download for a file.
protected  ControllerResponse Download.runListState(ControllerRequest request, ControllerResponse response)
          Lists the files available for download.
protected  ControllerResponse Download.runDownloadState(ControllerRequest controllerRequest, ControllerResponse controllerResponse)
          Returns the file actually requested by the user.
protected  void Download.logInvalidFileRequest(ControllerRequest request, User myUser)
          Sets off the system event for an invalid file number requested.
protected  String Download.getFriendlyName(DownloadFiles oneDownloadFile)
          Returns the friendly download name
protected  String Download.getDownloadTime(ControllerResponse response, long fileLength)
          Returns a string estimating download time at 28.8k This function assumes a download rate of 5 Mb / minute
protected  void Download.checkIsAllowed(ControllerRequest request, User u, DownloadFiles file)
          Checks file permissions and throws an Exception, and logs an event if the user does not have permission to run.
protected  void Download.runViewNotesState(ControllerRequest request, ControllerResponse response)
          View the notes associated with the download.
 ControllerResponse HealthCheck.newState(String newState, ControllerRequest params)
          Transition to a new state
protected  void DataTransfer.runSelSchemaState(ControllerRequest req, ControllerResponse res)
           
protected  void DataTransfer.runPromptState(ControllerRequest req, ControllerResponse res)
           
protected  void DataTransfer.runTransferState(ControllerRequest req, ControllerResponse res)
           
protected  ExpressoReport ReportServer.instantiateReport(ControllerRequest request)
          Instantiate an Expresso report based upon the 'ReportClass' parameter given in the ControllerRequest object
protected  void ReportServer.runProcessReportState(ControllerRequest request, ControllerResponse response)
          Process the actual report.
protected  void ReportServer.runPromptState(ControllerRequest request, ControllerResponse response)
          Runs the Prompt state
protected  void ReportServer.runSelectReportState(ControllerRequest request, ControllerResponse response)
          Runs the Prompt state
protected  void ReportServer.runSetParametersState(ControllerRequest request, ControllerResponse response)
          Selects the report output format, if it is a MultiFormatted Report, and if not, provide a few parameters.
 ControllerResponse TestController.newState(String newState, ControllerRequest params)
          Standard method to select the appropriate next state as the controller moves from state to state.
protected  void TestController.runTransition2FormTestState(ControllerRequest request, ControllerResponse response)
          test a transition to a controller/state which requires a form
protected  void TestController.runTransitionTestState(ControllerRequest request, ControllerResponse response)
          test a transition to a controller/state note that the ControllerSecurityMatrix output uses the default layout, so the title at the top of that page will show this test controller.
protected  void TestController.runPromptTestState(ControllerRequest request, ControllerResponse response)
          test a transition to a controller/state which requires a form
protected  void TestController.runTransitionFromFormTestState(ControllerRequest request, ControllerResponse response)
          test a transition from a controller/state which uses a form to one that does not use a form
 

Constructors in com.jcorporate.expresso.ext.controller that throw ControllerException
ReportServer()
          Creates an instance of ReportServer.
 

Uses of ControllerException in com.jcorporate.expresso.ext.struts.taglib
 

Methods in com.jcorporate.expresso.ext.struts.taglib that throw ControllerException
static ControllerElement ControllerUtils.interpretLeadElement(PageContext pageContext, String beanExpr)
          Inteprets the lead argument for InputTag expression where the bean expression is a scope for the type of controller that should be retrieved from the ControllerResponse.
 

Uses of ControllerException in com.jcorporate.expresso.ext.xml.controller
 

Methods in com.jcorporate.expresso.ext.xml.controller that throw ControllerException
 ControllerResponse XMLController.newState(String newState, ControllerRequest req)
          Old-Style State switching method.
 

Uses of ControllerException in com.jcorporate.expresso.services.controller.configuration
 

Methods in com.jcorporate.expresso.services.controller.configuration that throw ControllerException
 void ShowComponent.run(ControllerRequest request, ControllerResponse response)
           
 void ShowComponent.displayNoRuntime(ControllerRequest requset, ControllerResponse response)
           
protected  RootContainerInterface ConfigurationBase.getRuntime(ControllerRequest request)
          Retreives the current runtime that we're working on.
 void ShowContainerTree.run(ControllerRequest request, ControllerResponse response)
           
protected  void ShowContainerTree.addShowTransition(ExpressoComponent component, Block parent)
          Adds the transition to each block given each component to show any particular component
protected  void ShowContainerTree.addOneContainer(Block parentBlock, Containable current)
          Add a container and links to the block tree
protected  void CreateSettingsWizard.runStartState(ControllerRequest request, ControllerResponse response)
          Initialize Wizard and prepare runtime state.
protected  void CreateSettingsWizard.runRuntimeNameState(ControllerRequest request, ControllerResponse response)
          Prompt for a runtime name
protected  void CreateSettingsWizard.runProcessRuntimeNameState(ControllerRequest request, ControllerResponse response)
          Process and validates the input of the runtime state.
protected  void CreateSettingsWizard.runPromptDBSettingsState(ControllerRequest request, ControllerResponse response)
           
protected  void CreateSettingsWizard.runProcessDBSettingsState(ControllerRequest request, ControllerResponse response)
          Processes and validates the DB Settings.
protected  void CreateSettingsWizard.runPromptJNDISettingsState(ControllerRequest request, ControllerResponse response)
           
protected  void CreateSettingsWizard.runProcessJNDISettingsState(ControllerRequest request, ControllerResponse response)
           
protected  void CreateSettingsWizard.runReadDatabaseNotesState(ControllerRequest request, ControllerResponse response)
           
protected  void CreateSettingsWizard.runPromptTestSettingsState(ControllerRequest request, ControllerResponse response)
           
protected  void CreateSettingsWizard.runTestSettingsState(ControllerRequest request, ControllerResponse response)
           
protected  void CreateSettingsWizard.runPromptInstallExpressoState(ControllerRequest request, ControllerResponse response)
           
protected  void CreateSettingsWizard.runInstallExpressoState(ControllerRequest request, ControllerResponse response)
           
protected  void CreateSettingsWizard.runPromptFinishedState(ControllerRequest request, ControllerResponse response)
           
protected  void CreateSettingsWizard.runSaveFileLocalState(ControllerRequest request, ControllerResponse response)
           
protected  void CreateSettingsWizard.runViewFileState(ControllerRequest request, ControllerResponse response)
           
protected  void CreateSettingsWizard.runCompleteState(ControllerRequest request, ControllerResponse response)
           
 

Uses of ControllerException in com.jcorporate.expresso.services.controller.dbmaint
 

Methods in com.jcorporate.expresso.services.controller.dbmaint that throw ControllerException
protected  void Update.autoField(String oneFieldName)
          Create an input for one field specified by the field name.
 void Update.run(ControllerRequest req, ControllerResponse res)
          Perform the actions of this state.
 void ViewBlob.run(ControllerRequest newRequest, ControllerResponse newResponse)
          Download the BLOB field.
protected  void ViewBlob.sendBlobField(ControllerRequest newRequest, ControllerResponse newResponse, JDBCDataObject dbobj, String fieldName)
          Sends a BLOB field to the client browser.
protected  void ViewBlob.sendMediaObjectField(ControllerRequest newRequest, ControllerResponse newResponse, MediaDBObject dbobj, String fieldName)
          Sends a Media DBObject's BLOB fields to the client.
protected  void UpdateBase.showKey(boolean withEditLink)
          Display a table showing the key fields of this object and their values.
protected  void Add.autoField(String oneFieldName)
          Automatically handle a single field on the form.
 void Add.run(ControllerRequest req, ControllerResponse res)
          Actually perform the setup and display of the form
 void AddUpdate.run(ControllerRequest req, ControllerResponse res)
          Performs the real work for this class.
 void List.run(ControllerRequest req, ControllerResponse res)
          Perform the actions of this state.
 void UpdateDelete.run(ControllerRequest req, ControllerResponse res)
          Perform the actions of this state.
 void SearchList.run(ControllerRequest req, ControllerResponse res)
          Perform the actions of this state.
 void UpdateUpdate.run(ControllerRequest req, ControllerResponse res)
          Perform the actions of this state.
protected abstract  void GetBase.autoField(String oneFieldName)
          implemented by subclass
protected  void GetBase.showForm()
          Show the HTML form to the user - this form may be for add/update or search and may or may not be populated with data when presented to the user.
protected  String DynamicCmd.getSearchParam()
          Return the "decoded" search parameter, consisting of a series of fields and values pipe-delimited
protected  String DynamicCmd.getFieldsParam()
          Return the "decoded" 'fields' parameter, consisting of a series of pipe-delimited fields and values
protected  Map DynamicCmd.getFixedFields()
          Fixed fields are a hastable of field values keyed to field names that should not be modified.
 void DynamicCmd.run(ControllerRequest newParams, ControllerResponse newResponse)
          All of the sub-classes of DynamicCmd extend the run method to perform their functionality.
protected  boolean DynamicCmd.isKeyField(String fieldName)
          Base class Is this field a key in the given database object?
protected  void DynamicCmd.showOptions()
          Display a small table of icons giving the user the option to proceed directly to a search, add, or list function from this form.
protected  void DynamicCmd.showUserName(String theDescrip)
           
protected  void DynamicCmd.initializeDBObj()
          Given a class name that contains a DBObject, instantiate an instance of the object & return it.
protected  DBObject DynamicCmd.getCurrentDBObj()
          Deprecated. Since Expresso 5.1 Use getDataObject() for compatibility with AutoDBObject, JoinedDataObject, etc. Will be removed in Expresso 5.2
protected  DataObject DynamicCmd.getDataObject()
          Retrieve the data object
 int DynamicCmd.getPageNumber()
          Returns the current page number as specified in the 'page' parameter
protected  void DynamicCmd.addParams(Transition t)
          Add the fields, details, search and dbobj parameters to a given transition object
protected  void DynamicCmd.showEditLink(String fieldName, String oneFieldValue, DataObject currentRecord, Output myElement)
          Show the edit link as often used by the List state or updateupdate state.
protected  void DynamicCmd.showBlobViewLink(String fieldName, DataObject dbobj, Input myElement, String controller)
          Create a link that is nested to myElement that is for displaying a BLOB field.
protected  void DynamicCmd.showEditLink(String fieldName, String oneFieldValue, DataObject currentRecord, Output myElement, String controller)
          Write a hyperlink command that allows edit of the current key
protected  String DynamicCmd.getKeyParameter(DataObject srcDBObj)
          Create a key parameter for locating the DBObject.
protected  DataObject DynamicCmd.retrieveMyDBObject()
          Retrieves the DBObject as specified in the criteria key fields passed to the DBMaint controller.
protected  String DynamicCmd.getControllerName()
          Retrieve the name of the controller we use.
protected  RecordPaginator ListBase.getRecordPaginator()
          Gets the currently used paginator
protected  long ListBase.listRecords(String sortKey, Block myTable)
          Lists the records for display
protected  String ListBase.getSortKey()
          This method determines how the list is sorted.
protected  void ListBase.setupListSearchCriteria()
          This method sets the search conditions on the current DBObject.
protected  Block ListBase.generatePageTransitions(ControllerRequest request, RecordPaginator rp, int pageLimit)
          Generates an arrayList of transitions to allow direct jumping to a page.
protected  void ListBase.addRecordsToBlock(ArrayList i_AllRecords, Block myTable)
          Given an interator containing database objects add all of those objects to the given output block as rows.
protected  void ListBase.showList()
          Base class Show a list of database records to the user, allowing the key to be clicked on to request an edit of the object
protected  void Search.autoField(String oneFieldName)
           
 void Search.run(ControllerRequest req, ControllerResponse res)
          Perform the actions of this state.
 

Uses of ControllerException in com.jcorporate.expresso.services.controller.ui
 

Methods in com.jcorporate.expresso.services.controller.ui that throw ControllerException
 Input AutoControllerElement.renderDBObjectField(ControllerResponse response, DataObject dbobj, String fieldName, String defaultValue, boolean readOnly)
          Renders an Input in a update method per field name.
 Block AutoControllerElement.createDBObjectBlock(ControllerRequest request, ControllerResponse response, DataObject dbobj)
          Creates a DBObject Block that contains all the non-secret fields for the DBObject.
 Block AutoControllerElement.createDBObjectBlock(ControllerRequest request, ControllerResponse response, String title, DataObject dbobj)
          Creates a DBObject Block that contains all the non-secret fields for the DBObject.
 DataObject AutoControllerElement.parseBlock(ControllerRequest request, DataObject oneObject, ErrorCollection ec)
          Convienence method if you only expect one DBObject to be returned from a particular form.
 DataObject AutoControllerElement.parseDBObject(ControllerRequest request, DataObject oneObject, ErrorCollection ec)
          Convienence method if you only expect one DBObject to be returned from a particular form, and unlike the ParseBlock, there is no DBOBject name prefix attached to the parameter names.
 DataObject AutoControllerElement.parseDBObject(ControllerRequest request, DataObject oneObject, ErrorCollection ec, boolean validate)
           
 DataObject[] AutoControllerElement.parseBlocks(ControllerRequest request, DataObject[] theObjects, ErrorCollection ec)
          Parses the appropriate DBObject from the block.
 String AutoControllerElement.parseSingleInput(ControllerRequest request, DataObject dbobj, String fieldName, String parameterName, ErrorCollection ec)
          Takes the Controller Request and appropriately parses a string for a particular field.
 String AutoControllerElement.getNormalStyle()
          Allows for easy overriding of the style name for special customization
 String AutoControllerElement.getRequiredStyle()
          Allows for easy overriding fo the style name for special customization.
 String AutoControllerElement.getErrorStyle()
          Allows for easy overriding fo the style name for special customization.
static AutoControllerElement DefaultAutoElement.getAutoControllerElement()
          Constructor.
 Block DefaultAutoElement.createDBObjectBlock(ControllerRequest request, ControllerResponse response, DataObject dbobj)
          Creates a DBObject Block that contains all the non-secret fields for the DBObject.
 Block DefaultAutoElement.createDBObjectBlock(ControllerRequest request, ControllerResponse response, String title, DataObject dbobj)
          Creates a DBObject Block that contains all the non-secret fields for the DBObject.
protected  void DefaultAutoElement.retrieveCachedValueInForm(ControllerResponse response, String oneFieldName, Input i)
          Used to set values in created db objects to the values found (if any) in the form cache.
 DataObject DefaultAutoElement.parseBlock(ControllerRequest request, DataObject oneObject, ErrorCollection ec)
          Convienence method if you only expect one DBObject to be returned from a particular form.
 DataObject[] DefaultAutoElement.parseBlocks(ControllerRequest request, DataObject[] theObjects, ErrorCollection ec)
          Parses the appropriate DBObject from the block.
 DataObject DefaultAutoElement.parseDBObject(ControllerRequest request, DataObject oneObject, ErrorCollection ec, boolean validate)
          Parses a dbobject
 DataObject DefaultAutoElement.parseDBObject(ControllerRequest request, DataObject oneObject, ErrorCollection ec)
          Convienence method if you only expect one DBObject to be returned from a particular form, and unlike the ParseBlock, there is no DBOBject name prefix attached to the parameter names.
 String DefaultAutoElement.parseSingleInput(ControllerRequest request, DataObject dbobj, String fieldName, String parameterName, ErrorCollection ec)
          Takes the Controller Request and appropriately parses a string for a particular field.
 Input DefaultAutoElement.renderDBObjectField(ControllerResponse response, DataObject dbobj, String fieldName, String cachedValue, boolean readOnly)
          Renders a DBOBject Field as either an Input or an Output.
protected  String DefaultAutoElement.displayValue(DataFieldMetaData metaData, String fieldValue, String fieldName, Locale l)
          Format a value for display in the HTML being returned to the client
protected  Input DefaultAutoElement.renderReadOnlyInput(ControllerResponse response, Input oneField, DataObject dbobj, String fieldName, String oneFieldValue)
          Modifies an already instantiated Input to be a finished read only control.
protected  void DefaultAutoElement.renderReadWriteBlob(ControllerResponse response, Input oneField, DataObject dbobj, String fieldName, String oneFieldValue, String oneFieldSize)
          Modifies an already instantiated Input to be a finished Input control specifically for a blob field.
protected  Input DefaultAutoElement.renderReadWriteInput(ControllerResponse response, Input oneField, DataObject dbobj, String fieldName, String oneFieldValue, String oneFieldSize)
          Modifies an already instantiated Input to be a finished Input control
protected  void CacheAutoElement.retrieveCachedValueInForm(ControllerResponse response, String oneFieldName, Input i)
          Used to set values in created db objects to the values found (if any) in the form cache.
 

Uses of ControllerException in com.jcorporate.expresso.services.validation
 

Methods in com.jcorporate.expresso.services.validation that throw ControllerException
 ControllerResponse LoginEmailValidator.validated(Hashtable params, ControllerRequest request, ControllerResponse response, Controller ctlr)
          This method is used to transition back to the "emailValidate" state of the registration controller which then completes the user's registration and sends out the email notification of succesful registration.
 ControllerResponse ChangePasswordValidator.validated(Hashtable params, ControllerRequest request, ControllerResponse response, Controller ctlr)
          This method is used to regenerate an users password after the validation is successful.
 ControllerResponse ValidationHandler.validated(Hashtable params, ControllerRequest request, ControllerResponse response, Controller ctlr)
          This method is used to complete the application-specific action after the validation is successful.
 ControllerResponse ApproveRegistrationValidator.validated(Hashtable params, ControllerRequest request, ControllerResponse response, Controller ctlr)
          This method is used after the approver is validated.
 


Expresso 5-6

Please see www.jcorporate.com for information about new Expresso releases.