com.neurosys.domain

Interface Shell<E>

All Known Implementing Classes:

ContextualWebUserShell, EComUserShell, UserShell, WebUserShell

public interface Shell<E>

A Shell provides an environment context to interact with for a session of engagement.
Any shell must contain a Base level, which cannot be unwrapped, while a Shell can also be wrapped. The shell BEING wrapped is the parent.
Each shell is aware of its parent, but the parent is not aware of the child.

A parent and child share same types of Environments (E). The shells environments can be in isolation or shared depending on the implementation.

Author:

Arjun Dhar

Method Summary

Modifier and Type	Method and Description
<ES extends Shell<E>> ES	extend(Class<ES> extensionType, E e) Extend current shell, and return a new Shell with the current as its inner-shell (or parent()
Shell<E>	get(Class c) Fetch a particular inner Shell based on environment type it uses
E	getEnvironment() Returns the system set context, instance or environment for the current Shell
Shell<E>	parent() Access to a parent (wrapped shell), unless there is no parent (null)
void	setEnvironment(E environment) Returns the system set context, instance or environment for the current Shell

Method Detail

getEnvironment

E getEnvironment()

Returns the system set context, instance or environment for the current Shell

Returns:

E

setEnvironment

void setEnvironment(E environment)

Returns the system set context, instance or environment for the current Shell

parent

Shell<E> parent()
         throws AuthorizationException

Access to a parent (wrapped shell), unless there is no parent (null)

Returns:

S

Throws:

AuthorizationException

Can be null:

true

get

Shell<E> get(Class c)
      throws AuthorizationException

Fetch a particular inner Shell based on environment type it uses

Parameters:

c - as Class of Shell type or Environment looking for. (implementation dependent)

Returns:

Shell

Throws:

AuthorizationException

extend

<ES extends Shell<E>> ES extend(Class<ES> extensionType,
                                E e)

Extend current shell, and return a new Shell with the current as its inner-shell (or parent()

Parameters:

extensionType - as Class of type of shell to return

e - as Environment

Returns:

extended Shell