Class AbstractServer<S extends AbstractServer<S>>

java.lang.Object

ch.nolix.system.application.main.AbstractServer<S>

Type Parameters:

S - is the type of a AbstractServer.

All Implemented Interfaces:

IApplicationManager<IApplication<?,?>>, ISecuriyModeHolder, Closeable, CloseStateRequestable, GroupCloseable, Clearable, EmptinessRequestable, IServer<S>, AutoCloseable

Direct Known Subclasses:

LocalServer, Server, SslServer

public abstract class AbstractServer<S extends AbstractServer<S>>
extends Object
implements IServer<S>

A AbstractServer can contain Applications. A AbstractServer is closable.

Author:

Silvan Wyss

Constructor Summary

Constructors

Constructor	Description
AbstractServer()

Method Summary

Modifier and Type	Method	Description
final S	addApplication(IApplication<?,?> application)	Adds the given application to the current IServer.
final S	addApplicationWithNameAddendum(Application<?,?> application, String nameAddendum)	Adds the given application with the given instanceName to the current AbstractServer.
final <T extends AbstractSession<C,U>, C extends AbstractBackendClient<C,U>, U> S	addApplicationWithNameAndInitialSessionClassAndContext(String applicationName, Class<T> initialSessionClass, U applicationService)	Adds a new Application with the given instanceName, initialSessionClass and applicationService to the current AbstractServer.
final <T extends AbstractSession<C,Object>, C extends AbstractBackendClient<C,Object>> S	addApplicationWithNameAndInitialSessionClassAndVoidContext(String name, Class<T> initialSessionClass)	Adds a new Application with the given name, initialSessionClass and a void context to the current AbstractServer.
final <C extends AbstractBackendClient<C,U>, U> S	addDefaultApplication(Application<C,U> defaultApplication)	Adds the given defaultApplication to the current AbstractServer.
final <T extends AbstractSession<C,U>, C extends AbstractBackendClient<C,U>, U> S	addDefaultApplicationWithNameAndInitialSessionClassAndContext(String applicationName, Class<T> initialSessionClass, U applicationService)	Adds a new default Application with the given name, initialSessionClass and applicationService to the current AbstractServer.
final <T extends AbstractSession<C,Object>, C extends AbstractBackendClient<C,Object>> S	addDefaultApplicationWithNameAndInitialSessionClassAndVoidContext(String name, Class<T> initialSessionClass)	Adds a new Application with the given name, initialSessionClass and a void context as default Application the current AbstractServer.
final void	clear()	Removes the elements of the current Clearable.
final boolean	containsApplicationWithName(String name)
final boolean	containsDefaultApplication()
final Application<?,?>	getStoredApplicationByInstanceName(String instanceName)
final Application<?,?>	getStoredApplicationByUrlInstanceName(String urlInstanceName)
final IContainer<? extends IApplication<?,?>>	getStoredApplications()
final ICloseController	getStoredCloseController()
final Application<?,?>	getStoredDefaultApplication()
final boolean	hasClientConnected()
final boolean	isEmpty()
final void	noteClose()	Lets the current GroupCloseable note a close.
final void	removeApplicationWithInstanceName(String instanceName)	Removes the IApplication with the given instanceName from the current IServer.
final void	takeClient(AbstractBackendClient<?,?> client)	Lets the current AbstractServer take the given client.

Methods inherited from class Object

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

Methods inherited from interface CloseStateRequestable

isOpen

Methods inherited from interface EmptinessRequestable

containsAny

Methods inherited from interface GroupCloseable

close, createCloseDependencyTo, isClosed

Methods inherited from interface ISecuriyModeHolder

getSecurityMode

Methods inherited from interface IServer

asTarget

Constructor Details

AbstractServer

public AbstractServer()

Method Details

addApplication

public final S addApplication(IApplication<?,?> application)

Adds the given application to the current IServer.

Specified by:

addApplication in interface IServer<S extends AbstractServer<S>>

Parameters:

application -

Returns:

the current IServer.

addApplicationWithNameAddendum

public final S addApplicationWithNameAddendum(Application<?,?> application,
 String nameAddendum)

Adds the given application with the given instanceName to the current AbstractServer.

Parameters:

application -

nameAddendum -

Returns:

the current AbstractServer.

Throws:

RuntimeException - if the given application is null.

RuntimeException - if the given application belongs already to a AbstractServer.

RuntimeException - if the given instanceName is null

RuntimeException - if the given instanceName is blank.

RuntimeException - if the current AbstractServer contains already a Application with the given instanceName.

addApplicationWithNameAndInitialSessionClassAndContext

public final <T extends AbstractSession<C,U>, C extends AbstractBackendClient<C,U>, U>
S addApplicationWithNameAndInitialSessionClassAndContext(String applicationName,
 Class<T> initialSessionClass,
 U applicationService)

Adds a new Application with the given instanceName, initialSessionClass and applicationService to the current AbstractServer.

Type Parameters:

T - is the type of the given initialSessionClass.

C - is the type of the AbstractBackendClient of the given initialSessionClass.

U - is the type of the given applicationService.

Parameters:

applicationName -

initialSessionClass -

applicationService -

Returns:

the current AbstractServer.

Throws:

RuntimeException - if the given instanceName is null.

RuntimeException - if the given instanceName is blank.

RuntimeException - if the current AbstractServer contains already a Application with the given instanceName.

RuntimeException - if the given initialSessionClass is null.

addApplicationWithNameAndInitialSessionClassAndVoidContext

public final <T extends AbstractSession<C,Object>, C extends AbstractBackendClient<C,Object>>
S addApplicationWithNameAndInitialSessionClassAndVoidContext(String name,
 Class<T> initialSessionClass)

Adds a new Application with the given name, initialSessionClass and a void context to the current AbstractServer.

Type Parameters:

T - is the type of the given initialSessionClass.

C - is the type of the AbstractBackendClient of the given initialSessionClass.

Parameters:

name -

initialSessionClass -

Returns:

the current AbstractServer.

Throws:

RuntimeException - if the given name is null.

RuntimeException - if the given name is blank.

RuntimeException - if the current AbstractServer contains already a Application with an instanceName that equals the given name.

RuntimeException - if the given initialSessionClass is null.

addDefaultApplication

public final <C extends AbstractBackendClient<C,U>, U>
S addDefaultApplication(Application<C,U> defaultApplication)

Adds the given defaultApplication to the current AbstractServer. A default Application takes all AbstractClients that do not have a target.

Type Parameters:

C - is the type of the AbstractBackendClient of the given defaultApplication.

U - is the type of the context of the given defaultApplication.

Parameters:

defaultApplication -

Returns:

the current AbstractServer.

Throws:

RuntimeException - if the given defaultApplication is null.

addDefaultApplicationWithNameAndInitialSessionClassAndContext

public final <T extends AbstractSession<C,U>, C extends AbstractBackendClient<C,U>, U>
S addDefaultApplicationWithNameAndInitialSessionClassAndContext(String applicationName,
 Class<T> initialSessionClass,
 U applicationService)

Adds a new default Application with the given name, initialSessionClass and applicationService to the current AbstractServer.

Type Parameters:

T - is the type of the given initialSessionClass.

C - is the type of the AbstractBackendClient of the given initialSessionClass.

U - is the type of the given applicationService.

Parameters:

applicationName -

initialSessionClass -

applicationService -

Returns:

the current AbstractServer.

Throws:

RuntimeException - if the given instanceName is null.

RuntimeException - if the given instanceName is blank.

RuntimeException - if the current AbstractServer contains already a default Application.

RuntimeException - if the current AbstractServer contains already a Application with the given instanceName.

RuntimeException - if the given initialSessionClass is null.

addDefaultApplicationWithNameAndInitialSessionClassAndVoidContext

public final <T extends AbstractSession<C,Object>, C extends AbstractBackendClient<C,Object>>
S addDefaultApplicationWithNameAndInitialSessionClassAndVoidContext(String name,
 Class<T> initialSessionClass)

Adds a new Application with the given name, initialSessionClass and a void context as default Application the current AbstractServer.

Type Parameters:

T - is the type of the given initialSessionClass.

C - is the type of the AbstractBackendClient of the given initialSessionClass.

Parameters:

name -

initialSessionClass -

Returns:

the current AbstractServer.

Throws:

RuntimeException - if the given name is null.

RuntimeException - if the given name is blank.

RuntimeException - if the current AbstractServer contains already a Application with an instanceName that equals the given name.

RuntimeException - if the given initialSessionClass is null.

clear

public final void clear()

Removes the elements of the current Clearable.

Specified by:

clear in interface Clearable

containsDefaultApplication

public final boolean containsDefaultApplication()

Returns:

true if the current AbstractServer contains a default Application, false otherwise.

containsApplicationWithName

public final boolean containsApplicationWithName(String name)

Parameters:

name -

Returns:

true if the current AbstractServer contains a Application with the given name, false otherwise.

getStoredApplicationByInstanceName

public final Application<?,?> getStoredApplicationByInstanceName(String instanceName)

Parameters:

instanceName -

Returns:

the Application with the given instanceName from the current AbstractServer.

Throws:

ArgumentDoesNotHaveAttributeException - if the current AbstractServer does not contain a Application with the given instanceName.

getStoredApplicationByUrlInstanceName

public final Application<?,?> getStoredApplicationByUrlInstanceName(String urlInstanceName)

Parameters:

urlInstanceName -

Returns:

the Application with the given urlInstanceName from the current AbstractServer.

Throws:

ArgumentDoesNotHaveAttributeException - if the current AbstractServer does not contain a Application with the given urlInstanceName.

getStoredApplications

public final IContainer<? extends IApplication<?,?>> getStoredApplications()

Specified by:

getStoredApplications in interface IApplicationManager<S extends AbstractServer<S>>

Returns:

the applications of the current IApplicationManager.

getStoredCloseController

public final ICloseController getStoredCloseController()

Specified by:

getStoredCloseController in interface GroupCloseable

Returns:

the ICloseController of the current GroupCloseable.

getStoredDefaultApplication

public final Application<?,?> getStoredDefaultApplication()

Returns:

the default Application of the current AbstractServer.

Throws:

ArgumentDoesNotHaveAttributeException - if the current AbstractServer does not contain a default Application.

isEmpty

public final boolean isEmpty()

Specified by:

isEmpty in interface EmptinessRequestable

Returns:

true if EmptinessRequestable does not contain an element, false otherwise.

hasClientConnected

public final boolean hasClientConnected()

Returns:

true if the current AbstractServer has a AbstractClient connected, false otherwise.

noteClose

public final void noteClose()

Lets the current GroupCloseable note a close.

Specified by:

noteClose in interface GroupCloseable

removeApplicationWithInstanceName

public final void removeApplicationWithInstanceName(String instanceName)

Removes the IApplication with the given instanceName from the current IServer.

Specified by:

removeApplicationWithInstanceName in interface IServer<S extends AbstractServer<S>>

Parameters:

instanceName -

takeClient

public final void takeClient(AbstractBackendClient<?,?> client)

Lets the current AbstractServer take the given client.

Parameters:

client -

Throws:

ArgumentDoesNotHaveAttributeException - if the given client does not have a target and the current AbstractServer does not contain a default Application.

ArgumentDoesNotHaveAttributeException - if the given client has a target and the current AbstractServer does not contain a Application with a name that equals the given target.