Package jakarta.jms

Annotation Type JMSConnectionFactoryDefinition

  • @Target(TYPE)
@Retention(RUNTIME)
@Repeatable(JMSConnectionFactoryDefinitions.class)
public @interface JMSConnectionFactoryDefinition
    An application may use this annotation to specify a Jakarta Messaging ConnectionFactory 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 Jakarta 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 the properties element. Once defined, a ConnectionFactory resource may be referenced by a component in the same way as any other ConnectionFactory resource, for example by using the lookup element of the Resource annotation.

    Since:
    JMS 2.0
    Version:
    Jakarta Messaging 2.0
    See Also:
    Resource

    • Required Element Summary

      Required Elements 
      Modifier and Type Required Element Description
      String name
      JNDI name of the Jakarta Messaging connection factory being defined.

    • Optional Element Summary

      Optional Elements 
      Modifier and Type Optional Element Description
      String className
      Fully-qualified name of the Jakarta Messaging connection factory implementation class.
      String clientId
      Client id to use for connection.
      String description
      Description of this Jakarta Messaging connection factory.
      String interfaceName
      Fully qualified name of the Jakarta Messaging 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
      Jakarta Messaging connection factory property.
      String resourceAdapter
      Resource adapter name.
      boolean transactional
      Set to false if connections should not participate in transactions.
      String user
      User name to use for connection authentication.

    • Element Detail

      • name

        String name
        JNDI name of the Jakarta Messaging connection factory being defined.
        Returns:
        The JNDI name of the Jakarta Messaging connection factory being defined.

      • description

        String description
        Description of this Jakarta Messaging connection factory.
        Returns:
        The description of this Jakarta Messaging connection factory.
        Default:
        ""

      • interfaceName

        String interfaceName
        Fully qualified name of the Jakarta Messaging connection factory interface. Permitted values are jakarta.jms.ConnectionFactory or jakarta.jms.QueueConnectionFactory or jakarta.jms.TopicConnectionFactory. If not specified then jakarta.jms.ConnectionFactory will be used.
        Returns:
        The fully qualified name of the Jakarta Messaging connection factory interface.
        Default:
        "jakarta.jms.ConnectionFactory"

      • className

        String className
        Fully-qualified name of the Jakarta Messaging connection factory implementation class. Ignored if a resource adapter is used.
        Returns:
        The fully-qualified name of the Jakarta Messaging connection factory implementation class.
        Default:
        ""

      • resourceAdapter

        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.
        Returns:
        The resource adapter name.
        Default:
        ""

      • user

        String user
        User name to use for connection authentication.
        Returns:
        The user name to use for connection authentication.
        Default:
        ""

      • password

        String password
        Password to use for connection authentication.
        Returns:
        The password to use for connection authentication.
        Default:
        ""

      • clientId

        String clientId
        Client id to use for connection.
        Returns:
        The client id to use for connection.
        Default:
        ""

      • properties

        String[] properties
        Jakarta Messaging connection factory 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.

        Returns:
        The Jakarta Messaging connection factory property.
        Default:
        {}

      • transactional

        boolean transactional
        Set to false if connections should not participate in transactions.

        Default is to enlist in a transaction when one is active or becomes active.

        Returns:
        Whether connections should participate in transactions.
        Default:
        true

      • maxPoolSize

        int maxPoolSize
        Maximum number of connections that should be concurrently allocated for a connection pool.

        Default is vendor-specific.

        Returns:
        The maximum number of connections that should be concurrently allocated for a connection pool.
        Default:
        -1

      • minPoolSize

        int minPoolSize
        Minimum number of connections that should be concurrently allocated for a connection pool.

        Default is vendor-specific.

        Returns:
        The minimum number of connections that should be concurrently allocated for a connection pool.
        Default:
        -1