org.objectweb.joram.client.jms.admin
Class User

java.lang.Object
  extended byorg.objectweb.joram.client.jms.admin.AdministeredObject
      extended byorg.objectweb.joram.client.jms.admin.User
All Implemented Interfaces:
javax.naming.Referenceable, java.io.Serializable, SoapObjectItf

public class User
extends AdministeredObject

The User class is a utility class needed for administering JORAM users.

See Also:
Serialized Form

Field Summary
 
Fields inherited from class org.objectweb.joram.client.jms.admin.AdministeredObject
id, instancesTable
 
Constructor Summary
User(java.lang.String name, java.lang.String proxyId)
          Constructs an User instance.
 
Method Summary
 java.util.Hashtable code()
          Codes an User instance as a Hashtable for travelling through the SOAP protocol.
static User create(java.lang.String name, java.lang.String password)
          Admin method creating a user on the local server and instanciating the corresponding User object.
static User create(java.lang.String name, java.lang.String password, int serverId)
          Admin method creating a user for a given server and instanciating the corresponding User object.
 java.lang.Object decode(java.util.Hashtable h)
          Decodes an User which travelled through the SOAP protocol.
 void delete()
          Removes this user.
 boolean equals(java.lang.Object o)
          Provides a reliable way to compare User instances.
 DeadMQueue getDMQ()
          Returns the dead message queue for this user, null if not set.
 java.lang.String getName()
          Returns the user name.
 java.lang.String getProxyId()
          Returns the identifier of the user's proxy.
 javax.naming.Reference getReference()
          Sets the naming reference of this user.
 int getThreshold()
          Returns the threshold for this user, -1 if not set.
 void setDMQ(DeadMQueue dmq)
          Admin method setting a given dead message queue for this user.
 void setThreshold(int thresh)
          Admin method setting a given value as the threshold for this user.
 java.lang.String toString()
          Returns a string view of this User instance.
 void update(java.lang.String newName, java.lang.String newPassword)
          Admin method updating this user identification.
 
Methods inherited from class org.objectweb.joram.client.jms.admin.AdministeredObject
getInstance
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

User

public User(java.lang.String name,
            java.lang.String proxyId)
Constructs an User instance.

Parameters:
name - The name of the user.
proxyId - Identifier of the user's proxy agent.
Method Detail

toString

public java.lang.String toString()
Returns a string view of this User instance.


getName

public java.lang.String getName()
Returns the user name.


equals

public boolean equals(java.lang.Object o)
Provides a reliable way to compare User instances.


create

public static User create(java.lang.String name,
                          java.lang.String password,
                          int serverId)
                   throws java.net.ConnectException,
                          AdminException
Admin method creating a user for a given server and instanciating the corresponding User object.

If the user has already been set on this server, the method simply returns the corresponding User object. Its fails if the target server does not belong to the platform, or if a proxy could not be deployed server side for a new user.

Parameters:
name - Name of the user.
password - Password of the user.
serverId - The identifier of the user's server.
Throws:
java.net.ConnectException - If the connection fails.
AdminException - If the request fails.

create

public static User create(java.lang.String name,
                          java.lang.String password)
                   throws java.net.ConnectException,
                          AdminException
Admin method creating a user on the local server and instanciating the corresponding User object.

If the user has already been set on this server, the method simply returns the corresponding User object. It fails if a proxy could not be deployed server side for a new user.

Parameters:
name - Name of the user.
password - Password of the user.
Throws:
java.net.ConnectException - If the connection fails.
AdminException - If the request fails.

update

public void update(java.lang.String newName,
                   java.lang.String newPassword)
            throws java.net.ConnectException,
                   AdminException
Admin method updating this user identification.

The request fails if the user does not exist server side, or if the new identification is already taken by a user on the same server.

Parameters:
newName - The new name of the user.
newPassword - The new password of the user.
Throws:
java.net.ConnectException - If the connection fails.
AdminException - If the request fails.

delete

public void delete()
            throws java.net.ConnectException,
                   AdminException
Removes this user.

Throws:
java.net.ConnectException - If the connection fails.
AdminException - Never thrown.

setDMQ

public void setDMQ(DeadMQueue dmq)
            throws java.net.ConnectException,
                   AdminException
Admin method setting a given dead message queue for this user.

The request fails if the user is deleted server side.

Parameters:
dmq - The dead message queue to be set.
Throws:
java.net.ConnectException - If the connection fails.
AdminException - If the request fails.

setThreshold

public void setThreshold(int thresh)
                  throws java.net.ConnectException,
                         AdminException
Admin method setting a given value as the threshold for this user.

The request fails if the user is deleted server side.

Throws:
java.net.ConnectException - If the connection fails.
AdminException - If the request fails.

getDMQ

public DeadMQueue getDMQ()
                  throws java.net.ConnectException,
                         AdminException
Returns the dead message queue for this user, null if not set.

The request fails if the user is deleted server side.

Throws:
java.net.ConnectException - If the connection fails.
AdminException - If the request fails.

getThreshold

public int getThreshold()
                 throws java.net.ConnectException,
                        AdminException
Returns the threshold for this user, -1 if not set.

The request fails if the user is deleted server side.

Throws:
java.net.ConnectException - If the connection fails.
AdminException - If the request fails.

getProxyId

public java.lang.String getProxyId()
Returns the identifier of the user's proxy.


getReference

public javax.naming.Reference getReference()
                                    throws javax.naming.NamingException
Sets the naming reference of this user.

Specified by:
getReference in interface javax.naming.Referenceable
Overrides:
getReference in class AdministeredObject
Throws:
javax.naming.NamingException

code

public java.util.Hashtable code()
Codes an User instance as a Hashtable for travelling through the SOAP protocol.

Specified by:
code in interface SoapObjectItf
Overrides:
code in class AdministeredObject

decode

public java.lang.Object decode(java.util.Hashtable h)
Decodes an User which travelled through the SOAP protocol.



Copyright ? 2004 Scalagent - All rights reserved