org.tentackle.persist.app

Class ServerApplication

java.lang.Object

org.tentackle.app.AbstractApplication

org.tentackle.persist.app.ServerApplication

All Implemented Interfaces:

ConnectionManagerProvider, DomainContextProvider, org.tentackle.session.SessionPoolProvider, org.tentackle.session.SessionProvider

public abstract class ServerApplication
extends AbstractApplication
implements org.tentackle.session.SessionPoolProvider, ConnectionManagerProvider

Application Server.

Author:

harald

Constructor Summary

Constructors

Constructor and Description
ServerApplication(String name, Class<? extends RemoteDbConnectionImpl> connectionClass) Creates an instance of an application server.

Method Summary

Modifier and Type	Method and Description
protected void	configurePreferences()
protected void	configureSessionInfo(org.tentackle.session.SessionInfo sessionInfo) Configures the session info.
ConnectionManager	createConnectionManager() Creates the connection manager for the client sessions.
protected DbServer	createDbServer(Class<? extends RemoteDbConnectionImpl> connectionClass) Creates the DbServer instance (but does not start it). The default implementation creates a DbServer.
org.tentackle.session.SessionPool	createSessionPool() Creates the logical SessionPool.
protected void	doFinishStartup() Finishes the startup. The default implementation starts the modification thread, unless "--nomodthread" given, creates the connection manager, the Db pool, and the DbServer instance.
protected void	doLogin() Connects the server to the database backend.
protected void	doStartDbServer() Starts the RMI-server.
protected void	doStop(int exitValue) Terminates the application server.
protected void	doStop(int exitValue, Exception ex) Terminates the application server.
org.tentackle.misc.CommandLine	getCommandLine() Gets the command line.
ConnectionManager	getConnectionManager() Gets the connection manager.
DbServer	getDbServer() Gets the RMI server.
static ServerApplication	getServerApplication() Gets the running server application.
org.tentackle.session.SessionPool	getSessionPool()
boolean	isServer()
void	setSessionInfo(org.tentackle.session.SessionInfo sessionInfo)
void	start() Starts the application server without further arguments.
void	start(String[] args) Starts the application server.
void	stop() Gracefully terminates the application server.

Methods inherited from class org.tentackle.app.AbstractApplication

applyProperties, configureModificationTracker, configureSecurityManager, createDomainContext, createSession, createSessionInfo, deregisterJdbcDrivers, detectContainer, detectJNLP, doConfigureApplication, doInitialize, getCreationTime, getDomainContext, getName, getProperties, getProperty, getRunningApplication, getSession, getSessionInfo, getUser, getUser, isDeployedByJNLP, isRunningInContainer, logStackdump, register, setDomainContext, setName, setProperties, toString, unregister, updateSessionInfoAfterLogin

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.tentackle.pdo.DomainContextProvider

on, op

Constructor Detail

ServerApplication

public ServerApplication(String name,
                         Class<? extends RemoteDbConnectionImpl> connectionClass)

Creates an instance of an application server.

Parameters:

name - the application name

connectionClass - the class of the connection object to instantiate, null = default or from serverInfo's properties file

Method Detail

getServerApplication

public static ServerApplication getServerApplication()

Gets the running server application.

Returns:

the application

getCommandLine

public org.tentackle.misc.CommandLine getCommandLine()

Gets the command line.

Returns:

the command line

getDbServer

public DbServer getDbServer()

Gets the RMI server.

Returns:

the RMI dbserver

isServer

public boolean isServer()

Specified by:

isServer in class AbstractApplication

start

public void start(String[] args)

Starts the application server.

Parameters:

args - the arguments (usually from commandline)

start

public void start()

Starts the application server without further arguments.

stop

public void stop()

Gracefully terminates the application server.

configurePreferences

protected void configurePreferences()

Overrides:

configurePreferences in class AbstractApplication

createDbServer

protected DbServer createDbServer(Class<? extends RemoteDbConnectionImpl> connectionClass)
                           throws org.tentackle.misc.ApplicationException

Creates the DbServer instance (but does not start it).
The default implementation creates a DbServer.

Parameters:

connectionClass - the class of the connection object to instantiate, null = default or from serverInfo's properties file

Returns:

the created DbServer

Throws:

org.tentackle.misc.ApplicationException - if creating the DbServer failed

createConnectionManager

public ConnectionManager createConnectionManager()

Creates the connection manager for the client sessions. The default creates an MpxConnectionManager.

Returns:

the connection manager

getConnectionManager

public ConnectionManager getConnectionManager()

Gets the connection manager.

Specified by:

getConnectionManager in interface ConnectionManagerProvider

Returns:

the connection manager.

createSessionPool

public org.tentackle.session.SessionPool createSessionPool()

Creates the logical SessionPool. The default implementation creates a DefaultDbPool.

Returns:

the database pool, null if don't use a pool

getSessionPool

public org.tentackle.session.SessionPool getSessionPool()

Specified by:

getSessionPool in interface org.tentackle.session.SessionPoolProvider

setSessionInfo

public void setSessionInfo(org.tentackle.session.SessionInfo sessionInfo)

Overwridden to protect the sessioninfo once it is set.

Overrides:

setSessionInfo in class AbstractApplication

configureSessionInfo

protected void configureSessionInfo(org.tentackle.session.SessionInfo sessionInfo)

Configures the session info.

Parameters:

sessionInfo - the session info

doLogin

protected void doLogin()
                throws org.tentackle.misc.ApplicationException

Connects the server to the database backend.

Throws:

org.tentackle.misc.ApplicationException - if login failed

doFinishStartup

protected void doFinishStartup()
                        throws org.tentackle.misc.ApplicationException

Finishes the startup.
The default implementation starts the modification thread, unless "--nomodthread" given, creates the connection manager, the Db pool, and the DbServer instance.

Overrides:

doFinishStartup in class AbstractApplication

Throws:

org.tentackle.misc.ApplicationException - if finish failed

doStartDbServer

protected void doStartDbServer()
                        throws org.tentackle.misc.ApplicationException

Starts the RMI-server. The default implementation just does dbServer.start().

Throws:

org.tentackle.misc.ApplicationException - if starting the dbServer failed

doStop

protected void doStop(int exitValue,
                      Exception ex)

Terminates the application server.

Parameters:

exitValue - the doStop value for System.exit()

ex - an exception causing the termination, null if none

doStop

protected void doStop(int exitValue)

Terminates the application server.

Parameters:

exitValue - the doStop value for System.exit()