dk.brics.jwig.server

Class RequestManager

java.lang.Object

dk.brics.jwig.server.RequestManager

public class RequestManager
extends Object

Request manager for a web application.

Constructor Summary

Constructors

Constructor and Description
RequestManager() Constructs an uninitialized request manager object.
RequestManager(WebApp webapp) Constructs a new request manager for the given web app.

Method Summary

Methods

Modifier and Type	Method and Description
Object	deserializeArgument(Object[] actuals, Class<?> type, String name, boolean is_array, boolean is_collection, Class<? extends Collection<?>> collection_type) Deserializes an argument, i.e.
<E> E	deserializeArgument(Object[] actuals, Class<E> type, String name)
Session	getEmailSession() Returns the email session.
PatternMatcher	getPatternmatcher()
WebApp	getWebApp() Returns the web app of this web app request manager.
String	getWebAppURL(boolean secure, Map<String,String[]> argMap) Returns the URL prefix for this web app.
String	getWebAppURL(Map<String,String[]> argMap) Returns the URL prefix for this web app.
List<RegisteredMethod>	getWebMethods() Returns the list of web methods.
String	getWebSiteURL(boolean secure) Returns the URL prefix for the web site.
void	introspectWebAppClass(Class<? extends WebApp> webapp_class) Finds the web methods for the given web app class.
(package private) void	invoke(Method m, Object thisobj, Object[] args) Invokes the given web/handler method.
Object	invokeHandlerMethod(AbstractHandler handler, String referer) Invokes the handler run method.
Object	invokeHandlerValidationMethod(SubmitHandler handler)
URL	makeURL(boolean secure, Map<String,?> webapp_params, String method, Object... args) Generates a URL for the given web method within the same web site.
URL	makeURL(Map<String,?> webapp_params, String method, Object... args) Generates a URL for the given web method within the same web site.
URL	makeURL(String method, Object... args) Generates a URL for the given web method within the same web site.
static String	makeURLArg(Object arg) Converts a single web method argument into its string representation.
(package private) Object[]	match(RegisteredMethod rm, String path) Checks whether the given method matches the given path and builds argument array (combined from the path parameters and ordinary servlet parameters).
boolean	matches(String path) Returns true if this web app may match requests to the given url

Methods inherited from class java.lang.Object

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

Constructor Detail

RequestManager

public RequestManager()

Constructs an uninitialized request manager object.

RequestManager

public RequestManager(WebApp webapp)

Constructs a new request manager for the given web app. Finds the web methods and creates pattern matchers.

Method Detail

deserializeArgument

public Object deserializeArgument(Object[] actuals,
                         Class<?> type,
                         String name,
                         boolean is_array,
                         boolean is_collection,
                         Class<? extends Collection<?>> collection_type)

Deserializes an argument, i.e. converts it from string to object.

deserializeArgument

public <E> E deserializeArgument(Object[] actuals,
                        Class<E> type,
                        String name)

getEmailSession

public Session getEmailSession()

Returns the email session.

getPatternmatcher

public PatternMatcher getPatternmatcher()

getWebApp

public WebApp getWebApp()

Returns the web app of this web app request manager.

getWebAppURL

public String getWebAppURL(boolean secure,
                  Map<String,String[]> argMap)

Returns the URL prefix for this web app.

Parameters:

secure - if true, use https in the URL, otherwise use http

getWebAppURL

public String getWebAppURL(Map<String,String[]> argMap)

Returns the URL prefix for this web app. Uses SSL/TLS if the current request uses SSL/TLS.

getWebMethods

public List<RegisteredMethod> getWebMethods()

Returns the list of web methods.

getWebSiteURL

public String getWebSiteURL(boolean secure)

Returns the URL prefix for the web site.

Parameters:

secure - if true, use https in the URL otherwise use http

introspectWebAppClass

public void introspectWebAppClass(Class<? extends WebApp> webapp_class)

Finds the web methods for the given web app class. Also creates a pattern matcher for the web app and finds the web app parameter names.

invoke

void invoke(Method m,
          Object thisobj,
          Object[] args)

Invokes the given web/handler method.

invokeHandlerMethod

public Object invokeHandlerMethod(AbstractHandler handler,
                         String referer)

Invokes the handler run method.

invokeHandlerValidationMethod

public Object invokeHandlerValidationMethod(SubmitHandler handler)

makeURL

public URL makeURL(boolean secure,
          Map<String,?> webapp_params,
          String method,
          Object... args)

Generates a URL for the given web method within the same web site.

makeURL

public URL makeURL(Map<String,?> webapp_params,
          String method,
          Object... args)

Generates a URL for the given web method within the same web site. The URL uses https if the current request is on a secure connection.

makeURL

public URL makeURL(String method,
          Object... args)

Generates a URL for the given web method within the same web site. The URL uses https if the current request is on a secure connection.

makeURLArg

public static String makeURLArg(Object arg)

Converts a single web method argument into its string representation.

match

Object[] match(RegisteredMethod rm,
             String path)

Checks whether the given method matches the given path and builds argument array (combined from the path parameters and ordinary servlet parameters). Returns null if no match.

matches

public boolean matches(String path)

Returns true if this web app may match requests to the given url