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


Copyright © 2009 Eurotech Inc. All rights reserved.