Package 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 Details

    • 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.