Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.apache.commons.jxpath.servlet
Class JXPathServletContexts

    java.lang.Object
      org.apache.commons.jxpath.servlet.JXPathServletContexts

    public final class JXPathServletContexts

extends Object

Static methods that allocate and cache JXPathContexts bound to `PageContext`, `ServletRequest`, `HttpSession` and `ServletContext`.

The `JXPathContext` returned by `getPageContext()` provides access to all scopes via the PageContext.findAttribute() method. Thus, an expression like "foo" will first look for the attribute named "foo" in the "page" context, then the "request" context, then the "session" one and finally in the "application" context.

If you need to limit the attibute lookup to just one scope, you can use the pre-definded variables "page", "request", "session" and "application". For example, the expression "$session/foo" extracts the value of the session attribute named "foo".

Following are some implementation details. There is a separate JXPathContext for each of the four scopes. These contexts are chained according to the nesting of the scopes. So, the parent of the "page" JXPathContext is a "request" JXPathContext, whose parent is a "session" JXPathContext (that is if there is a session), whose parent is an "application" context.

The XPath context node for each context is the corresponding object: PageContext, ServletRequest, HttpSession or ServletContext. This feature can be used by servlets. A servlet can use one of the methods declared by this class and work with a specific JXPathContext for any scope.

Since JXPath chains lookups for variables and extension functions, variables and extension function declared in the outer scopes are also available in the inner scopes.

Each of the four context declares exactly one variable, the value of which is the corresponding object: PageContext, etc.

The "session" variable will be undefined if there is no session for this servlet. JXPath does not automatically create sessions.

Version:
  $Revision: 652845 $ $Date: 2008-05-02 12:46:46 -0500 (Fri, 02 May 2008) $
Author:
  Dmitri Plotnikov

Constructor Summary
`JXPathServletContexts()`

Method Summary
`static JXPathContext` | `getApplicationContext(ServletContext servletContext)` Returns a JXPathContext bound to the "application" scope.
`static JXPathContext` | `getPageContext(PageContext pageContext)` Returns a JXPathContext bound to the "page" scope.
`static JXPathContext` | `getRequestContext(ServletRequest request, ServletContext servletContext)` Returns a JXPathContext bound to the "request" scope.
`static JXPathContext` | `getSessionContext(HttpSession session, ServletContext servletContext)` Returns a JXPathContext bound to the "session" scope.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### JXPathServletContexts

    public JXPathServletContexts()

Method Detail

### getPageContext

    public static JXPathContext getPageContext(PageContext pageContext)

  Returns a JXPathContext bound to the "page" scope. Caches that context within the PageContext itself.

  Parameters:
    `pageContext` - as described
  Returns:
    JXPathContext

### getRequestContext

    public static JXPathContext getRequestContext(ServletRequest request,
                                                  ServletContext servletContext)

  Returns a JXPathContext bound to the "request" scope. Caches that context within the request itself.

  Parameters:
    `request` - as described
    `servletContext` - operative
  Returns:
    JXPathContext

### getSessionContext

    public static JXPathContext getSessionContext(HttpSession session,
                                                  ServletContext servletContext)

  Returns a JXPathContext bound to the "session" scope. Caches that context within the session itself.

  Parameters:
    `session` - as described
    `servletContext` - operative
  Returns:
    JXPathContext

### getApplicationContext

    public static JXPathContext getApplicationContext(ServletContext servletContext)

  Returns a JXPathContext bound to the "application" scope. Caches that context within the servlet context itself.

  Parameters:
    `servletContext` - operative
  Returns:
    JXPathContext

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2001-2008 The Apache Software Foundation. All Rights Reserved.