org.apache.wicket
Class Application

java.lang.Object
  org.apache.wicket.Application

Direct Known Subclasses:

WebApplication

public abstract class Application
extends java.lang.Object

Base class for all Wicket applications. To create a Wicket application, you generally should not directly subclass this class. Instead, you will want to subclass some subclass of Application, like WebApplication, which is appropriate for the protocol and markup type you are working with.

Application has the following interesting features / attributes:

• Name - The Application's name, which is the same as its class name.
• Home Page - The Application's home Page class. Subclasses must override getHomePage() to provide this property value.
• Settings - Application settings are partitioned into sets of related settings using interfaces in the org.apache.wicket.settings package. These interfaces are returned by the following methods, which should be used to configure framework settings for your application: getApplicationSettings(), getDebugSettings(), getExceptionSettings(), getMarkupSettings(), getPageSettings(), getRequestCycleSettings(), getSecuritySettings and getSessionSettings(). These settings are configured by default through the constructor or internalInit methods. Default the application is configured for DEVELOPMENT. You can configure this globally to DEPLOYMENT or override specific settings by implementing the init() method.
• Shared Resources - Resources added to an Application's SharedResources have application-wide scope and can be referenced using a logical scope and a name with the ResourceReference class. ResourceReferences can then be used by multiple components in the same application without additional overhead (beyond the ResourceReference instance held by each referee) and will yield a stable URL, permitting efficient browser caching of the resource (even if the resource is dynamically generated). Resources shared in this manner may also be localized. See ResourceReference for more details.
• Custom Session Subclasses- In order to install your own Session subclass you must override ApplicationnewSession(Request, Response). For subclasses of WebApplication you will want to subclass WebSession.

Author:

Jonathan Locke

See Also:

WebApplication

Field Summary

static java.lang.String	CONFIGURATION Configuration constant for the 2 types
static java.lang.String	CONTEXTPATH Configuration type constant for getting the context path out of the web.xml
static java.lang.String	DEPLOYMENT Configuration type constant for deployment
static java.lang.String	DEVELOPMENT Configuration type constant for development

Constructor Summary

Application()
Constructor.

Method Summary

void	addComponentInstantiationListener(IComponentInstantiationListener listener) Adds a component instantiation listener.
void	addComponentOnAfterRenderListener(IComponentOnAfterRenderListener listener) Adds an IComponentOnAfterRenderListener.
void	addComponentOnBeforeRenderListener(IComponentOnBeforeRenderListener listener) Adds an IComponentOnBeforeRenderListener.
void	addRenderHeadListener(IHeaderContributor listener) Adds a listener that will be invoked for every header response
void	configure() Configures application settings to good defaults.
protected void	destroy() Deprecated. use onDestroy() instead
static boolean	exists() Checks if the Application threadlocal is set in this thread
static Application	get() Get Application for current thread.
static Application	get(java.lang.String applicationKey) Gets the Application based on the application key of that application.
abstract java.lang.String	getApplicationKey() Gets the unique key of this application within a given context (like a web application).
static java.util.Set	getApplicationKeys() Gets the keys of the currently registered Wicket applications for this web application.
IApplicationSettings	getApplicationSettings()
abstract java.lang.String	getConfigurationType() Gets the configuration mode to use for configuring the app, either DEVELOPMENT or DEPLOYMENT.
IConverterLocator	getConverterLocator()
IDebugSettings	getDebugSettings()
IExceptionSettings	getExceptionSettings()
IFrameworkSettings	getFrameworkSettings()
abstract java.lang.Class	getHomePage() Application subclasses must specify a home page class by implementing this abstract method.
IMarkupCache	getMarkupCache() Deprecated. please use IMarkupSettings.getMarkupCache() instead
IMarkupSettings	getMarkupSettings()
java.io.Serializable	getMetaData(MetaDataKey key) Gets metadata for this application using the given key.
java.lang.String	getName() Gets the name of this application.
IPageSettings	getPageSettings()
protected java.lang.Object	getRequestCycleFactory() Deprecated. replaced by newRequestCycle(Request, Response)
IRequestCycleSettings	getRequestCycleSettings()
IRequestLogger	getRequestLogger() Gets the RequestLogger.
IRequestLoggerSettings	getRequestLoggerSettings()
IResourceSettings	getResourceSettings()
ISecuritySettings	getSecuritySettings()
protected java.lang.Object	getSessionFactory() Deprecated. replaced by newSession(Request, Response)
ISessionSettings	getSessionSettings()
ISessionStore	getSessionStore() Gets the facade object for working getting/ storing session instances.
SharedResources	getSharedResources() Gets the shared resources.
protected void	init() Allows for initialization of the application by a subclass.
void	initializeComponents() THIS METHOD IS NOT PART OF THE WICKET PUBLIC API.
protected void	internalDestroy() THIS METHOD IS NOT PART OF THE WICKET PUBLIC API.
protected void	internalInit() THIS METHOD IS NOT PART OF THE WICKET PUBLIC API.
void	logEventTarget(IRequestTarget target) THIS METHOD IS NOT PART OF THE WICKET PUBLIC API.
void	logResponseTarget(IRequestTarget requestTarget) THIS METHOD IS NOT PART OF THE WICKET PUBLIC API.
protected IConverterLocator	newConverterLocator() Creates and returns a new instance of IConverterLocator.
RequestCycle	newRequestCycle(Application application, Request request, Response response) Deprecated. Applications wishing to provide custom request cycles should override method newRequestCycle(Request, Response)
abstract RequestCycle	newRequestCycle(Request request, Response response) Creates a new RequestCycle object.
protected IRequestLogger	newRequestLogger() creates a new request logger when requests logging is enabled.
abstract Session	newSession(Request request, Response response) Creates a new session.
protected abstract ISessionStore	newSessionStore() Creates a new session facade.
void	notifyRenderHeadListener(IHeaderResponse response) INTERNAL
protected void	onDestroy() Called when wicket servlet is destroyed.
void	removeComponentInstantiationListener(IComponentInstantiationListener listener) Removes a component instantiation listener.
void	removeComponentOnAfterRenderListener(IComponentOnAfterRenderListener listener) Removes an IComponentOnAfterRenderListener.
void	removeComponentOnBeforeRenderListener(IComponentOnBeforeRenderListener listener) Removes an IComponentOnBeforeRenderListener.
void	removeRenderHeadListener(IHeaderContributor listener)
static void	set(Application application) THIS METHOD IS NOT PART OF THE WICKET PUBLIC API.
void	setMetaData(MetaDataKey key, java.io.Serializable object) Sets the metadata for this application using the given key.
static void	unset() THIS METHOD IS NOT PART OF THE WICKET PUBLIC API.

Methods inherited from class java.lang.Object

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

Field Detail

CONFIGURATION

public static final java.lang.String CONFIGURATION

Configuration constant for the 2 types

See Also:

Constant Field Values

CONTEXTPATH

public static final java.lang.String CONTEXTPATH

Configuration type constant for getting the context path out of the web.xml

See Also:

Constant Field Values

DEPLOYMENT

public static final java.lang.String DEPLOYMENT

Configuration type constant for deployment

See Also:

Constant Field Values

DEVELOPMENT

public static final java.lang.String DEVELOPMENT

Configuration type constant for development

See Also:

Constant Field Values

Constructor Detail

Application

public Application()

Constructor. Use init() for any configuration of your application instead of overriding the constructor.

Method Detail

exists

public static boolean exists()

Checks if the Application threadlocal is set in this thread

Returns:

true if get() can return the instance of application, false otherwise

get

public static Application get()

Get Application for current thread.

Returns:

The current thread's Application

get

public static Application get(java.lang.String applicationKey)

Gets the Application based on the application key of that application. You typically never have to use this method unless you are working on an integration project.

Parameters:

applicationKey - The unique key of the application within a certain context (e.g. a web application)

Returns:

The application

Throws:

java.lang.IllegalArgumentException - When no application was found with the provided key

getApplicationKeys

public static java.util.Set getApplicationKeys()

Gets the keys of the currently registered Wicket applications for this web application. You typically never have to use this method unless you are working on an integration project.

Returns:

unmodifiable set with keys that correspond with getApplicationKey(). Never null, but possibly empty

set

public static void set(Application application)

THIS METHOD IS NOT PART OF THE WICKET PUBLIC API. DO NOT USE IT.

Parameters:

application - The current application or null for this thread

unset

public static void unset()

THIS METHOD IS NOT PART OF THE WICKET PUBLIC API. DO NOT USE IT.

addComponentInstantiationListener

public final void addComponentInstantiationListener(IComponentInstantiationListener listener)

Adds a component instantiation listener. This method should typically only be called during application startup; it is not thread safe.

Note: wicket does not guarantee the execution order of added listeners

Parameters:

listener - the listener to add

configure

public final void configure()

Configures application settings to good defaults.

getApplicationKey

public abstract java.lang.String getApplicationKey()

Gets the unique key of this application within a given context (like a web application). NOT INTENDED FOR FRAMEWORK CLIENTS.

Returns:

The unique key of this application

getApplicationSettings

public IApplicationSettings getApplicationSettings()

Returns:

Application's application-wide settings

Since:

1.2

See Also:

IApplicationSettings

getConfigurationType

public abstract java.lang.String getConfigurationType()

Gets the configuration mode to use for configuring the app, either DEVELOPMENT or DEPLOYMENT.

The configuration type. Must currently be either DEVELOPMENT or DEPLOYMENT. Currently, if the configuration type is DEVELOPMENT, resources are polled for changes, component usage is checked, wicket tags are not stripped from output and a detailed exception page is used. If the type is DEPLOYMENT, component usage is not checked, wicket tags are stripped from output and a non-detailed exception page is used to display errors.

Note that you should not run Wicket in DEVELOPMENT mode on production servers - the various debugging checks and resource polling is inefficient and may leak resources, particularly on webapp redeploy.

Returns:

configuration

Since:

1.2.3 (function existed as a property getter), 1.3.0 (abstract, used to configure things)

getConverterLocator

public final IConverterLocator getConverterLocator()

Returns:

The converter locator for this application

getDebugSettings

public IDebugSettings getDebugSettings()

Returns:

Application's debug related settings

Since:

1.2

See Also:

IDebugSettings

getExceptionSettings

public IExceptionSettings getExceptionSettings()

Returns:

Application's exception handling settings

Since:

1.2

See Also:

IExceptionSettings

getFrameworkSettings

public IFrameworkSettings getFrameworkSettings()

Returns:

Wicket framework settings

Since:

1.2

See Also:

IFrameworkSettings

getHomePage

public abstract java.lang.Class getHomePage()

Application subclasses must specify a home page class by implementing this abstract method.

Returns:

Home page class for this application

getMarkupCache

public final IMarkupCache getMarkupCache()

Deprecated. please use IMarkupSettings.getMarkupCache() instead

THIS METHOD IS NOT PART OF THE WICKET PUBLIC API. DO NOT USE IT.

Returns:

The markup cache associated with the application

getMarkupSettings

public IMarkupSettings getMarkupSettings()

Returns:

Application's markup related settings

Since:

1.2

See Also:

IMarkupSettings

getMetaData

public final java.io.Serializable getMetaData(MetaDataKey key)

Gets metadata for this application using the given key.

Parameters:

key - The key for the data

Returns:

The metadata

See Also:

MetaDataKey

getName

public final java.lang.String getName()

Gets the name of this application.

Returns:

The application name.

getPageSettings

public IPageSettings getPageSettings()

Returns:

Application's page related settings

Since:

1.2

See Also:

IPageSettings

getRequestCycleSettings

public IRequestCycleSettings getRequestCycleSettings()

Returns:

Application's request cycle related settings

Since:

1.2

See Also:

IDebugSettings

getRequestLogger

public final IRequestLogger getRequestLogger()

Gets the RequestLogger.

Returns:

The RequestLogger

getRequestLoggerSettings

public IRequestLoggerSettings getRequestLoggerSettings()

Returns:

Application's resources related settings

Since:

1.3

See Also:

IResourceSettings

getResourceSettings

public IResourceSettings getResourceSettings()

Returns:

Application's resources related settings

Since:

1.2

See Also:

IResourceSettings

getSecuritySettings

public ISecuritySettings getSecuritySettings()

Returns:

Application's security related settings

Since:

1.2

See Also:

ISecuritySettings

getSessionSettings

public ISessionSettings getSessionSettings()

Returns:

Application's session related settings

Since:

1.2

See Also:

ISessionSettings

getSessionStore

public final ISessionStore getSessionStore()

Gets the facade object for working getting/ storing session instances.

Returns:

The session facade

getSharedResources

public final SharedResources getSharedResources()

Gets the shared resources.

Returns:

The SharedResources for this application.

initializeComponents

public final void initializeComponents()

THIS METHOD IS NOT PART OF THE WICKET PUBLIC API. DO NOT CALL. Initializes wicket components.

logEventTarget

public void logEventTarget(IRequestTarget target)

THIS METHOD IS NOT PART OF THE WICKET PUBLIC API. DO NOT CALL.

Parameters:

target -

logResponseTarget

public void logResponseTarget(IRequestTarget requestTarget)

THIS METHOD IS NOT PART OF THE WICKET PUBLIC API. DO NOT CALL.

Parameters:

requestTarget -

newRequestCycle

public abstract RequestCycle newRequestCycle(Request request,
                                             Response response)

Creates a new RequestCycle object. Override this method if you want to provide a custom request cycle.

Parameters:

request - The request

response - The response

Returns:

The request cycle

Since:

1.3

newRequestCycle

public final RequestCycle newRequestCycle(Application application,
                                          Request request,
                                          Response response)

Deprecated. Applications wishing to provide custom request cycles should override method newRequestCycle(Request, Response)

FOR DEPRECATION ONLY.

Parameters:

application -

request -

response -

Returns:

nothing

Throws:

java.lang.UnsupportedOperationException - always

newSession

public abstract Session newSession(Request request,
                                   Response response)

Creates a new session. Override this method if you want to provide a custom session.

Parameters:

request - The request that will create this session.

response - The response to initialize, for example with cookies. This is important to use cases involving unit testing because those use cases might want to be able to sign a user in automatically when the session is created.

Returns:

The session

Since:

1.3

removeComponentInstantiationListener

public final void removeComponentInstantiationListener(IComponentInstantiationListener listener)

Removes a component instantiation listener. This method should typicaly only be called during application startup; it is not thread safe.

Parameters:

listener - the listener to remove

setMetaData

public final void setMetaData(MetaDataKey key,
                              java.io.Serializable object)

Sets the metadata for this application using the given key. If the metadata object is not of the correct type for the metadata key, an IllegalArgumentException will be thrown. For information on creating MetaDataKeys, see MetaDataKey.

Parameters:

key - The singleton key for the metadata

object - The metadata object

Throws:

java.lang.IllegalArgumentException

See Also:

MetaDataKey

destroy

protected final void destroy()

Deprecated. use onDestroy() instead

Called when wicket servlet is destroyed. Overrides do not have to call super.

onDestroy

protected void onDestroy()

Called when wicket servlet is destroyed. Overrides do not have to call super.

getRequestCycleFactory

protected final java.lang.Object getRequestCycleFactory()

Deprecated. replaced by newRequestCycle(Request, Response)

Returns:

Request cycle factory for this kind of session.

getSessionFactory

protected final java.lang.Object getSessionFactory()

Deprecated. replaced by newSession(Request, Response)

Gets the factory for creating session instances.

Returns:

Factory for creating session instances

init

protected void init()

Allows for initialization of the application by a subclass. Use this method for any application setup instead of the constructor.

internalDestroy

protected void internalDestroy()

THIS METHOD IS NOT PART OF THE WICKET PUBLIC API. DO NOT CALL IT.

internalInit

protected void internalInit()

THIS METHOD IS NOT PART OF THE WICKET PUBLIC API. DO NOT OVERRIDE OR CALL. Internal initialization.

newConverterLocator

protected IConverterLocator newConverterLocator()

Creates and returns a new instance of IConverterLocator.

Returns:

A new IConverterLocator instance

newRequestLogger

protected IRequestLogger newRequestLogger()

creates a new request logger when requests logging is enabled.

Returns:

The new request logger

newSessionStore

protected abstract ISessionStore newSessionStore()

Creates a new session facade. Is called once per application, and is typically not something clients reimplement.

Returns:

The session facade

addComponentOnBeforeRenderListener

public final void addComponentOnBeforeRenderListener(IComponentOnBeforeRenderListener listener)

Adds an IComponentOnBeforeRenderListener. This method should typically only be called during application startup; it is not thread safe.

Parameters:

listener -

removeComponentOnBeforeRenderListener

public final void removeComponentOnBeforeRenderListener(IComponentOnBeforeRenderListener listener)

Removes an IComponentOnBeforeRenderListener.

Parameters:

listener -

addComponentOnAfterRenderListener

public final void addComponentOnAfterRenderListener(IComponentOnAfterRenderListener listener)

Adds an IComponentOnAfterRenderListener. This method should typically only be called during application startup; it is not thread safe.

Parameters:

listener -

removeComponentOnAfterRenderListener

public final void removeComponentOnAfterRenderListener(IComponentOnAfterRenderListener listener)

Removes an IComponentOnAfterRenderListener.

Parameters:

listener -

addRenderHeadListener

public final void addRenderHeadListener(IHeaderContributor listener)

Adds a listener that will be invoked for every header response

Parameters:

listener -

removeRenderHeadListener

public void removeRenderHeadListener(IHeaderContributor listener)

Parameters:

listener -

notifyRenderHeadListener

public void notifyRenderHeadListener(IHeaderResponse response)

INTERNAL

Parameters:

response -