info.magnolia.context
Class MgnlContext

java.lang.Object
  extended by info.magnolia.context.MgnlContext

public class MgnlContext
extends Object

This class allows obtaining of the current Request without passing the request around the world. A ThreadLocal variable is used to manage the request and to make sure it doesn't escape to another processing.

In a later version this class should not depend on servlets. The core should use the context to get and set attributes instead of using the request or session object directly. Magnolia could run then in a neutral and configurable context.

Version:
$Revision: 41137 $ ($Author: gjoseph $)
Author:
Philipp Bracher

Nested Class Summary
static interface MgnlContext.Op<T,E extends Throwable>
          A simple execution interface to be used with the doInSystemContext method.
static interface MgnlContext.SystemContextOperation
          Deprecated. since 4.2 - use the Op interface, which can return values, or extend VoidOp.
static class MgnlContext.VoidOp
          An Op that does not return values and can only throw RuntimeExceptions.
 
Constructor Summary
MgnlContext()
          Do not instantiate this class.
 
Method Summary
static
<T,E extends Throwable>
T
doInSystemContext(MgnlContext.Op<T,E> op)
          Executes the given operation in the system context and sets it back to the original once done (also if an exception is thrown).
static
<T,E extends Throwable>
T
doInSystemContext(MgnlContext.Op<T,E> op, boolean releaseAfterExecution)
          Executes the given operation in the system context and sets it back to the original once done (also if an exception is thrown).
static void doInSystemContext(MgnlContext.SystemContextOperation op)
          Deprecated. since 4.2 - use the Op interface, which can return values, or extend VoidOp.
static void doInSystemContext(MgnlContext.SystemContextOperation op, boolean releaseAfterExecution)
          Deprecated. since 4.2 - use the Op interface, which can return values, or extend VoidOp.
static AccessManager getAccessManager(String repositoryId)
          Get access manager for the specified repository on default workspace.
static AccessManager getAccessManager(String repositoryId, String workspaceId)
          Get access manager for the specified repository on the specified workspace.
static AggregationState getAggregationState()
          Returns the AggregationState if we're in a WebContext, throws an IllegalStateException otherwise.
static Object getAttribute(String name)
          Get attribute value.
static Object getAttribute(String name, int scope)
          Get the attribute from the specified scope.
static String getContextPath()
           
static HierarchyManager getHierarchyManager(String repositoryId)
          Get hierarchy manager initialized for this user.
static HierarchyManager getHierarchyManager(String repositoryId, String workspaceId)
          Get hierarchy manager initialized for this user.
static Context getInstance()
          Get the current context of this thread.
static Locale getLocale()
          Get the context's locale object.
static Messages getMessages()
           
static Messages getMessages(String basename)
           
static String getParameter(String name)
          Get parameter value as string.
static Map<String,String> getParameters()
          Get parameter value as a Map<String, String>.
static String[] getParameterValues(String name)
           
static MultipartForm getPostedForm()
          Get form object assembled by MultipartRequestFilter.
static QueryManager getQueryManager(String repositoryId)
          Get QueryManager created for this user on the specified repository.
static QueryManager getQueryManager(String repositoryId, String workspaceId)
          Get QueryManager created for this user on the specified repository and workspace.
static SystemContext getSystemContext()
          Get Magnolia system context.
static User getUser()
          A short cut for the current user.
static WebContext getWebContext()
          Throws an IllegalStateException if the current context is not set, or if it is not an instance of WebContext.
static WebContext getWebContext(String exceptionMessage)
          Throws an IllegalStateException if the current context is not set, or if it is not an instance of WebContext.
static WebContext getWebContextOrNull()
          Returns the current context if it is set and is an instance of WebContext, returns null otherwise.
static boolean hasAttribute(String name)
          Check if this attribute exists in the local scope.
static boolean hasInstance()
          Used to check if an instance is already set since getInstance() will always return a context.
static void initAsWebContext(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, javax.servlet.ServletContext servletContext)
          Sets this context as a web context.
static boolean isSystemInstance()
           
static boolean isWebContext()
          Returns true if the current context is set and is an instance of WebContext.
static void login(User user)
           
static void pop()
           
static void push(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
           
static void release()
          Releases the current thread (if not a system context) and calls the releaseThread() method of the system context.
static void removeAttribute(String name)
          Remove an attribute in the local scope.
static void resetAggregationState()
          Resets the current aggregation state if we're in a WebContext, throws an IllegalStateException otherwise.
static void setAttribute(String name, Object value)
          Set attribute value, scope of the attribute is defined.
static void setAttribute(String name, Object value, int scope)
          Set attribute value, scope of the attribute is defined.
static void setInstance(Context context)
          Set context implementation instance.
static void setLocale(Locale locale)
          Set the locale for the current context.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

MgnlContext

public MgnlContext()
Do not instantiate this class. The constructor must be public to use discovery

Method Detail

getUser

public static User getUser()
A short cut for the current user.

Returns:
the current user

setLocale

public static void setLocale(Locale locale)
Set the locale for the current context.


getLocale

public static Locale getLocale()
Get the context's locale object.

Returns:
the current locale

getMessages

public static Messages getMessages()

getMessages

public static Messages getMessages(String basename)

login

public static void login(User user)

getHierarchyManager

public static HierarchyManager getHierarchyManager(String repositoryId)
Get hierarchy manager initialized for this user.


getHierarchyManager

public static HierarchyManager getHierarchyManager(String repositoryId,
                                                   String workspaceId)
Get hierarchy manager initialized for this user.


getAccessManager

public static AccessManager getAccessManager(String repositoryId)
Get access manager for the specified repository on default workspace.


getAccessManager

public static AccessManager getAccessManager(String repositoryId,
                                             String workspaceId)
Get access manager for the specified repository on the specified workspace.


getQueryManager

public static QueryManager getQueryManager(String repositoryId)
Get QueryManager created for this user on the specified repository.


getQueryManager

public static QueryManager getQueryManager(String repositoryId,
                                           String workspaceId)
Get QueryManager created for this user on the specified repository and workspace.


getPostedForm

public static MultipartForm getPostedForm()
Get form object assembled by MultipartRequestFilter.

Returns:
multipart form object TODO - move to getAggregationState() ?

getParameter

public static String getParameter(String name)
Get parameter value as string.


getParameterValues

public static String[] getParameterValues(String name)

getParameters

public static Map<String,String> getParameters()
Get parameter value as a Map<String, String>.


getContextPath

public static String getContextPath()
Returns:
the context path.

getAggregationState

public static AggregationState getAggregationState()
Returns the AggregationState if we're in a WebContext, throws an IllegalStateException otherwise.


resetAggregationState

public static void resetAggregationState()
Resets the current aggregation state if we're in a WebContext, throws an IllegalStateException otherwise.


setAttribute

public static void setAttribute(String name,
                                Object value)
Set attribute value, scope of the attribute is defined.


setAttribute

public static void setAttribute(String name,
                                Object value,
                                int scope)
Set attribute value, scope of the attribute is defined.

Parameters:
scope - , highest level of scope from which this attribute is visible.

getAttribute

public static Object getAttribute(String name)
Get attribute value.


getAttribute

public static Object getAttribute(String name,
                                  int scope)
Get the attribute from the specified scope.


hasAttribute

public static boolean hasAttribute(String name)
Check if this attribute exists in the local scope.


removeAttribute

public static void removeAttribute(String name)
Remove an attribute in the local scope.


setInstance

public static void setInstance(Context context)
Set context implementation instance.


getInstance

public static Context getInstance()
Get the current context of this thread.


getWebContext

public static WebContext getWebContext()
Throws an IllegalStateException if the current context is not set, or if it is not an instance of WebContext.

See Also:
getWebContext(String)

getWebContext

public static WebContext getWebContext(String exceptionMessage)
Throws an IllegalStateException if the current context is not set, or if it is not an instance of WebContext. Yes, you can specify the exception message if you want. This is useful if you're calling this from a component which only supports WebContext and still care enough to actually throw an exception with a meaningful message.

See Also:
getWebContext()

getWebContextOrNull

public static WebContext getWebContextOrNull()
Returns the current context if it is set and is an instance of WebContext, returns null otherwise.

Returns:

hasInstance

public static boolean hasInstance()
Used to check if an instance is already set since getInstance() will always return a context.

Returns:
true if an instance was set.

isSystemInstance

public static boolean isSystemInstance()

isWebContext

public static boolean isWebContext()
Returns true if the current context is set and is an instance of WebContext. (it might be wrapped in a ContextDecorator)


getSystemContext

public static SystemContext getSystemContext()
Get Magnolia system context. This context has full permissions over all repositories/ workspaces.


doInSystemContext

public static void doInSystemContext(MgnlContext.SystemContextOperation op)
Deprecated. since 4.2 - use the Op interface, which can return values, or extend VoidOp.


doInSystemContext

public static <T,E extends Throwable> T doInSystemContext(MgnlContext.Op<T,E> op)
                           throws E extends Throwable
Executes the given operation in the system context and sets it back to the original once done (also if an exception is thrown). Also works if there was no context upon calling. (sets it back to null in this case)

Throws:
E extends Throwable

doInSystemContext

public static void doInSystemContext(MgnlContext.SystemContextOperation op,
                                     boolean releaseAfterExecution)
Deprecated. since 4.2 - use the Op interface, which can return values, or extend VoidOp.


doInSystemContext

public static <T,E extends Throwable> T doInSystemContext(MgnlContext.Op<T,E> op,
                                                          boolean releaseAfterExecution)
                           throws E extends Throwable
Executes the given operation in the system context and sets it back to the original once done (also if an exception is thrown). Also works if there was no context upon calling (sets it back to null in this case)

Parameters:
releaseAfterExecution - TODO document this parameter
Throws:
E extends Throwable

initAsWebContext

public static void initAsWebContext(javax.servlet.http.HttpServletRequest request,
                                    javax.servlet.http.HttpServletResponse response,
                                    javax.servlet.ServletContext servletContext)
Sets this context as a web context.

Parameters:
request - HttpServletRequest
response - HttpServletResponse
servletContext - ServletContext instance

release

public static void release()
Releases the current thread (if not a system context) and calls the releaseThread() method of the system context.


push

public static void push(javax.servlet.http.HttpServletRequest request,
                        javax.servlet.http.HttpServletResponse response)

pop

public static void pop()


Copyright © 2003-2011 Magnolia International Ltd.. All Rights Reserved.