Service Registry 3.1 Developer's Guide

JAXR Information Model Interfaces

Table 3–1 lists the main interfaces supported by the JAXR information model. All these interfaces extend the RegistryObject interface. The table indicates objects specific to the Service Registry implementation of JAXR.

For more details, and for a figure that illustrates the relationships among these interfaces, see the API documentation for the javax.xml.registry.infomodel package at http://java.sun.com/j2ee/1.4/docs/api/javax/xml/registry/infomodel/package-summary.html.

Table 3–1 JAXR RegistryObject Subinterfaces


Interface Name	Description
`AdhocQuery`	(Implementation-specific) Represents an ad hoc query expressed in a query syntax. `AdhocQuery` objects are stored in the Registry and are used for discovery of registry objects. `AdhocQuery` objects are similar in purpose to the concept of stored procedures in relational databases.
`Association`	Defines a relationship between two objects. Getter and finder methods: `RegistryObject.getAssociations`, `BusinessQueryManager.findAssociations`, `BusinessQueryManager.findCallerAssociations`.
`AuditableEvent`	Provides a record of a change to an object. A collection of `AuditableEvent` objects constitutes an object’s audit trail. Getter method: `RegistryObject.getAuditTrail`.
`Classification`	Classifies an object by using a `ClassificationScheme`. Getter method: `RegistryObject.getClassifications`.
`ClassificationScheme`	Represents a taxonomy used to classify objects. In an internal `ClassificationScheme`, all taxonomy elements are defined in the registry as `Concept` instances. In an external `ClassificationScheme`, the values are not defined in the registry as `Concept` instances but instead are referenced by their `String` representations. Finder methods: `BusinessQueryManager.findClassificationSchemes`, `BusinessQueryManager.findClassificationSchemeByName`.
`Concept`	Represents a taxonomy element and its structural relationship with other elements in an internal `ClassificationScheme`. Called a `ClassificationNode` in the ebXML specifications. Finder methods: `BusinessQueryManager.findConcepts`, `BusinessQueryManager.findConceptByPath`.
`ExternalIdentifier`	Provides additional information about an object by using `String` values within an identification scheme (an external `ClassificationScheme`). Examples of identification schemes are DUNS numbers and Social Security numbers. Getter method: `RegistryObject.getExternalIdentifiers`.
`ExternalLink`	Provides a URI for content that resides outside the registry. Getter method: `RegistryObject.getExternalLinks`.
`ExtrinsicObject`	Provides metadata that describes submitted content whose type is not intrinsically known to the registry and that therefore must be described by means of additional attributes, such as MIME type. No specific getter or finder methods.
`Federation`	(Implementation-specific) Represents an affiliated group of registries. No specific getter or finder methods.
`Notification`	(Implementation-specific) Represents a notification from the registry regarding an event that matches a `Subscription.` No specific getter or finder methods.
`Organization`	Provides information about an organization. May have a parent, and may have one or more child organizations. Always has a User object as a primary contact, and may offer Service objects. Finder method: `BusinessQueryManager.findOrganizations`.
`Registry`	(Implementation-specific) Represents a registry. No specific getter or finder methods.
`RegistryPackage`	Represents a logical grouping of registry objects. A `RegistryPackage` may have any number of `RegistryObject`s. Getter and finder methods: `RegistryObject.getRegistryPackages`, `BusinessQueryManager.findRegistryPackages`.
`Service`	Provides information on a service. May have a set of `ServiceBinding` objects. Finder method: `BusinessQueryManager.findServices`.
`ServiceBinding`	Represents technical information on how to access a `Service`. Getter and finder methods: `Service.getServiceBindings`, `BusinessQueryManager.findServiceBindings`.
`SpecificationLink`	Provides the linkage between a `ServiceBinding` and a technical specification that describes how to use the service by using the `ServiceBinding`. Getter method: `ServiceBinding.getSpecificationLinks`.
`Subscription`	(Implementation-specific) Defines a `User`'s interest in certain types of `AuditableEvent` objects. No specific getter or finder methods.
`User`	Provide information about registered users within the registry. `User` objects are affiliated with `Organization` objects. Getter methods: `Organization.getUsers`, `Organization.getPrimaryContact`.

Table 3–2 lists the other interfaces supported by the JAXR information model. These interfaces provide attributes for the main registry objects. These interfaces do not extend the RegistryObject interface.

Table 3–2 JAXR Information Model Interfaces Used as Attributes


Interface Name	Description
`EmailAddress`	Represents an email address. A `User` can have an `EmailAddress`. Getter method: `User.getEmailAddresses`.
`InternationalString`	Represents a `String` that can be internationalized into several locales. Contains a `Collection` of `LocalizedString` objects. The name and description of a `RegistryObject` are `InternationalString` objects. Getter methods: `RegistryObject.getName`, `RegistryObject.getDescription`.
`Key`	An object that identifies a `RegistryObject`. Contains a unique identifier value that must be a unique URN, such as a DCE 128 UUID (Universal Unique IDentifier). Getter method: `RegistryObject.getKey`.
`LocalizedString`	A component of an `InternationalString` that associates a `String` with its `Locale`. Getter method: `InternationalString.getLocalizedStrings`.
`PersonName`	Represents a person’s name. A `User` has a `PersonName`. Getter method: `User.getPersonName`.
`PostalAddress`	Represents a postal address. An `Organization` or `User` can have one or more `PostalAddress` objects. Getter methods: `Organization.getPostalAddress`, `OrganizationImpl.getPostalAddresses` (implementation-specific), `User.getPostalAddresses`.
`Slot`	Provides a dynamic way to add arbitrary attributes to `RegistryObject` instances. Getter methods: `RegistryObject.getSlot`, `RegistryObject.getSlots`.
`TelephoneNumber`	Represents a telephone number. An `Organization` or a `User` can have one or more `TelephoneNumber` objects. Getter methods: `Organization.getTelephoneNumbers`, `User.getTelephoneNumbers`.