站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JBOSS Portal 2.4 API 英文版文档

InvocationContext - JBOSS Portal 2.4 API 英文版文档


org.jboss.portal.portlet.spi
Interface InvocationContext

All Known Subinterfaces:
ActionContext, RenderContext
All Known Implementing Classes:
AbstractInvocationContext, ActionContextSupport, CoreActionContext, CoreInvocationContext, CoreRenderContext, InvocationContextSupport, PortletController.ActionContextImpl, PortletController.InvocationContextImpl, PortletController.RenderContextImpl, RenderContextSupport, WSRPActionContext, WSRPInvocationContext, WSRPRenderContext

public interface InvocationContext


Nested Class Summary
static class InvocationContext.Scope
           
 
Field Summary
static InvocationContext.Scope INVOCATION_SCOPE
           
static InvocationContext.Scope PRINCIPAL_SCOPE
           
static InvocationContext.Scope SESSION_SCOPE
           
 
Method Summary
 java.lang.String encodeURL(PortletURL portletURL, java.lang.Boolean wantSecure, java.lang.Boolean wantAuthenticated, boolean relative)
           
 java.lang.String encodeURL(java.lang.String url)
          Encodes the specified URL by including the session ID in it, or, if encoding is not needed, returns the URL unchanged.
 java.lang.Object getAttribute(InvocationContext.Scope scope, java.lang.String name)
           
 Mode getMode()
          Returns the mode for this invocation.
 StateString getNavigationalState()
          Returns the navigational state for this invocation.
 HTTPStreamInfo getStreamInfo()
          Return information about the underlying http wire this invocation is performed.
 WindowState getWindowState()
          Returns the window state for this invocation.
 void setAttribute(InvocationContext.Scope scope, java.lang.String name, java.lang.Object value)
           
 

Field Detail

INVOCATION_SCOPE

public static final InvocationContext.Scope INVOCATION_SCOPE

SESSION_SCOPE

public static final InvocationContext.Scope SESSION_SCOPE

PRINCIPAL_SCOPE

public static final InvocationContext.Scope PRINCIPAL_SCOPE
Method Detail

getNavigationalState

public StateString getNavigationalState()
Returns the navigational state for this invocation.

Returns:
the navigational state

getMode

public Mode getMode()
Returns the mode for this invocation.

Returns:
the mode

getWindowState

public WindowState getWindowState()
Returns the window state for this invocation.

Returns:
the window state

getStreamInfo

public HTTPStreamInfo getStreamInfo()
Return information about the underlying http wire this invocation is performed.

Returns:
the stream info

encodeURL

public java.lang.String encodeURL(java.lang.String url)
                           throws java.lang.IllegalArgumentException

Encodes the specified URL by including the session ID in it, or, if encoding is not needed, returns the URL unchanged. The implementation of this method includes the logic to determine whether the session ID needs to be encoded in the URL. For example, if the browser supports cookies, or session tracking is turned off, URL encoding is unnecessary.

For robust session tracking, all URLs emitted by a servlet should be run through this method. Otherwise, URL rewriting cannot be used with browsers which do not support cookies.

Parameters:
url - the url to be encoded
Returns:
the encoded URL if encoding is needed, the unchanged URL otherwise
Throws:
java.lang.IllegalArgumentException - if the url is not valid or null

encodeURL

public java.lang.String encodeURL(PortletURL portletURL,
                                  java.lang.Boolean wantSecure,
                                  java.lang.Boolean wantAuthenticated,
                                  boolean relative)
Parameters:
portletURL - the portlet url
wantSecure -
wantAuthenticated -
relative -
Returns:
the url

setAttribute

public void setAttribute(InvocationContext.Scope scope,
                         java.lang.String name,
                         java.lang.Object value)

getAttribute

public java.lang.Object getAttribute(InvocationContext.Scope scope,
                                     java.lang.String name)