Class AbstractServer<S extends AbstractServer<S>>

java.lang.Object

ch.nolix.base.net.clientserver.AbstractServer<S>

Type Parameters:

S - the type of a AbstractServer.

All Implemented Interfaces:

Clearable, EmptinessRequestable, Server<S>, SecurityModeHolder, ApplicationManager<Application<?,?>>, Closeable, GroupCloseable, OpennessRequestable, AutoCloseable

Direct Known Subclasses:

LocalServer, Server, SslServer

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

A AbstractServer can contain AbstractApplications. A AbstractServer is closable.

Author:

Silvan Wyss

Constructor Summary

Constructors

Constructor	Description
AbstractServer()

Method Summary

Modifier and Type	Method	Description
final S	addApplication(Application<?,?> application)	Adds the given application to the current Server.
final S	addApplicationWithNameAddendum(AbstractApplication<?,?> 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 AbstractApplication 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 AbstractApplication with the given name, initialSessionClass and a void context to the current AbstractServer.
<C extends BackendClient<T>, T> S	addDefaultApplication(Application<C,T> defaultApplication)	Adds the given defaultApplication to the current Server.
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 AbstractApplication 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 AbstractApplication with the given name, initialSessionClass and a void context as default AbstractApplication the current AbstractServer.
final void	clear()	Removes the elements of the current Clearable.
final boolean	containsApplicationWithName(String name)
final boolean	containsDefaultApplication()
final AbstractApplication<?,?>	getStoredApplicationByInstanceName(String instanceName)
final AbstractApplication<?,?>	getStoredApplicationByUrlInstanceName(String urlInstanceName)
final ExtendedIterable<? extends Application<?,?>>	getStoredApplications()
final ICloseController	getStoredCloseController()
final AbstractApplication<?,?>	getStoredDefaultApplication()
final boolean	hasClientConnected()
final boolean	isEmpty()
final void	noteClose()	Lets the current GroupCloseable note a close.
final void	removeApplicationWithInstanceName(String instanceName)	Removes the Application with the given instanceName from the current Server.
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 EmptinessRequestable

containsAny

Methods inherited from interface GroupCloseable

close, createCloseDependencyTo, isClosed

Methods inherited from interface OpennessRequestable

isOpen

Methods inherited from interface SecurityModeHolder

getSecurityMode

Methods inherited from interface Server

asTarget

Constructor Details

AbstractServer

public AbstractServer()

Method Details

addApplication

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

Adds the given application to the current Server.

Specified by:

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

Parameters:

application -

Returns:

the current Server

addApplicationWithNameAddendum

public final S addApplicationWithNameAddendum(AbstractApplication<?,?> 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 AbstractApplication 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 AbstractApplication with the given instanceName, initialSessionClass and applicationService to the current AbstractServer.

Type Parameters:

T - the type of the given initialSessionClass

C - the type of the AbstractBackendClient of the given initialSessionClass

U - 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 AbstractApplication 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 AbstractApplication with the given name, initialSessionClass and a void context to the current AbstractServer.

Type Parameters:

T - the type of the given initialSessionClass

C - 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 AbstractApplication with an instanceName that equals the given name

RuntimeException - if the given initialSessionClass is null

addDefaultApplication

public <C extends BackendClient<T>, T> S addDefaultApplication(Application<C,T> defaultApplication)

Adds the given defaultApplication to the current Server.

Specified by:

addDefaultApplication in interface Server<S extends AbstractServer<S>>

Type Parameters:

C - the type of the BackendClient of the given defaultApplication

T - the type of the application context of the given defaultApplication

Parameters:

defaultApplication -

Returns:

the current Server

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 AbstractApplication with the given name, initialSessionClass and applicationService to the current AbstractServer.

Type Parameters:

T - the type of the given initialSessionClass

C - the type of the AbstractBackendClient of the given initialSessionClass

U - 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 AbstractApplication

RuntimeException - if the current AbstractServer contains already a AbstractApplication 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 AbstractApplication with the given name, initialSessionClass and a void context as default AbstractApplication the current AbstractServer.

Type Parameters:

T - the type of the given initialSessionClass

C - 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 AbstractApplication 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 AbstractApplication, false otherwise

containsApplicationWithName

public final boolean containsApplicationWithName(String name)

Parameters:

name -

Returns:

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

getStoredApplicationByInstanceName

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

Parameters:

instanceName -

Returns:

the AbstractApplication with the given instanceName from the current AbstractServer

Throws:

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

getStoredApplicationByUrlInstanceName

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

Parameters:

urlInstanceName -

Returns:

the AbstractApplication with the given urlInstanceName from the current AbstractServer

Throws:

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

getStoredApplications

public final ExtendedIterable<? extends Application<?,?>> getStoredApplications()

Specified by:

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

Returns:

the applications of the current ApplicationManager

getStoredCloseController

public final ICloseController getStoredCloseController()

Specified by:

getStoredCloseController in interface GroupCloseable

Returns:

the ICloseController of the current GroupCloseable.

getStoredDefaultApplication

public final AbstractApplication<?,?> getStoredDefaultApplication()

Returns:

the default AbstractApplication of the current AbstractServer

Throws:

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

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 Application with the given instanceName from the current Server.

Specified by:

removeApplicationWithInstanceName in interface Server<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 AbstractApplication

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