|
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 | |
void |
addReader(java.lang.String proxyId)
used by MBean jmx |
void |
addWriter(java.lang.String proxyId)
used by MBean jmx |
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 |
getReaderList()
used by MBean jmx |
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.util.Hashtable |
getStatistic()
|
java.lang.String |
getType()
|
java.util.List |
getWriterList()
used by MBean jmx |
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 |
removeReader(java.lang.String proxyId)
used by MBean jmx |
void |
removeWriter(java.lang.String proxyId)
used by MBean jmx |
void |
setDMQ(DeadMQueue dmq)
Admin method setting or unsetting a dead message queue for this destination. |
void |
setFreelyReadable(boolean b)
used by MBean |
void |
setFreelyWriteable(boolean b)
used by MBean |
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()
getName
in interface DestinationMBean
public final java.lang.String getAdminName()
getAdminName
in interface DestinationMBean
public final java.lang.String getType()
getType
in interface DestinationMBean
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.
isQueue
in interface DestinationMBean
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
delete
in interface DestinationMBean
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 addReader(java.lang.String proxyId) throws java.net.ConnectException, AdminException
addReader
in interface DestinationMBean
java.net.ConnectException
AdminException
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 addWriter(java.lang.String proxyId) throws java.net.ConnectException, AdminException
addWriter
in interface DestinationMBean
java.net.ConnectException
AdminException
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 removeReader(java.lang.String proxyId) throws java.net.ConnectException, AdminException
removeReader
in interface DestinationMBean
java.net.ConnectException
AdminException
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 removeWriter(java.lang.String proxyId) throws java.net.ConnectException, AdminException
removeWriter
in interface DestinationMBean
java.net.ConnectException
AdminException
public void setDMQ(DeadMQueue dmq) throws java.net.ConnectException, AdminException
The request fails if this destination is deleted server side.
setDMQ
in interface DestinationMBean
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 getReaderList() throws java.net.ConnectException, AdminException
getReaderList
in interface DestinationMBean
java.net.ConnectException
AdminException
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 java.util.List getWriterList() throws java.net.ConnectException, AdminException
getWriterList
in interface DestinationMBean
java.net.ConnectException
AdminException
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.
isFreelyReadable
in interface DestinationMBean
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public void setFreelyReadable(boolean b) throws java.net.ConnectException, AdminException
setFreelyReadable
in interface DestinationMBean
java.net.ConnectException
AdminException
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.
isFreelyWriteable
in interface DestinationMBean
java.net.ConnectException
- If the admin connection is closed or broken.
AdminException
- If the request fails.public void setFreelyWriteable(boolean b) throws java.net.ConnectException, AdminException
setFreelyWriteable
in interface DestinationMBean
java.net.ConnectException
AdminException
public DeadMQueue getDMQ() throws java.net.ConnectException, AdminException
The request fails if the destination is deleted server side.
getDMQ
in interface DestinationMBean
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)
public java.util.Hashtable getStatistic() throws java.net.ConnectException, AdminException
getStatistic
in interface DestinationMBean
java.net.ConnectException
AdminException
|
Joram ${version} | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |