org.tentackle.app

Class ServerApplication

java.lang.Object

org.tentackle.app.AbstractApplication

org.tentackle.app.ServerApplication

All Implemented Interfaces:

DomainContextProvider, SessionManagerProvider, SessionPoolProvider, SessionProvider

public abstract class ServerApplication
extends AbstractApplication
implements SessionPoolProvider, SessionManagerProvider

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 DbServer	createDbServer(Class<? extends RemoteDbConnectionImpl> connectionClass) Creates the DbServer instance (but does not start it). The default implementation creates a DbServer.
SessionManager	createSessionManager() Creates the connection manager for the client sessions.
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.
CommandLine	getCommandLine() Gets the command line.
DbServer	getDbServer() Gets the RMI server.
static ServerApplication	getServerApplication() Gets the running server application.
SessionManager	getSessionManager() Gets the connection manager.
SessionPool	getSessionPool()
boolean	isServer()
void	setSessionInfo(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

configurePdoTracker, configureSecurityManager, createDomainContext, createSession, createSessionInfo, 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, opn

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 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 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:

ApplicationException - if creating the DbServer failed

createSessionManager

public SessionManager createSessionManager()

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

Returns:

the connection manager

getSessionManager

public SessionManager getSessionManager()

Gets the connection manager.

Specified by:

getSessionManager in interface SessionManagerProvider

Returns:

the connection manager.

createSessionPool

public 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 SessionPool getSessionPool()

Specified by:

getSessionPool in interface SessionPoolProvider

setSessionInfo

public void setSessionInfo(SessionInfo sessionInfo)

Overwridden to protect the sessioninfo once it is set.

Overrides:

setSessionInfo in class AbstractApplication

doLogin

protected void doLogin()
                throws ApplicationException

Connects the server to the database backend.

Throws:

ApplicationException - if login failed

doFinishStartup

protected void doFinishStartup()
                        throws 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:

ApplicationException - if finish failed

doStartDbServer

protected void doStartDbServer()
                        throws ApplicationException

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

Throws:

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()