< Vorherige Lektion | Nächste Lektion >

Abfrage erstellen

Sie erstellen eine Abfrage, indem Sie durch Aufrufen der Methode BuildQuery des Sitzungsobjekts ein QueryDef-Objekt erstellen.
Eine Abfrage besteht aus einer Liste von Feldern für einen bestimmten Datensatztyp, für den Sie die Werte abrufen möchten. Die Datensätze werden in einem ResultSet-Objekt zurückgegeben. Die Abfrage gibt die erforderlichen Felder für alle Datensätze eines bestimmten Typs zurück. Sie können dann durch die Ergebnismengen navigieren und die Daten verarbeiten.

Die Erstellung einer Abfrage umfasst die Erstellung von mindestens drei separaten Objekten: einem QueryDef-Objekt, einem QueryFilterNode-Objekt und einem ResultSet-Objekt. Komplexere Abfragen beinhalten möglicherweise die Erstellung zusätzlicher QueryFilterNode-Objekte.

Führen Sie die folgenden Schritte aus, um eine einfache Abfrage zu erstellen:

  1. Erstellen Sie eine Abfrage, indem Sie das QueryDef-Objekt verwenden, um die abzurufenden Daten anzugeben. Das QueryDef-Objekt enthält die Definition einer Abfrage für eine Rational-ClearQuest-Datenbank. Nach Erstellung eines QueryDef-Objekts können Sie mit diesem Objekt Informationen aus der Datenbank abrufen. Verwenden Sie zum Erstellen dieses Objekts die Methode BuildQuery des Sitzungsobjekts.
  2. Verwenden Sie die Methoden von QueryDef, um Suchkriterien hinzuzufügen und die Felder der einzelnen Datensätze anzugeben, die von der Abfrage zurückgegeben werden sollen.
  3. Erstellen Sie ein ResultSet-Objekt, das die zurückgegebenen Daten speichern soll. Rufen Sie zum Erstellen dieses Objekts die Methode BuildResultSet des Sitzungsobjekts auf. Bei der Erstellung wird vom ResultSet-Objekt ein Satz interner Datenstrukturen erstellt, wobei die Informationen im QueryDef-Objekt als Vorlage dienen. Bei Ausführung der Abfrage füllt das ResultSet-Objekt diese Datenstrukturen mit den Daten aus der Abfrage.
  4. Führen Sie die Abfrage aus, indem Sie die Methode Execute oder ExecuteAndCountRecords des ResultSet-Objekts aufrufen. Durch Aufrufen einer dieser Methoden wird eine Ergebnismenge mit den aus der Datenbank abgerufenen Daten gefüllt.
  5. Greifen Sie auf die Daten zu, indem Sie durch das ResultSet-Objekt navigieren und andere Methoden des Objekts verwenden, um Informationen zu den Feldern eines Datensatzes abzurufen.
Eine Abfrage gibt nicht den gesamten Datensatz, sondern nur die Felder des Datensatzes zurück, die Sie durch Aufrufen der Methode BuildField des QueryDef-Objekts angegeben haben. Die Methode Execute gibt Ergebnisse in keiner bestimmten Reihenfolge zurück. Deshalb verwendet das ResultSet-Objekt ein cursorbasiertes System, damit der Code nacheinander durch die einzelnen Datensätze navigieren kann.
< Vorherige Lektion | Nächste Lektion >

Feedback