User | javax.xml.registry.infomodel |
JAXR 1.0; JWSDP 1.0, J2EE 1.4 |
public interface User extends RegistryObject { // Property Accessor Methods (by property name) public abstract Collection getEmailAddresses( ) throws javax.xml.registry.JAXRException; //L0 public abstract void setEmailAddresses(Collection emailAddresses ) throws javax.xml.registry.JAXRException; //L0 public abstract Organization getOrganization( ) throws javax.xml.registry.JAXRException; //L0 public abstract PersonName getPersonName( ) throws javax.xml.registry.JAXRException; //L0 public abstract void setPersonName(PersonName personName ) throws javax.xml.registry.JAXRException; //L0 public abstract Collection getPostalAddresses( ) throws javax.xml.registry.JAXRException; //L0 public abstract void setPostalAddresses(Collection addresses ) throws javax.xml.registry.JAXRException; //L0 public abstract String getType( ) throws javax.xml.registry.JAXRException; //L0 public abstract void setType(String type ) throws javax.xml.registry.JAXRException; //L0 public abstract java.net.URL getUrl( ) throws javax.xml.registry.JAXRException; //L1 public abstract void setUrl(java.net.URL url ) throws javax.xml.registry.JAXRException; //L1 // Public Instance Methods public abstract Collection getTelephoneNumbers( String phoneType ) throws javax.xml.registry.JAXRException; //L0 public abstract void setTelephoneNumbers(Collection phoneNumbers ) throws javax.xml.registry.JAXRException; //L0 }
The User interface represents a registry user. Every object in the registry is associated with the User object of the user that created it and, in a level 1 registry, changes to registry content are audited using the User object of the authenticated user that made the change in order to preserve accountability. The User object is also used to ensure that updates can only be made by the owner of the object being modified.
When used by the registry for auditing and authorization checks, the User object is created from authentication supplied when the user connected to the registry. It is also possible for a registry client to create a User object by calling the createUser( ) method of LifeCycleManager . An object created in this way is used to assign the primary contact for or to add a user to an Organization .
Like many other objects in this package, the User interface consists mainly of getter and setter methods that access attributes of the object. A User object has the following attributes:
The Organization with which the user is associated. Unlike the other attributes, this one cannot be modified. It is set when the user is added to the Organization object either as the primary contact or as an ordinary user.
A name, held in the form of a PersonName object.
A type, which is an arbitrary string that probably has some specific meaning within the organization that assigned it.
A collection of postal addresses, represented by objects of type PostalAddress .
A collection of TelephoneNumber objects supplying contact numbers of various types (home, office, mobile, fax, etc.) for the user.
A collection of email addresses, represented by objects of type EmailAddress .
For level 1 registries only, a URL that is owned by the user in some way. This might, for example, be the URL of the user's home page or, in the case of the primary contact for an Organization , the URL of a page that is relevant to the services that it has published in the registry.
Organization.{addUser( ) , removeUser( ) , setPrimaryContact( )}
javax.xml.registry.LifeCycleManager.createUser( ) , AuditableEvent.getUser( ) , Organization.getPrimaryContact( )