javax.jms

Interface XAConnectionFactory

Inhoudsopgave
  • All Known Subinterfaces:
    XAQueueConnectionFactory, XATopicConnectionFactory

    public interface XAConnectionFactory
    The XAConnectionFactory interface is a base interface for the XAQueueConnectionFactory and XATopicConnectionFactory interfaces.

    Some application servers provide support for grouping JTA capable resource use into a distributed transaction (optional). To include JMS API transactions in a JTA transaction, an application server requires a JTA aware JMS provider. A JMS provider exposes its JTA support using an XAConnectionFactory object, which an application server uses to create XAConnection objects.

    XAConnectionFactory objects are JMS administered objects, just like ConnectionFactory objects. It is expected that application servers will find them using the Java Naming and Directory Interface (JNDI) API.

    The XAConnectionFactory interface is optional. JMS providers are not required to support this interface. This interface is for use by JMS providers to support transactional environments. Client programs are strongly encouraged to use the transactional support available in their environment, rather than use these XA interfaces directly.

    Since:
    JMS 1.0
    Version:
    JMS 2.0

    • Method Detail

      • createXAConnection

        XAConnection createXAConnection()
                         throws JMSException
        Creates an XAConnection with the default user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.
        Returns:
        a newly created XAConnection
        Throws:
        JMSException - if the JMS provider fails to create an XA connection due to some internal error.
        JMSSecurityException - if client authentication fails due to an invalid user name or password.
        Since:
        JMS 1.1

      • createXAConnection

        XAConnection createXAConnection(String userName,
                                String password)
                         throws JMSException
        Creates an XAConnection with the specified user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.
        Parameters:
        userName - the caller's user name
        password - the caller's password
        Returns:
        a newly created XAConnection
        Throws:
        JMSException - if the JMS provider fails to create an XA connection due to some internal error.
        JMSSecurityException - if client authentication fails due to an invalid user name or password.
        Since:
        JMS 1.1

      • createXAContext

        XAJMSContext createXAContext()
        Creates a XAJMSContext with the default user identity

        A connection and session are created for use by the new XAJMSContext. The connection is created in stopped mode but will be automatically started when a JMSConsumer is created.

        Returns:
        a newly created XAJMSContext
        Throws:
        JMSRuntimeException - if the JMS provider fails to create the XAJMSContext due to some internal error.
        JMSSecurityRuntimeException - if client authentication fails due to an invalid user name or password.
        Since:
        JMS 2.0

      • createXAContext

        XAJMSContext createXAContext(String userName,
                             String password)
        Creates a JMSContext with the specified user identity

        A connection and session are created for use by the new XAJMSContext. The connection is created in stopped mode but will be automatically started when a JMSConsumer is created.

        Parameters:
        userName - the caller's user name
        password - the caller's password
        Returns:
        a newly created JMSContext
        Throws:
        JMSRuntimeException - if the JMS provider fails to create the JMSContext due to some internal error.
        JMSSecurityRuntimeException - if client authentication fails due to an invalid user name or password.
        Since:
        JMS 2.0

Nederlandse vertaling

U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.

Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.

Bij voorbaat dank.

Document heeft de 11/06/2005 gemaakt, de laatste keer de 18/08/2025 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-javaee-rf-javax/jms/xaconnectionfactory.html

De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.

Referenties

  1. Bekijk - html-document Taal van het document:fr Manuel PHP : https://docs.oracle.com

Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur van deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.