com.esf.core.system.manager.service
Interface ISystemManagerService

public interface ISystemManagerService

Service to provide basic system information including Operating System information, JVM information, and filesystem information. This service is also used to load bundles within ESF. This service is directly tied to the ESF configuration directory level services.xml file that is used to provide information to this service with regard to what bundles to load. An example services.xml file is provided with this package. Any services referenced within that file will be loaded at startup of ESF along with their dependencies.

Field Summary

static java.lang.String

SERVICE_NAME Reports the class name representing this interface.

Method Summary

java.util.ArrayList	getComPorts() gets the complete list of COM ports based on the configuration
java.lang.String	getEsfBaseBundleDirectory() gets the location where the ESF base bundle directory is.
java.lang.String	getEsfConfigDirectory() gets the location where all ESF specific non-volatile configuration files and bundle specific files are stored.
java.lang.String	getEsfHome() gets the location where the ESF root directory is stored in the filesystem
java.util.ArrayList	getEthernetInterfaces() gets the complete list of ethernet interfaces based on the configuration
java.lang.String	getFileSeparator() gets the system file separator used by the filesystem
java.lang.String	getJavaHome() gets the location where the JVM is stored in the filesystem
java.lang.String	getJavaProfile() gets the Java Virtual Machine profile that is currently being used
java.lang.String	getJavaVmName() gets the Java Virtual Machine name that is currently being used
java.lang.String	getJavaVmVersion() gets the Java Virtual Machine version that is currently being used
java.lang.String	getOsArch() gets the Operating System architecture for the system
java.lang.String	getOsDistro() gets the Operating System Distribution name if appropriate
java.lang.String	getOsDistroVersion() gets the Operating System Distribution version if appropriate
java.lang.String	getOsName() gets the Operating System name for the system
java.lang.String	getOsVersion() gets the Operating System version for the system
java.lang.String	getPlatform() /** gets the platform name ESF is running on.
java.lang.String	getTemporaryConfigDirectory() gets the location where all volatile ESF specific configuration and status information should be stored.

Field Detail

SERVICE_NAME

public static final java.lang.String SERVICE_NAME

Reports the class name representing this interface.

Method Detail

getPlatform

public java.lang.String getPlatform()
                             throws java.lang.Exception

/** gets the platform name ESF is running on. This could be catalyst, duracor1200, helios, isis, proteus, etc

Returns:

the platform name

Throws:

java.lang.Exception - if the platform is undefined or can not be determined

getOsArch

public java.lang.String getOsArch()

gets the Operating System architecture for the system

Returns:

the Operating System architecture as defined by the Java System property os.arch

getOsName

public java.lang.String getOsName()

gets the Operating System name for the system

Returns:

the Operating System name as defined by the Java System property os.name

getOsVersion

public java.lang.String getOsVersion()

gets the Operating System version for the system

Returns:

the Operating System version as defined by the Java System property os.version

getOsDistro

public java.lang.String getOsDistro()
                             throws java.lang.Exception

gets the Operating System Distribution name if appropriate

Returns:

a String representing the Operating System Distribution name if appropriate

Throws:

java.lang.Exception - if the Distribution name is undefined or not applicable

getOsDistroVersion

public java.lang.String getOsDistroVersion()
                                    throws java.lang.Exception

gets the Operating System Distribution version if appropriate

Returns:

a String representing the Operating System Distribution version if appropriate

Throws:

java.lang.Exception - if the Distribution version is undefined or not applicable

getJavaVmName

public java.lang.String getJavaVmName()

gets the Java Virtual Machine name that is currently being used

Returns:

the Java Virtual Machine name as defined by the Java System property java.vm.name

getJavaVmVersion

public java.lang.String getJavaVmVersion()

gets the Java Virtual Machine version that is currently being used

Returns:

the Java Virtual Machine version as defined by the Java System property java.vm.version

getJavaProfile

public java.lang.String getJavaProfile()

gets the Java Virtual Machine profile that is currently being used

Returns:

the Java Virtual Machine profile currently being used

getFileSeparator

public java.lang.String getFileSeparator()

gets the system file separator used by the filesystem

Returns:

the system file separator used by the system

getJavaHome

public java.lang.String getJavaHome()

gets the location where the JVM is stored in the filesystem

Returns:

the location of the root JVM directory

getEsfHome

public java.lang.String getEsfHome()

gets the location where the ESF root directory is stored in the filesystem

Returns:

the root ESF directory

getEsfBaseBundleDirectory

public java.lang.String getEsfBaseBundleDirectory()

gets the location where the ESF base bundle directory is. This is the location where all ESF specific bundles are stored in the filesystem.

Returns:

the root ESF base bundle directory

getEsfConfigDirectory

public java.lang.String getEsfConfigDirectory()

gets the location where all ESF specific non-volatile configuration files and bundle specific files are stored. The convention is for each bundle that has filesystem dependencies is for those filesystem components to be stored in the configuration directory root followed by a file seperator followed by the project name that needs some configuration. This will keep seperate configuration components tied to their appropriate projects.

Returns:

the location of the ESF configuration directory root

getTemporaryConfigDirectory

public java.lang.String getTemporaryConfigDirectory()

gets the location where all volatile ESF specific configuration and status information should be stored. The convention is for each bundle that has filesystem dependencies is for those filesystem components to be stored in the configuration directory root followed by a file seperator followed by the project name that needs some configuration. This will keep seperate configuration components tied to their appropriate projects.

Returns:

the location of the volatile ESF configuration and status directory root

getEthernetInterfaces

public java.util.ArrayList getEthernetInterfaces()
                                          throws java.lang.Exception

gets the complete list of ethernet interfaces based on the configuration

Returns:

an ArrayList of Strings defining the Ethernet Interfaces onboard.

Throws:

java.lang.Exception - if the platform is undefined or can not be determined

getComPorts

public java.util.ArrayList getComPorts()
                                throws java.lang.Exception

gets the complete list of COM ports based on the configuration

Returns:

an ArrayList of Strings defining the COM ports onboard

Throws:

java.lang.Exception - if the platform is undefined or can not be determined