coldbox.system

Class RestHandler

lucee.Component
    extended by coldbox.system.FrameworkSupertype
      extended by coldbox.system.EventHandler
        extended by coldbox.system.RestHandler

Copyright 2005-2007 ColdBox Framework by Luis Majano and Ortus Solutions, Corp www.ortussolutions.com This specialized handler is to be used for Restful applications. It wraps around functions to provide consistency and an opinionated approach to RESTing!

Class Attributes:
  • synchronized : false
    •  
  • accessors : false
    •  
  • persistent : false
    •  
    Method Summary
    any aroundHandler([any event], [any rc], [any prc], [any targetAction], [any eventArguments])
         Our Rest handler adds a nice around handler that will be active for all handlers.
    any onAuthenticationFailure([any event='[runtime expression]'], [any rc='[runtime expression]'], [any prc='[runtime expression]'], [any abort='false'])
         Action that can be used for authentication failures.
    any onAuthorizationFailure([any event='[runtime expression]'], [any rc='[runtime expression]'], [any prc='[runtime expression]'], [any abort='false'])
         Action that can be used for authorization failures.
    any onEntityNotFoundException([any event], [any rc], [any prc], [any eventArguments], [any exception])
         Action that can be used when an entity or record is not found.
    any onError([any event], [any rc], [any prc], [any faultAction=''], [any exception], [any eventArguments='[runtime expression]'])
         Implicit action that detects exceptions on your handlers and processes them.
    any onExpectationFailed([any event='[runtime expression]'], [any rc='[runtime expression]'], [any prc='[runtime expression]'], [any message='An expectation for the request failed. Could not proceed'])
         Utility method for when an expectation of the request fails ( e.
    any onInvalidHTTPMethod([any event], [any rc], [any prc], [any faultAction], [any eventArguments])
         Action used when the framework detects and Invalid HTTP method for the action.
    any onInvalidRoute([any event], [any rc], [any prc])
         Action for when a route is invalid or not found.
    any onMissingAction([any event], [any rc], [any prc], [any missingAction], [any eventArguments])
         Action used when the original action does not exist in a handler.
    any onValidationException([any event], [any rc], [any prc], [any eventArguments], [any exception])
         Action that can be used when validation exceptions ocur.
     
    Methods inherited from class coldbox.system.EventHandler
    _actionExists, _actionMetadata, _privateInvoker, getCachebox, getFlash, getLog, getLogBox, getWirebox, init, setCachebox, setFlash, setLog, setLogBox, setWirebox
     
    Methods inherited from class coldbox.system.FrameworkSupertype
    addAsset, announce, announceInterception, async, getCache, getColdBoxSetting, getController, getEnv, getInstance, getInterceptor, getModel, getModuleConfig, getModuleSettings, getRenderer, getRequestCollection, getRequestContext, getSetting, getSystemProperty, getSystemSetting, includeUDF, listen, loadApplicationHelpers, locateDirectoryPath, locateFilePath, persistVariables, populateModel, relocate, renderExternalView, renderLayout, renderView, runEvent, runRoute, setController, setSetting, settingExists, when
     
    Methods inherited from class lucee.Component
    None
    Method Detail

    aroundHandler

    public any aroundHandler([any event], [any rc], [any prc], [any targetAction], [any eventArguments])

    Our Rest handler adds a nice around handler that will be active for all handlers that leverage it. So it can add uniformity, exception handling, tracking and more.

    Parameters:
    event - The request context
    rc - The rc reference
    prc - The prc reference
    targetAction - The action UDF to execute
    eventArguments - The original event arguments

    onAuthenticationFailure

    public any onAuthenticationFailure([any event='[runtime expression]'], [any rc='[runtime expression]'], [any prc='[runtime expression]'], [any abort='false'])

    Action that can be used for authentication failures. You can point to this action from cbsecurity, cbauth, etc or call it a-la-carte. It also monitors cbsecurity convention of validator results for setting error messages into the data packet

    Parameters:
    event - The request context
    rc - The rc reference
    prc - The prc reference
    abort
    Returns:
    403

    onAuthorizationFailure

    public any onAuthorizationFailure([any event='[runtime expression]'], [any rc='[runtime expression]'], [any prc='[runtime expression]'], [any abort='false'])

    Action that can be used for authorization failures. You can point to this action from cbsecurity, cbauth, etc or call it a-la-carte. It will check for cbsecurity validation results and set the appropriate error messages

    Parameters:
    event - The request context
    rc - The rc reference
    prc - The prc reference
    abort - Hard abort the request if passed, defaults to false

    onEntityNotFoundException

    public any onEntityNotFoundException([any event], [any rc], [any prc], [any eventArguments], [any exception])

    Action that can be used when an entity or record is not found. Can be called manually or automatically via thrown exceptions in the around handler

    Parameters:
    event - The request context
    rc - The rc reference
    prc - The prc reference
    eventArguments - The original event arguments
    exception - The thrown exception

    onError

    public any onError([any event], [any rc], [any prc], [any faultAction=''], [any exception], [any eventArguments='[runtime expression]'])

    Implicit action that detects exceptions on your handlers and processes them

    Parameters:
    event - The request context
    rc - The rc reference
    prc - The prc reference
    faultAction - The action that blew up
    exception - The thrown exception
    eventArguments - The original event arguments

    onExpectationFailed

    public any onExpectationFailed([any event='[runtime expression]'], [any rc='[runtime expression]'], [any prc='[runtime expression]'], [any message='An expectation for the request failed. Could not proceed'])

    Utility method for when an expectation of the request fails ( e.g. an expected parameter is not provided ) - It will output a 417 status code (event.STATUS.EXPECTATION_FAILED) - Add the error flag - Add an failure message to the data packet which you can customize

    Parameters:
    event - The request context
    rc - The rc reference
    prc - The prc reference
    message - The failure message sent in the request packge

    onInvalidHTTPMethod

    public any onInvalidHTTPMethod([any event], [any rc], [any prc], [any faultAction], [any eventArguments])

    Action used when the framework detects and Invalid HTTP method for the action

    Parameters:
    event - The request context
    rc - The rc reference
    prc - The prc reference
    faultAction - The action that was secured
    eventArguments - The original event arguments

    onInvalidRoute

    public any onInvalidRoute([any event], [any rc], [any prc])

    Action for when a route is invalid or not found. Usually you use this in your router as a catch all. 

    // Catch All Resource
route( "/:anything" ).to( "MyHandler.onInvalidRoute" );

    Parameters:
    event - The request context
    rc - The rc reference
    prc - The prc reference

    onMissingAction

    public any onMissingAction([any event], [any rc], [any prc], [any missingAction], [any eventArguments])

    Action used when the original action does not exist in a handler.

    Parameters:
    event - The request context
    rc - The rc reference
    prc - The prc reference
    missingAction - The missing action
    eventArguments - The original event arguments

    onValidationException

    public any onValidationException([any event], [any rc], [any prc], [any eventArguments], [any exception])

    Action that can be used when validation exceptions ocur. Can be called manually or automatically via thrown exceptions in the around handler

    Parameters:
    event - The request context
    rc - The rc reference
    prc - The prc reference
    eventArguments - The original event arguments
    exception - The thrown exception