|
Joram ${version} | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.objectweb.joram.client.jms.admin.AdministeredObject
org.objectweb.joram.client.jms.Destination
Implements the javax.jms.Destination
interface and provides
JORAM specific administration and monitoring methods.
Field Summary | |
protected java.lang.String |
adminName
Name given by the administrator. |
protected java.lang.String |
agentId
Identifier of the agent destination. |
Constructor Summary | |
|
Destination()
|
protected |
Destination(java.lang.String name,
java.lang.String type)
|
Method Summary | |
java.util.Hashtable |
code()
Codes a Destination as a Hashtable for travelling through the
SOAP protocol. |
void |
decode(java.util.Hashtable h)
|
void |
delete()
Admin method removing this destination from the platform. |
protected static void |
doCreate(int serverId,
java.lang.String name,
java.lang.String className,
java.util.Properties props,
Destination dest,
java.lang.String expectedType)
Admin method creating or retrieving a destination with a given name on a given server, and returning its identifier. |
boolean |
equals(java.lang.Object obj)
Returns true if the parameter object is a Joram destination
wrapping the same agent identifier. |
java.lang.String |
getAdminName()
Returns the admin name of the destination. |
DeadMQueue |
getDMQ()
Monitoring method returning the dead message queue of this destination, null if not set. |
java.lang.String |
getName()
Returns the name of the destination. |
java.util.List |
getReaders()
Monitoring method returning the list of all users that have a reading permission on this destination, or an empty list if no specific readers are set. |
javax.naming.Reference |
getReference()
Sets the naming reference of a destination. |
java.lang.String |
getType()
|
java.util.List |
getWriters()
Monitoring method returning the list of all users that have a writing permission on this destination, or an empty list if no specific writers are set. |
static boolean |
isAssignableTo(java.lang.String realType,
java.lang.String resultingType)
|
boolean |
isFreelyReadable()
Monitoring method returning true if this destination
provides free READ access. |
boolean |
isFreelyWriteable()
Monitoring method returning true if this destination
provides free WRITE access. |
boolean |
isQueue()
Returns true if the destination is a queue. |
static Destination |
newInstance(java.lang.String id,
java.lang.String name,
java.lang.String type)
|
void |
setDMQ(DeadMQueue dmq)
Admin method setting or unsetting a dead message queue for this destination. |
void |
setFreeReading()
Admin method setting free reading access to this destination. |
void |
setFreeWriting()
Admin method setting free writing access to this destination. |
void |
setReader(User user)
Admin method setting a given user as a reader on this destination. |
void |
setWriter(User user)
Admin method setting a given user as a writer on this destination. |
void |
unsetFreeReading()
Admin method unsetting free reading access to this destination. |
void |
unsetFreeWriting()
Admin method unsetting free writing access to this destination. |
void |
unsetReader(User user)
Admin method unsetting a given user as a reader on this destination. |
void |
unsetWriter(User user)
Admin method unsetting a given user as a writer on this destination. |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
protected java.lang.String agentId
protected java.lang.String adminName
Constructor Detail |
public Destination()
protected Destination(java.lang.String name, java.lang.String type)
Method Detail |
public java.lang.String getName()
public final java.lang.String getAdminName()
public final java.lang.String getType()
public boolean equals(java.lang.Object obj)
true
if the parameter object is a Joram destination
wrapping the same agent identifier.
public boolean isQueue()
true
if the destination is a queue.
public java.util.Hashtable code()
Destination
as a Hashtable for travelling through the
SOAP protocol.
code
in interface fr.dyade.aaa.jndi2.soap.SoapObjectItf
public void decode(java.util.Hashtable h)
decode
in interface fr.dyade.aaa.jndi2.soap.SoapObjectItf
public javax.naming.Reference getReference() throws javax.naming.NamingException
getReference
in interface javax.naming.Referenceable
getReference
in class AdministeredObject
javax.naming.NamingException
protected static void doCreate(int serverId, java.lang.String name, java.lang.String className, java.util.Properties props, Destination dest, java.lang.String expectedType) throws java.net.ConnectException, AdminException
The request fails if the target server does not belong to the platform, or if the destination deployement fails server side.
serverId
- The identifier of the server where deploying the
destination.name
- The destination name.className
- Name of the MOM destination class.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public void delete() throws java.net.ConnectException, AdminException, javax.jms.JMSException
AdminException
- Never thrown.
java.net.ConnectException
- If the admin connection is closed or broken.
JMSException
- Never thrown.public void setFreeReading() throws java.net.ConnectException, AdminException
The request fails if this destination is deleted server side.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public void setFreeWriting() throws java.net.ConnectException, AdminException
The request fails if this destination is deleted server side.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public void unsetFreeReading() throws java.net.ConnectException, AdminException
The request fails if this destination is deleted server side.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public void unsetFreeWriting() throws java.net.ConnectException, AdminException
The request fails if this destination is deleted server side.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public void setReader(User user) throws java.net.ConnectException, AdminException
The request fails if this destination is deleted server side.
user
- User to be set as a reader.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public void setWriter(User user) throws java.net.ConnectException, AdminException
The request fails if this destination is deleted server side.
user
- User to be set as a writer.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public void unsetReader(User user) throws java.net.ConnectException, AdminException
The request fails if this destination is deleted server side.
user
- Reader to be unset.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public void unsetWriter(User user) throws java.net.ConnectException, AdminException
The request fails if this destination is deleted server side.
user
- Writer to be unset.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public void setDMQ(DeadMQueue dmq) throws java.net.ConnectException, AdminException
The request fails if this destination is deleted server side.
dmq
- The dead message queue to be set (null
for
unsetting current DMQ).
java.lang.IllegalArgumentException
- If the DMQ is not a valid
JORAM destination.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public java.util.List getReaders() throws java.net.ConnectException, AdminException
The request fails if the destination is deleted server side.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public java.util.List getWriters() throws java.net.ConnectException, AdminException
The request fails if the destination is deleted server side.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public boolean isFreelyReadable() throws java.net.ConnectException, AdminException
true
if this destination
provides free READ access.
The request fails if the destination is deleted server side.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public boolean isFreelyWriteable() throws java.net.ConnectException, AdminException
true
if this destination
provides free WRITE access.
The request fails if the destination is deleted server side.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public DeadMQueue getDMQ() throws java.net.ConnectException, AdminException
The request fails if the destination is deleted server side.
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public static Destination newInstance(java.lang.String id, java.lang.String name, java.lang.String type) throws AdminException
AdminException
public static boolean isAssignableTo(java.lang.String realType, java.lang.String resultingType)
|
Joram ${version} | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |