Interaktion mit Datenbanken mit Hilfe des JavaCompute-Knotens

Zugriff auf Datenbanken über den im JavaCompute-Knoten enthaltenen Java-Code.

Wählen Sie für die Datenbankinteraktion eine der folgenden Optionen aus:

Wenn Sie den JDBC-Provider für Typ-4-Verbindungen bzw. MbSQLStatement verwenden, kann die Datenbank, auf die Sie zugreifen, an global koordinierten Transaktionen teilnehmen. Bei allen anderen Optionen ist die globale Koordination des Datenbankzugriffs nicht möglich.

JDBC-Provider des Brokers für Typ-4-Verbindungen

Für die Interaktion mit Datenbanken über JavaCompute-Knoten können Sie JDBC-Typ-4-Verbindungen einrichten. Der Broker unterstützt Typ-4-Treiber, stellt diese aber nicht bereit. Die Treiber erhalten Sie von Ihrem Datenbankhersteller. Die unterstützten Treiber sind im Abschnitt Unterstützte Datenbanken aufgelistet.

Der JDBC-Provider des Brokers für Typ-4-Verbindungen bietet folgende Vorteile:
  • Sie können die Konfigurationsmöglichkeiten des Brokers zur Definition der Verbindung und zur Bereitstellung optionaler Sicherheitsfunktionen verwenden. Dadurch ersparen Sie sich die Codierung dieser Aktionen.
  • In der Konfiguration des Brokers und der Datenbanken können Sie den Zugriff auf andere Ressourcen, auf die Sie über Ihre Nachrichtenflüsse zugreifen, sowie die Aktualisierung mit diesen Ressourcen koordinieren (Ausnahme: bei Ausführung des Brokers unter z/OS).
  • Sie können die Verbindung mit der Java-API getJDBCTyep4Connection des Brokers initiieren und nachfolgende SQL-Operationen mit den Standard-JDBC-APIs ausführen. Der Broker verwaltet die Verbindungen, die Thread-Affinität, das Verbindungspooling und die Verbindungsdauer. Bei Inaktivität einer Verbindung für etwa eine Minute oder nach Abschluss des Nachrichtenflusses schließt der Broker die Verbindung.

Bei Ausführung des Brokers in einem verteilten System können Sie die Datenbanken und Verbindungen mit anderen Ressourcenaktivitäten koordinieren. Die globale Koordination auf verteilten Systemen wird von WebSphere MQ bereitgestellt. Sie kann Interaktionen mit lokalen oder fernen Datenbanken, einschließlich fernen Datenbanken auf z/OS-Systemen, umfassen. Bei einer JDBC-Typ-4-Datenbankverbindung von einem Broker, der unter z/OS ausgeführt wird, ist keine Koordination möglich. Informationen zum Einrichten von Verbindungen sowie Informationen zur Koordination finden Sie im Abschnitt JDBC-Verbindungen zu den Datenbanken herstellen.

Bevor Sie diese Funktion in den Code für den Knoten integrieren, müssen Sie die erforderliche Umgebung konfigurieren. Überlegen Sie sich zuvor, ob für die Datenbank ein sicherer Zugriff erforderlich ist und ob die Datenbankaktualisierungen an global koordinierten Transaktionen teilnehmen sollen. Führen Sie die erforderlichen und optionalen Tasks nach den Anweisungen im Abschnitt JDBC-Verbindungen zu den Datenbanken herstellen aus.

Nach der Konfiguration des JDBC-Providers können Sie in der MbNode-Schnittstelle mit dem Aufruf von getJDBCType4Connection eine JDBC-Typ-4-Verbindung zur Datenbank einrichten. Nachfolgend finden Sie ein Code-Beispiel:

public class MyJavaCompute extends MbJavaComputeNode {
{
  public void evaluate(MbMessageAssembly inAssembly) throws MbException {
		MbOutputTerminal out = getOutputTerminal("out");
		MbMessage inMessage = inAssembly.getMessage();
	      	      
		// Neue Nachricht erstellen
		MbMessage outMessage = new MbMessage(inMessage);
		MbMessageAssembly outAssembly = new MbMessageAssembly(inAssembly,outMessage);

    try {
	        // Obtain a javax.sql.Connection using a JDBC Type4 datasource - in this example for a 
          // JDBC broker configurable service called "MyDB2"  
			
 	        Connection conn = getJDBCType4Connection("MyDB2",JDBC_TransactionType.MB_TRANSACTION_AUTO);
   
   	      // Example of using the Connection to create a java.sql.Statement  
          Statement stmt = conn.createStatement(
	        											    		ResultSet.TYPE_SCROLL_INSENSITIVE,
											            		ResultSet.CONCUR_READ_ONLY);
											            		ResultSet srs0 = stmt.executeQuery(
											            		"SELECT NAME, CITY FROM MyDataBase.MyTable");    

             stmt.executeUpdate("UPDATE MyDataBase.MyTable SET CITY = "Springfield" WHERE Name = "Bart");
           .
   	         // Perform other database updates   
           . 

    } catch (SQLException sqx ){
	     sqx.printStackTrace();
   } finally {
	    // clear the outMessage
	    outMessage.clearMessage();
   }     
		     
  }  
}  

In diesem Beispiel gilt Folgendes:

  • MyDB2 ist der Name des konfigurierbaren Service des JDBC-Providers. Geben Sie den Namen des Service ein, den Sie für die Verbindung mit Ihrer Datenbank erstellt haben.
  • MB_TRANSACTION_AUTO legt die für den Knoten erforderliche Transaktionskoordinationsstufe fest. Es wird nur dieser Wert unterstützt. Er gibt an, dass die Koordinationseinstellung für den Knoten aus der Meldungsflussebene übernommen wird.

Da die Verbindungen vom Broker verwaltet werden, gelten für Ihren Code die folgenden Einschränkungen:

  • Fügen Sie keinen Code ein, der eine COMMIT- oder eine ROLLBACK-Funktion ausführt.
  • Fügen Sie keinen Code ein, der die Verbindung mit der Datenbank schließt.

Fügen Sie Code ein, der bei Rückgabe der Kontrolle die erfolgreiche oder fehlerhafte Durchführung der vom Knoten durchgeführten Aktionen meldet.

MbSQLStatement

Die MbSQLStatement stellt mittels ESQL oder ODBC vollständigen transaktionalen Datenbankzugriff bereit. Bei Verwendung von MbSQLStatement koordiniert der Ressourcenmanager des Brokers den Datenbankzugriff. Die globale Koordination wird auf verteilten Plattformen von WebSphere MQ und unter z/OS von RRS bereitgestellt. Informationen zum Einrichten der erforderlichen ODBC-Ressourcen finden Sie im Abschnitt ODBC-Verbindungen zu den Datenbanken herstellen.

Erstellen Sie mit Hilfe der MbNode-Methode createSQLStatement() Instanzen der MbSQLStatement-Klasse, durch die die ODBC-Datenquelle, die EQSL-Anweisung eines Brokers und (optional) der Transaktionsmodus an die Methode übergeben werden.
  • Durch den Aufruf von select() auf diesem Objekt werden die Ergebnisse der Abfrage zurückgegeben.
  • Durch den Aufruf von execute() in diesem Objekt wird eine Abfrage ausgeführt, in der keine Ergebnisse wie beispielsweise die Aktualisierung einer Tabelle zurückgegeben werden.
Im folgenden Java-Code wird gezeigt, wie auf eine Datenbank mit Hilfe von MbSQLStatement zugegriffen wird:
MbMessage newMsg = new MbMessage(assembly.getMessage());
MbMessageAssembly newAssembly = new MbMessageAssembly(assembly, newMsg);

String table = "dbTable";

MbSQLStatement state = createSQLStatement( "dbName", 
	"SET OutputRoot.XMLNS.integer[] = PASSTHRU('SELECT * FROM " + table + "');" );

state.setThrowExceptionOnDatabaseError(false);
state.setTreatWarningsAsErrors(true);
state.select( assembly, newAssembly );

int sqlCode = state.getSQLCode(); 
if(sqlCode != 0)
{
	// Fehlerbehandlung hier ausführen 
}

getOutputTerminal("out").propagate(assembly); 

JDBC-API in einer nicht verwalteten Umgebung

Im Code, den Sie für Ihre JavaCompute-Knoten schreiben, können Sie auf Java-Standard-APIs einschließlich JDBC-Aufrufe zugreifen. Zum Herstellen der Verbindung mit einer Datenbank, zum Lesen aus oder Schreiben in eine Datenbank und zum Trennen einer Datenbankverbindung können Sie daher JDBC-APIs verwenden. Der Broker erlaubt in Ihrem JDBC-Verbindungscode sowohl den Aufruf von Typ-2-JDBC-Treibern als auch den Aufruf von Typ-4-JDBC-Treibern in dieser Umgebung, stellt diese Treiber allerdings nicht bereit. Sie erhalten diese Treiber von Ihrem Datenbankhersteller.

Bei dieser Datenbankzugriffsmethode bietet der Broker keinerlei Unterstützung für die Transaktionsverwaltung. Das bedeutet, dass die Verwaltung des lokalen Commits und Rollbacks von Datenbankänderungen in Ihrem Code integriert sein muss. Auch die Verbindungsdauer, die Thread-Affinität der Verbindungen und das Verbindungspooling müssen vom Code verwaltet werden. Darüber hinaus müssen Sie bei Verwendung dieser Methode den Zugriff auf die Datenbanken überwachen, um sicherzustellen, dass sich die vom Broker hergestellten Verbindungen und Ihre eigenen Verbindungen nicht gegenseitig beeinträchtigen. Beachten Sie in diesem Zusammenhang, dass Typ-2-Treiber zu einer ODBC-Verbindung überbrückt werden, die eventuell in Nachrichtenflüssen verwendet wird, deren Datenbankzugriff über ESQL erfolgt.

SQLJ

SQLJ ist eine Java-Erweiterung zum Einbetten statischer SQL-Anweisungen in Java-Code. SQLJ-Dateien erstellen Sie in der Workbench. Bei Verwendung von SQLJ koordiniert der Ressourcenmanager des Brokers den Datenbankzugriff nicht.
  1. Aktivieren Sie die SQLJ-Funktion in der Workbench:
    1. Wechseln Sie in die Ansicht 'Brokeranwendungsentwicklung'.
    2. Wählen Sie die Optionsfolge Windows > Einstellungen.
    3. Erweitern Sie Workbench.
    4. Wählen Sie Capabilities (Funktionen) aus.
    5. Erweitern Sie Database Developer (Datenbankentwickler).
    6. Wählen Sie SQLJ Development (SQLJ-Entwicklung) aus.
    7. Klicken Sie auf OK.
  2. Erstellen Sie eine neue SQLJ-Datei in einem Java-Projekt:
    1. Klicken Sie mit der rechten Maustaste auf das Java-Projekt, in der die Datei erstellt werden soll.
    2. Klicken Sie nacheinander auf Neu > Sonstige....
    3. Erweitern Sie Daten.
    4. Erweitern Sie SQLJ.
    5. Wählen Sie SQLJ File (SQLJ-Datei) aus.
    6. Klicken Sie auf Weiter.
    7. Folgen Sie zum Generieren der SQLJ-Datei den Anweisungen den Assistenten zur Erstellung einer neuen SQLJ-Datei.
Sie können jetzt in dieser SQLJ-Datei aus einer JavaCompute-Knotenklasse in diesem Projekt oder in einem anderen Projekt, auf das verwiesen wird, auf die Klasse verweisen.
Zugehörige Konzepte
Projektverweise
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac30494_