Oracle GlassFish(tm) Server Message Queue
5.0

javax.jms
Annotation Type JMSDestinationDefinition


@Target(value=TYPE)
@Retention(value=RUNTIME)
public @interface JMSDestinationDefinition

An application may use this annotation to specify a JMS Destination resource that it requires in its operational environment. This provides information that can be used at the application's deployment to provision the required resource and allows an application to be deployed into a Java EE environment with more minimal administrative configuration.

The Destination resource may be configured by setting the annotation elements for commonly used properties. Additional properties may be specified using the properties element. Once defined, a Destination resource may be referenced by a component in the same way as any other Destination resource, for example by using the lookup element of the Resource annotation.

Since:
JMS 2.0
See Also:
javax.annotation.Resource

Required Element Summary
 java.lang.String interfaceName
          Fully qualified name of the JMS destination interface.
 java.lang.String name
          JNDI name of the destination resource being defined.
 
Optional Element Summary
 java.lang.String className
          Fully-qualified name of the JMS destination implementation class.
 java.lang.String description
          Description of this JMS destination.
 java.lang.String destinationName
          Name of the queue or topic.
 java.lang.String[] properties
          JMS destination property.
 java.lang.String resourceAdapter
          Resource adapter name.
 

Element Detail

name

public abstract java.lang.String name
JNDI name of the destination resource being defined.


interfaceName

public abstract java.lang.String interfaceName
Fully qualified name of the JMS destination interface. Permitted values are javax.jms.Queue or javax.jms.Topic.

description

public abstract java.lang.String description
Description of this JMS destination.

Default:
""

className

public abstract java.lang.String className
Fully-qualified name of the JMS destination implementation class. Ignored if a resource adapter is used unless the resource adapter defines more than one JMS destination implementation class for the specified interface

Default:
""

resourceAdapter

public abstract java.lang.String resourceAdapter
Resource adapter name. If not specified then the application server will define the default behaviour, which may or may not involve the use of a resource adapter.

Default:
""

destinationName

public abstract java.lang.String destinationName
Name of the queue or topic.

Default:
""

properties

public abstract java.lang.String[] properties
JMS destination property. This may be a vendor-specific property or a less commonly used ConnectionFactory property.

Properties are specified using the format: propertyName=propertyValue with one property per array element.

Default:
{}

Oracle GlassFish(tm) Server Message Queue
5.0

Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.