Package org.java.plugin.tools.mocks
Class MockPluginRegistry
- java.lang.Object
-
- org.java.plugin.tools.mocks.MockPluginRegistry
-
- All Implemented Interfaces:
PluginRegistry
public class MockPluginRegistry extends java.lang.Object implements PluginRegistry
- Version:
- $Id: MockPluginRegistry.java,v 1.4 2007/03/03 17:16:22 ddimon Exp $
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface org.java.plugin.registry.PluginRegistry
PluginRegistry.RegistryChangeData, PluginRegistry.RegistryChangeListener
-
-
Constructor Summary
Constructors Constructor Description MockPluginRegistry()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description MockPluginRegistryaddExtensionPoint(ExtensionPoint extPoint)MockPluginRegistryaddPluginDescriptor(PluginDescriptor descr)MockPluginRegistryaddPluginFragment(PluginFragment fragment)IntegrityCheckReportcheckIntegrity(PathResolver pathResolver)Performs integrity check of all registered plug-ins and generates result as a collection of standard report items.IntegrityCheckReportcheckIntegrity(PathResolver pathResolver, boolean includeRegistrationReport)Performs integrity check of all registered plug-ins and generates result as a collection of standard report items.voidconfigure(ExtendedProperties config)Configures this registry instance.java.lang.StringextractId(java.lang.String uniqueId)Extracts plug-in element ID from some unique identifier.java.lang.StringextractPluginId(java.lang.String uniqueId)Extracts plug-in ID from some unique identifier.VersionextractVersion(java.lang.String uniqueId)Extracts plug-in version identifier from some unique identifier (plug-in or plug-in fragment).java.util.Collection<PluginDescriptor>getDependingPlugins(PluginDescriptor descr)Utility method that recursively collects all plug-ins that depends on the given plug-in.ExtensionPointgetExtensionPoint(java.lang.String uniqueId)Looks for extension point.ExtensionPointgetExtensionPoint(java.lang.String pluginId, java.lang.String pointId)Looks for extension point.PluginDescriptorgetPluginDescriptor(java.lang.String pluginId)Returns descriptor of plug-in with given ID.java.util.Collection<PluginDescriptor>getPluginDescriptors()Returns collection of descriptors of all plug-ins that was successfully populated by this registry.java.util.Collection<PluginFragment>getPluginFragments()Returns collection of descriptors of all plug-in fragments that was successfully populated by this registry.IntegrityCheckReportgetRegistrationReport()booleanisExtensionPointAvailable(java.lang.String uniqueId)Checks if extension point exists and is in valid state.booleanisExtensionPointAvailable(java.lang.String pluginId, java.lang.String pointId)Checks if extension point exists and is in valid state.booleanisPluginDescriptorAvailable(java.lang.String pluginId)Checks if plug-in exists and is in valid state.java.lang.StringmakeUniqueId(java.lang.String pluginId, java.lang.String elementId)Constructs unique identifier for some plug-in element from it's ID.java.lang.StringmakeUniqueId(java.lang.String pluginId, Version version)Constructs unique identifier for plug-in with given ID.ManifestInforeadManifestInfo(java.net.URL manifest)Reads basic information from a plug-in or plug-in fragment manifest.java.util.Map<java.lang.String,Identity>register(java.net.URL[] manifests)Registers plug-ins and plug-in fragments in this registry.voidregisterListener(PluginRegistry.RegistryChangeListener listener)Registers plug-in registry change event listener.MockPluginRegistrysetIntegrityCheckReport(IntegrityCheckReport value)MockPluginRegistrysetRegistrationReport(IntegrityCheckReport value)java.util.Collection<java.lang.String>unregister(java.lang.String[] ids)Unregisters plug-ins and plug-in fragments with given ID's (including depending plug-ins and plug-in fragments).voidunregisterListener(PluginRegistry.RegistryChangeListener listener)Unregisters registry change event listener.
-
-
-
Method Detail
-
checkIntegrity
public IntegrityCheckReport checkIntegrity(PathResolver pathResolver)
Description copied from interface:PluginRegistryPerforms integrity check of all registered plug-ins and generates result as a collection of standard report items.- Specified by:
checkIntegrityin interfacePluginRegistry- Parameters:
pathResolver- optional path resolver- Returns:
- integrity check report
- See Also:
PluginRegistry.checkIntegrity( org.java.plugin.PathResolver)
-
checkIntegrity
public IntegrityCheckReport checkIntegrity(PathResolver pathResolver, boolean includeRegistrationReport)
Description copied from interface:PluginRegistryPerforms integrity check of all registered plug-ins and generates result as a collection of standard report items.- Specified by:
checkIntegrityin interfacePluginRegistry- Parameters:
pathResolver- optional path resolverincludeRegistrationReport- iftrue, the plug-ins registration report will be included into resulting report- Returns:
- integrity check report
- See Also:
PluginRegistry.checkIntegrity( org.java.plugin.PathResolver, boolean)
-
setIntegrityCheckReport
public MockPluginRegistry setIntegrityCheckReport(IntegrityCheckReport value)
- Parameters:
value- the integrity check report to set- Returns:
- this instance
-
configure
public void configure(ExtendedProperties config)
Description copied from interface:PluginRegistryConfigures this registry instance. Usually this method is called fromobject factoryimplementation.- Specified by:
configurein interfacePluginRegistry- Parameters:
config- registry configuration data- See Also:
PluginRegistry.configure( org.java.plugin.util.ExtendedProperties)
-
extractId
public java.lang.String extractId(java.lang.String uniqueId)
Description copied from interface:PluginRegistryExtracts plug-in element ID from some unique identifier.- Specified by:
extractIdin interfacePluginRegistry- Parameters:
uniqueId- unique ID- Returns:
- element ID
- See Also:
PluginRegistry.extractId( java.lang.String)
-
extractPluginId
public java.lang.String extractPluginId(java.lang.String uniqueId)
Description copied from interface:PluginRegistryExtracts plug-in ID from some unique identifier.- Specified by:
extractPluginIdin interfacePluginRegistry- Parameters:
uniqueId- unique ID- Returns:
- plug-in ID
- See Also:
PluginRegistry.extractPluginId( java.lang.String)
-
extractVersion
public Version extractVersion(java.lang.String uniqueId)
Description copied from interface:PluginRegistryExtracts plug-in version identifier from some unique identifier (plug-in or plug-in fragment).- Specified by:
extractVersionin interfacePluginRegistry- Parameters:
uniqueId- unique ID- Returns:
- plug-in version identifier
- See Also:
PluginRegistry.extractVersion( java.lang.String)
-
getDependingPlugins
public java.util.Collection<PluginDescriptor> getDependingPlugins(PluginDescriptor descr)
Description copied from interface:PluginRegistryUtility method that recursively collects all plug-ins that depends on the given plug-in.- Specified by:
getDependingPluginsin interfacePluginRegistry- Parameters:
descr- descriptor of plug-in to collect dependencies for- Returns:
- collection of
plug-in descriptorsthat depend on given plug-in - See Also:
PluginRegistry.getDependingPlugins( org.java.plugin.registry.PluginDescriptor)
-
getExtensionPoint
public ExtensionPoint getExtensionPoint(java.lang.String pluginId, java.lang.String pointId)
Description copied from interface:PluginRegistryLooks for extension point. This method have throw anIllegalArgumentExceptionif requested extension point can't be found or is in invalid state.- Specified by:
getExtensionPointin interfacePluginRegistry- Parameters:
pluginId- plug-in IDpointId- extension point ID- Returns:
- plug-in extension point
- See Also:
PluginRegistry.getExtensionPoint( java.lang.String, java.lang.String)
-
getExtensionPoint
public ExtensionPoint getExtensionPoint(java.lang.String uniqueId)
Description copied from interface:PluginRegistryLooks for extension point.- Specified by:
getExtensionPointin interfacePluginRegistry- Parameters:
uniqueId- extension point unique ID- Returns:
- plug-in extension point
- See Also:
PluginRegistry.getExtensionPoint( java.lang.String)
-
addExtensionPoint
public MockPluginRegistry addExtensionPoint(ExtensionPoint extPoint)
- Parameters:
extPoint- extension point to add- Returns:
- this instance
-
getPluginDescriptor
public PluginDescriptor getPluginDescriptor(java.lang.String pluginId)
Description copied from interface:PluginRegistryReturns descriptor of plug-in with given ID.
If plug-in descriptor with given ID can't be found or such plug-in exists but is damaged this method have to throw anIllegalArgumentException. In other words, this method shouldn't returnnull.- Specified by:
getPluginDescriptorin interfacePluginRegistry- Parameters:
pluginId- plug-id ID- Returns:
- plug-in descriptor
- See Also:
PluginRegistry.getPluginDescriptor( java.lang.String)
-
getPluginDescriptors
public java.util.Collection<PluginDescriptor> getPluginDescriptors()
Description copied from interface:PluginRegistryReturns collection of descriptors of all plug-ins that was successfully populated by this registry.- Specified by:
getPluginDescriptorsin interfacePluginRegistry- Returns:
- collection of
PluginDescriptorobjects - See Also:
PluginRegistry.getPluginDescriptors()
-
addPluginDescriptor
public MockPluginRegistry addPluginDescriptor(PluginDescriptor descr)
- Parameters:
descr- plug-in descriptor to add- Returns:
- this instance
-
getPluginFragments
public java.util.Collection<PluginFragment> getPluginFragments()
Description copied from interface:PluginRegistryReturns collection of descriptors of all plug-in fragments that was successfully populated by this registry.- Specified by:
getPluginFragmentsin interfacePluginRegistry- Returns:
- collection of
PluginFragmentobjects - See Also:
PluginRegistry.getPluginFragments()
-
addPluginFragment
public MockPluginRegistry addPluginFragment(PluginFragment fragment)
- Parameters:
fragment- plug-in fragment to add- Returns:
- this instance
-
getRegistrationReport
public IntegrityCheckReport getRegistrationReport()
- Specified by:
getRegistrationReportin interfacePluginRegistry- Returns:
- plug-ins registration report for this registry
- See Also:
PluginRegistry.getRegistrationReport()
-
setRegistrationReport
public MockPluginRegistry setRegistrationReport(IntegrityCheckReport value)
- Parameters:
value- the registration report to set- Returns:
- this instance
-
isExtensionPointAvailable
public boolean isExtensionPointAvailable(java.lang.String pluginId, java.lang.String pointId)Description copied from interface:PluginRegistryChecks if extension point exists and is in valid state. If this method returnstrue, the methodPluginRegistry.getExtensionPoint(String, String)should always return valid extension point.- Specified by:
isExtensionPointAvailablein interfacePluginRegistry- Parameters:
pluginId- plug-in IDpointId- extension point ID- Returns:
trueif extension point exists and valid- See Also:
PluginRegistry.isExtensionPointAvailable( java.lang.String, java.lang.String)
-
isExtensionPointAvailable
public boolean isExtensionPointAvailable(java.lang.String uniqueId)
Description copied from interface:PluginRegistryChecks if extension point exists and is in valid state.- Specified by:
isExtensionPointAvailablein interfacePluginRegistry- Parameters:
uniqueId- extension point unique ID- Returns:
trueif extension point exists and valid- See Also:
PluginRegistry.isExtensionPointAvailable( java.lang.String)
-
isPluginDescriptorAvailable
public boolean isPluginDescriptorAvailable(java.lang.String pluginId)
Description copied from interface:PluginRegistryChecks if plug-in exists and is in valid state. If this method returnstrue, the methodPluginRegistry.getPluginDescriptor(String)should always return valid plug-in descriptor.- Specified by:
isPluginDescriptorAvailablein interfacePluginRegistry- Parameters:
pluginId- plug-in ID- Returns:
trueif plug-in exists and valid- See Also:
PluginRegistry.isPluginDescriptorAvailable( java.lang.String)
-
makeUniqueId
public java.lang.String makeUniqueId(java.lang.String pluginId, java.lang.String elementId)Description copied from interface:PluginRegistryConstructs unique identifier for some plug-in element from it's ID.- Specified by:
makeUniqueIdin interfacePluginRegistry- Parameters:
pluginId- plug-in IDelementId- element ID- Returns:
- unique ID
- See Also:
PluginRegistry.makeUniqueId( java.lang.String, java.lang.String)
-
makeUniqueId
public java.lang.String makeUniqueId(java.lang.String pluginId, Version version)Description copied from interface:PluginRegistryConstructs unique identifier for plug-in with given ID.- Specified by:
makeUniqueIdin interfacePluginRegistry- Parameters:
pluginId- plug-in IDversion- plug-in version identifier- Returns:
- unique plug-in ID
- See Also:
PluginRegistry.makeUniqueId( java.lang.String, org.java.plugin.registry.Version)
-
readManifestInfo
public ManifestInfo readManifestInfo(java.net.URL manifest)
Description copied from interface:PluginRegistryReads basic information from a plug-in or plug-in fragment manifest.- Specified by:
readManifestInfoin interfacePluginRegistry- Parameters:
manifest- manifest data URL- Returns:
- manifest info
- See Also:
PluginRegistry.readManifestInfo( java.net.URL)
-
register
public java.util.Map<java.lang.String,Identity> register(java.net.URL[] manifests)
Description copied from interface:PluginRegistryRegisters plug-ins and plug-in fragments in this registry. Note that this method not makes plug-ins available for activation by anyPluginManagerinstance as it is not aware of any manager. Using this method just makes plug-in meta-data available for reading from this registry.If more than one version of the same plug-in or plug-in fragment given, the only latest version should be registered. If some plug-in or plug-in fragment already registered it should be ignored by this method. Client application have to un-register such plug-ins first before registering their newest versions.
- Specified by:
registerin interfacePluginRegistry- Parameters:
manifests- array of manifest locations- Returns:
- map where keys are URL's and values are registered plug-ins or plug-in fragments, URL's for unprocessed manifests are not included
- See Also:
PluginRegistry.register(java.net.URL[])
-
registerListener
public void registerListener(PluginRegistry.RegistryChangeListener listener)
Description copied from interface:PluginRegistryRegisters plug-in registry change event listener. If given listener has been registered before, this method should throw anIllegalArgumentException.- Specified by:
registerListenerin interfacePluginRegistry- Parameters:
listener- new registry change event listener- See Also:
PluginRegistry.registerListener( org.java.plugin.registry.PluginRegistry.RegistryChangeListener)
-
unregister
public java.util.Collection<java.lang.String> unregister(java.lang.String[] ids)
Description copied from interface:PluginRegistryUnregisters plug-ins and plug-in fragments with given ID's (including depending plug-ins and plug-in fragments).- Specified by:
unregisterin interfacePluginRegistry- Parameters:
ids- ID's of plug-ins and plug-in fragments to be unregistered- Returns:
- collection of UID's of actually unregistered plug-ins and plug-in fragments
- See Also:
PluginRegistry.unregister( java.lang.String[])
-
unregisterListener
public void unregisterListener(PluginRegistry.RegistryChangeListener listener)
Description copied from interface:PluginRegistryUnregisters registry change event listener. If given listener hasn't been registered before, this method should throw anIllegalArgumentException.- Specified by:
unregisterListenerin interfacePluginRegistry- Parameters:
listener- registered listener- See Also:
PluginRegistry.unregisterListener( org.java.plugin.registry.PluginRegistry.RegistryChangeListener)
-
-