info.magnolia.context
Interface Context

All Superinterfaces:

org.apache.commons.chain.Context, Map

All Known Subinterfaces:

SystemContext, ThreadDependentSystemContext, UserContext, WebContext

All Known Implementing Classes:

AbstractSystemContext, JCRSessionPerThreadSystemContext, SingleJCRSessionSystemContext, UserContextImpl, WebContextImpl

public interface Context
extends org.apache.commons.chain.Context

This interface defines all the methods which should be implemented by any configured magnolia context. Implementing class should never be accessible directly but only via MgnlContext static methods which work on a local (Thread) copy of the implementation.

Version:

$Revision $ ($Author $)

Author:

Sameer Charles

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Field Summary

static int	APPLICATION_SCOPE Attribute visibility scope, its visible to all sessions of this application.
static String	ATTRIBUTE_COMMENT
static String	ATTRIBUTE_EXCEPTION
static String	ATTRIBUTE_MESSAGE
static String	ATTRIBUTE_PATH
static String	ATTRIBUTE_RECURSIVE
static String	ATTRIBUTE_REPOSITORY
static String	ATTRIBUTE_UUID
static String	ATTRIBUTE_VERSION
static String	ATTRIBUTE_VERSION_MAP
static int	LOCAL_SCOPE Attribute visibility scope.
static int	SESSION_SCOPE Attribute visibility scope Shared by all requests from this session.

Method Summary

AccessManager	getAccessManager(String repositoryId) Get access manager for the specified repository on default workspace.
AccessManager	getAccessManager(String repositoryId, String workspaceId) Get access manager for the specified repository on the specified workspace.
Object	getAttribute(String name) Get attribute value without passing a scope.
Object	getAttribute(String name, int scope) Get attribute value.
Map<String,Object>	getAttributes() Get an over all map.
Map<String,Object>	getAttributes(int scope) Get a map of a attributes set in the scope.
HierarchyManager	getHierarchyManager(String repositoryId) Get hierarchy manager initialized for this user.
HierarchyManager	getHierarchyManager(String repositoryId, String workspaceId) Get hierarchy manager initialized for this user.
Locale	getLocale() Get the current locale.
Messages	getMessages() Get the default messages.
Messages	getMessages(String basename) Get the messages of the named bundle.
QueryManager	getQueryManager(String repositoryId) Get QueryManager created for this user on the specified repository.
QueryManager	getQueryManager(String repositoryId, String workspaceId) Get QueryManager created for this user on the specified repository and workspace.
User	getUser() If this is not a UserContext this method will very likely return the system user.
void	release() Release any resource used by this Context (e.g.
void	removeAttribute(String name, int scope) Remove an attribute.
void	setAttribute(String name, Object value, int scope) Set attribute value, scope of the attribute is defined.
void	setLocale(Locale locale)

Methods inherited from interface java.util.Map

clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values

Field Detail

LOCAL_SCOPE

static final int LOCAL_SCOPE

Attribute visibility scope.

See Also:

Constant Field Values

SESSION_SCOPE

static final int SESSION_SCOPE

Attribute visibility scope Shared by all requests from this session.

See Also:

Constant Field Values

APPLICATION_SCOPE

static final int APPLICATION_SCOPE

Attribute visibility scope, its visible to all sessions of this application.

See Also:

Constant Field Values

ATTRIBUTE_REPOSITORY

static final String ATTRIBUTE_REPOSITORY

See Also:

Constant Field Values

ATTRIBUTE_PATH

static final String ATTRIBUTE_PATH

See Also:

Constant Field Values

ATTRIBUTE_VERSION

static final String ATTRIBUTE_VERSION

See Also:

Constant Field Values

ATTRIBUTE_VERSION_MAP

static final String ATTRIBUTE_VERSION_MAP

See Also:

Constant Field Values

ATTRIBUTE_UUID

static final String ATTRIBUTE_UUID

See Also:

Constant Field Values

ATTRIBUTE_RECURSIVE

static final String ATTRIBUTE_RECURSIVE

See Also:

Constant Field Values

ATTRIBUTE_COMMENT

static final String ATTRIBUTE_COMMENT

See Also:

Constant Field Values

ATTRIBUTE_MESSAGE

static final String ATTRIBUTE_MESSAGE

See Also:

Constant Field Values

ATTRIBUTE_EXCEPTION

static final String ATTRIBUTE_EXCEPTION

See Also:

Constant Field Values

Method Detail

getUser

User getUser()

If this is not a UserContext this method will very likely return the system user.

setLocale

void setLocale(Locale locale)

Parameters:

locale -

getLocale

Locale getLocale()

Get the current locale.

getHierarchyManager

HierarchyManager getHierarchyManager(String repositoryId)

Get hierarchy manager initialized for this user.

Parameters:

repositoryId -

Returns:

hierarchy manager

getHierarchyManager

HierarchyManager getHierarchyManager(String repositoryId,
                                     String workspaceId)

Get hierarchy manager initialized for this user.

Parameters:

repositoryId -

workspaceId -

Returns:

hierarchy manager

getAccessManager

AccessManager getAccessManager(String repositoryId)

Get access manager for the specified repository on default workspace.

Parameters:

repositoryId -

Returns:

access manager

getAccessManager

AccessManager getAccessManager(String repositoryId,
                               String workspaceId)

Get access manager for the specified repository on the specified workspace.

Parameters:

repositoryId -

workspaceId -

Returns:

access manager

getQueryManager

QueryManager getQueryManager(String repositoryId)

Get QueryManager created for this user on the specified repository.

Parameters:

repositoryId -

Returns:

query manager

getQueryManager

QueryManager getQueryManager(String repositoryId,
                             String workspaceId)

Get QueryManager created for this user on the specified repository and workspace.

Parameters:

repositoryId -

workspaceId -

Returns:

query manager

setAttribute

void setAttribute(String name,
                  Object value,
                  int scope)

Set attribute value, scope of the attribute is defined.

Parameters:

name - is used as a key

value -

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

getAttribute

Object getAttribute(String name,
                    int scope)

Get attribute value.

Parameters:

name - to which value is associated to

scope - the scope (request, session, application)

Returns:

attribute value

getAttribute

Object getAttribute(String name)

Get attribute value without passing a scope. the scopes are searched from bottom up (request, session, application)

Parameters:

name - to which value is associated to

Returns:

attribute value

getAttributes

Map<String,Object> getAttributes(int scope)

Get a map of a attributes set in the scope.

Parameters:

scope -

Returns:

the map

removeAttribute

void removeAttribute(String name,
                     int scope)

Remove an attribute.

Parameters:

name -

scope -

getAttributes

Map<String,Object> getAttributes()

Get an over all map.

Returns:

the map

getMessages

Messages getMessages()

Get the default messages. It uses the locale set on this context TODO: This duplicates methods from MessagesManager : remove either

getMessages

Messages getMessages(String basename)

Get the messages of the named bundle. It uses the locale set on this context

Parameters:

basename - name of the bundle TODO: This duplicates methods from MessagesManager : remove either

release

void release()

Release any resource used by this Context (e.g. jcr sessions).