info.magnolia.context
Class MgnlContext

java.lang.Object
  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()