Package com.sun.ts.lib.porting
Interface TSJMSAdminInterface
public interface TSJMSAdminInterface
This is the TSJMSAdminInterface. An implementation of this interface must be provided by each Java EE implementation,
to support their own creation/deletion semantics of topic/queue and QueueConnectionFactory/TopicConnectionFactory/
ConnectionFactory.
- Author:
- Kyle Grucci
-
Method Summary
Modifier and TypeMethodDescriptionvoid
createConnectionFactories
(String[] connectionFactories, String[] props) This method creates ConnectionFactorys in a Java EE implementation.void
createQueueConnectionFactories
(String[] queueConnectionFactories, String[] props) This method creates QueueConnectionFactorys in a Java EE implementation.void
createQueues
(String[] queues) The createQueues method creates queues in a Java EE implementation.void
createTopicConnectionFactories
(String[] topicConnectionFactories, String[] props) This method creates TopicConnectionFactorys in a Java EE implementation.void
createTopics
(String[] topics) The createTopics method creates topics in a Java EE implementation.void
init
(PrintWriter writer) The init method is a logging mechanism for diagnostics.void
removeJmsConnectionFactories
(String[] jmsConnectionFactoryNames) This method removes ConnectionFactories from a Java EE implementation.void
removeQueues
(String[] queues) The removeQueues method removes queues in a Java EE implementation.void
removeTopics
(String[] topics) The removeTopics method remove topics in a Java EE implementation.
-
Method Details
-
init
The init method is a logging mechanism for diagnostics. The writer parameter specifies the PrinterWriter that is used to log output. Initializes a new TSJMSAdminInterface instance. All output should be printed to this PrintWriter. All properties in the ts.jte file are accessible to this porting implementation class only via the TSPropertyManager class.- Parameters:
writer
- The PrintWriter that is used to log output.
-
createQueues
The createQueues method creates queues in a Java EE implementation. The queues parameter specifies the queue destination objects to create.- Parameters:
queues
- Queues to create- Throws:
TSJMSAdminException
-
createTopics
The createTopics method creates topics in a Java EE implementation. The topics parameter specifies the topic destination objects to create.- Parameters:
topics
- Topics to create- Throws:
TSJMSAdminException
-
removeQueues
The removeQueues method removes queues in a Java EE implementation. The queues parameter specifies the queue destination objects to remove.- Parameters:
queues
- Queues to remove- Throws:
TSJMSAdminException
-
removeTopics
The removeTopics method remove topics in a Java EE implementation. The topics parameter specifies the topic destination objects to remove.- Parameters:
topics
- Topics to remove- Throws:
TSJMSAdminException
-
createQueueConnectionFactories
void createQueueConnectionFactories(String[] queueConnectionFactories, String[] props) throws TSJMSAdminException This method creates QueueConnectionFactorys in a Java EE implementation. Two String array parameters are passed when createQueueConnectionFactories is called, where the first array specifies QueueConnectionFactorys to create and the second array specifies properties associated with the QueueConnectionFactory. Arguments passed as queueConnectionFactories[n],props[n] where props[i] consists all properties that associated to QueueConnectionFactory queueConnectionFactories[i]. Each element in the Properties array consists of a String name value pair that defines the properties for the factory connection. Some of the connection factories set up by the Java EE TCK require a property for the clientID. The name value pair in this case would be "clientId=cts". If more than one property needs to be specified by a single QueueConnectionFactory, the properties should be space separated in the props string. If no property is being specified, the name value pair would be an empty String "".- Parameters:
queueConnectionFactories
- queueConnectionFactories to createprops
- properties for the connection, if any- Throws:
TSJMSAdminException
-
createTopicConnectionFactories
void createTopicConnectionFactories(String[] topicConnectionFactories, String[] props) throws TSJMSAdminException This method creates TopicConnectionFactorys in a Java EE implementation. Two String array parameters are passed when createTopicConnectionFactories is called, where the first array specifies TopicConnectionFactorys to create and the second array specifies properties associated with the TopicConnectionFactory. Arguments passed as topicConnectionFactories[n],props[n] where props[i] consists all properties that associated to TopicConnectionFactory topicConnectionFactories[i]. Each element in the Properties array consists of a String name value pair that defines the properties for the factory connection. Some of the connection factories set up by the Java EE TCK require a property for the clientID. The name value pair in this case would be "clientId=cts". If more than one property needs to be specified by a single TopicConnectionFactory, the properties should be space separated in the props string. If no property is being specified, the name value pair would be an empty String "".- Parameters:
topicConnectionFactories
- topicConnectionFactories to createprops
- properties for the connection, if any- Throws:
TSJMSAdminException
-
createConnectionFactories
void createConnectionFactories(String[] connectionFactories, String[] props) throws TSJMSAdminException This method creates ConnectionFactorys in a Java EE implementation. Two String array parameters are passed when createConnectionFactories is called, where the first array specifies ConnectionFactorys to create and the second array specifies properties associated with the ConnectionFactory. Arguments passed as connectionFactories[n],props[n] where props[i] consists all properties that associated to ConnectionFactory connectionFactories[i]. Each element in the Properties array consists of a String name value pair that defines the properties for the factory connection. If more than one property needs to be specified by a single ConnectionFactory, the properties should be space separated in the props string. If no property is being specified, the name value pair would be an empty String "".- Parameters:
connectionFactories
- connectionFactories to createprops
- properties for the connection, if any- Throws:
TSJMSAdminException
-
removeJmsConnectionFactories
This method removes ConnectionFactories from a Java EE implementation.- Parameters:
jmsConnectionFactoryNames
- JmsConnectionFactoryNames to remove- Throws:
TSJMSAdminException
-