Behandlung von geprüften Ausnahmen

Wenn eine Anwendung beispielsweise bei der Verbindung mit einem Warteschlangenmanager eine falsche Portnummer angibt, bilden die Ausnahmebedingungen die folgende Kette:

com.ibm.msg.client.jms.DetailIllegalStateException
|
+--->
    com.ibm.mq.MQException
    |
    +--->
        com.ibm.mq.jmqi.JmqiException
        |
        +--->
            com.ibm.mq.jmqi.JmqiException
            |
            +--->
                java.net.ConnectionException

Normalerweise wird jede Ausnahmebedingung in einer Kette von einer anderen Schicht im Code ausgelöst. In der oben genannten Kette wurden die Ausnahmebedingungen beispielsweise von folgenden Schichten ausgelöst:

• Die erste Ausnahme, eine Instanz einer Unterklasse von JMSException, wird von der allgemeinen Schicht in IBM MQ classes for JMSausgelöst.
• Die nächste Ausnahme, eine Instanz von com.ibm.mq.MQException, wird vom IBM MQ-Messaging-Provider ausgelöst.
• Die nächsten beiden Ausnahmen, die beide Instanzen von com.ibm.mq.jmqi.JmqiExceptionsind, werden von der Java Message Queueing Interface (JMQI) ausgelöst. JMQI ist die Komponente, die von IBM MQ classes for JMS für die Kommunikation mit einem Warteschlangenmanager verwendet wird.
• Die letzte Ausnahmebedingung, eine Instanz von java.net.ConnectionException, wird von der Java-Klassenbibliothek ausgelöst.

Weitere Informationen zu der Schichtarchitektur von IBM MQ classes for JMS finden Sie im Abschnitt IBM MQ-Klassen für JMS-Architektur.

Sie können Ihre Anwendung so codieren, dass diese Kette durchlaufen wird, um alle geeigneten Informationen zu extrahieren, wie im folgenden Beispiel gezeigt wird:

import com.ibm.msg.client.jms.JmsExceptionDetail;
import com.ibm.mq.MQException;
import com.ibm.mq.jmqi.JmqiException;
import jakarta.jms.JMSException;
.
.
.
catch (JMSException je) {
  System.err.println("Caught JMSException");
  // Check for linked exceptions in JMSException
  Throwable t = je;
  while (t != null) {
    // Write out the message that is applicable to all exceptions
    System.err.println("Exception Msg: " + t.getMessage());
    // Write out the exception stack trace
    t.printStackTrace(System.err);

    // Add on specific information depending on the type of exception
    if (t instanceof JMSException) {
      JMSException je1 = (JMSException) t;
      System.err.println("JMS Error code: " + je1.getErrorCode());
      if (t instanceof JmsExceptionDetail){
        JmsExceptionDetail jed = (JmsExceptionDetail)je1;
        System.err.println("JMS Explanation: " + jed.getExplanation());
        System.err.println("JMS Explanation: " + jed.getUserAction());
      }
    } else if (t instanceof MQException) {
      MQException mqe = (MQException) t;
      System.err.println("WMQ Completion code: " + mqe.getCompCode());
      System.err.println("WMQ Reason code: " + mqe.getReason());
    } else if (t instanceof JmqiException){
      JmqiException jmqie = (JmqiException)t;
      System.err.println("WMQ Log Message: " + jmqie.getWmqLogMessage());
      System.err.println("WMQ Explanation: " + jmqie.getWmqMsgExplanation());
      System.err.println("WMQ Msg Summary: " + jmqie.getWmqMsgSummary());
      System.err.println("WMQ Msg User Response: " + jmqie.getWmqMsgUserResponse());
      System.err.println("WMQ Msg Severity: " + jmqie.getWmqMsgSeverity());
    }
    // Get the next cause
    t = t.getCause();
  }
}

import com.ibm.msg.client.jms.JmsExceptionDetail;
import com.ibm.mq.MQException;
import com.ibm.mq.jmqi.JmqiException;
import javax.jms.JMSException;
.
.
.
catch (JMSException je) {
  System.err.println("Caught JMSException");
  // Check for linked exceptions in JMSException
  Throwable t = je;
  while (t != null) {
    // Write out the message that is applicable to all exceptions
    System.err.println("Exception Msg: " + t.getMessage());
    // Write out the exception stack trace
    t.printStackTrace(System.err);

    // Add on specific information depending on the type of exception
    if (t instanceof JMSException) {
      JMSException je1 = (JMSException) t;
      System.err.println("JMS Error code: " + je1.getErrorCode());
      if (t instanceof JmsExceptionDetail){
        JmsExceptionDetail jed = (JmsExceptionDetail)je1;
        System.err.println("JMS Explanation: " + jed.getExplanation());
        System.err.println("JMS Explanation: " + jed.getUserAction());
      }
    } else if (t instanceof MQException) {
      MQException mqe = (MQException) t;
      System.err.println("WMQ Completion code: " + mqe.getCompCode());
      System.err.println("WMQ Reason code: " + mqe.getReason());
    } else if (t instanceof JmqiException){
      JmqiException jmqie = (JmqiException)t;
      System.err.println("WMQ Log Message: " + jmqie.getWmqLogMessage());
      System.err.println("WMQ Explanation: " + jmqie.getWmqMsgExplanation());
      System.err.println("WMQ Msg Summary: " + jmqie.getWmqMsgSummary());
      System.err.println("WMQ Msg User Response: " + jmqie.getWmqMsgUserResponse());
      System.err.println("WMQ Msg Severity: " + jmqie.getWmqMsgSeverity());
    }
    // Get the next cause
    t = t.getCause();
  }
}

Beachten Sie, dass Ihre Anwendung immer den Typ jeder einzelnen Ausnahmebedingung in einer Kette überprüfen sollte, da der Typ variieren kann und verschiedene Ausnahmebedingungstypen verschiedene Informationen einbinden.

Ein MQException enthält die folgenden Informationen:

• Einen Beendigungscode, den Ihre Anwendung durch Aufrufen der Methode getCompCode() abrufen kann.
• Einen Ursachencode, den Ihre Anwendung durch Aufrufen der Methode getReason() abrufen kann.

Ein JmqiException kapselt auch einen Beendigungscode und einen Ursachencode. Darüber hinaus enthält ein JmqiException die Informationen in einer AMQ-Nnnn oder CSQ-Nnnn Nachricht, wenn der Ausnahmebedingung eine zugeordnet ist. Ihre Anwendung kann die verschiedenen Komponenten dieser Nachricht abrufen, indem Sie folgende Methoden aufruft:

• Die Methode getWmqMsgExplanation() gibt die Erläuterung der Nachricht AMQ-Nnnn oder CSQ-Nnnn zurück.
• Die Methode getWmqMsgSeverity() gibt die Wertigkeit der Nachricht AMQ-Nnnn oder CSQ-Nnnn zurück.
• Die Methode getWmqMsgSummary() gibt die Zusammenfassung der Nachricht AMQ-Nnnn oder CSQ-Nnnn zurück.
• Die Methode getWmqMsgUserResponse() gibt die Benutzeraktion zurück, die der Nachricht AMQ-Nnnn oder CSQ-Nnnn zugeordnet ist.