View Javadoc

    1   /*
    2    * $Id: Globals.java 471754 2006-11-06 14:55:09Z husted $
    3    *
    4    * Licensed to the Apache Software Foundation (ASF) under one
    5    * or more contributor license agreements.  See the NOTICE file
    6    * distributed with this work for additional information
    7    * regarding copyright ownership.  The ASF licenses this file
    8    * to you under the Apache License, Version 2.0 (the
    9    * "License"); you may not use this file except in compliance
    10   * with the License.  You may obtain a copy of the License at
    11   *
    12   *  http://www.apache.org/licenses/LICENSE-2.0
    13   *
    14   * Unless required by applicable law or agreed to in writing,
    15   * software distributed under the License is distributed on an
    16   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    17   * KIND, either express or implied.  See the License for the
    18   * specific language governing permissions and limitations
    19   * under the License.
    20   */
    21  package org.apache.struts;
    22
    23  import java.io.Serializable;
    24
    25  /**
    26   * Global manifest constants for the entire Struts Framework.
    27   *
    28   * @version $Rev: 471754 $ $Date: 2005-06-18 20:27:26 -0400 (Sat, 18 Jun 2005)
    29   *          $
    30   */
    31  public class Globals implements Serializable {
    32      // ----------------------------------------------------- Manifest Constants
    33
    34      /**
    35       * The context attributes key under which our <code>ActionServlet</code>
    36       * instance will be stored.
    37       *
    38       * @since Struts 1.1
    39       */
    40      public static final String ACTION_SERVLET_KEY =
    41          "org.apache.struts.action.ACTION_SERVLET";
    42
    43      /**
    44       * The request attributes key under which a boolean <code>true</code>
    45       * value should be stored if this request was cancelled.
    46       *
    47       * @since Struts 1.1
    48       */
    49      public static final String CANCEL_KEY = "org.apache.struts.action.CANCEL";
    50
    51      /**
    52       * <p>The base of the context attributes key under which our
    53       * <code>ModuleConfig</code> data structure will be stored.  This will be
    54       * suffixed with the actual module prefix (including the leading "/"
    55       * character) to form the actual attributes key.</p>
    56       *
    57       * <p>For each request processed by the controller servlet, the
    58       * <code>ModuleConfig</code> object for the module selected by the request
    59       * URI currently being processed will also be exposed under this key as a
    60       * request attribute.</p>
    61       *
    62       * @since Struts 1.1
    63       */
    64      public static final String MODULE_KEY = "org.apache.struts.action.MODULE";
    65
    66      /**
    67       * The ServletContext attribute under which we store the module prefixes
    68       * String[].
    69       *
    70       * @since Struts 1.2
    71       */
    72      public static final String MODULE_PREFIXES_KEY =
    73          "org.apache.struts.globals.MODULE_PREFIXES";
    74
    75      /**
    76       * The request attribute under which we store the original URI of the
    77       * request.
    78       *
    79       * @since Struts 1.3
    80       */
    81      public static final String ORIGINAL_URI_KEY =
    82          "org.apache.struts.globals.ORIGINAL_URI_KEY";
    83
    84      /**
    85       * The request attributes key under which your action should store an
    86       * <code>org.apache.struts.action.ActionErrors</code> object, if you are
    87       * using the corresponding custom tag library elements.
    88       */
    89      public static final String ERROR_KEY = "org.apache.struts.action.ERROR";
    90
    91      /**
    92       * The request attributes key under which Struts custom tags might store a
    93       * <code>Throwable</code> that caused them to report a JspException at
    94       * runtime.  This value can be used on an error page to provide more
    95       * detailed information about what really went wrong.
    96       */
    97      public static final String EXCEPTION_KEY =
    98          "org.apache.struts.action.EXCEPTION";
    99
    100     /**
    101      * The session attributes key under which the user's selected
    102      * <code>java.util.Locale</code> is stored, if any.  If no such attribute
    103      * is found, the system default locale will be used when retrieving
    104      * internationalized messages.  If used, this attribute is typically set
    105      * during user login processing.
    106      */
    107     public static final String LOCALE_KEY = "org.apache.struts.action.LOCALE";
    108
    109     /**
    110      * The request attributes key under which our <code>org.apache.struts.ActionMapping</code>
    111      * instance is passed.
    112      */
    113     public static final String MAPPING_KEY =
    114         "org.apache.struts.action.mapping.instance";
    115
    116     /**
    117      * The request attributes key under which your action should store an
    118      * <code>org.apache.struts.action.ActionMessages</code> object, if you are
    119      * using the corresponding custom tag library elements.
    120      *
    121      * @since Struts 1.1
    122      */
    123     public static final String MESSAGE_KEY =
    124         "org.apache.struts.action.ACTION_MESSAGE";
    125
    126     /**
    127      * <p>The base of the context attributes key under which our module
    128      * <code>MessageResources</code> will be stored.  This will be suffixed
    129      * with the actual module prefix (including the leading "/" character) to
    130      * form the actual resources key.</p>
    131      *
    132      * <p>For each request processed by the controller servlet, the
    133      * <code>MessageResources</code> object for the module selected by the
    134      * request URI currently being processed will also be exposed under this
    135      * key as a request attribute.</p>
    136      */
    137     public static final String MESSAGES_KEY =
    138         "org.apache.struts.action.MESSAGE";
    139
    140     /**
    141      * The request attributes key under which our multipart class is stored.
    142      */
    143     public static final String MULTIPART_KEY =
    144         "org.apache.struts.action.mapping.multipartclass";
    145
    146     /**
    147      * <p>The base of the context attributes key under which an array of
    148      * <code>PlugIn</code> instances will be stored.  This will be suffixed
    149      * with the actual module prefix (including the leading "/" character) to
    150      * form the actual attributes key.</p>
    151      *
    152      * @since Struts 1.1
    153      */
    154     public static final String PLUG_INS_KEY =
    155         "org.apache.struts.action.PLUG_INS";
    156
    157     /**
    158      * <p>The base of the context attributes key under which our
    159      * <code>RequestProcessor</code> instance will be stored.  This will be
    160      * suffixed with the actual module prefix (including the leading "/"
    161      * character) to form the actual attributes key.</p>
    162      *
    163      * @since Struts 1.1
    164      */
    165     public static final String REQUEST_PROCESSOR_KEY =
    166         "org.apache.struts.action.REQUEST_PROCESSOR";
    167
    168     /**
    169      * The context attributes key under which we store the mapping defined for
    170      * our controller serlet, which will be either a path-mapped pattern
    171      * (<code>/action/*</code>) or an extension mapped pattern
    172      * (<code>*.do</code>).
    173      */
    174     public static final String SERVLET_KEY =
    175         "org.apache.struts.action.SERVLET_MAPPING";
    176
    177     /**
    178      * The session attributes key under which our transaction token is stored,
    179      * if it is used.
    180      */
    181     public static final String TRANSACTION_TOKEN_KEY =
    182         "org.apache.struts.action.TOKEN";
    183
    184     /**
    185      * The page attributes key under which xhtml status is stored.  This may
    186      * be "true" or "false".  When set to true, the html tags output xhtml.
    187      *
    188      * @since Struts 1.1
    189      */
    190     public static final String XHTML_KEY = "org.apache.struts.globals.XHTML";
    191
    192     /**
    193      * The name of the taglib package.
    194      */
    195     public static final String TAGLIB_PACKAGE = "org.apache.struts.taglib.html";
    196
    197     /**
    198      * The property under which a Cancel button press is reported.
    199      */
    200     public static final String CANCEL_PROPERTY = TAGLIB_PACKAGE + ".CANCEL";
    201
    202     /**
    203      * The property under which a Cancel button press is reported, if the
    204      * Cancel button is rendered as an image.
    205      */
    206     public static final String CANCEL_PROPERTY_X = TAGLIB_PACKAGE + ".CANCEL.x";
    207
    208     /**
    209      * The property under which a transaction token is reported.
    210      */
    211     public static final String TOKEN_KEY = TAGLIB_PACKAGE + ".TOKEN";
    212 }