Deklaration

Beschreibung

Zur Abfrage eines benutzerdefinierten Datentyps kann man eine eigene Zuordnung durchführen und die Daten in eine eigene Klasse übertragen, die das Interface SQLData implementiert. Die Zuordnung zwischen benutzerdefiniertem Datentyp in der Datenbank und zugehöriger Java-Klasse wird über eine Type-Map durchgeführt, die den vollqualifizierten Namen des SQL-Datentyps der entsprechenden Java-Klasse zuordnet. Eine Type-Map kann entweder dem Connection-Exemplar, oder einer der Methoden getArray() oder getResultSet übergeben werden.

Methoden im Detail

public Object getArray()

Liefert die Daten des SQL-Datentyps ARRRAY aus der Datenbank zurück. Wenn dem zugrundeliegenden Datentyp keine eigene Klasse über ein Type-Mapping zugeordnet wurde, wird das Ergebnis in Form eines Java-Arrays zurückgeliefert. Ist ein Type-Mapping vorhanden, wird das Ergebnis im zugeordneten Datentyp zurückgeliefert.

Exception: SQLException

• Wird ausgelöst, wenn ein Fehler beim Zugriff auf die Daten auftritt..

public Object getArray(Map map)

Liefert die Daten des SQL-Datentyps ARRRAY aus der Datenbank zurück. Wenn dem zugrundeliegenden Datentyp keine eigene Klasse über die übergebene Type-Mapping zugeordnet wurde, wird das Ergebnis in Form eines Java-Arrays zurückgeliefert. Ist ein Type-Mapping vorhanden, wird das Ergebnis im zugeordneten Datentyp zurückgeliefert. Diese Methode berücksichtigt nicht die Typ-Zuordnungen, die dem zugrundeliegendenConnection gesetzt wurden.

Exception: SQLException

• Wird ausgelöst, wenn ein Fehler beim Zugriff auf die Daten auftritt..

public Object getArray(long index, int count)

Liefert einen Teil der Daten der zugrundeliegendenARRAY -Daten zurück. Der Parameter index bestimmt die Startposition, count die maximale Anzahl an Elementen, die gelesen werden sollen. Die Methode berücksichtigt benutzerdefinierte Typen-Zuordnungen, die im zugrundeliegenden Connection-Exemplar gesetzt wurden.

Exception: SQLException

• Wird ausgelöst, wenn ein Fehler beim Zugriff auf die Daten auftritt..

public Object getArray(long index, int count, Map map)

Liefert einen Teil der Daten der zugrundeliegendenARRAY -Daten zurück. Der Parameter index bestimmt die Startposition, count die maximale Anzahl an Elementen, die gelesen werden sollen. Die Methode berücksichtigt lediglich Typ-Zuordnungen, die über den Parameter map gesetzt wurden. Typ-Zuordnungen im zugrundeliegenden Connection-Exemplar werden nicht benutzt.

Exception: SQLException

• Wird ausgelöst, wenn ein Fehler beim Zugriff auf die Daten auftritt..

public int getBaseType()

Liefert den JDBC-Datentyp (definiert in der Klasse java.sql.Types) der Elemente im Array zurück.

Exception: SQLException

• Wird ausgelöst, wenn ein Fehler beim Zugriff auf die Daten auftritt..

public String getBaseTypeName()

Liefert den Namen des SQL-Datentyps der Elemente in diesem Array zurück.

Exception: SQLException

• Wird ausgelöst, wenn ein Fehler beim Zugriff auf die Daten auftritt..

public ResultSet getResultSet()

Liefert ein ResultSet-Exemplar zurück, das Zugriff auf die Daten des ARRAY-Datentyps bietet. Bei Bedarf wird für die Abfrage die Type-Map des zugehörigen Connection -Exemplars benutzt. Die Ergebnismenge enthält für jedes Element eine Zeile mit jeweils zwei Spalten. Die erste Spalte enthält den Index des Elementes (beginnend bei 1) innerhalb der Datenbank, die zweite Spalte enthält die Daten des Elements. Die Zeilen sind aufsteigend nach dem Index sortiert.

Exception: SQLException

• Wird ausgelöst, wenn ein Fehler beim Zugriff auf die Daten auftritt..

public ResultSet getResultSet(Map map)

Liefert ein ResultSet-Exemplar zurück, das Zugriff auf die Daten des ARRAY-Datentyps bietet. Die Methode berücksichtigt lediglich Typ-Zuordnungen, die über den Parameter map gesetzt wurden. Typ-Zuordnungen im zugrundeliegenden Connection-Exemplar werden nicht benutzt. Die Ergebnismenge enthält für jedes Element eine Zeile mit jeweils zwei Spalten. Die erste Spalte enthält den Index des Elementes (beginnend bei 1) innerhalb der Datenbank, die zweite Spalte enthält die Daten des Elements. Die Zeilen sind aufsteigend nach dem Index sortiert.

Exception: SQLException

• Wird ausgelöst, wenn ein Fehler beim Zugriff auf die Daten auftritt..

public ResultSet getResultSet(long index, int count)

Liefert ein ResultSet-Exemplar zurück, das Zugriff auf max count Elemente des ARRAY -Datentyps ab der Position index bietet. Bei Bedarf wird für die Abfrage die Type-Map des zugehörigen Connection -Exemplars benutzt. Die Ergebnismenge enthält für jedes Element eine Zeile mit jeweils zwei Spalten. Die erste Spalte enthält den Index des Elementes (beginnend bei 1) innerhalb der Datenbank, die zweite Spalte enthält die Daten des Elements. Die Zeilen sind aufsteigend nach dem Index sortiert.

Exception: SQLException

• Wird ausgelöst, wenn ein Fehler beim Zugriff auf die Daten auftritt..

public ResultSet getResultSet(long index, int count, Map map)

Liefert ein ResultSet-Exemplar zurück, das Zugriff auf max count Elemente des ARRAY -Datentyps ab der Position index bietet. Die Methode berücksichtigt lediglich Typ-Zuordnungen, die über den Parameter map gesetzt wurden. Typ-Zuordnungen im zugrundeliegenden Connection-Exemplar werden nicht benutzt. Die Ergebnismenge enthält für jedes Element eine Zeile mit jeweils zwei Spalten. Die erste Spalte enthält den Index des Elementes (beginnend bei 1) innerhalb der Datenbank, die zweite Spalte enthält die Daten des Elements. Die Zeilen sind aufsteigend nach dem Index sortiert.

Exception: SQLException

• Wird ausgelöst, wenn ein Fehler beim Zugriff auf die Daten auftritt..