psdi.app.system

Class SystemService

java.lang.Object

psdi.server.AppService

psdi.app.system.SystemService

All Implemented Interfaces:

java.rmi.Remote, SystemServiceRemote, MboServerInterface, MaxRemoteProxy, AppServiceRemote, Dependable, Service, ServiceRemote, FixedLoggerNames, FixedLoggers

public class SystemService
extends AppService
implements SystemServiceRemote

The service for maintaining data in the System package.

Field Summary

Fields inherited from interface psdi.util.logging.FixedLoggers

APPLOGGER, CRONTASKLOGGER, CRONTASKMGRLOGGER, CRONTASKMGRSQLLOGGER, DBCONNECTIONLOGGER, DDLOGGER, DMLOGGER, EVENTLOGGER, EXCEPTIONLOGGER, MAILLOGGER, MAXIMOLOGGER, MTLOGGER, NULLMBOPOINTER, SECURITY, SENDFAILEDLOGGER, SERVICELOGGER, SQLLOGGER

Fields inherited from interface psdi.util.logging.FixedLoggerNames

appenderPrefix, LOGGERNAME_APP, LOGGERNAME_CRONTASK, LOGGERNAME_CRONTASKMGR, LOGGERNAME_DBCONNECTION, LOGGERNAME_DD, LOGGERNAME_DM, LOGGERNAME_DMPREVIEW, LOGGERNAME_EVENT, LOGGERNAME_EXCEPTION, LOGGERNAME_MAIL, LOGGERNAME_MAXIMO, LOGGERNAME_MT, LOGGERNAME_NULLMBOPOINTER, LOGGERNAME_SECURITY, LOGGERNAME_SENDFAILED, LOGGERNAME_SERVICE, LOGGERNAME_SQL, LOGGERNAME_SQL_CRONTASKMGR, LOGGERNAME_TXN, loggerPrefix

Constructor Summary

Constructors

Constructor and Description
SystemService()
SystemService(MXServer mxServer)

Method Summary

Modifier and Type	Method and Description
void	destroy() Release system resources.
java.util.Date	getDate() Get current date from MXServer.
java.lang.String	getDeploymentMgrURL()
java.lang.Object[]	getLookupKeyMap(java.lang.String target, java.lang.String source, java.lang.String attr, UserInfo ui) Get the lookup key map.
java.lang.Object[]	getLookupKeyMap(java.lang.String target, java.lang.String attr, UserInfo ui) Get the lookup key map.
java.lang.String[]	getMXServerVersion(UserInfo userInfo) Return the version for MXServer and any add-ons.
java.util.Map<java.lang.String,java.lang.Object>	getProperties(java.util.List<java.lang.String> propNames, UserInfo userInfo)
java.lang.String	getProperty(java.lang.String propName, UserInfo userInfo) Return the cached property value for a property not flagged as "private".
java.util.List<java.lang.String>	getPropertyNames(UserInfo userInfo) Return all the current non-private property names of MXServer.
void	init() Overwrite the init() to include initializing the maxlookupMap cache and the condition cache
void	setProperty(java.lang.String propName, java.lang.String serverName, java.lang.String serverHost, java.lang.String propValue, UserInfo userInfo) Set value for a property and initiate cache update to synchronize the new value across all servers using this database.

Methods inherited from class psdi.server.AppService

checkSecurity, configure, freeDBConnection, freeMboSet, getCriteria, getCurrentState, getDBConnection, getLiveObjCount, getLoad, getMaximoDD, getMaxVar, getMboSet, getMXServer, getName, getProfile, getProxy, getSchemaOwner, getServiceInfo, getServiceLogger, getSetForRelationship, getSetFromKeys, getStateCmdList, getStateList, getURL, initCriteriaList, isAppService, isRunning, isSingletonService, restart, setProxy, setRunning, setURL, verifyUser, verifyUser

Methods inherited from class java.lang.Object

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

Methods inherited from interface psdi.server.AppServiceRemote

checkSecurity, getCriteria, getCurrentState, getLiveObjCount, getMboSet, getName, getSchemaOwner, getSetForRelationship, getSetFromKeys, getStateCmdList, getStateList, getURL, verifyUser, verifyUser

Methods inherited from interface psdi.server.ServiceRemote

isAppService, isSingletonService, restart

Constructor Detail

SystemService

public SystemService()
              throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

SystemService

public SystemService(MXServer mxServer)
              throws java.rmi.RemoteException

Parameters:

mxServer - The "Server Environment" this Service is being created in.

Throws:

java.rmi.RemoteException

Method Detail

getLookupKeyMap

public java.lang.Object[] getLookupKeyMap(java.lang.String target,
                                          java.lang.String source,
                                          java.lang.String attr,
                                          UserInfo ui)
                                   throws MXException,
                                          java.rmi.RemoteException

Get the lookup key map. If the map is not defined in maxlookupmap, null will be returned.

Specified by:

getLookupKeyMap in interface SystemServiceRemote

Parameters:

target - targetMbo

source -

attr -

ui - UserInfo

Returns:

Lookup key map

Throws:

MXException

java.rmi.RemoteException

getLookupKeyMap

public java.lang.Object[] getLookupKeyMap(java.lang.String target,
                                          java.lang.String attr,
                                          UserInfo ui)
                                   throws MXException,
                                          java.rmi.RemoteException

Get the lookup key map. If the map is not defined in maxlookupmap, null will be returned.

Specified by:

getLookupKeyMap in interface SystemServiceRemote

Parameters:

target - targetMbo

attr -

ui - UserInfo

Returns:

Lookup key map

Throws:

MXException

java.rmi.RemoteException

init

public void init()

Overwrite the init() to include initializing the maxlookupMap cache and the condition cache

Specified by:

init in interface Service

Overrides:

init in class AppService

See Also:

Service

destroy

public void destroy()

Description copied from interface: Service

Release system resources. The object should release all system resources. This will be called only once and is called to prepare the object for finalization.

Specified by:

destroy in interface Service

Overrides:

destroy in class AppService

See Also:

Service

getMXServerVersion

public java.lang.String[] getMXServerVersion(UserInfo userInfo)
                                      throws java.rmi.RemoteException

Return the version for MXServer and any add-ons.

Parameters:

userInfo - UserInfo making the request

Returns:

Version info

Throws:

java.rmi.RemoteException

See Also:

MXServer.getMXServerVersion()

getDate

public java.util.Date getDate()
                       throws java.rmi.RemoteException

Get current date from MXServer.

Returns:

Current date

Throws:

java.rmi.RemoteException

See Also:

MXServer.getDate()

getProperty

public java.lang.String getProperty(java.lang.String propName,
                                    UserInfo userInfo)
                             throws java.rmi.RemoteException

Return the cached property value for a property not flagged as "private". If the property is not defined, this will return null. If the property is defined but has no value, this will return the empty string. If userInfo is null, this will return only public properties.

Parameters:

propName - Property name

userInfo - UserInfo making the request

Returns:

Property value

Throws:

java.rmi.RemoteException

See Also:

MXServer.getProperty(String, UserInfo)

getProperties

public java.util.Map<java.lang.String,java.lang.Object> getProperties(java.util.List<java.lang.String> propNames,
                                                                      UserInfo userInfo)
                                                               throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

getPropertyNames

public java.util.List<java.lang.String> getPropertyNames(UserInfo userInfo)
                                                  throws java.rmi.RemoteException

Return all the current non-private property names of MXServer. If userInfo is null, this will return null.

Parameters:

userInfo - UserInfo making the request

Returns:

Set of property names (String)

Throws:

java.rmi.RemoteException

See Also:

MXServer.getConfig(UserInfo)

setProperty

public void setProperty(java.lang.String propName,
                        java.lang.String serverName,
                        java.lang.String serverHost,
                        java.lang.String propValue,
                        UserInfo userInfo)
                 throws MXException,
                        java.rmi.RemoteException

Set value for a property and initiate cache update to synchronize the new value across all servers using this database. An error will be thrown if any of the following is true:

• Property does not exist (invalid property name).
• Access is not allowed to this property (based on maxprop.securelevel).
• The property does not permit updates while MXServer is up.
• The property does not permit cache refresh while MXServer is up.
• The current cached property value was loaded from the properties file (not from the database).
• There is no row in MaxPropValue (servername and/or serverHost are not valid).
• The requested new value is not valid for any reason.

Parameters:

propName - Property name (maxprop, maxpropvalue)

serverName - Server name (maxpropvalue)

serverHost - Can be null (maxpropvalue)

propValue - The new value for this property

userInfo - The userInfo making this request.

Throws:

MXException

java.rmi.RemoteException

getDeploymentMgrURL

public java.lang.String getDeploymentMgrURL()
                                     throws java.rmi.RemoteException

Specified by:

getDeploymentMgrURL in interface SystemServiceRemote

Throws:

java.rmi.RemoteException