LifeCycleManager (Java EE 5 SDK)

javax.xml.registry Interface LifeCycleManager

所有已知子接口:

BusinessLifeCycleManager

public interface LifeCycleManager

The LifeCycleManager interface is the main interface in the API for managing life cycle operations on objects defined by the information model.

The factory methods of this interface must throw an 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.

作者:

Farrukh S. Najmi

ASSOCIATION

static final String ASSOCIATION

另请参见:

常量字段

AUDITABLE_EVENT

static final String AUDITABLE_EVENT

另请参见:

常量字段

CLASSIFICATION

static final String CLASSIFICATION

另请参见:

常量字段

CLASSIFICATION_SCHEME

static final String CLASSIFICATION_SCHEME

另请参见:

常量字段

CONCEPT

static final String CONCEPT

另请参见:

常量字段

EMAIL_ADDRESS

static final String EMAIL_ADDRESS

另请参见:

常量字段

EXTERNAL_IDENTIFIER

static final String EXTERNAL_IDENTIFIER

另请参见:

常量字段

EXTERNAL_LINK

static final String EXTERNAL_LINK

另请参见:

常量字段

EXTRINSIC_OBJECT

static final String EXTRINSIC_OBJECT

另请参见:

常量字段

INTERNATIONAL_STRING

static final String INTERNATIONAL_STRING

另请参见:

常量字段

KEY

static final String KEY

另请参见:

常量字段

LOCALIZED_STRING

static final String LOCALIZED_STRING

另请参见:

常量字段

ORGANIZATION

static final String ORGANIZATION

另请参见:

常量字段

PERSON_NAME

static final String PERSON_NAME

另请参见:

常量字段

POSTAL_ADDRESS

static final String POSTAL_ADDRESS

另请参见:

常量字段

REGISTRY_ENTRY

static final String REGISTRY_ENTRY

另请参见:

常量字段

REGISTRY_PACKAGE

static final String REGISTRY_PACKAGE

另请参见:

常量字段

SERVICE

static final String SERVICE

另请参见:

常量字段

SERVICE_BINDING

static final String SERVICE_BINDING

另请参见:

常量字段

SLOT

static final String SLOT

另请参见:

常量字段

SPECIFICATION_LINK

static final String SPECIFICATION_LINK

另请参见:

常量字段

TELEPHONE_NUMBER

static final String TELEPHONE_NUMBER

另请参见:

常量字段

USER

static final String USER

另请参见:

常量字段

VERSIONABLE

static final String VERSIONABLE

另请参见:

常量字段

createObject

Object createObject(String interfaceName)
                    throws JAXRException,
                           InvalidRequestException,
                           UnsupportedCapabilityException

Creates instances of information model interfaces (factory method). To create an Organization, use this method as follows:

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

Capability Level: 0

参数:

interfaceName - the unqualified name of an interface in the javax.xml.registry.infomodel package

返回:

an Object that can then be cast to an instance of the interface

抛出异常:

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

Association createAssociation(RegistryObject targetObject,
                              Concept associationType)
                              throws JAXRException

Creates an Association instance using the specified parameters. The sourceObject is left null and will be set when the Association is added to a RegistryObject.

Note that for a UDDI provider an Association may only be created between Organizations.

Capability Level: 0

参数:

targetObject - the target RegistryObject for the association

associationType - the association type for the Association

返回:

the Association instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createClassification

Classification createClassification(ClassificationScheme scheme,
                                    String name,
                                    String value)
                                    throws JAXRException

Creates a Classification instance for an external Classification using the specified String name and String value that identify a taxonomy element within the specified ClassificationScheme.

Capability Level: 0

参数:

scheme - the ClassificationScheme to be used

name - the name of the taxonomy element (a String)

value - the value of the taxonomy element

返回:

the Classification instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createClassification

Classification createClassification(ClassificationScheme scheme,
                                    InternationalString name,
                                    String value)
                                    throws JAXRException

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

参数:

scheme - the ClassificationScheme to be used

name - the name of the taxonomy element (an InternationalString)

value - the value of the taxonomy element

返回:

the Classification instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createClassification

Classification createClassification(Concept concept)
                                    throws JAXRException,
                                           InvalidRequestException

Creates a Classification instance for an internal Classification using the specified Concept that identifies a taxonomy element within an internal ClassificationScheme.

Capability Level: 0

参数:

concept - the Concept that identifies the taxonomy element

返回:

the Classification instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

InvalidRequestException - if the Concept is not under a ClassificationScheme

createClassificationScheme

ClassificationScheme createClassificationScheme(String name,
                                                String description)
                                                throws JAXRException,
                                                       InvalidRequestException

Creates a ClassificationScheme given the specified String parameters.

Capability Level: 0

参数:

name - the name of the ClassificationScheme (a String)

description - a description of the ClassificationScheme (a String)

返回:

the ClassificationScheme instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

InvalidRequestException

createClassificationScheme

ClassificationScheme createClassificationScheme(InternationalString name,
                                                InternationalString description)
                                                throws JAXRException,
                                                       InvalidRequestException

Creates a ClassificationScheme given the specified InternationalString parameters.

Capability Level: 0

参数:

name - the name of the ClassificationScheme (an InternationalString)

description - a description of the ClassificationScheme (an InternationalString)

返回:

the ClassificationScheme instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

InvalidRequestException

createClassificationScheme

ClassificationScheme createClassificationScheme(Concept concept)
                                                throws JAXRException,
                                                       InvalidRequestException

Creates a ClassificationScheme from a Concept that has no ClassificationScheme or parent Concept.

This method is a special-case method to do a type-safe conversion from Concept to ClassificationScheme.

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 programmer to make sure that the Concept is indeed semantically a ClassificationScheme.

This method is necessary because in the UDDI specification 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. The UDDI specification leaves the determination to the programmer, and consequently so does this method.

Capability Level: 0

参数:

concept - the Concept to be used

返回:

the ClassificationScheme instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

InvalidRequestException - if the Concept has a parent Concept or is under a ClassificationScheme

createConcept

Concept createConcept(RegistryObject parent,
                      String name,
                      String value)
                      throws JAXRException

Creates a Concept instance using the specified parameters, where the name is a String.

Capability Level: 0

参数:

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

返回:

the Concept instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createConcept

Concept createConcept(RegistryObject parent,
                      InternationalString name,
                      String value)
                      throws JAXRException

Creates a Concept instance using the specified parameters, where the name is an InternationalString.

Capability Level: 0

参数:

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

返回:

the Concept instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createEmailAddress

EmailAddress createEmailAddress(String address)
                                throws JAXRException

Creates an EmailAddress instance using an address as the parameter.

Capability Level: 0

参数:

address - the email address

返回:

the EmailAddress instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createEmailAddress

EmailAddress createEmailAddress(String address,
                                String type)
                                throws JAXRException

Creates an EmailAddress instance using both an address and a type as parameters.

Capability Level: 0

参数:

address - the email address

type - the type of the address

返回:

the EmailAddress instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createExternalIdentifier

ExternalIdentifier createExternalIdentifier(ClassificationScheme identificationScheme,
                                            String name,
                                            String value)
                                            throws JAXRException

Creates an ExternalIdentifier instance using the specified parameters, where the name is a String.

Capability Level: 0

参数:

identificationScheme - the ClassificationScheme used

name - the name of the external identifier (a String)

value - the value of the external identifier

返回:

the ExternalIdentifier instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createExternalIdentifier

ExternalIdentifier createExternalIdentifier(ClassificationScheme identificationScheme,
                                            InternationalString name,
                                            String value)
                                            throws JAXRException

Creates an ExternalIdentifier instance using the specified parameters, where the name is an InternationalString.

Capability Level: 0

参数:

identificationScheme - the ClassificationScheme used

name - the name of the external identifier (an InternationalString)

value - the value of the external identifier

返回:

the ExternalIdentifier instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createExternalLink

ExternalLink createExternalLink(String externalURI,
                                String description)
                                throws JAXRException

Creates an ExternalLink instance using the specified parameters, where the description is a String.

Capability Level: 0

参数:

externalURI - the external URI

description - a description of the link (a String)

返回:

the ExternalLink instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createExternalLink

ExternalLink createExternalLink(String externalURI,
                                InternationalString description)
                                throws JAXRException

Creates an ExternalLink instance using the specified parameters, where the description is an InternationalString.

Capability Level: 0

参数:

externalURI - the external URI

description - a description of the link (an InternationalString)

返回:

the ExternalLink instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createExtrinsicObject

ExtrinsicObject createExtrinsicObject(DataHandler repositoryItem)
                                      throws JAXRException

Creates an ExtrinsicObject instance using the specified parameters.

Capability Level: 1

参数:

repositoryItem - the DataHandler for the repository item. Must not be null.

返回:

the ExtrinsicObject instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createInternationalString

InternationalString createInternationalString()
                                              throws JAXRException

Creates an empty InternationalString instance.

Capability Level: 0

返回:

the InternationalString instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createInternationalString

InternationalString createInternationalString(String s)
                                              throws JAXRException

Creates an InternationalString instance using a String parameter and the default Locale.

Capability Level: 0

参数:

s - the String from which to create the InternationalString

返回:

the InternationalString instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createInternationalString

InternationalString createInternationalString(Locale l,
                                              String s)
                                              throws JAXRException

Creates an InternationalString instance using the specified Locale and String parameters.

Capability Level: 0

参数:

l - the Locale in which to create the InternationalString

s - the String from which to create the InternationalString

返回:

the InternationalString instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createKey

Key createKey(String id)
              throws JAXRException

Creates a Key instance from an ID.

Capability Level: 0

参数:

id - the ID string from which to create the Key

返回:

the Key instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createLocalizedString

LocalizedString createLocalizedString(Locale l,
                                      String s)
                                      throws JAXRException

Creates a LocalizedString instance using the specified Locale and String parameters.

Capability Level: 0

参数:

l - the Locale in which to create the LocalizedString

s - the String from which to create the LocalizedString

返回:

the LocalizedString instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createLocalizedString

LocalizedString createLocalizedString(Locale l,
                                      String s,
                                      String charSetName)
                                      throws JAXRException

Creates a LocalizedString instance using the specified Locale, String, and character set parameters.

Capability Level: 0

参数:

l - 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

返回:

the LocalizedString instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createOrganization

Organization createOrganization(String name)
                                throws JAXRException

Creates an Organization instance using the specified name, where the name is a String.

Capability Level: 0

参数:

name - the name of the Organization

返回:

the Organization instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createOrganization

Organization createOrganization(InternationalString name)
                                throws JAXRException

Creates an Organization instance using the specified name, where the name is an InternationalString.

Capability Level: 0

参数:

name - the name of the Organization

返回:

the Organization instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createPersonName

PersonName createPersonName(String firstName,
                            String middleName,
                            String lastName)
                            throws JAXRException

Creates a PersonName instance using the specified first, middle, and last names.

Capability Level: 1

参数:

firstName - the person's first name

middleName - the person's middle name

lastName - the person's last name

返回:

the PersonName instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createPersonName

PersonName createPersonName(String fullName)
                            throws JAXRException

Creates a PersonName instance using the specified full name.

Capability Level: 0

参数:

fullName - the person's full name

返回:

the PersonName instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createPostalAddress

PostalAddress createPostalAddress(String streetNumber,
                                  String street,
                                  String city,
                                  String stateOrProvince,
                                  String country,
                                  String postalCode,
                                  String type)
                                  throws JAXRException

Creates a PostalAddress instance using the specified parameters.

Capability Level: 0

参数:

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

返回:

the PostalAddress instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createRegistry软件包

RegistryPackage createRegistryPackage(String name)
                                      throws JAXRException

Creates a RegistryPackage instance using the specified name, where the name is a String.

Capability Level: 1

参数:

name - the name of the registry package (a String)

返回:

the RegistryPackage instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createRegistry软件包

RegistryPackage createRegistryPackage(InternationalString name)
                                      throws JAXRException

Creates a RegistryPackage instance using the specified name, where the name is an InternationalString.

Capability Level: 1

参数:

name - the name of the registry package (an InternationalString)

返回:

the RegistryPackage instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createService

Service createService(String name)
                      throws JAXRException

Creates a Service instance using the specified name, where the name is a String.

Capability Level: 0

参数:

name - the name of the Service (a String)

返回:

the Service instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createService

Service createService(InternationalString name)
                      throws JAXRException

Creates a Service instance using the specified name, where the name is an InternationalString.

Capability Level: 0

参数:

name - the name of the Service (an InternationalString)

返回:

the Service instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createServiceBinding

ServiceBinding createServiceBinding()
                                    throws JAXRException

Creates an empty ServiceBinding instance.

Capability Level: 0

返回:

the ServiceBinding instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createSlot

Slot createSlot(String name,
                String value,
                String slotType)
                throws JAXRException

Creates a Slot instance using the specified parameters, where the value is a String.

Capability Level: 0

参数:

name - the name of the Slot

value - the value (a String)

slotType - the slot type

返回:

the Slot instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createSlot

Slot createSlot(String name,
                Collection values,
                String slotType)
                throws JAXRException

Creates a Slot instance using the specified parameters, where the value is a Collection of Strings.

Capability Level: 0

参数:

name - the name of the Slot

value - the value (a Collection of Strings)

slotType - the slot type

返回:

the Slot instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createSpecificationLink

SpecificationLink createSpecificationLink()
                                          throws JAXRException

Creates an empty SpecificationLink instance.

Capability Level: 0

返回:

the SpecificationLink instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createTelephoneNumber

TelephoneNumber createTelephoneNumber()
                                      throws JAXRException

Creates an empty TelephoneNumber instance.

Capability Level: 0

返回:

the TelephoneNumber instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

createUser

User createUser()
                throws JAXRException

Creates an empty User instance.

Capability Level: 0

返回:

the User instance created

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

saveObjects

BulkResponse saveObjects(Collection objects)
                         throws JAXRException

Saves one or more Objects to the registry. An object may be a RegistryObject subclass instance.

If an object is not in the registry, 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

参数:

objects - a potentially heterogeneous Collection of RegistryObject instances

返回:

a BulkResponse containing the Collection of keys for those objects that were saved successfully and any SaveException that was encountered in case of partial commit

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

deprecateObjects

BulkResponse deprecateObjects(Collection keys)
                              throws JAXRException

Deprecates one or more previously submitted objects. Deprecation marks an object as "soon to be deleted". Once an object is deprecated, the JAXR provider must not allow any new references (e.g. new Associations, Classifications and ExternalLinks) to that object to be submitted. If a client makes an API call that results in a new reference to a deprecated object, the JAXR provider must throw a java.lang.IllegalStateException within a JAXRException. However, existing references to a deprecated object continue to function normally.

Capability Level: 1

参数:

keys - a Collection of keys for the objects to be deprecated

返回:

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

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

unDeprecateObjects

BulkResponse unDeprecateObjects(Collection keys)
                                throws JAXRException

Undeprecates one or more previously deprecated objects. If an object was not previously deprecated, it is not an error, and no exception is thrown. Once an object is undeprecated, the JAXR provider must again allow new references (e.g. new Associations, Classifications and ExternalLinks) to that object to be submitted.

Capability Level: 1

参数:

keys - a Collection of keys for the objects to be undeprecated

返回:

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

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

deleteObjects

BulkResponse deleteObjects(Collection keys)
                           throws JAXRException

Deletes one or more previously submitted objects from the registry using the object keys.

Capability Level: 1

参数:

keys - a Collection of keys for the objects to be deleted

返回:

a BulkResponse containing the Collection of keys for those objects that were deleted successfully and any DeleteException that was encountered in case of partial commit

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

deleteObjects

BulkResponse deleteObjects(Collection keys,
                           String objectType)
                           throws JAXRException

Deletes one or more previously submitted objects from the registry using the object keys and a specified objectType attribute.

Capability Level: 0

参数:

keys - a Collection of keys for the objects to be deleted

objectType - the objectType attribute for the objects to be deleted

返回:

a BulkResponse containing the Collection of keys for those objects that were deleted successfully and any DeleteException that was encountered in case of partial commit

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

getRegistryService

RegistryService getRegistryService()
                                   throws JAXRException

Returns the parent RegistryService that created this object.

Capability Level: 0

返回:

the parent RegistryService

抛出异常:

JAXRException - if the JAXR provider encounters an internal error

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.