com.sun.jbi.management.registry

Class RegistryDiff

java.lang.Object

com.sun.jbi.management.registry.RegistryDiff

public class RegistryDiff
extends Object

This class performs a logical difference between two open registry instances and maintains state information about the changes that can be queried afterwards.

Author:

Sun Microsystems, Inc.

Constructor Summary

Constructors

Constructor and Description
RegistryDiff(Registry master, Registry target, String targetName) Construct a RegistryDiff object using two given registries and the target processing entity of interest.

Method Summary

Methods

Modifier and Type	Method and Description
List<String>	componentsToStartForDeploy() Compute the set of components that need to be started so that a deploy service assembly operation can execute.
List<String>	componentsToStartForUndeploy() Compute the set of components that need to be started so that a undeploy service assembly operation can execute.
boolean	computeDiff() Perform the actual difference computation.
Map<String,ComponentInfo.Variable[]>	getAddComponentAppVars()
Map<String,Map<String,Properties>>	getAddComponentConfigs()
List<String>	getAffectedComponents() Get the list of components affected by other changes.
List<String>	getAffectedServiceAssemblies() Get the list of service assemblies affected by other changes.
List<String>	getChangedConfigComponents()
List<String>	getChangedLifeCycleComponents() Get the list of components with lifecycle changes.
List<String>	getChangedLifeCycleServiceAssemblies() Get the list of service assemblies with lifecycle changes.
Map<String,Properties>	getComponentPropertyUpdates()
Map<String,String>	getConfigChanges(String category)
Map<String,String>	getGlobalConfigChanges(String category)
ComponentInfo	getNewComponentInfo(String compName) Get ComponentInfo about a new Component
List<String>	getNewComponents() Get the list of new components in the master.
List<String>	getNewServiceAssemblies() Get the list of new service assemblies in the master.
ServiceAssemblyInfo	getNewServiceAssemblyInfo(String saName) Get ServiceAssemblyInfo about a new ServiceAssembly
ServiceAssemblyState	getNewServiceAssemblyState(String saName) Compute the state of a new service assembly (exists in master) from the state of the service units.
List<String>	getNewSharedLibraries() Get the list of new shared libraries in the master.
ComponentInfo	getNewSharedLibraryInfo(String slName) Get ComponentInfo about a new SharedLibrary
List<String>	getOldComponents() Get the list of old components in the target.
List<String>	getOldServiceAssemblies() Get the list of old service assemblies in the target.
List<String>	getOldSharedLibraries() Get the list of old shared libraries in the target.
Map<String,String[]>	getRemoveComponentAppVars()
Map<String,String>	getRemoveComponentConfigs()
List<String>	getReplacedComponents() Get the list of replaced components
List<String>	getReplacedServiceAssemblies() Get the list of replaced service assemblies in the target.
List<String>	getReplacedSharedLibraries() Get the list of replaced shared libraries in the target.
List<String>	getUpdatedComponents() Get the list of updated components
String	toString() Return a printable status that summarizes the changes and actions.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

RegistryDiff

public RegistryDiff(Registry master,
            Registry target,
            String targetName)

Construct a RegistryDiff object using two given registries and the target processing entity of interest.

Parameters:

master - - Registry that is considered to be the reference

target - - Registry that is being upgraded to be consistent with the master

targetName - - The target processing entity (instance, cluster)

Method Detail

computeDiff

public boolean computeDiff()

Perform the actual difference computation.

Returns:

indication if a difference was detected.

componentsToStartForUndeploy

public List<String> componentsToStartForUndeploy()

Compute the set of components that need to be started so that a undeploy service assembly operation can execute.

Returns:

List of components name that need to be started.

componentsToStartForDeploy

public List<String> componentsToStartForDeploy()

Compute the set of components that need to be started so that a deploy service assembly operation can execute.

Returns:

List of components name that need to be started.

getNewServiceAssemblyState

public ServiceAssemblyState getNewServiceAssemblyState(String saName)

Compute the state of a new service assembly (exists in master) from the state of the service units.

Parameters:

saName - - name of the service assembly

Returns:

service assembly state

getNewSharedLibraries

public List<String> getNewSharedLibraries()

Get the list of new shared libraries in the master.

Returns:

List of shared library names.

getNewSharedLibraryInfo

public ComponentInfo getNewSharedLibraryInfo(String slName)

Get ComponentInfo about a new SharedLibrary

Returns:

ComponentInfo for the given shared library.

getOldSharedLibraries

public List<String> getOldSharedLibraries()

Get the list of old shared libraries in the target.

Returns:

List of shared library names.

getReplacedSharedLibraries

public List<String> getReplacedSharedLibraries()

Get the list of replaced shared libraries in the target.

Returns:

List of shared library names.

getReplacedServiceAssemblies

public List<String> getReplacedServiceAssemblies()

Get the list of replaced service assemblies in the target.

Returns:

List of shared library names.

getNewComponents

public List<String> getNewComponents()

Get the list of new components in the master.

Returns:

List of component names.

getNewComponentInfo

public ComponentInfo getNewComponentInfo(String compName)

Get ComponentInfo about a new Component

Returns:

ComponentInfo for the given component

getOldComponents

public List<String> getOldComponents()

Get the list of old components in the target.

Returns:

List of component names.

getAffectedComponents

public List<String> getAffectedComponents()

Get the list of components affected by other changes. This typically means a dependent shared libaray has changed.

Returns:

List of components names.\

getUpdatedComponents

public List<String> getUpdatedComponents()

Get the list of updated components

Returns:

List of components names.

getReplacedComponents

public List<String> getReplacedComponents()

Get the list of replaced components

Returns:

List of components names.

getChangedLifeCycleComponents

public List<String> getChangedLifeCycleComponents()

Get the list of components with lifecycle changes.

Returns:

List of components names.\

getNewServiceAssemblyInfo

public ServiceAssemblyInfo getNewServiceAssemblyInfo(String saName)

Get ServiceAssemblyInfo about a new ServiceAssembly

Returns:

ComponentInfo for the given service assembly

getNewServiceAssemblies

public List<String> getNewServiceAssemblies()

Get the list of new service assemblies in the master.

Returns:

List of service assemblies names.

getOldServiceAssemblies

public List<String> getOldServiceAssemblies()

Get the list of old service assemblies in the target.

Returns:

List of service assemblies names.

getAffectedServiceAssemblies

public List<String> getAffectedServiceAssemblies()

Get the list of service assemblies affected by other changes. This typically means a dependent component has changed.

Returns:

List of service assembly names.

getChangedLifeCycleServiceAssemblies

public List<String> getChangedLifeCycleServiceAssemblies()

Get the list of service assemblies with lifecycle changes.

Returns:

List of service assembly names.

getGlobalConfigChanges

public Map<String,String> getGlobalConfigChanges(String category)

getConfigChanges

public Map<String,String> getConfigChanges(String category)

getChangedConfigComponents

public List<String> getChangedConfigComponents()

getComponentPropertyUpdates

public Map<String,Properties> getComponentPropertyUpdates()

getAddComponentAppVars

public Map<String,ComponentInfo.Variable[]> getAddComponentAppVars()

getRemoveComponentAppVars

public Map<String,String[]> getRemoveComponentAppVars()

getAddComponentConfigs

public Map<String,Map<String,Properties>> getAddComponentConfigs()

getRemoveComponentConfigs

public Map<String,String> getRemoveComponentConfigs()

toString

public String toString()

Return a printable status that summarizes the changes and actions.

Overrides:

toString in class Object

Returns:

String describing changes.