org.appng.api

Class RequestUtil

java.lang.Object

org.appng.api.RequestUtil

public class RequestUtil
extends Object

Utility-class for retrieving Sites by name,host or ServletRequest and also creating a Path -object based on a ServletRequest.

Author:

Matthias Müller

Method Summary

Modifier and Type	Method and Description
static String	getHostIdentifier(javax.servlet.ServletRequest request, Environment env) Retrieves the host-identifier for the given ServletRequest, using the given Environment to retrieve the VHostMode used by appNG.
static PathInfo	getPathInfo(Environment env, Site site, String servletPath) Creates and returns a PathInfo-object based upon the given parameters.
static Site	getSite(Environment env, javax.servlet.ServletRequest servletRequest) Retrieves a Site by its host-identifier.
static Site	getSiteByHost(Environment env, String host) Retrieves a Site by its host.
static Site	getSiteByName(Environment env, String name) Retrieves a Site by its name.
static Set<String>	getSiteNames(Environment env) Returns an immutable Set containing all the Site names.

Methods inherited from class java.lang.Object

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

Method Detail

getSite

public static Site getSite(Environment env,
                           javax.servlet.ServletRequest servletRequest)

Retrieves a Site by its host-identifier.

Parameters:

env - the current Environment

servletRequest - the current ServletRequest

Returns:

the Site, if any

See Also:

getHostIdentifier(ServletRequest, Environment), getSiteByHost(Environment, String)

getSiteByHost

public static Site getSiteByHost(Environment env,
                                 String host)

Retrieves a Site by its host.

Parameters:

env - the current Environment

host - the host of the Site

Returns:

the Site, if any

See Also:

Site.getHost()

getSiteByName

public static Site getSiteByName(Environment env,
                                 String name)

Retrieves a Site by its name.

Parameters:

env - the current Environment

name - the name of the Site

Returns:

the Site, if any

See Also:

Nameable.getName()

getSiteNames

public static Set<String> getSiteNames(Environment env)

Returns an immutable Set containing all the Site names.

Parameters:

env - the current Environment

Returns:

the Site names

getPathInfo

public static PathInfo getPathInfo(Environment env,
                                   Site site,
                                   String servletPath)

Creates and returns a PathInfo-object based upon the given parameters.

Parameters:

env - the current Environment

site - the current Site

servletPath - the current servlet-path

Returns:

a PathInfo-object

getHostIdentifier

public static String getHostIdentifier(javax.servlet.ServletRequest request,
                                       Environment env)

Retrieves the host-identifier for the given ServletRequest, using the given Environment to retrieve the VHostMode used by appNG.

Parameters:

request - the ServletRequest

env - an Environment

Returns:

• the IP-address, if VHostMode.IP_BASED is used (see ServletRequest.getLocalAddr())
• the value of the request-header SERVER_LOCAL_NAME, if present. This header has to be added by the webserver of choice (usually Apache httpd), in case a Site needs to be accessible from a domain that is different from the one configured by Site.getDomain().
• the lower-cased server name, otherwise (see ServletRequest.getServerName())