org.apache.tapestry5.internal.services
Class EnvironmentImpl

java.lang.Object
  org.apache.tapestry5.internal.services.EnvironmentImpl

All Implemented Interfaces:

EventListener, ThreadCleanupListener, Environment

public class EnvironmentImpl
extends Object
implements Environment, ThreadCleanupListener

A non-threadsafe implementation (expects to use the "perthread" service lifecyle).

Constructor Summary

EnvironmentImpl()

Method Summary

void	clear() Clears all stacks; no longer used by Tapestry.
void	cloak() Hides all current environment values, making the Environment object appear empty, until a call to Environment.decloak()} restores the original state.
void	decloak() Restores state previously hidden by Environment.cloak()}.
<T> T	peek(Class<T> type) Peeks at the current top of the indicated stack.
<T> T	peekRequired(Class<T> type) Peeks at the current top of the indicated stack (which must have a non-null value).
<T> T	pop(Class<T> type) Removes and returns the top environmental object of the selected type.
<T> T	push(Class<T> type, T instance) Pushes a new service onto the stack.
void	threadDidCleanup() Invoked by PerthreadManager service when a thread performs and end-of-request cleanup.

Methods inherited from class java.lang.Object

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

Constructor Detail

EnvironmentImpl

public EnvironmentImpl()

Method Detail

peek

public <T> T peek(Class<T> type)

Description copied from interface: Environment

Peeks at the current top of the indicated stack.

Specified by:

peek in interface Environment

Type Parameters:

T - the type of environmental object

Parameters:

type - class used to select the object

Returns:

the current object of that type, or null if no service of that type has been added

peekRequired

public <T> T peekRequired(Class<T> type)

Description copied from interface: Environment

Peeks at the current top of the indicated stack (which must have a non-null value).

Specified by:

peekRequired in interface Environment

Type Parameters:

T - the type of environmental object

Parameters:

type - class used to select the object

Returns:

the current object of the specified type

pop

public <T> T pop(Class<T> type)

Description copied from interface: Environment

Removes and returns the top environmental object of the selected type.

Specified by:

pop in interface Environment

Type Parameters:

T - the type of environmental object

Parameters:

type - class used to select the object

Returns:

the object just removed

push

public <T> T push(Class<T> type,
                  T instance)

Description copied from interface: Environment

Pushes a new service onto the stack. The old service at the top of the stack is returned (it may be null).

Specified by:

push in interface Environment

Type Parameters:

T - the type of environmental object

Parameters:

type - class used to select the object

instance - the service object

Returns:

the previous top service

clear

public void clear()

Description copied from interface: Environment

Clears all stacks; no longer used by Tapestry.

Specified by:

clear in interface Environment

threadDidCleanup

public void threadDidCleanup()

Description copied from interface: ThreadCleanupListener

Invoked by PerthreadManager service when a thread performs and end-of-request cleanup.

Specified by:

threadDidCleanup in interface ThreadCleanupListener

cloak

public void cloak()

Description copied from interface: Environment

Hides all current environment values, making the Environment object appear empty, until a call to Environment.decloak()} restores the original state.

Specified by:

cloak in interface Environment

decloak

public void decloak()

Description copied from interface: Environment

Restores state previously hidden by Environment.cloak()}.

Specified by:

decloak in interface Environment