-
@Target(value=TYPE) @Retention(value=RUNTIME) public @interface JMSConnectionFactoryDefinition
An application may use this annotation to specify a JMSConnectionFactory
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
ConnectionFactory
resource may be configured by setting the annotation elements for commonly used properties. Additional properties may be specified using theproperties
element. Once defined, aConnectionFactory
resource may be referenced by a component in the same way as any otherConnectionFactory
resource, for example by using thelookup
element of theResource
annotation.- Since:
- JMS 2.0
- Version:
- JMS 2.0
- See Also:
Resource
-
-
Required Element Summary
Required Elements Modifier and Type Required Element and Description String
name
JNDI name of the JMS connection factory being defined.
-
Optional Element Summary
Optional Elements Modifier and Type Optional Element and Description String
className
Fully-qualified name of the JMS connection factory implementation class.String
clientId
Client id to use for connection.String
description
Description of this JMS connection factory.String
interfaceName
Fully qualified name of the JMS connection factory interface.int
maxPoolSize
Maximum number of connections that should be concurrently allocated for a connection pool.int
minPoolSize
Minimum number of connections that should be concurrently allocated for a connection pool.String
password
Password to use for connection authentication.String[]
properties
JMS connection factory property.String
resourceAdapter
Resource adapter name.boolean
transactional
Set tofalse
if connections should not participate in transactions.String
user
User name to use for connection authentication.
-
-
-
Element Detail
-
name
public abstract String name
JNDI name of the JMS connection factory being defined.
-
-
-
description
public abstract String description
Description of this JMS connection factory.- Default:
- ""
-
-
-
interfaceName
public abstract String interfaceName
Fully qualified name of the JMS connection factory interface. Permitted values arejavax.jms.ConnectionFactory
orjavax.jms.QueueConnectionFactory
orjavax.jms.TopicConnectionFactory
. If not specified thenjavax.jms.ConnectionFactory
will be used.- Default:
- "javax.jms.ConnectionFactory"
-
-
-
className
public abstract String className
Fully-qualified name of the JMS connection factory implementation class. Ignored if a resource adapter is used.- Default:
- ""
-
-
-
resourceAdapter
public abstract 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:
- ""
-
-
-
user
public abstract String user
User name to use for connection authentication.- Default:
- ""
-
-
-
password
public abstract String password
Password to use for connection authentication.- Default:
- ""
-
-
-
clientId
public abstract String clientId
Client id to use for connection.- Default:
- ""
-
-
-
properties
public abstract String[] properties
JMS connection factory property. This may be a vendor-specific property or a less commonly usedConnectionFactory
property.Properties are specified using the format: propertyName=propertyValue with one property per array element.
- Default:
- {}
-
-
-
transactional
public abstract boolean transactional
Set tofalse
if connections should not participate in transactions.Default is to enlist in a transaction when one is active or becomes active.
- Default:
- true
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
22/08/2025 04:06:29 Cette version de la page est en cache (à la date du 22/08/2025 04:06:29) afin d'accélérer le traitement.Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la version plus récente de la page.
Document créé le 11/06/2005, dernière modification le 18/08/2025
Source du document imprimé : https://www.gaudry.be/java-api-javaee-rf-javax/jms/jmsconnectionfactorydefinition.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.