Rio Project 4.2 API Documentation

org.rioproject.monitor
Class ProvisionMonitorAdminProxy

java.lang.Object
  org.rioproject.resources.servicecore.ServiceAdminProxy
      org.rioproject.monitor.ProvisionMonitorAdminProxy

All Implemented Interfaces:

DestroyAdmin, Serializable, Remote, JoinAdmin, ReferentUuid, ServiceBeanAdmin, ServiceBeanControl, DeployAdmin, ProvisionMonitorAdmin, ServiceAdmin

public class ProvisionMonitorAdminProxy
extends ServiceAdminProxy
implements ProvisionMonitorAdmin, Serializable

A ProvisionMonitorAdminProxy is a proxy for the ProvisionMonitorAdmin server. This is the object passed to clients of the ProvisionMonitorAdmin.

Author:

Dennis Reedy

See Also:

Serialized Form

Field Summary

Fields inherited from class org.rioproject.resources.servicecore.ServiceAdminProxy

serviceAdmin, uuid

Method Summary

Map<String,Throwable>	deploy(OperationalString opString) Deploy an OperationalString to the ProvisionMonitor.
Map<String,Throwable>	deploy(OperationalString opString, ServiceProvisionListener listener) Deploy an OperationalString to the ProvisionMonitor.
Map<String,Throwable>	deploy(String location) Deploy an OperationalString to the ProvisionMonitor.
Map<String,Throwable>	deploy(String location, ServiceProvisionListener listener) Deploy an OperationalString to the ProvisionMonitor.
Map<String,Throwable>	deploy(URL opStringURL) Deploy an OperationalString URL to the ProvisionMonitor.
Map<String,Throwable>	deploy(URL opStringURL, ServiceProvisionListener listener) Deploy an OperationalString URL to the ProvisionMonitor.
ProvisionMonitor.PeerInfo[]	getBackupInfo() Get the ProvisionMonitor instances that are being backed up
OperationalStringManager	getOperationalStringManager(String name) Retrieve the managing OperationalStringManager for an OperationalString
OperationalStringManager[]	getOperationalStringManagers() This will retrieve an array of OperationalStringManager instances that are managing deployed OperationalString instances.
boolean	hasDeployed(String opStringName) Determine if this ProvisionMonitor has deployed the OperationalString as determined by the name
boolean	undeploy(String opStringName) Undeploy an OperationalString deployed by the ProvisionMonitor.

Methods inherited from class org.rioproject.resources.servicecore.ServiceAdminProxy

addLookupAttributes, addLookupGroups, addLookupLocators, advertise, destroy, equals, getJoinSet, getLookupAttributes, getLookupGroups, getLookupLocators, getReferentUuid, getServiceBeanInstantiatorUuid, getServiceElement, getUpTime, hashCode, modifyLookupAttributes, removeLookupGroups, removeLookupLocators, setLookupGroups, setLookupLocators, setServiceElement, start, stop, unadvertise

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.rioproject.resources.servicecore.ServiceAdmin

getJoinSet

Methods inherited from interface org.rioproject.core.jsb.ServiceBeanAdmin

getServiceBeanInstantiatorUuid, getServiceElement, getUpTime, setServiceElement

Methods inherited from interface org.rioproject.jsb.ServiceBeanControl

advertise, start, stop, unadvertise

Methods inherited from interface net.jini.admin.JoinAdmin

addLookupAttributes, addLookupGroups, addLookupLocators, getLookupAttributes, getLookupGroups, getLookupLocators, modifyLookupAttributes, removeLookupGroups, removeLookupLocators, setLookupGroups, setLookupLocators

Methods inherited from interface com.sun.jini.admin.DestroyAdmin

destroy

Method Detail

deploy

public Map<String,Throwable> deploy(URL opStringURL)
                             throws OperationalStringException,
                                    RemoteException

Description copied from interface: DeployAdmin

Deploy an OperationalString URL to the ProvisionMonitor. The ProvisionMonitor will load the location and deploy the OperationalString If the OperationalString includes nested OperationalStrings, the nested OperationalStrings will be deployed as well. If nested OperationalString items are already deployed, they will not be re-deployed. If the OperationalString specified by the input URL has already been deployed, or is scheduled for deployment, then no part of that OperationalString (or nested OperationalString instances) will be deployed

Specified by:

deploy in interface DeployAdmin

Parameters:

opStringURL - The URL indicating the location of the OperationalString to deploy

Returns:

If there are errors loading part of the OperationalString the Map will be returned with name value pairs associating the service and corresponding exceptions

Throws:

OperationalStringException - If the OperationalString parsing errors occur

RemoteException - If communication errors happen

See Also:

DeployAdmin.deploy(java.lang.String)

deploy

public Map<String,Throwable> deploy(URL opStringURL,
                                    ServiceProvisionListener listener)
                             throws OperationalStringException,
                                    RemoteException

Description copied from interface: DeployAdmin

Deploy an OperationalString URL to the ProvisionMonitor. The ProvisionMonitor will load the location and deploy the OperationalString If the OperationalString includes nested OperationalStrings, the nested OperationalStrings will be deployed as well. If nested OperationalString items are already deployed, they will not be re-deployed. If the OperationalString specified by the input URL has already been deployed, or is scheduled for deployment, then no part of that OperationalString (or nested OperationalString instances) will be deployed

Specified by:

deploy in interface DeployAdmin

Parameters:

opStringURL - The URL indicating the location of the OperationalString to deploy

listener - If not null, the ServiceProvisionListener will be notified as each service is deployed

Returns:

If there are errors loading part of the OperationalString the Map will be returned with name value pairs associating the service and corresponding exceptions

Throws:

OperationalStringException - If OperationalString parsing errors occur

RemoteException - If communication errors happen

See Also:

DeployAdmin.deploy(java.lang.String)

deploy

public Map<String,Throwable> deploy(String location)
                             throws OperationalStringException,
                                    RemoteException

Description copied from interface: DeployAdmin

Deploy an OperationalString to the ProvisionMonitor. The ProvisionMonitor will load the location and deploy the OperationalString If the OperationalString includes nested OperationalStrings, the nested OperationalStrings will be deployed as well. If nested OperationalString items are already deployed, they will not be re-deployed. If the OperationalString specified by the input URL has already been deployed, or is scheduled for deployment, then no part of that OperationalString (or nested OperationalString instances) will be deployed

Specified by:

deploy in interface DeployAdmin

Parameters:

location - The location of the OperationalString to deploy (may also be an OAR, or artifact that resolves to an OAR)

Returns:

If there are errors loading part of the OperationalString the Map will be returned with name value pairs associating the service and corresponding exceptions

Throws:

OperationalStringException - If the OperationalString parsing errors occur

RemoteException - If communication errors happen

See Also:

DeployAdmin.deploy(java.lang.String)

deploy

public Map<String,Throwable> deploy(String location,
                                    ServiceProvisionListener listener)
                             throws OperationalStringException,
                                    RemoteException

Description copied from interface: DeployAdmin

Deploy an OperationalString to the ProvisionMonitor. The ProvisionMonitor will load the location and deploy the OperationalString If the OperationalString includes nested OperationalStrings, the nested OperationalStrings will be deployed as well. If nested OperationalString items are already deployed, they will not be re-deployed. If the OperationalString specified by the input URL has already been deployed, or is scheduled for deployment, then no part of that OperationalString (or nested OperationalString instances) will be deployed

Specified by:

deploy in interface DeployAdmin

Parameters:

location - The location of the OperationalString to deploy (may also be an OAR, or artifact that resolves to an OAR)

listener - If not null, the ServiceProvisionListener will be notified as each service is deployed

Returns:

If there are errors loading part of the OperationalString the Map will be returned with name value pairs associating the service and corresponding exceptions

Throws:

OperationalStringException - If OperationalString parsing errors occur

RemoteException - If communication errors happen

See Also:

DeployAdmin.deploy(java.lang.String)

deploy

public Map<String,Throwable> deploy(OperationalString opString)
                             throws OperationalStringException,
                                    RemoteException

Description copied from interface: DeployAdmin

Deploy an OperationalString to the ProvisionMonitor. The ProvisionMonitor will deploy the contents specified by the OperationalString object f the OperationalString includes nested OperationalStrings, the nested OperationalStrings will be deployed as well. If nested OperationalString items are already deployed, they will not be re-deployed. If the OperationalString specified by the input URL has already been deployed, or is scheduled for deployment, then no part of that OperationalString (or nested OperationalString instances) will be deployed

Specified by:

deploy in interface DeployAdmin

Parameters:

opString - The OperationalString to deploy

Returns:

If there are errors loading part of the OperationalString the Map will be returned with name value pairs associating the service and corresponding exceptions

Throws:

OperationalStringException - If the OperationalString parsing errors occur

RemoteException - If communication errors happen

See Also:

DeployAdmin.deploy(java.lang.String)

deploy

public Map<String,Throwable> deploy(OperationalString opString,
                                    ServiceProvisionListener listener)
                             throws OperationalStringException,
                                    RemoteException

Description copied from interface: DeployAdmin

Deploy an OperationalString to the ProvisionMonitor. The ProvisionMonitor will deploy the contents specified by the OperationalString object f the OperationalString includes nested OperationalStrings, the nested OperationalStrings will be deployed as well. If nested OperationalString items are already deployed, they will not be re-deployed. If the OperationalString specified by the input URL has already been deployed, or is scheduled for deployment, then no part of that OperationalString (or nested OperationalString instances) will be deployed

Specified by:

deploy in interface DeployAdmin

Parameters:

opString - The OperationalString to deploy

listener - If not null, the ServiceProvisionListener will be notified as each service is deployed

Returns:

If there are errors loading part of the OperationalString the Map will be returned with name value pairs associating the service and corresponding exceptions

Throws:

OperationalStringException - if the the entire deployment fails

RemoteException - If communication errors happen

See Also:

DeployAdmin.deploy(java.lang.String)

undeploy

public boolean undeploy(String opStringName)
                 throws OperationalStringException,
                        RemoteException

Description copied from interface: DeployAdmin

Undeploy an OperationalString deployed by the ProvisionMonitor. The ProvisionMonitor will search as follows:

1. First for the OperationalString by it's name, and if found, remove the OperationalString and any nested OperationalStrings that are included by the OperatinalString.
2. If the name is not found, the ProvisionMonitor will search for the matching OAR, by looking at directory names under the configured installDir property. If a matching directory name is found, the corresponding OAR file will be loaded, loading the configured OperationalString, and undeploying as indicated in step 1.

As a result of undeploying the OperationalString(s), all services that have a provision type of ServiceElement.ProvisionType.DYNAMIC or ServiceElement.ProvisionType.FIXED will be terminated. If any deployment request or redeployment requests are pending for the OperationalString(s) being undeployed, these requests will be cancelled

Specified by:

undeploy in interface DeployAdmin

Parameters:

opStringName - The name of the OperationalString or directory to undeploy

Returns:

Returns true if the OperationalString has been undeployed

Throws:

OperationalStringException - If the OperationalString does not exist

RemoteException - If communication errors occur

See Also:

DeployAdmin.undeploy(java.lang.String)

hasDeployed

public boolean hasDeployed(String opStringName)
                    throws RemoteException

Description copied from interface: DeployAdmin

Determine if this ProvisionMonitor has deployed the OperationalString as determined by the name

Specified by:

hasDeployed in interface DeployAdmin

Parameters:

opStringName - The name of the OperationalString

Returns:

If found return true, otherwise false

Throws:

RemoteException - If communication errors happen

See Also:

DeployAdmin.hasDeployed(java.lang.String)

getOperationalStringManagers

public OperationalStringManager[] getOperationalStringManagers()
                                                        throws RemoteException

Description copied from interface: DeployAdmin

This will retrieve an array of OperationalStringManager instances that are managing deployed OperationalString instances. If an OperationalString includes nested OperationalStrings, those OperationalStringManager instances that are nested will be returned as part of this array.

Specified by:

getOperationalStringManagers in interface DeployAdmin

Returns:

Array of OperationalStringManager instances that are managing deployed OperationalString instances. Only OperationalStringManager instances created on the local ProvisionMonitor will be returned

Throws:

RemoteException - If communication errors happen

See Also:

DeployAdmin.getOperationalStringManagers()

getOperationalStringManager

public OperationalStringManager getOperationalStringManager(String name)
                                                     throws OperationalStringException,
                                                            RemoteException

Description copied from interface: DeployAdmin

Retrieve the managing OperationalStringManager for an OperationalString

Specified by:

getOperationalStringManager in interface DeployAdmin

Parameters:

name - The name of the OperationalString

Returns:

The OperationalStringManager instance that is managing a deployed OperationalString. The OperationalStringManager returned may be running in a remote ProvisionMonitor

Throws:

OperationalStringException - If an OperationalStringManager can not be found to the OperationalString

RemoteException - If communication errors happen

getBackupInfo

public ProvisionMonitor.PeerInfo[] getBackupInfo()
                                          throws RemoteException

Description copied from interface: ProvisionMonitorAdmin

Get the ProvisionMonitor instances that are being backed up

Specified by:

getBackupInfo in interface ProvisionMonitorAdmin

Returns:

Array of PeerInfo objects

Throws:

RemoteException - if there are communication errors