|
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.
Passed To
Organization.{addUser( ), removeUser(
), setPrimaryContact( )}
Returned By
javax.xml.registry.LifeCycleManager.createUser( ),
AuditableEvent.getUser( ),
Organization.getPrimaryContact( )