com.hp.ucmdb.api.discovery.services

Interface DDMSoftwareSignatureService

public interface DDMSoftwareSignatureService

Services to define software items to be discovered by the Data Flow Probe components. The definitions are system-wide. If more than one Data Flow probe component is defined, the definitions apply to all of them.

Method Summary

Modifier and Type	Method and Description
void	disableSignature(String signatureID) Disables the SoftwareSignature.
void	enableSignature(String signatureID) Enables the SoftwareSignature.
DiscoveryFactory	getDiscoveryFactory() Returns the factory that creates the objects required by this service.
SoftwareSignature	getSignature(String signatureID) Returns the specified SoftwareSignature.
Collection<SoftwareSignature>	getSignatures() Returns the SoftwareSignature objects currently associated with the Universal Discovery system.
void	removeSignature(String signatureID) Removes the SoftwareSignature from the system.
void	setSignature(SoftwareSignature softwareSignature) Sets a softwareSignature to be available to the Data Flow Probe components.

Method Detail

setSignature

void setSignature(SoftwareSignature softwareSignature)
           throws IllegalArgumentException

Sets a softwareSignature to be available to the Data Flow Probe components.
If this is a new signature, it is added and enabled.
If a signature with the same ID already exists, the data is updated. If an existing signature is disabled, calling this method does not enable it.

Parameters:

softwareSignature - the SoftwareSignature.

Throws:

IllegalArgumentException - if the SoftwareSignature object is not valid

disableSignature

void disableSignature(String signatureID)
               throws SignatureDoesNotExistException

Disables the SoftwareSignature.
Disabled software is ignored by the Data Flow Probe components and cannot be discovered.

Parameters:

signatureID - the name of the SoftwareSignature.

Throws:

SignatureDoesNotExistException - ia signature named signatureID does not exist.

enableSignature

void enableSignature(String signatureID)
              throws SignatureDoesNotExistException

Enables the SoftwareSignature.
Enabled software can be discovered by the Data Flow probes.

Parameters:

signatureID - the name of the SoftwareSignature.

Throws:

SignatureDoesNotExistException - a signature named signatureID does not exist.

removeSignature

void removeSignature(String signatureID)
              throws SignatureDoesNotExistException

Removes the SoftwareSignature from the system.
After using this method, the software cannot be discovered by the Data Flow Probe components.

Parameters:

signatureID - the name of the SoftwareSignature.

Throws:

SignatureDoesNotExistException - a signature named signatureID does not exist.

getSignatures

Collection<SoftwareSignature> getSignatures()

Returns the SoftwareSignature objects currently associated with the Universal Discovery system.

Returns:

the SoftwareSignature objects currently associated with the Universal Discovery system.

getSignature

SoftwareSignature getSignature(String signatureID)

Returns the specified SoftwareSignature.
Changes made to the returned SoftwareSignature do not affect the Universal Discovery server.

Parameters:

signatureID - the name of the SoftwareSignature to retrieve.

Returns:

the specified SoftwareSignature, or null if no signature of the specified name exists.

getDiscoveryFactory

DiscoveryFactory getDiscoveryFactory()

Returns the factory that creates the objects required by this service.

Returns:

the factory that creates the objects required by this service.