Previous Up Next
<properties> <properties> <listeners>

<property>

Sets an application instance configuration setting.

Alan Richmond
Copyright 2003, 2004 Ben Edwards, Inc.
property name="text string" value="text string"
Attribute Req/Opt Default Description
name Required Enumerated:
  • defaultEvent
  • exceptionEvent
  • applicationRoot
  • eventParameter
  • parameterPrecedence
  • maxEvents
  • A framework parameter name.
    value Required CDATA A framework parameter value.

    property

    <property> sets a framework configuration value.

    Six properties need to be defined in each configuration file for for the framework to operate properly. These properties are each defined as a <property> tag under the <properties> of the config file.

    The required properties to be defined:

    defaultEvent
  • The event for the framework to handle if one is not specified in a new request.

  • exceptionEvent
  • The event for the framework to handle if there is an unhandled exception in the application.

  • applicationRoot
  • The path to the application's directory relative to the web server's document root.

  • eventParameter
  • The name of the request parameter that will define the event for the framework to handle.

  • parameterPrecedence
  • form|url (or _POST|_GET), which to favor for conflicting request parameters.

  • maxEvents
  • The maximum number of events for the framework to process on a single request.

  • Parent

  • properties
  • Example

    Example code from a mach-ii.xml file:

    <mach-ii version="1.0">
        <!-- PROPERTIES -->
        <properties>
            <property name="defaultEvent" value="showHome"/>
            <property name="exceptionEvent" value="exception"/>
            <property name="applicationRoot" value="/ContactManager"/>
            <property name="eventParameter" value="event"/>
            <property name="parameterPrecedence" value="form"/>
            <property name="maxEvents" value="10"/>
        </properties>
        ...
    </mach-ii>
       
    Previous Up Next
    <properties> <properties> <listeners>

    Documentation generated on Thu, 20 Jan 2005 10:47:24 -0800 by phpDocumentor 1.3.0RC3