Class LifeCycleManagerImpl

    • Constructor Detail

      • LifeCycleManagerImpl

        public LifeCycleManagerImpl()
    • Method Detail

      • createObject

        public Object createObject​(String className)
                            throws JAXRException
        Factory method for creating instances of information model interfaces. To create an Organization use it as follows:

        Organization org = lifeCycleMgr.createObject(LifeCycleManager.Organization);

        Specified by:
        createObject in interface LifeCycleManager
        Parameters:
        interfaceName - Is the unqualified name of an interface in the javax.xml.registry.infomodel package

        Throws InvalidRequestException if the interface is not an interface in from javax.xml.registry.infomodel package.

        Returns:
        an Object that can then be cast to an instance of the interface
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
        InvalidRequestException - if the interface is not an interface in the javax.xml.registry.infomodel package
        UnsupportedCapabilityException - if the client attempts to create an instance of an infomodel interface that is not supported by the capability level of the JAXR provider
      • createAssociation

        public Association createAssociation​(RegistryObject targetObject,
                                             Concept associationType)
                                      throws JAXRException
        Create an Association instance using the specified parameters. The sourceObject is left null and will be set wen the Association is added to a RegistryObject.
        Specified by:
        createAssociation in interface LifeCycleManager
        Parameters:
        targetObject - the target RegistryObject for the association
        associationType - the association type for the Association
        Returns:
        the Association instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createClassification

        public Classification createClassification​(ClassificationScheme scheme,
                                                   String name,
                                                   String value)
                                            throws JAXRException
        Create a Classification instance for an external Classification using the specified name and value that identifies a taxonomy element within specified ClassificationScheme.
        Specified by:
        createClassification in interface LifeCycleManager
        Parameters:
        scheme - the ClassificationScheme to be used
        name - the name of the taxonomy element (a String)
        value - the value of the taxonomy element
        Returns:
        the Classification instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createClassification

        public Classification createClassification​(Concept concept)
                                            throws JAXRException,
                                                   InvalidRequestException
        Create a Classification instance for an internal Classification using the specified Concept which identifies a taxonomy element within an internal ClassificationScheme.

        Throws InvalidRequestException if the Concept is not under a ClassificationScheme.

        Specified by:
        createClassification in interface LifeCycleManager
        Parameters:
        concept - the Concept that identifies the taxonomy element
        Returns:
        the Classification instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
        InvalidRequestException - if the Concept is not under a ClassificationScheme
      • createClassificationScheme

        public ClassificationScheme createClassificationScheme​(Concept concept)
                                                        throws JAXRException,
                                                               InvalidRequestException
        Creates a ClassificationScheme from a Concept that has no ClassificationScheme or parent Concept.

        This method is provided to allow for Concepts returned by the BusinessQueryManager findConcepts call to be safely cast to ClassificationScheme. It is up to the programer to make sure that the Concept is indeed semantically a ClassificationScheme.

        This method is necessary because in UDDI a tModel may serve multiple purposes and there is no way to know when a tModel maps to a Concept and when it maps to a ClassificationScheme. UDDI leaves the determination to the programmer and consequently so does this method.

        Throws InvalidRequestException if the Concept has a parent Concept or is under a ClassificationScheme.

        Specified by:
        createClassificationScheme in interface LifeCycleManager
        Parameters:
        concept - the Concept to be used
        Returns:
        the ClassificationScheme instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
        InvalidRequestException - if the Concept has a parent Concept or is under a ClassificationScheme
      • createConcept

        public Concept createConcept​(RegistryObject parent,
                                     String name,
                                     String value)
                              throws JAXRException
        Description copied from interface: LifeCycleManager
        Creates a Concept instance using the specified parameters, where the name is a String.

        Capability Level: 0
        Specified by:
        createConcept in interface LifeCycleManager
        Parameters:
        parent - a reference either to a parent ClassificationScheme or to a Concept
        name - the name of the concept (a String)
        value - the value of the concept
        Returns:
        the Concept instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createConcept

        public Concept createConcept​(RegistryObject parent,
                                     InternationalString name,
                                     String value)
                              throws JAXRException
        Description copied from interface: LifeCycleManager
        Creates a Concept instance using the specified parameters, where the name is an InternationalString.

        Capability Level: 0
        Specified by:
        createConcept in interface LifeCycleManager
        Parameters:
        parent - a reference either to a parent ClassificationScheme or to a Concept
        name - the name of the concept (an InternationalString)
        value - the value of the concept
        Returns:
        the Concept instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createEmailAddress

        public EmailAddress createEmailAddress​(String address,
                                               String type)
                                        throws JAXRException
        Description copied from interface: LifeCycleManager
        Creates an EmailAddress instance using both an address and a type as parameters.

        Capability Level: 0
        Specified by:
        createEmailAddress in interface LifeCycleManager
        Parameters:
        address - the email address
        type - the type of the address
        Returns:
        the EmailAddress instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createExternalIdentifier

        public ExternalIdentifier createExternalIdentifier​(ClassificationScheme identificationScheme,
                                                           String name,
                                                           String value)
                                                    throws JAXRException
        Create an ExternalIdentifier instance using the specified parameters.
        Specified by:
        createExternalIdentifier in interface LifeCycleManager
        Parameters:
        identificationScheme - the ClassificationScheme used
        name - the name of the external identifier (a String)
        value - the value of the external identifier
        Returns:
        the ExternalIdentifier instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createExternalLink

        public ExternalLink createExternalLink​(String externalURI,
                                               String description)
                                        throws JAXRException
        Create an ExternalLink instance using the specified parameters.
        Specified by:
        createExternalLink in interface LifeCycleManager
        Parameters:
        externalURI - the external URI
        description - a description of the link (a String)
        Returns:
        the ExternalLink instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createKey

        public Key createKey​(String id)
                      throws JAXRException
        Create a Key instance using the specified parameters.
        Specified by:
        createKey in interface LifeCycleManager
        Parameters:
        id - the ID string from which to create the Key
        Returns:
        the Key instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createPersonName

        public PersonName createPersonName​(String fullName)
                                    throws JAXRException
        Create a PersonName instance using the specified parameters.
        Specified by:
        createPersonName in interface LifeCycleManager
        Parameters:
        fullName - the person's full name
        Returns:
        the PersonName instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createPostalAddress

        public PostalAddress createPostalAddress​(String streetNumber,
                                                 String street,
                                                 String city,
                                                 String stateOrProvince,
                                                 String country,
                                                 String postalCode,
                                                 String type)
                                          throws JAXRException
        Create a PostalAddress instance using the specified parameters.
        Specified by:
        createPostalAddress in interface LifeCycleManager
        Parameters:
        streetNumber - the street number
        street - the street name
        city - the city name
        stateOrProvince - the state or province name
        country - the country name
        postalCode - the postal code (such as a US ZIP code)
        type - the type of the address
        Returns:
        the PostalAddress instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createService

        public Service createService​(String name)
                              throws JAXRException
        Description copied from interface: LifeCycleManager
        Creates a Service instance using the specified name, where the name is a String.

        Capability Level: 0
        Specified by:
        createService in interface LifeCycleManager
        Parameters:
        name - the name of the Service (a String)
        Returns:
        the Service instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createSlot

        public Slot createSlot​(String name,
                               String value,
                               String slotType)
                        throws JAXRException
        Create a Slot instance using the specified parameters.
        Specified by:
        createSlot in interface LifeCycleManager
        Parameters:
        name - the name of the Slot
        value - the value (a String)
        slotType - the slot type
        Returns:
        the Slot instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createSlot

        public Slot createSlot​(String name,
                               Collection values,
                               String slotType)
                        throws JAXRException
        Create a Slot instance using the specified parameters.
        Specified by:
        createSlot in interface LifeCycleManager
        Parameters:
        name - the name of the Slot
        slotType - the slot type
        Returns:
        the Slot instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • saveObjects

        public BulkResponse saveObjects​(Collection cataloguedObjects)
                                 throws JAXRException
        Saves one or more CataloguedObjects to the registry. If an object is not in the registry, then it is created in the registry. If it already exists in the registry and has been modified, then its state is updated (replaced) in the registry.

        Capability Level: 0
        Specified by:
        saveObjects in interface LifeCycleManager
        Parameters:
        cataloguedObjects - a potentially heterogeneous Collection of RegistryObject instances
        Returns:
        BulkResponse containing the Collection of keys for those objects that were saved successfully and any SaveException that was encountered in case of partial commit.
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • deleteObjects

        public BulkResponse deleteObjects​(Collection keys)
                                   throws JAXRException
        Deletes one or more previously submitted objects from the registry.

        Capability Level: 1
        Specified by:
        deleteObjects in interface LifeCycleManager
        Parameters:
        keys - a Collection of keys for the objects to be deleted
        Returns:
        BulkResponse containing the Collection of keys for those objects that were deleted successfully and any DeleteException that was encountered in case of partial commit.
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • deleteObjects

        public BulkResponse deleteObjects​(Collection keys,
                                          String objectType)
                                   throws JAXRException
        Deletes one or more previously submitted objects from the registry.

        Capability Level: 0
        Specified by:
        deleteObjects in interface LifeCycleManager
        Parameters:
        keys - a Collection of keys for the objects to be deleted
        objectType - the objectType attribute for the objects to be deleted
        Returns:
        BulkResponse containing the Collection of keys for those objects that were deleted successfully and any DeleteException that was encountered in case of partial commit.
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createConceptEquivalence

        public void createConceptEquivalence​(Concept concept1,
                                             Concept concept2)
                                      throws JAXRException
        Create a semantic equivalence between the two specified Concepts. This is a convenience method to create an Association with sourceObject as concept1 and targetObject as concept2 and associationType as EquivalentTo.

        Capability Level: 0
        Throws:
        JAXRException
      • deleteConceptEquivalence

        public void deleteConceptEquivalence​(Concept concept1,
                                             Concept concept2)
                                      throws JAXRException
        Removes the semantic equivalence, if any, between the specified two Concepts. This is a convenience method to to delete any Association sourceObject as concept1 and targetObject as concept2 and associationType as EquivalentTo.

        Capability Level: 0
        Throws:
        JAXRException
      • createLocalizedString

        public LocalizedString createLocalizedString​(Locale locale,
                                                     String str)
                                              throws JAXRException
        Description copied from interface: LifeCycleManager
        Creates a LocalizedString instance using the specified Locale and String parameters.

        Capability Level: 0
        Specified by:
        createLocalizedString in interface LifeCycleManager
        Parameters:
        locale - the Locale in which to create the LocalizedString
        str - the String from which to create the LocalizedString
        Returns:
        the LocalizedString instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createInternationalString

        public InternationalString createInternationalString​(Locale locale,
                                                             String str)
                                                      throws JAXRException
        Description copied from interface: LifeCycleManager
        Creates an InternationalString instance using the specified Locale and String parameters.

        Capability Level: 0
        Specified by:
        createInternationalString in interface LifeCycleManager
        Parameters:
        locale - the Locale in which to create the InternationalString
        str - the String from which to create the InternationalString
        Returns:
        the InternationalString instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createInternationalString

        public InternationalString createInternationalString​(String str)
                                                      throws JAXRException
        Description copied from interface: LifeCycleManager
        Creates an InternationalString instance using a String parameter and the default Locale.

        Capability Level: 0
        Specified by:
        createInternationalString in interface LifeCycleManager
        Parameters:
        str - the String from which to create the InternationalString
        Returns:
        the InternationalString instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createClassification

        public Classification createClassification​(ClassificationScheme classificationScheme,
                                                   InternationalString name,
                                                   String value)
                                            throws JAXRException
        Description copied from interface: LifeCycleManager
        Creates a Classification instance for an external Classification using the specified InternationalString name and String value that identify a taxonomy element within the specified ClassificationScheme.

        Capability Level: 0
        Specified by:
        createClassification in interface LifeCycleManager
        Parameters:
        classificationScheme - the ClassificationScheme to be used
        name - the name of the taxonomy element (an InternationalString)
        value - the value of the taxonomy element
        Returns:
        the Classification instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createLocalizedString

        public LocalizedString createLocalizedString​(Locale locale,
                                                     String s,
                                                     String charsetName)
                                              throws JAXRException
        Description copied from interface: LifeCycleManager
        Creates a LocalizedString instance using the specified Locale, String, and character set parameters.

        Capability Level: 0
        Specified by:
        createLocalizedString in interface LifeCycleManager
        Parameters:
        locale - the Locale in which to create the LocalizedString
        s - the String from which to create the LocalizedString
        charsetName - the name of the character set to use
        Returns:
        the LocalizedString instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createOrganization

        public Organization createOrganization​(String name)
                                        throws JAXRException
        Description copied from interface: LifeCycleManager
        Creates an Organization instance using the specified name, where the name is a String.

        Capability Level: 0
        Specified by:
        createOrganization in interface LifeCycleManager
        Parameters:
        name - the name of the Organization
        Returns:
        the Organization instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createExternalLink

        public ExternalLink createExternalLink​(String externalURI,
                                               InternationalString description)
                                        throws JAXRException
        Description copied from interface: LifeCycleManager
        Creates an ExternalLink instance using the specified parameters, where the description is an InternationalString.

        Capability Level: 0
        Specified by:
        createExternalLink in interface LifeCycleManager
        Parameters:
        externalURI - the external URI
        description - a description of the link (an InternationalString)
        Returns:
        the ExternalLink instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createExternalIdentifier

        public ExternalIdentifier createExternalIdentifier​(ClassificationScheme identificationScheme,
                                                           InternationalString name,
                                                           String value)
                                                    throws JAXRException
        Description copied from interface: LifeCycleManager
        Creates an ExternalIdentifier instance using the specified parameters, where the name is an InternationalString.

        Capability Level: 0
        Specified by:
        createExternalIdentifier in interface LifeCycleManager
        Parameters:
        identificationScheme - the ClassificationScheme used
        name - the name of the external identifier (an InternationalString)
        value - the value of the external identifier
        Returns:
        the ExternalIdentifier instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createService

        public Service createService​(InternationalString name)
                              throws JAXRException
        Description copied from interface: LifeCycleManager
        Creates a Service instance using the specified name, where the name is an InternationalString.

        Capability Level: 0
        Specified by:
        createService in interface LifeCycleManager
        Parameters:
        name - the name of the Service (an InternationalString)
        Returns:
        the Service instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • createPersonName

        public PersonName createPersonName​(String firstName,
                                           String middleName,
                                           String lastName)
                                    throws JAXRException
        Level 1 method
        Specified by:
        createPersonName in interface LifeCycleManager
        Parameters:
        firstName - the person's first name
        middleName - the person's middle name
        lastName - the person's last name
        Returns:
        the PersonName instance created
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • deprecateObjects

        public BulkResponse deprecateObjects​(Collection keys)
                                      throws JAXRException
        Level 1 method
        Specified by:
        deprecateObjects in interface LifeCycleManager
        Parameters:
        keys - a Collection of keys for the objects to be deprecated
        Returns:
        a BulkResponse containing the Collection of keys for those objects that were deprecated successfully and any JAXRException that was encountered in case of partial commit
        Throws:
        JAXRException - if the JAXR provider encounters an internal error
      • unDeprecateObjects

        public BulkResponse unDeprecateObjects​(Collection keys)
                                        throws JAXRException
        Level 1 method
        Specified by:
        unDeprecateObjects in interface LifeCycleManager
        Parameters:
        keys - a Collection of keys for the objects to be undeprecated
        Returns:
        a BulkResponse containing the Collection of keys for those objects that were deprecated successfully and any JAXRException that was encountered in case of partial commit
        Throws:
        JAXRException - if the JAXR provider encounters an internal error