org.zkoss.web.fn

Class ServletFns

java.lang.Object

org.zkoss.web.fn.ServletFns

public class ServletFns
extends Object

Providing servlet relevant functions for EL.

Author:

tomyeh

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ServletFns()

Method Summary

Modifier and Type	Method and Description
static String	encodeThemeURL(String s) Encodes a URL with theme key injected.
static String	encodeURL(String uri) Encodes a URL.
static RequestContext	getCurrentContext() Returns the current EL context.
static Writer	getCurrentOut() Returns the current output.
static javax.servlet.ServletRequest	getCurrentRequest() Returns the current servlet request, or null if not available.
static javax.servlet.ServletResponse	getCurrentResponse() Returns the current servlet response, or null if not available.
static javax.servlet.ServletContext	getCurrentServletContext() Returns the current servlet context, or null if not available.
static boolean	isBrowser(String type) Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).
static boolean	isExplorer() Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).
static boolean	isExplorer7() Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).
static boolean	isGecko() Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).
static boolean	isGecko3() Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).
static boolean	isOpera() Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).
static boolean	isSafari() Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).
static void	render(ActionContext ac) Renders the DSP fragment from EL.
static String	resolveThemeURL(String url) Resolves a URL to point to resource served by the current theme.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServletFns

protected ServletFns()

Method Detail

encodeURL

public static String encodeURL(String uri)
                        throws javax.servlet.ServletException

Encodes a URL.

If an URI contains "*", it will be replaced with a proper Locale. For example, if the current Locale is zh_TW and the resource is named "ab*.cd", then it searches "ab_zh_TW.cd", "ab_zh.cd" and then "ab.cd", until any of them is found.

Note: "*" must be right before ".", or the last character. For example, "ab*.cd" and "ab*" are both correct, while "ab*cd" and "ab*\/cd" are ignored.

If an URI contains two "*", the first "*" will be replaced with a browser code and the second with a proper locale. The browser code depends on what browser the user are used to visit the web site. Currently, the code for Internet Explorer is "ie", Safari is "saf", Opera is "opr" and all others are "moz". Thus, in the above example, if the resource is named "ab**.cd" and Firefox is used, then it searches "abmoz_zh_TW.cd", "abmoz_zh.cd" and then "abmoz.cd", until any of them is found.

Throws:

javax.servlet.ServletException

encodeThemeURL

public static final String encodeThemeURL(String s)
                                   throws javax.servlet.ServletException

Encodes a URL with theme key injected.

Parameters:

s - the string to encode

Returns:

the encoded string or null if s is null

Throws:

UnsupportedEncodingException

javax.servlet.ServletException

Since:

6.0.0

resolveThemeURL

public static final String resolveThemeURL(String url)

Resolves a URL to point to resource served by the current theme.

Parameters:

url - the default theme url to resolve

Returns:

the resolved url or null if url is null

Since:

6.5.2

isBrowser

public static boolean isBrowser(String type)

Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).

Returns whether the current request is from a browser of the specified type.

Parameters:

type - the type of the browser. The syntax: <browser-name>[<version-number>][-].
For example, ie9, ios and ie6-. And, ie9 means Internet Explorer 9 and later, while ie6- means Internet Explorer 6 (not prior, nor later).

Since:

3.5.1

isExplorer

public static boolean isExplorer()

Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).

Returns whether the browser of the current request is Explorer.

isExplorer7

public static boolean isExplorer7()

Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).

Returns whether the browser of the current request is Explorer 7 or later.

isGecko

public static boolean isGecko()

Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).

Returns whether the browser of the current request is Gecko based, such as Mozilla, Firefox and Camino.

isGecko3

public static boolean isGecko3()

Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).

Returns whether the browser is Gecko 3 based, such as Firefox 3.

Since:

3.5.0

isSafari

public static boolean isSafari()

Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).

Returns whether the browser of the current request is Safari.

isOpera

public static boolean isOpera()

Deprecated. As of release 6.0.0, replaced with Servlets.getBrowser(javax.servlet.ServletRequest, java.lang.String).

Returns whether the browser of the current request is Opera.

getCurrentContext

public static RequestContext getCurrentContext()

Returns the current EL context.

getCurrentOut

public static Writer getCurrentOut()
                            throws IOException

Returns the current output.

Throws:

IOException

getCurrentServletContext

public static javax.servlet.ServletContext getCurrentServletContext()

Returns the current servlet context, or null if not available.

getCurrentRequest

public static javax.servlet.ServletRequest getCurrentRequest()

Returns the current servlet request, or null if not available.

getCurrentResponse

public static javax.servlet.ServletResponse getCurrentResponse()

Returns the current servlet response, or null if not available.

render

public static void render(ActionContext ac)
                   throws DspException,
                          IOException

Renders the DSP fragment from EL.

Parameters:

ac - the action context; never null.

Throws:

DspException

IOException