|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.springframework.web.context.request.AbstractRequestAttributes org.springframework.web.portlet.context.PortletRequestAttributes
public class PortletRequestAttributes
Portlet-based implementation of the
RequestAttributes
interface.
Accesses objects from portlet request and portlet session scope, with a distinction between "session" (the PortletSession's "portlet scope") and "global session" (the PortletSession's "application scope").
PortletRequest.getAttribute(java.lang.String)
,
PortletSession.getAttribute(java.lang.String)
,
PortletSession.PORTLET_SCOPE
,
PortletSession.APPLICATION_SCOPE
,
RequestAttributes.SCOPE_SESSION
,
RequestAttributes.SCOPE_GLOBAL_SESSION
Field Summary |
---|
Fields inherited from class org.springframework.web.context.request.AbstractRequestAttributes |
---|
requestDestructionCallbacks |
Fields inherited from interface org.springframework.web.context.request.RequestAttributes |
---|
SCOPE_GLOBAL_SESSION, SCOPE_REQUEST, SCOPE_SESSION |
Constructor Summary | |
---|---|
PortletRequestAttributes(PortletRequest request)
Create a new PortletRequestAttributes instance for the given request. |
Method Summary | |
---|---|
Object |
getAttribute(String name,
int scope)
Return the value for the scoped attribute of the given name, if any. |
PortletRequest |
getRequest()
Exposes the native PortletRequest that we're wrapping. |
protected PortletSession |
getSession(boolean allowCreate)
Exposes the PortletSession that we're wrapping. |
String |
getSessionId()
Return an id for the current underlying session. |
Object |
getSessionMutex()
Expose the best available mutex for the underlying session: that is, an object to synchronize on for the underlying session. |
void |
registerDestructionCallback(String name,
Runnable callback,
int scope)
Register a callback to be executed on destruction of the specified attribute in the given scope. |
void |
removeAttribute(String name,
int scope)
Remove the scoped attribute of the given name, if it exists. |
void |
setAttribute(String name,
Object value,
int scope)
Set the value for the scoped attribute of the given name, replacing an existing value (if any). |
protected void |
updateAccessedSessionAttributes()
Update all accessed session attributes through session.setAttribute
calls, explicitly indicating to the container that they might have been modified. |
Methods inherited from class org.springframework.web.context.request.AbstractRequestAttributes |
---|
registerRequestDestructionCallback, removeRequestDestructionCallback, requestCompleted |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public PortletRequestAttributes(PortletRequest request)
request
- current portlet requestMethod Detail |
---|
public final PortletRequest getRequest()
PortletRequest
that we're wrapping.
protected final PortletSession getSession(boolean allowCreate)
PortletSession
that we're wrapping.
allowCreate
- whether to allow creation of a new session if none exists yetpublic Object getAttribute(String name, int scope)
RequestAttributes
name
- the name of the attributescope
- the scope identifier
null
if not foundpublic void setAttribute(String name, Object value, int scope)
RequestAttributes
name
- the name of the attributevalue
- the value for the attributescope
- the scope identifierpublic void removeAttribute(String name, int scope)
RequestAttributes
Note that an implementation should also remove a registered destruction callback for the specified attribute, if any. It does, however, not need to execute a registered destruction callback in this case, since the object will be destroyed by the caller (if appropriate).
name
- the name of the attributescope
- the scope identifierpublic void registerDestructionCallback(String name, Runnable callback, int scope)
RequestAttributes
Implementations should do their best to execute the callback at the appropriate time: that is, at request completion or session termination, respectively. If such a callback is not supported by the underlying runtime environment, the callback must be ignored and a corresponding warning should be logged.
Note that 'destruction' usually corresponds to destruction of the
entire scope, not to the individual attribute having been explicitly
removed by the application. If an attribute gets removed via this
facade's RequestAttributes.removeAttribute(String, int)
method, any registered
destruction callback should be disabled as well, assuming that the
removed object will be reused or manually destroyed.
name
- the name of the attribute to register the callback forcallback
- the destruction callback to be executedscope
- the scope identifierpublic String getSessionId()
RequestAttributes
null
public Object getSessionMutex()
RequestAttributes
null
protected void updateAccessedSessionAttributes()
session.setAttribute
calls, explicitly indicating to the container that they might have been modified.
updateAccessedSessionAttributes
in class AbstractRequestAttributes
|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |