org.ow2.jonas.lib.jmbeans
Class J2EEServer

java.lang.Object
  org.ow2.jonas.lib.management.javaee.ManagedObject
      org.ow2.jonas.lib.management.javaee.J2EEManagedObject
          org.ow2.jonas.lib.jmbeans.J2EEServer

All Implemented Interfaces:

java.util.EventListener, javax.management.MBeanRegistration, javax.management.NotificationListener, J2EEServerService

public class J2EEServer
extends J2EEManagedObject
implements J2EEServerService, javax.management.NotificationListener, javax.management.MBeanRegistration

The JSR77 J2EEServer MBean implementation. Implement the StateManagement and Events specified in the JSR77.

Author:

Adriana.Danes@bull.net, Francois Fornaciari

Field Summary

static java.lang.String

DEPL_EXTENSION file extension containing a deployment plan

Fields inherited from class org.ow2.jonas.lib.management.javaee.J2EEManagedObject

J2EE_TYPE_APPLICATION, J2EE_TYPE_SERVER, NAME

Constructor Summary

J2EEServer()
MBean constructor.

Method Summary

void	addJavaVM(java.lang.String objectName) Add an object name to the javaVMs list.
void	bindVersioningService(VersioningService versioningService)
void	deploy(java.lang.String fileName) Deploy a file to a local deployer.
java.lang.String	distribute(java.lang.String fileName, byte[] fileContent) Dump the given bytes to a local file and then return the path to this file.
java.util.Properties	getConfigFileEnv()
long	getCurrentTotalMemory()
long	getCurrentUsedMemory()
protected org.ow2.util.ee.deploy.api.deployable.IDeployable	getDeployable(java.lang.String fileName) Convert a ready to deploy file to a deployable object.
java.util.ArrayList<java.lang.String>	getDeployableEars()
java.util.ArrayList<java.lang.String>	getDeployableFiles()
java.util.ArrayList<java.lang.String>	getDeployableJars()
java.util.ArrayList<java.lang.String>	getDeployableRars()
java.util.ArrayList<java.lang.String>	getDeployableWars()
java.util.ArrayList<java.lang.String>	getDeployedEars()
java.util.ArrayList<java.lang.String>	getDeployedFiles()
java.util.ArrayList<java.lang.String>	getDeployedJars()
java.util.List<java.lang.String>	getDeployedObjects()
java.util.ArrayList<java.lang.String>	getDeployedRars()
java.util.ArrayList<java.lang.String>	getDeployedWars()
java.lang.String	getDomainName()
java.lang.String[]	getEventTypes()
java.lang.String[]	getJavaVMs()
java.lang.String	getJonasBase()
java.lang.String	getJonasRoot()
java.lang.String	getJvmInfos()
java.lang.String	getProtocols()
int	getRange()
java.util.List<java.lang.String>	getResources()
java.lang.String	getServerName()
java.lang.String	getServerVendor()
java.lang.String	getServerVersion()
java.lang.String	getServiceDescription(java.lang.String service) Get a service description.
java.util.List<java.lang.String>	getServices() Return the all the services names, whatever their state is.
java.lang.String	getServiceState(java.lang.String service) Get a service state.
int	getSizeTableMeasures()
long	getStartTime()
J2EEServerState	getState()
java.lang.Long[]	getTableMeasures()
java.lang.String	getThreadStackDump() Return a JVM thread stack dump.
javax.management.openmbean.TabularData	getThreadStackDumpList() Return a TabularData containing a JVM thread stack dump.
TimerManager	getTimerManager()
java.lang.String	getUploadDirectory() Get the directory in which J2EEServer uploads files
long	getUptime()
java.lang.String	getVersions()
void	halt() Halt the server.
void	handleNotification(javax.management.Notification notification, java.lang.Object handback) Treat JMX notifications.
boolean	isActivated()
boolean	isDeployed(java.lang.String fileName)
boolean	isFailed()
boolean	isRunning()
boolean	isStarting()
boolean	isStopped()
boolean	isStopping()
static java.lang.String	jvmInfos()
void	logThreadStackDump() Log a JVM thread stack dump in JOnAS log file (level : info).
void	postDeregister()
void	postRegister(java.lang.Boolean registrationDone) After registering, add myself as listener to notifications emitted by: - the MBeanServerDelegate (to receive JMX registration/un-registration notifications).
void	preDeregister()
javax.management.ObjectName	preRegister(javax.management.MBeanServer server, javax.management.ObjectName name)
void	printThreadStackDump(java.lang.String filename) Print a JVM thread stack dump in a given file.
boolean	removeModuleFile(java.lang.String fileName) Remove a specified J2EE module
void	runGC()
java.lang.String	sendFile(byte[] fileContent, java.lang.String fileName, boolean replaceExisting)
void	setActivated(boolean activated) Set memory monitoring activation.
void	setArchiveManager(org.ow2.util.archive.api.IArchiveManager archiveManager)
void	setConfigManager(ConfigurationManager configManager)
void	setDeployerManager(org.ow2.util.ee.deploy.api.deployer.IDeployerManager deployerManager)
void	setEasyBeansService(IEasyBeansService easyBeansService)
void	setFailed()
void	setRange(int range)
void	setRegistryService(RegistryService registryService)
void	setRepositoryManager(org.ow2.util.plan.repository.api.IRepositoryManager repositoryManager) Set the repository manager used by this service.
void	setRunning()
void	setServerProperties(ServerProperties serverProperties)
void	setServiceManager(ServiceManager serviceManager)
void	setSizeTableMeasures(int sizeTableMeasures)
void	setStarting()
void	setStopped()
void	setStopping()
void	setTimerManager(TimerManager timerManager)
void	start() Start the server by starting all the non-mandatory services.
void	start(boolean standby) Start the server by starting all the non-mandatory services.
void	startJ2EEServer()
void	startRecursive(boolean standby) Start recursive.
void	startService(java.lang.String service) Start a service.
void	stop() Stop the server by stopping all the non-mandatory services.
void	stopService(java.lang.String service) Stop a service.
void	unbindVersioningService() Sets the versioning service to null.
void	undeploy(java.lang.String fileName) Undeploy a file from a local deployer.

Methods inherited from class org.ow2.jonas.lib.management.javaee.J2EEManagedObject

getObjectName, isEventProvider, isStateManageable, isStatisticsProvider, setEventProvider, setObjectName, setStateManageable, setStatisticsProvider

Methods inherited from class org.ow2.jonas.lib.management.javaee.ManagedObject

getModelMBean, sendNotification, sendReconfigNotification, sendSaveNotification, setModelMBean

Methods inherited from class java.lang.Object

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

Field Detail

DEPL_EXTENSION

public static final java.lang.String DEPL_EXTENSION

file extension containing a deployment plan

See Also:

Constant Field Values

Constructor Detail

J2EEServer

public J2EEServer()

MBean constructor.

Method Detail

startJ2EEServer

public void startJ2EEServer()
                     throws java.lang.Exception

Throws:

java.lang.Exception

getEventTypes

public java.lang.String[] getEventTypes()

getStartTime

public long getStartTime()

getUptime

public long getUptime()

Returns:

the uptime of the server (in ms)

getServerVendor

public java.lang.String getServerVendor()

getServerVersion

public java.lang.String getServerVersion()

getServerName

public java.lang.String getServerName()

getJonasBase

public java.lang.String getJonasBase()

Returns:

jonas.base

getJonasRoot

public java.lang.String getJonasRoot()

Returns:

jonas.root

getProtocols

public java.lang.String getProtocols()

getVersions

public java.lang.String getVersions()

isActivated

public boolean isActivated()

setActivated

public void setActivated(boolean activated)

Set memory monitoring activation.

Parameters:

activated -

getCurrentUsedMemory

public long getCurrentUsedMemory()

getCurrentTotalMemory

public long getCurrentTotalMemory()

getRange

public int getRange()

setRange

public void setRange(int range)

getSizeTableMeasures

public int getSizeTableMeasures()

setSizeTableMeasures

public void setSizeTableMeasures(int sizeTableMeasures)

getTableMeasures

public java.lang.Long[] getTableMeasures()

getResources

public java.util.List<java.lang.String> getResources()

Returns:

The resources list.

getDeployedObjects

public java.util.List<java.lang.String> getDeployedObjects()

Returns:

The deployed list.

getDomainName

public java.lang.String getDomainName()

Returns:

The current domain name.

getJavaVMs

public java.lang.String[] getJavaVMs()

Returns:

the list of MBean names corresponding to the JVMs on which this server has running threads

addJavaVM

public void addJavaVM(java.lang.String objectName)

Add an object name to the javaVMs list.

Parameters:

objectName - Object name corresponding to a JVM MBean

bindVersioningService

public void bindVersioningService(VersioningService versioningService)

Parameters:

versioningService - The versioning service to set.

unbindVersioningService

public void unbindVersioningService()

Sets the versioning service to null.

start

public void start()
           throws java.lang.Exception

Start the server by starting all the non-mandatory services.

Throws:

java.lang.Exception

start

public void start(boolean standby)
           throws java.lang.Exception

Start the server by starting all the non-mandatory services.

Parameters:

standby - true to activate standby mode.

Throws:

java.lang.Exception - any.

startRecursive

public void startRecursive(boolean standby)
                    throws java.lang.Exception

Start recursive. Check if standby mode is enabled.

Parameters:

standby - true to activate standby mode.

Throws:

java.lang.Exception - any.

stop

public void stop()
          throws java.lang.Exception

Stop the server by stopping all the non-mandatory services.

Throws:

java.lang.Exception

halt

public void halt()
          throws java.lang.Exception

Halt the server.

Throws:

java.lang.Exception

handleNotification

public void handleNotification(javax.management.Notification notification,
                               java.lang.Object handback)

Treat JMX notifications.

Specified by:

handleNotification in interface javax.management.NotificationListener

Parameters:

notification - received notification

handback - hand back object

postDeregister

public void postDeregister()

Specified by:

postDeregister in interface javax.management.MBeanRegistration

postRegister

public void postRegister(java.lang.Boolean registrationDone)

After registering, add myself as listener to notifications emitted by: - the MBeanServerDelegate (to receive JMX registration/un-registration notifications).

Specified by:

postRegister in interface javax.management.MBeanRegistration

preDeregister

public void preDeregister()
                   throws java.lang.Exception

Specified by:

preDeregister in interface javax.management.MBeanRegistration

Throws:

java.lang.Exception

preRegister

public javax.management.ObjectName preRegister(javax.management.MBeanServer server,
                                               javax.management.ObjectName name)
                                        throws java.lang.Exception

Specified by:

preRegister in interface javax.management.MBeanRegistration

Throws:

java.lang.Exception

setStarting

public void setStarting()

Specified by:

setStarting in interface J2EEServerService

jvmInfos

public static java.lang.String jvmInfos()

Returns:

information on JVM currently used

setRunning

public void setRunning()

Specified by:

setRunning in interface J2EEServerService

setStopping

public void setStopping()

Specified by:

setStopping in interface J2EEServerService

setStopped

public void setStopped()

Specified by:

setStopped in interface J2EEServerService

setFailed

public void setFailed()

Specified by:

setFailed in interface J2EEServerService

getState

public J2EEServerState getState()

isStarting

public boolean isStarting()

Specified by:

isStarting in interface J2EEServerService

isRunning

public boolean isRunning()

Specified by:

isRunning in interface J2EEServerService

isFailed

public boolean isFailed()

Specified by:

isFailed in interface J2EEServerService

isStopping

public boolean isStopping()

Specified by:

isStopping in interface J2EEServerService

isStopped

public boolean isStopped()

Specified by:

isStopped in interface J2EEServerService

setDeployerManager

public void setDeployerManager(org.ow2.util.ee.deploy.api.deployer.IDeployerManager deployerManager)

Parameters:

deployerManager - reference to the deployerManager

setRepositoryManager

public void setRepositoryManager(org.ow2.util.plan.repository.api.IRepositoryManager repositoryManager)

Set the repository manager used by this service.

Parameters:

repositoryManager - the new repository manager.

setArchiveManager

public void setArchiveManager(org.ow2.util.archive.api.IArchiveManager archiveManager)

Parameters:

archiveManager - reference to the archiveManager

setServiceManager

public void setServiceManager(ServiceManager serviceManager)

Parameters:

serviceManager - reference to the serviceManager

deploy

public void deploy(java.lang.String fileName)

Deploy a file to a local deployer.

Parameters:

fileName - the name of the file to deploy

undeploy

public void undeploy(java.lang.String fileName)

Undeploy a file from a local deployer.

Parameters:

fileName - the name of the file to undeploy

getDeployable

protected org.ow2.util.ee.deploy.api.deployable.IDeployable getDeployable(java.lang.String fileName)

Convert a ready to deploy file to a deployable object.

Parameters:

fileName - the name of the file

Returns:

the deployable object

isDeployed

public boolean isDeployed(java.lang.String fileName)
                   throws java.lang.Exception

Throws:

java.lang.Exception

getJvmInfos

public java.lang.String getJvmInfos()

runGC

public void runGC()
           throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

getConfigFileEnv

public java.util.Properties getConfigFileEnv()

setConfigManager

public void setConfigManager(ConfigurationManager configManager)

getTimerManager

public TimerManager getTimerManager()

setTimerManager

public void setTimerManager(TimerManager timerManager)

setServerProperties

public void setServerProperties(ServerProperties serverProperties)

setRegistryService

public void setRegistryService(RegistryService registryService)

setEasyBeansService

public void setEasyBeansService(IEasyBeansService easyBeansService)

getDeployableFiles

public java.util.ArrayList<java.lang.String> getDeployableFiles()

getDeployableJars

public java.util.ArrayList<java.lang.String> getDeployableJars()

getDeployableEars

public java.util.ArrayList<java.lang.String> getDeployableEars()

getDeployableWars

public java.util.ArrayList<java.lang.String> getDeployableWars()

getDeployableRars

public java.util.ArrayList<java.lang.String> getDeployableRars()

getDeployedWars

public java.util.ArrayList<java.lang.String> getDeployedWars()
                                                      throws java.lang.Exception

Returns:

List of deployed WAR files.

Throws:

java.lang.NullPointerException

javax.management.MalformedObjectNameException

javax.management.ReflectionException

javax.management.MBeanException

javax.management.InstanceNotFoundException

javax.management.AttributeNotFoundException

java.lang.Exception

getDeployedJars

public java.util.ArrayList<java.lang.String> getDeployedJars()
                                                      throws java.lang.Exception

Returns:

List of deployed JAR files.

Throws:

java.lang.Exception

getDeployedRars

public java.util.ArrayList<java.lang.String> getDeployedRars()
                                                      throws java.lang.Exception

Returns:

List of deployed RAR files.

Throws:

java.lang.Exception

getDeployedEars

public java.util.ArrayList<java.lang.String> getDeployedEars()
                                                      throws java.lang.Exception

Returns:

List of deployed EAR files.

Throws:

java.lang.Exception

getDeployedFiles

public java.util.ArrayList<java.lang.String> getDeployedFiles()
                                                       throws java.lang.Exception

Throws:

java.lang.Exception

sendFile

public java.lang.String sendFile(byte[] fileContent,
                                 java.lang.String fileName,
                                 boolean replaceExisting)
                          throws java.lang.Exception

Throws:

java.lang.Exception

distribute

public java.lang.String distribute(java.lang.String fileName,
                                   byte[] fileContent)
                            throws java.lang.Exception

Dump the given bytes to a local file and then return the path to this file.

Parameters:

fileName - the name of the file to distribute

fileContent - the content of the given file

Returns:

the path of the distributed file

Throws:

java.lang.Exception

removeModuleFile

public boolean removeModuleFile(java.lang.String fileName)
                         throws java.lang.Exception

Remove a specified J2EE module

Parameters:

fileName - Name of file to remove

Returns:

true if file has been removed

Throws:

java.lang.Exception - if remove fails

getUploadDirectory

public java.lang.String getUploadDirectory()

Get the directory in which J2EEServer uploads files

Specified by:

getUploadDirectory in interface J2EEServerService

Returns:

directory in which J2EEServer uploads files

getServices

public java.util.List<java.lang.String> getServices()

Return the all the services names, whatever their state is.

Returns:

list of services names.

getServiceDescription

public java.lang.String getServiceDescription(java.lang.String service)

Get a service description.

Parameters:

service - the service name.

Returns:

the service description

getServiceState

public java.lang.String getServiceState(java.lang.String service)

Get a service state.

Parameters:

service - the service name.

Returns:

the service state.

startService

public void startService(java.lang.String service)
                  throws java.lang.Exception

Start a service.

Parameters:

service - the service name.

Throws:

java.lang.Exception - If the startup of the service fails

stopService

public void stopService(java.lang.String service)
                 throws java.lang.Exception

Stop a service.

Parameters:

service - the service name.

Throws:

java.lang.Exception - If the stop of the service fails

getThreadStackDump

public java.lang.String getThreadStackDump()

Return a JVM thread stack dump.

Returns:

A String containing the thread stack dump

printThreadStackDump

public void printThreadStackDump(java.lang.String filename)

Print a JVM thread stack dump in a given file.

Parameters:

filename - the file name

logThreadStackDump

public void logThreadStackDump()

Log a JVM thread stack dump in JOnAS log file (level : info).

getThreadStackDumpList

public javax.management.openmbean.TabularData getThreadStackDumpList()

Return a TabularData containing a JVM thread stack dump.

Returns:

A TabularData containing the thread stack dump