Package org.zkoss.web.servlet.xel
Class RequestContexts
java.lang.Object
org.zkoss.web.servlet.xel.RequestContexts
RequestContexts maintains a stack of
RequestContext to simplify
the signatures of the XEL function.
It is designed to make the signature of XEL functions
(see ServletFns) simpler.
For example, ServletFns.getCurrentContext() requires
no argument, since it assumes the current context can be retrieved
from getCurrent().
Spec Issue:
It is controversial whether the introduction of RequestContext and
RequestContexts is worth. However, we have to maintain the backward
compatibility of the XEL/EL function signatures.
- Since:
- 3.0.0
- Author:
- tomyeh
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic final RequestContextReturns the current page context if this thread is evaluating a page, or null if not.static final voidpop()Pops the context out and use the previous one as the current context.static final voidpush(RequestContext jc) Pushes the context as the current context, such that it will be returned bygetCurrent().
-
Constructor Details
-
RequestContexts
protected RequestContexts()
-
-
Method Details
-
getCurrent
Returns the current page context if this thread is evaluating a page, or null if not. -
push
Pushes the context as the current context, such that it will be returned bygetCurrent(). The reason this method exists is many functions (ServletFns) counts on it.However, you don't need to invoke this method if you are using DSP.
- If go thru DSP, it is done automatically
(by
Interpreter
Note: you must use try/finally as follows:
RequestContexts.push(jc); try { ... } finally { RequestContexts.pop(); } - If go thru DSP, it is done automatically
(by
-
pop
public static final void pop()Pops the context out and use the previous one as the current context.However, you don't need to invoke this method if you are using DSP.
-