psdi.app.integration

Class IntegrationService

java.lang.Object

psdi.server.AppService

psdi.app.integration.IntegrationService

All Implemented Interfaces:

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

public class IntegrationService
extends AppService
implements IntegrationServiceRemote

The Integration package includes Mbos related to exchanging data with other systems.

For a detailed description of how Process Control IDs work, see Process Control IDs.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Hashtable	mxc Hashtable for maintaining local cache

Fields inherited from class psdi.server.AppService

currentState, dbManager, INIT, liveObjCount, load, LOAD, mxServer, name, RUN, running, stateCmdList, stateList, STOP, url

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
IntegrationService()
IntegrationService(MXServer mxServer)

Method Summary

Modifier and Type	Method and Description
MboSetRemote	copySystem(java.lang.String fromSysID, java.lang.String toSysID, UserInfo userInfo) Used to add mxcollab data for a new system.
MboSetRemote	deleteSystem(java.lang.String sysID, java.lang.String indicator, UserInfo userInfo) Used to delete mxcollab data for a system.
boolean	getDefaultPCValue(java.lang.String owner1sysid, java.lang.String owner2sysid, java.lang.String pcid, UserInfo userInfo) Get the default value from the mxcollab table for a specified owner1sysid, owner2sysid, and pcid.
java.lang.String	getMxSysID(UserInfo userInfo) get the MXSYSID from MAXVARS
boolean	isPCIDValid(java.lang.String pcid, UserInfo userInfo) validates pcid on mxcollabref table
java.lang.Object	put(java.lang.String owner1sysid, java.lang.String owner2sysid, java.lang.String pcid, boolean newvalue) call this after updating the database to put new mxcollab in hashtable.
java.lang.Object	remove(java.lang.String owner1sysid, java.lang.String owner2sysid, java.lang.String pcid) call this after deleting a record from database to remove entry from hashtable.
void	restart() Flushes old values out of internal cache
boolean	useIntegrationRules(java.lang.String owner1sysid, java.lang.String owner2sysid, java.lang.String pcid, UserInfo userInfo) Answers the question "Should I use integration rules?"

Methods inherited from class psdi.server.AppService

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

Methods inherited from class java.lang.Object

clone, equals, finalize, 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

Field Detail

mxc

protected java.util.Hashtable mxc

Hashtable for maintaining local cache

Constructor Detail

IntegrationService

public IntegrationService()
                   throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException

IntegrationService

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

Throws:

java.rmi.RemoteException

Method Detail

restart

public void restart()
             throws java.rmi.RemoteException

Flushes old values out of internal cache

Specified by:

restart in interface ServiceRemote

Overrides:

restart in class AppService

Throws:

java.rmi.RemoteException

useIntegrationRules

public boolean useIntegrationRules(java.lang.String owner1sysid,
                                   java.lang.String owner2sysid,
                                   java.lang.String pcid,
                                   UserInfo userInfo)
                            throws MXException,
                                   java.rmi.RemoteException

Answers the question "Should I use integration rules?"

False = do normal processing

boolean useIt = useIntegrationRules(owner1sysid, owner2sysid, pcid);

See Process Control IDs.

There is no pcvalue for EXT THISMX PRPAB and people should not be seeking it.

THISMX, THISMX always returns false.

Specified by:

useIntegrationRules in interface IntegrationServiceRemote

Parameters:

owner1sysid - Which table this is derived from is different for each pcid.

owner2sysid - Which table this is derived from is different for each pcid.

pcid - Identifier for the affected process (see mxcollabref table)

userInfo - The UserInfo making the request.

Returns:

true = use integration rules;
false = normal processing

Throws:

MXException

java.rmi.RemoteException

See Also:

IntegrationService.useIntegrationRules(java.lang.String, java.lang.String, java.lang.String, psdi.security.UserInfo)

put

public java.lang.Object put(java.lang.String owner1sysid,
                            java.lang.String owner2sysid,
                            java.lang.String pcid,
                            boolean newvalue)
                     throws MXException,
                            java.rmi.RemoteException

call this after updating the database to put new mxcollab in hashtable.

Specified by:

put in interface IntegrationServiceRemote

Parameters:

newvalue -

owner1sysid -

owner2sysid -

pcid -

Throws:

MXException

java.rmi.RemoteException

See Also:

IntegrationService.put(java.lang.String, java.lang.String, java.lang.String, boolean)

remove

public java.lang.Object remove(java.lang.String owner1sysid,
                               java.lang.String owner2sysid,
                               java.lang.String pcid)
                        throws MXException,
                               java.rmi.RemoteException

call this after deleting a record from database to remove entry from hashtable.

Specified by:

remove in interface IntegrationServiceRemote

Parameters:

owner1sysid -

owner2sysid -

pcid -

Throws:

MXException

java.rmi.RemoteException

See Also:

IntegrationService.remove(java.lang.String, java.lang.String, java.lang.String)

copySystem

public MboSetRemote copySystem(java.lang.String fromSysID,
                               java.lang.String toSysID,
                               UserInfo userInfo)
                        throws MXException,
                               java.rmi.RemoteException

Used to add mxcollab data for a new system. Copy data from an existing system to the new system. If any mxcollab data already exists for the new system, nothing is copied. If nothing is copied, null is returned. Must call MXCollabSetRemote Save to complete the save process.

Specified by:

copySystem in interface IntegrationServiceRemote

Parameters:

toSysID - The new system being copied to.

fromSysID - The system being copied from.

userInfo - The UserInfo making the request.

Returns:

The set of added MxCollab

Throws:

MXException

java.rmi.RemoteException

See Also:

IntegrationService.copySystem(java.lang.String, java.lang.String, psdi.security.UserInfo)

deleteSystem

public MboSetRemote deleteSystem(java.lang.String sysID,
                                 java.lang.String indicator,
                                 UserInfo userInfo)
                          throws MXException,
                                 java.rmi.RemoteException

Used to delete mxcollab data for a system. If nothing is deleted, null is returned. Must call MXCollabSetRemote Save to complete the save process.

Specified by:

deleteSystem in interface IntegrationServiceRemote

Parameters:

indicator - "OWNER1", "OWNER2", or "BOTH"

sysID -

userInfo - The UserInfo making the request.

Returns:

The set of deleted MxCollab

Throws:

MXException

java.rmi.RemoteException

See Also:

IntegrationService.deleteSystem(java.lang.String, java.lang.String, psdi.security.UserInfo)

getMxSysID

public java.lang.String getMxSysID(UserInfo userInfo)
                            throws MXException,
                                   java.rmi.RemoteException

get the MXSYSID from MAXVARS

Specified by:

getMxSysID in interface IntegrationServiceRemote

Returns:

value of MXSYSID from maxvars

Throws:

MXException

java.rmi.RemoteException

See Also:

IntegrationService.getMxSysID(psdi.security.UserInfo)

isPCIDValid

public boolean isPCIDValid(java.lang.String pcid,
                           UserInfo userInfo)
                    throws MXException,
                           java.rmi.RemoteException

validates pcid on mxcollabref table

Specified by:

isPCIDValid in interface IntegrationServiceRemote

Parameters:

pcid -

userInfo - The UserInfo making the request.

Returns:

true = pcid is valid

Throws:

MXException

java.rmi.RemoteException

See Also:

IntegrationService.isPCIDValid(java.lang.String, psdi.security.UserInfo)

getDefaultPCValue

public boolean getDefaultPCValue(java.lang.String owner1sysid,
                                 java.lang.String owner2sysid,
                                 java.lang.String pcid,
                                 UserInfo userInfo)
                          throws MXException,
                                 java.rmi.RemoteException

Get the default value from the mxcollab table for a specified owner1sysid, owner2sysid, and pcid. The input owner1 and owner2 are converted to "THISMX" or "EXT" to look up the default pcvalue.

Specified by:

getDefaultPCValue in interface IntegrationServiceRemote

Parameters:

owner1sysid -

owner2sysid -

pcid -

userInfo - The UserInfo making the request.

Throws:

MXException

java.rmi.RemoteException

See Also:

IntegrationService.getDefaultPCValue(java.lang.String, java.lang.String, java.lang.String, psdi.security.UserInfo)