R
- The record type contained in this resultpublic interface Result<R extends Record> extends java.util.List<R>, Attachable
SelectQuery
ResultQuery.getResult()
Modifier and Type | Method and Description |
---|---|
void |
attach(Configuration configuration)
Attach this result and all of its contained records to a new
Configuration . |
void |
detach()
Detach this result and all of its contained records from their current
Configuration . |
<O extends TableRecord<O>> |
fetchChildren(ForeignKey<O,R> key)
Fetch child records of this record, given a foreign key.
|
<O extends UpdatableRecord<O>> |
fetchParents(ForeignKey<R,O> key)
Fetch parent records of this record, given a foreign key.
|
<T> Field<T> |
field(Field<T> field)
Get a specific field from this Result.
|
Field<?> |
field(int index)
Get a specific field from this Result.
|
<T> Field<T> |
field(int index,
java.lang.Class<T> type)
Get a specific field from this Result, coerced to
type . |
<T> Field<T> |
field(int index,
DataType<T> dataType)
Get a specific field from this Result, coerced to
dataType . |
Field<?> |
field(java.lang.String name)
Get a specific field from this Result.
|
<T> Field<T> |
field(java.lang.String name,
java.lang.Class<T> type)
Get a specific field from this Result, coerced to
type . |
<T> Field<T> |
field(java.lang.String name,
DataType<T> dataType)
Get a specific field from this Result, coerced to
dataType . |
Field<?>[] |
fields()
Get all fields from this Result.
|
Row |
fieldsRow()
Get this result's fields as a
Row . |
java.lang.String |
format()
Get a simple formatted representation of this result.
|
java.lang.String |
format(int maxRecords)
Get a simple formatted representation of this result.
|
void |
format(java.io.OutputStream stream)
Like
format() , but the data is output onto an OutputStream . |
void |
format(java.io.OutputStream stream,
int maxRecords)
Like
format(int) , but the data is output onto an OutputStream . |
void |
format(java.io.Writer writer)
Like
format() , but the data is output onto a Writer . |
void |
format(java.io.Writer writer,
int maxRecords)
Like
format(int) , but the data is output onto a Writer . |
java.lang.String |
formatCSV()
Get a simple formatted representation of this result as CSV.
|
java.lang.String |
formatCSV(char delimiter)
Get a simple formatted representation of this result as CSV.
|
java.lang.String |
formatCSV(char delimiter,
java.lang.String nullString)
Get a simple formatted representation of this result as CSV.
|
void |
formatCSV(java.io.OutputStream stream)
Like
formatCSV() , but the data is output onto an OutputStream . |
void |
formatCSV(java.io.OutputStream stream,
char delimiter)
Like
formatCSV(char) , but the data is output onto an OutputStream . |
void |
formatCSV(java.io.OutputStream stream,
char delimiter,
java.lang.String nullString)
Like
formatCSV(char, String) , but the data is output onto an OutputStream . |
void |
formatCSV(java.io.Writer writer)
Like
formatCSV() , but the data is output onto a Writer . |
void |
formatCSV(java.io.Writer writer,
char delimiter)
Like
formatCSV(char) , but the data is output onto a Writer . |
void |
formatCSV(java.io.Writer writer,
char delimiter,
java.lang.String nullString)
Like
formatCSV(char, String) , but the data is output onto a Writer . |
java.lang.String |
formatHTML()
Get a simple formatted representation of this result as HTML.
|
void |
formatHTML(java.io.OutputStream stream)
Like
formatHTML() , but the data is output onto an OutputStream . |
void |
formatHTML(java.io.Writer writer)
Like
formatHTML() , but the data is output onto a Writer . |
java.lang.String |
formatInsert()
Get this result as a set of
INSERT statements. |
void |
formatInsert(java.io.OutputStream stream)
Like
formatInsert() , but the data is output onto an OutputStream . |
void |
formatInsert(java.io.OutputStream stream,
Table<?> table,
Field<?>... fields)
Like
formatInsert(Table, Field...) , but the data is output onto an OutputStream . |
java.lang.String |
formatInsert(Table<?> table,
Field<?>... fields)
Get this result as a set of
INSERT statements. |
void |
formatInsert(java.io.Writer writer)
Like
formatInsert() , but the data is output onto a Writer . |
void |
formatInsert(java.io.Writer writer,
Table<?> table,
Field<?>... fields)
Like
formatInsert(Table, Field...) , but the data is output onto an Writer . |
java.lang.String |
formatJSON()
Get a simple formatted representation of this result as a JSON array of
array.
|
void |
formatJSON(java.io.OutputStream stream)
Like
formatJSON() , but the data is output onto an OutputStream . |
void |
formatJSON(java.io.Writer writer)
Like
formatJSON() , but the data is output onto a Writer . |
java.lang.String |
formatXML()
Get this result formatted as XML.
|
void |
formatXML(java.io.OutputStream stream)
Like
formatXML() , but the data is output onto an OutputStream . |
void |
formatXML(java.io.Writer writer)
Like
formatXML() , but the data is output onto a Writer . |
<T> T |
getValue(int index,
Field<T> field)
Convenience method to fetch a value at a given position in the result.
|
<T> T |
getValue(int index,
Field<T> field,
T defaultValue)
Deprecated.
- 3.3.0 - [#2878] - This method will be removed in jOOQ 4.0
|
java.lang.Object |
getValue(int index,
int fieldIndex)
Convenience method to fetch a value at a given position in the result.
|
java.lang.Object |
getValue(int index,
int fieldIndex,
java.lang.Object defaultValue)
Deprecated.
- 3.3.0 - [#2878] - This method will be removed in jOOQ 4.0
|
java.lang.Object |
getValue(int index,
java.lang.String fieldName)
Convenience method to fetch a value at a given position in the result.
|
java.lang.Object |
getValue(int index,
java.lang.String fieldName,
java.lang.Object defaultValue)
Deprecated.
- 3.3.0 - [#2878] - This method will be removed in jOOQ 4.0
|
<T> java.util.List<T> |
getValues(Field<?> field,
java.lang.Class<? extends T> type)
Convenience method to fetch all values for a given field.
|
<T> java.util.List<T> |
getValues(Field<T> field)
Convenience method to fetch all values for a given field.
|
<T,U> java.util.List<U> |
getValues(Field<T> field,
Converter<? super T,U> converter)
Convenience method to fetch all values for a given field.
|
java.util.List<?> |
getValues(int fieldIndex)
Convenience method to fetch all values for a given field.
|
<T> java.util.List<T> |
getValues(int fieldIndex,
java.lang.Class<? extends T> type)
Convenience method to fetch all values for a given field.
|
<U> java.util.List<U> |
getValues(int fieldIndex,
Converter<?,U> converter)
Convenience method to fetch all values for a given field.
|
java.util.List<?> |
getValues(java.lang.String fieldName)
Convenience method to fetch all values for a given field.
|
<T> java.util.List<T> |
getValues(java.lang.String fieldName,
java.lang.Class<? extends T> type)
Convenience method to fetch all values for a given field.
|
<U> java.util.List<U> |
getValues(java.lang.String fieldName,
Converter<?,U> converter)
Convenience method to fetch all values for a given field.
|
Result<R> |
intern(Field<?>... fields)
Specify a set of fields whose values should be interned.
|
Result<R> |
intern(int... fieldIndexes)
Specify a set of field indexes whose values should be interned.
|
Result<R> |
intern(java.lang.String... fieldNames)
Specify a set of field names whose values should be interned.
|
<E> java.util.List<E> |
into(java.lang.Class<? extends E> type)
Map resulting records onto a custom type.
|
Result<Record> |
into(Field<?>... fields)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1> Result<Record1<T1>> |
into(Field<T1> field1)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2> Result<Record2<T1,T2>> |
into(Field<T1> field1,
Field<T2> field2)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3> Result<Record3<T1,T2,T3>> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9,
Field<T10> field10)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9,
Field<T10> field10,
Field<T11> field11)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9,
Field<T10> field10,
Field<T11> field11,
Field<T12> field12)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9,
Field<T10> field10,
Field<T11> field11,
Field<T12> field12,
Field<T13> field13)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9,
Field<T10> field10,
Field<T11> field11,
Field<T12> field12,
Field<T13> field13,
Field<T14> field14)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9,
Field<T10> field10,
Field<T11> field11,
Field<T12> field12,
Field<T13> field13,
Field<T14> field14,
Field<T15> field15)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9,
Field<T10> field10,
Field<T11> field11,
Field<T12> field12,
Field<T13> field13,
Field<T14> field14,
Field<T15> field15,
Field<T16> field16)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9,
Field<T10> field10,
Field<T11> field11,
Field<T12> field12,
Field<T13> field13,
Field<T14> field14,
Field<T15> field15,
Field<T16> field16,
Field<T17> field17)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9,
Field<T10> field10,
Field<T11> field11,
Field<T12> field12,
Field<T13> field13,
Field<T14> field14,
Field<T15> field15,
Field<T16> field16,
Field<T17> field17,
Field<T18> field18)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18,T19> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9,
Field<T10> field10,
Field<T11> field11,
Field<T12> field12,
Field<T13> field13,
Field<T14> field14,
Field<T15> field15,
Field<T16> field16,
Field<T17> field17,
Field<T18> field18,
Field<T19> field19)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18,T19,T20> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9,
Field<T10> field10,
Field<T11> field11,
Field<T12> field12,
Field<T13> field13,
Field<T14> field14,
Field<T15> field15,
Field<T16> field16,
Field<T17> field17,
Field<T18> field18,
Field<T19> field19,
Field<T20> field20)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18,T19,T20,T21> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9,
Field<T10> field10,
Field<T11> field11,
Field<T12> field12,
Field<T13> field13,
Field<T14> field14,
Field<T15> field15,
Field<T16> field16,
Field<T17> field17,
Field<T18> field18,
Field<T19> field19,
Field<T20> field20,
Field<T21> field21)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18,T19,T20,T21,T22> |
into(Field<T1> field1,
Field<T2> field2,
Field<T3> field3,
Field<T4> field4,
Field<T5> field5,
Field<T6> field6,
Field<T7> field7,
Field<T8> field8,
Field<T9> field9,
Field<T10> field10,
Field<T11> field11,
Field<T12> field12,
Field<T13> field13,
Field<T14> field14,
Field<T15> field15,
Field<T16> field16,
Field<T17> field17,
Field<T18> field18,
Field<T19> field19,
Field<T20> field20,
Field<T21> field21,
Field<T22> field22)
Copy all records from this result into a new result with new records
holding only a subset of the previous fields.
|
<H extends RecordHandler<? super R>> |
into(H handler)
Map results into a custom handler callback.
|
<Z extends Record> |
into(Table<Z> table)
Map resulting records onto a custom record.
|
java.lang.Object[][] |
intoArray()
Deprecated.
- 3.6.0 - [#3879] - Use
intoArrays() instead. |
<T> T[] |
intoArray(Field<?> field,
java.lang.Class<? extends T> type)
Return all values for a field from the result.
|
<T> T[] |
intoArray(Field<T> field)
Return all values for a field from the result.
|
<T,U> U[] |
intoArray(Field<T> field,
Converter<? super T,U> converter)
Return all values for a field from the result.
|
java.lang.Object[] |
intoArray(int fieldIndex)
Return all values for a field index from the result.
|
<T> T[] |
intoArray(int fieldIndex,
java.lang.Class<? extends T> type)
Return all values for a field index from the result.
|
<U> U[] |
intoArray(int fieldIndex,
Converter<?,U> converter)
Return all values for a field index from the result.
|
java.lang.Object[] |
intoArray(java.lang.String fieldName)
Return all values for a field name from the result.
|
<T> T[] |
intoArray(java.lang.String fieldName,
java.lang.Class<? extends T> type)
Return all values for a field name from the result.
|
<U> U[] |
intoArray(java.lang.String fieldName,
Converter<?,U> converter)
Return all values for a field name from the result.
|
java.lang.Object[][] |
intoArrays()
Convert this result into an array of arrays.
|
java.util.Map<Record,Result<R>> |
intoGroups(Field<?>[] keys)
Return a
Map with the result grouped by the given keys. |
<E> java.util.Map<Record,java.util.List<E>> |
intoGroups(Field<?>[] keys,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given keys and mapped
into the given entity type. |
<E> java.util.Map<Record,java.util.List<E>> |
intoGroups(Field<?>[] keys,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given keys and mapped
into the given entity type. |
<K> java.util.Map<K,Result<R>> |
intoGroups(Field<K> key)
Return a
Map with one of the result's columns as key and a list
of corresponding records as value. |
<K,E> java.util.Map<K,java.util.List<E>> |
intoGroups(Field<K> key,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given key and mapped
into the given entity type. |
<K,V> java.util.Map<K,java.util.List<V>> |
intoGroups(Field<K> key,
Field<V> value)
Return a
Map with one of the result's columns as key and another
one of the result's columns as value. |
<K,E> java.util.Map<K,java.util.List<E>> |
intoGroups(Field<K> key,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given key and mapped by
the given mapper. |
java.util.Map<?,Result<R>> |
intoGroups(int keyFieldIndex)
Return a
Map with one of the result's columns as key and a list
of corresponding records as value. |
java.util.Map<Record,Result<R>> |
intoGroups(int[] keyFieldIndexes)
Return a
Map with the result grouped by the given keys. |
<E> java.util.Map<Record,java.util.List<E>> |
intoGroups(int[] keyFieldIndexes,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given keys and mapped
into the given entity type. |
<E> java.util.Map<Record,java.util.List<E>> |
intoGroups(int[] keyFieldIndexes,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given keys and mapped
into the given entity type. |
<E> java.util.Map<?,java.util.List<E>> |
intoGroups(int keyFieldIndex,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given key and mapped
into the given entity type. |
java.util.Map<?,java.util.List<?>> |
intoGroups(int keyFieldIndex,
int valueFieldIndex)
Return a
Map with one of the result's columns as key and another
one of the result's columns as value. |
<E> java.util.Map<?,java.util.List<E>> |
intoGroups(int keyFieldIndex,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given key and mapped by
the given mapper. |
java.util.Map<?,Result<R>> |
intoGroups(java.lang.String keyFieldName)
Return a
Map with one of the result's columns as key and a list
of corresponding records as value. |
java.util.Map<Record,Result<R>> |
intoGroups(java.lang.String[] keyFieldNames)
Return a
Map with the result grouped by the given keys. |
<E> java.util.Map<Record,java.util.List<E>> |
intoGroups(java.lang.String[] keyFieldNames,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given keys and mapped
into the given entity type. |
<E> java.util.Map<Record,java.util.List<E>> |
intoGroups(java.lang.String[] keyFieldNames,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given keys and mapped
into the given entity type. |
<E> java.util.Map<?,java.util.List<E>> |
intoGroups(java.lang.String keyFieldName,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given key and mapped
into the given entity type. |
<E> java.util.Map<?,java.util.List<E>> |
intoGroups(java.lang.String keyFieldName,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given key and mapped by
the given mapper. |
java.util.Map<?,java.util.List<?>> |
intoGroups(java.lang.String keyFieldName,
java.lang.String valueFieldName)
Return a
Map with one of the result's columns as key and another
one of the result's columns as value. |
<S extends Record> |
intoGroups(Table<S> table)
Return a
Map with the result grouped by the given key table. |
<E,S extends Record> |
intoGroups(Table<S> table,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given key table and
mapped into the given entity type. |
<E,S extends Record> |
intoGroups(Table<S> table,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given key table and
mapped into the given entity type. |
java.util.Map<Record,R> |
intoMap(Field<?>[] keys)
Return a
Map with the given keys as a map key and the
corresponding record as value. |
<E> java.util.Map<java.util.List<?>,E> |
intoMap(Field<?>[] keys,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given keys and mapped
into the given entity type. |
<E> java.util.Map<java.util.List<?>,E> |
intoMap(Field<?>[] keys,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given keys and mapped by
the given mapper. |
<K> java.util.Map<K,R> |
intoMap(Field<K> key)
Return a
Map with one of the result's columns as key and the
corresponding records as value. |
<K,E> java.util.Map<K,E> |
intoMap(Field<K> key,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given key and mapped
into the given entity type. |
<K,V> java.util.Map<K,V> |
intoMap(Field<K> key,
Field<V> value)
Return a
Map with one of the result's columns as key and another
one of the result's columns as value
An InvalidResultException is thrown, if the key turns out to be
non-unique in the result set. |
<K,E> java.util.Map<K,E> |
intoMap(Field<K> key,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given key and mapped by
the given mapper. |
java.util.Map<?,R> |
intoMap(int keyFieldIndex)
Return a
Map with one of the result's columns as key and the
corresponding records as value. |
java.util.Map<Record,R> |
intoMap(int[] keyFieldIndexes)
Return a
Map with the given keys as a map key and the
corresponding record as value. |
<E> java.util.Map<java.util.List<?>,E> |
intoMap(int[] keyFieldIndexes,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given keys and mapped
into the given entity type. |
<E> java.util.Map<java.util.List<?>,E> |
intoMap(int[] keyFieldIndexes,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given keys and mapped by
the given mapper. |
<E> java.util.Map<?,E> |
intoMap(int keyFieldIndex,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given key and mapped
into the given entity type. |
java.util.Map<?,?> |
intoMap(int keyFieldIndex,
int valueFieldIndex)
Return a
Map with one of the result's columns as key and another
one of the result's columns as value
An InvalidResultException is thrown, if the key turns out to be
non-unique in the result set. |
<E> java.util.Map<?,E> |
intoMap(int keyFieldIndex,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given key and mapped by
the given mapper. |
java.util.Map<?,R> |
intoMap(java.lang.String keyFieldName)
Return a
Map with one of the result's columns as key and the
corresponding records as value. |
java.util.Map<Record,R> |
intoMap(java.lang.String[] keyFieldNames)
Return a
Map with the given keys as a map key and the
corresponding record as value. |
<E> java.util.Map<java.util.List<?>,E> |
intoMap(java.lang.String[] keyFieldNames,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given keys and mapped
into the given entity type. |
<E> java.util.Map<java.util.List<?>,E> |
intoMap(java.lang.String[] keyFieldNames,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given keys and mapped by
the given mapper. |
<E> java.util.Map<?,E> |
intoMap(java.lang.String keyFieldName,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given key and mapped
into the given entity type. |
<E> java.util.Map<?,E> |
intoMap(java.lang.String keyFieldName,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given key and mapped by
the given mapper. |
java.util.Map<?,?> |
intoMap(java.lang.String keyFieldName,
java.lang.String valueFieldName)
Return a
Map with one of the result's columns as key and another
one of the result's columns as value
An InvalidResultException is thrown, if the key turns out to be
non-unique in the result set. |
<S extends Record> |
intoMap(Table<S> table)
Return a
Map with the given key table as a map key and the
corresponding record as value. |
<E,S extends Record> |
intoMap(Table<S> table,
java.lang.Class<? extends E> type)
Return a
Map with results grouped by the given key table and
mapped into the given entity type. |
<E,S extends Record> |
intoMap(Table<S> table,
RecordMapper<? super R,E> mapper)
Return a
Map with results grouped by the given key table and
mapped by the given mapper. |
java.util.List<java.util.Map<java.lang.String,java.lang.Object>> |
intoMaps()
Return the generated result as a list of name/value maps.
|
java.sql.ResultSet |
intoResultSet()
Generate an in-memory JDBC
ResultSet containing the data of this
Result . |
<T> java.util.Set<T> |
intoSet(Field<?> field,
java.lang.Class<? extends T> type)
Return all values for a field from the result.
|
<T> java.util.Set<T> |
intoSet(Field<T> field)
Return all values for a field from the result.
|
<T,U> java.util.Set<U> |
intoSet(Field<T> field,
Converter<? super T,U> converter)
Return all values for a field from the result.
|
java.util.Set<?> |
intoSet(int fieldIndex)
Return all values for a field index from the result.
|
<T> java.util.Set<T> |
intoSet(int fieldIndex,
java.lang.Class<? extends T> type)
Return all values for a field index from the result.
|
<U> java.util.Set<U> |
intoSet(int fieldIndex,
Converter<?,U> converter)
Return all values for a field index from the result.
|
java.util.Set<?> |
intoSet(java.lang.String fieldName)
Return all values for a field name from the result.
|
<T> java.util.Set<T> |
intoSet(java.lang.String fieldName,
java.lang.Class<? extends T> type)
Return all values for a field name from the result.
|
<U> java.util.Set<U> |
intoSet(java.lang.String fieldName,
Converter<?,U> converter)
Return all values for a field name from the result.
|
org.w3c.dom.Document |
intoXML()
Get this result as XML.
|
<H extends org.xml.sax.ContentHandler> |
intoXML(H handler)
Get this result as XML using a SAX
ContentHandler . |
boolean |
isEmpty()
Whether there are any records contained in this
Result . |
boolean |
isNotEmpty()
Whether there are any records contained in this
Result . |
<E> java.util.List<E> |
map(RecordMapper<? super R,E> mapper)
Map results into a custom mapper callback.
|
RecordType<R> |
recordType()
Get this result's record type.
|
Result<R> |
sortAsc(java.util.Comparator<? super R> comparator)
Sort this result using a comparator that can compare records.
|
<T extends java.lang.Comparable<? super T>> |
sortAsc(Field<T> field)
Sort this result by one of its contained fields.
|
<T> Result<R> |
sortAsc(Field<T> field,
java.util.Comparator<? super T> comparator)
Sort this result by one of its contained fields using a comparator.
|
Result<R> |
sortAsc(int fieldIndex)
Sort this result by one of its contained fields.
|
Result<R> |
sortAsc(int fieldIndex,
java.util.Comparator<?> comparator)
Sort this result by one of its contained fields using a comparator.
|
Result<R> |
sortAsc(java.lang.String fieldName)
Sort this result by one of its contained fields.
|
Result<R> |
sortAsc(java.lang.String fieldName,
java.util.Comparator<?> comparator)
Sort this result by one of its contained fields using a comparator.
|
Result<R> |
sortDesc(java.util.Comparator<? super R> comparator)
Reverse-sort this result using a comparator that can compare records.
|
<T extends java.lang.Comparable<? super T>> |
sortDesc(Field<T> field)
Reverse-sort this result by one of its contained fields.
|
<T> Result<R> |
sortDesc(Field<T> field,
java.util.Comparator<? super T> comparator)
Reverse-sort this result by one of its contained fields using a
comparator.
|
Result<R> |
sortDesc(int fieldIndex)
Reverse-sort this result by one of its contained fields.
|
Result<R> |
sortDesc(int fieldIndex,
java.util.Comparator<?> comparator)
Reverse-sort this result by one of its contained fields using a
comparator.
|
Result<R> |
sortDesc(java.lang.String fieldName)
Reverse-sort this result by one of its contained fields.
|
Result<R> |
sortDesc(java.lang.String fieldName,
java.util.Comparator<?> comparator)
Reverse-sort this result by one of its contained fields using a
comparator.
|
RecordType<R> recordType()
<T> Field<T> field(Field<T> field)
Row.field(Field)
Field<?> field(java.lang.String name)
Row.field(String)
<T> Field<T> field(java.lang.String name, java.lang.Class<T> type)
type
.Row.field(String, Class)
<T> Field<T> field(java.lang.String name, DataType<T> dataType)
dataType
.Row.field(String, DataType)
Field<?> field(int index)
Row.field(int)
<T> Field<T> field(int index, java.lang.Class<T> type)
type
.Row.field(int, Class)
<T> Field<T> field(int index, DataType<T> dataType)
dataType
.Row.field(int, DataType)
Field<?>[] fields()
Row.fields()
<T> T getValue(int index, Field<T> field) throws java.lang.IndexOutOfBoundsException, java.lang.IllegalArgumentException
T
- The value's field's generic type parameterindex
- The record's indexfield
- The value's fieldjava.lang.IndexOutOfBoundsException
- if the index is out of range (
index < 0 || index >= size())java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
@Deprecated <T> T getValue(int index, Field<T> field, T defaultValue) throws java.lang.IndexOutOfBoundsException, java.lang.IllegalArgumentException
T
- The value's field's generic type parameterindex
- The record's indexfield
- The value's fielddefaultValue
- The default value if the value was null
java.lang.IndexOutOfBoundsException
- if the index is out of range (
index < 0 || index >= size())java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
java.lang.Object getValue(int index, int fieldIndex) throws java.lang.IndexOutOfBoundsException, java.lang.IllegalArgumentException
index
- The record's indexfieldIndex
- The value's field indexjava.lang.IndexOutOfBoundsException
- if the index is out of range (
index < 0 || index >= size())java.lang.IllegalArgumentException
- If the argument fieldIndex is not
contained in fieldsRow()
@Deprecated java.lang.Object getValue(int index, int fieldIndex, java.lang.Object defaultValue) throws java.lang.IndexOutOfBoundsException, java.lang.IllegalArgumentException
index
- The record's indexfieldIndex
- The value's field indexdefaultValue
- The default value if the value was null
java.lang.IndexOutOfBoundsException
- if the index is out of range (
index < 0 || index >= size())java.lang.IllegalArgumentException
- If the argument fieldIndex is not
contained in fieldsRow()
java.lang.Object getValue(int index, java.lang.String fieldName) throws java.lang.IndexOutOfBoundsException, java.lang.IllegalArgumentException
index
- The record's indexfieldName
- The value's field namejava.lang.IndexOutOfBoundsException
- if the index is out of range (
index < 0 || index >= size())java.lang.IllegalArgumentException
- If the argument fieldName is not
contained in fieldsRow()
@Deprecated java.lang.Object getValue(int index, java.lang.String fieldName, java.lang.Object defaultValue) throws java.lang.IndexOutOfBoundsException, java.lang.IllegalArgumentException
index
- The record's indexfieldName
- The value's field namedefaultValue
- The default value if the value was null
java.lang.IndexOutOfBoundsException
- if the index is out of range (
index < 0 || index >= size())java.lang.IllegalArgumentException
- If the argument fieldName is not
contained in fieldsRow()
<T> java.util.List<T> getValues(Field<T> field) throws java.lang.IllegalArgumentException
T
- The values' field's generic type parameterfield
- The values' fieldjava.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
<T> java.util.List<T> getValues(Field<?> field, java.lang.Class<? extends T> type) throws java.lang.IllegalArgumentException
field
- The values' fieldtype
- The type used for type conversionjava.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
Record.getValue(Field, Class)
,
Convert.convert(Object, Class)
<T,U> java.util.List<U> getValues(Field<T> field, Converter<? super T,U> converter) throws java.lang.IllegalArgumentException
field
- The values' fieldconverter
- The data type converter used for type conversionjava.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
Record.getValue(Field, Converter)
,
Convert.convert(Object, Converter)
java.util.List<?> getValues(int fieldIndex) throws java.lang.IllegalArgumentException
fieldIndex
- The values' field indexjava.lang.IllegalArgumentException
- If the argument fieldIndex is not
contained in fieldsRow()
<T> java.util.List<T> getValues(int fieldIndex, java.lang.Class<? extends T> type) throws java.lang.IllegalArgumentException, DataTypeException
fieldIndex
- The values' field indextype
- The type used for type conversionjava.lang.IllegalArgumentException
- If the argument fieldIndex is not
contained in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredRecord.getValue(int, Class)
,
Convert.convert(Object, Class)
<U> java.util.List<U> getValues(int fieldIndex, Converter<?,U> converter) throws java.lang.IllegalArgumentException, DataTypeException
fieldIndex
- The values' field indexconverter
- The data type converter used for type conversionjava.lang.IllegalArgumentException
- If the argument fieldIndex is not
contained in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredRecord.getValue(int, Converter)
,
Convert.convert(Object, Converter)
java.util.List<?> getValues(java.lang.String fieldName) throws java.lang.IllegalArgumentException
fieldName
- The values' field namejava.lang.IllegalArgumentException
- If the argument fieldName is not
contained in fieldsRow()
<T> java.util.List<T> getValues(java.lang.String fieldName, java.lang.Class<? extends T> type) throws java.lang.IllegalArgumentException, DataTypeException
fieldName
- The values' field nametype
- The type used for type conversionjava.lang.IllegalArgumentException
- If the argument fieldName is not
contained in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredRecord.getValue(String, Class)
,
Convert.convert(Object, Class)
<U> java.util.List<U> getValues(java.lang.String fieldName, Converter<?,U> converter) throws java.lang.IllegalArgumentException, DataTypeException
fieldName
- The values' field nameconverter
- The data type converter used for type conversionjava.lang.IllegalArgumentException
- If the argument fieldName is not
contained in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredRecord.getValue(String, Converter)
,
Convert.convert(Object, Converter)
boolean isEmpty()
Result
.boolean isNotEmpty()
Result
.java.lang.String format()
This is the same as calling format(int)
with
maxRows = 50
java.lang.String format(int maxRecords)
maxRecords
- The maximum number of records to include in the
formatted resultjava.lang.String formatHTML()
The HTML code is formatted as follows:
<table>
<thead>
<tr>
<th>field-1</th>
<th>field-2</th>
...
<th>field-n</th>
</tr>
</thead>
<tbody>
<tr>
<th>value-1-1</th>
<th>value-1-2</th>
...
<th>value-1-n</th>
</tr>
<tr>
<th>value-2-1</th>
<th>value-2-2</th>
...
<th>value-2-n</th>
</tr>
...
</tbody>
</table>
java.lang.String formatCSV()
This is the same as calling formatCSV(',', "")
java.lang.String formatCSV(char delimiter)
This is the same as calling formatCSV(delimiter, "")
delimiter
- The delimiter to use between recordsjava.lang.String formatCSV(char delimiter, java.lang.String nullString)
delimiter
- The delimiter to use between recordsnullString
- A special string for encoding NULL
values.java.lang.String formatJSON()
The format is the following:
{"fields":[{"name":"field-1","type":"type-1"},
{"name":"field-2","type":"type-2"},
...,
{"name":"field-n","type":"type-n"}],
"records":[[value-1-1,value-1-2,...,value-1-n],
[value-2-1,value-2-2,...,value-2-n]]}
java.lang.String formatXML()
java.lang.String formatInsert()
INSERT
statements.
This uses the the first record's TableRecord.getTable()
, if the
first record is a TableRecord
. Otherwise, this generates
INSERT
statements into an "UNKNOWN_TABLE"
. In
both cases, the fields()
are used for column names.
java.lang.String formatInsert(Table<?> table, Field<?>... fields)
INSERT
statements.
This explicitly specifies the table (and optionally the fields) to insert
into. If the fields
argument is left empty, the
fields()
are used, instead.
void format(java.io.OutputStream stream) throws IOException
format()
, but the data is output onto an OutputStream
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void format(java.io.OutputStream stream, int maxRecords) throws IOException
format(int)
, but the data is output onto an OutputStream
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatHTML(java.io.OutputStream stream) throws IOException
formatHTML()
, but the data is output onto an OutputStream
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatCSV(java.io.OutputStream stream) throws IOException
formatCSV()
, but the data is output onto an OutputStream
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatCSV(java.io.OutputStream stream, char delimiter) throws IOException
formatCSV(char)
, but the data is output onto an OutputStream
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatCSV(java.io.OutputStream stream, char delimiter, java.lang.String nullString) throws IOException
formatCSV(char, String)
, but the data is output onto an OutputStream
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatJSON(java.io.OutputStream stream) throws IOException
formatJSON()
, but the data is output onto an OutputStream
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatXML(java.io.OutputStream stream) throws IOException
formatXML()
, but the data is output onto an OutputStream
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatInsert(java.io.OutputStream stream) throws IOException
formatInsert()
, but the data is output onto an OutputStream
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatInsert(java.io.OutputStream stream, Table<?> table, Field<?>... fields) throws IOException
formatInsert(Table, Field...)
, but the data is output onto an OutputStream
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void format(java.io.Writer writer) throws IOException
format()
, but the data is output onto a Writer
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void format(java.io.Writer writer, int maxRecords) throws IOException
format(int)
, but the data is output onto a Writer
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatHTML(java.io.Writer writer) throws IOException
formatHTML()
, but the data is output onto a Writer
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatCSV(java.io.Writer writer) throws IOException
formatCSV()
, but the data is output onto a Writer
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatCSV(java.io.Writer writer, char delimiter) throws IOException
formatCSV(char)
, but the data is output onto a Writer
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatCSV(java.io.Writer writer, char delimiter, java.lang.String nullString) throws IOException
formatCSV(char, String)
, but the data is output onto a Writer
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatJSON(java.io.Writer writer) throws IOException
formatJSON()
, but the data is output onto a Writer
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatXML(java.io.Writer writer) throws IOException
formatXML()
, but the data is output onto a Writer
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatInsert(java.io.Writer writer) throws IOException
formatInsert()
, but the data is output onto a Writer
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.void formatInsert(java.io.Writer writer, Table<?> table, Field<?>... fields) throws IOException
formatInsert(Table, Field...)
, but the data is output onto an Writer
.IOException
- - an unchecked wrapper for IOException
, if anything goes wrong.org.w3c.dom.Document intoXML()
<H extends org.xml.sax.ContentHandler> H intoXML(H handler) throws org.xml.sax.SAXException
ContentHandler
.handler
- The custom content handler.org.xml.sax.SAXException
formatXML()
,
http://www.jooq.org/xsd/jooq-export-2.6.0.xsdjava.util.List<java.util.Map<java.lang.String,java.lang.Object>> intoMaps()
Record.intoMap()
<K> java.util.Map<K,R> intoMap(Field<K> key) throws java.lang.IllegalArgumentException, InvalidResultException
Map
with one of the result's columns as key and the
corresponding records as value.
An InvalidResultException
is thrown, if the key turns out to be
non-unique in the result set. Use intoGroups(Field)
instead, if
your keys are non-unique
K
- The key's generic field typekey
- The key field. Client code must assure that this field is
unique in the result set.java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
InvalidResultException
- if the key field returned two or more
equal values from the result set.java.util.Map<?,R> intoMap(int keyFieldIndex) throws java.lang.IllegalArgumentException, InvalidResultException
Map
with one of the result's columns as key and the
corresponding records as value.
An InvalidResultException
is thrown, if the key turns out to be
non-unique in the result set. Use intoGroups(int)
instead, if
your keys are non-unique
keyFieldIndex
- The key field index. Client code must assure that
this field is unique in the result set.java.lang.IllegalArgumentException
- If the argument keyFieldIndex is not
contained in fieldsRow()
InvalidResultException
- if the key field returned two or more
equal values from the result set.java.util.Map<?,R> intoMap(java.lang.String keyFieldName) throws java.lang.IllegalArgumentException, InvalidResultException
Map
with one of the result's columns as key and the
corresponding records as value.
An InvalidResultException
is thrown, if the key turns out to be
non-unique in the result set. Use intoGroups(String)
instead, if
your keys are non-unique
keyFieldName
- The key field name. Client code must assure that this
field is unique in the result set.java.lang.IllegalArgumentException
- If the argument keyFieldName is not
contained in fieldsRow()
InvalidResultException
- if the key field returned two or more
equal values from the result set.<K,V> java.util.Map<K,V> intoMap(Field<K> key, Field<V> value) throws java.lang.IllegalArgumentException, InvalidResultException
Map
with one of the result's columns as key and another
one of the result's columns as value
An InvalidResultException
is thrown, if the key turns out to be
non-unique in the result set. Use intoGroups(Field, Field)
instead, if your keys are non-unique
K
- The key's generic field typeV
- The value's generic field typekey
- The key field. Client code must assure that this field is
unique in the result set.value
- The value fieldjava.lang.IllegalArgumentException
- If any of the argument fields is not
contained in fieldsRow()
InvalidResultException
- if the key field returned two or more
equal values from the result set.java.util.Map<?,?> intoMap(int keyFieldIndex, int valueFieldIndex) throws java.lang.IllegalArgumentException, InvalidResultException
Map
with one of the result's columns as key and another
one of the result's columns as value
An InvalidResultException
is thrown, if the key turns out to be
non-unique in the result set. Use intoGroups(int, int)
instead,
if your keys are non-unique
keyFieldIndex
- The key field index. Client code must assure that
this field is unique in the result set.valueFieldIndex
- The value field indexjava.lang.IllegalArgumentException
- If any of the argument field indexes is
not contained in fieldsRow()
InvalidResultException
- if the key field returned two or more
equal values from the result set.java.util.Map<?,?> intoMap(java.lang.String keyFieldName, java.lang.String valueFieldName) throws java.lang.IllegalArgumentException, InvalidResultException
Map
with one of the result's columns as key and another
one of the result's columns as value
An InvalidResultException
is thrown, if the key turns out to be
non-unique in the result set. Use intoGroups(String, String)
instead, if your keys are non-unique
key
- The key field name. Client code must assure that this field is
unique in the result set.value
- The value field namejava.lang.IllegalArgumentException
- If any of the argument field names is
not contained in fieldsRow()
InvalidResultException
- if the key field returned two or more
equal values from the result set.<K,E> java.util.Map<K,E> intoMap(Field<K> key, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given key and mapped
into the given entity type.
An InvalidResultException
is thrown, if the key is non-unique in
the result set. Use intoGroups(Field, Class)
instead, if your
key is non-unique.
key
- The key. Client code must assure that key is unique in the
result set.type
- The entity type.java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
InvalidResultException
- if the key is non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<?,E> intoMap(int keyFieldIndex, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given key and mapped
into the given entity type.
An InvalidResultException
is thrown, if the key is non-unique in
the result set. Use intoGroups(int, Class)
instead, if your
key is non-unique.
keyFieldIndex
- The key. Client code must assure that key is unique
in the result set.type
- The entity type.java.lang.IllegalArgumentException
- If the argument field index is not
contained in fieldsRow()
InvalidResultException
- if the key is non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<?,E> intoMap(java.lang.String keyFieldName, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given key and mapped
into the given entity type.
An InvalidResultException
is thrown, if the key is non-unique in
the result set. Use intoGroups(String, Class)
instead, if your
key is non-unique.
keyFieldName
- The key. Client code must assure that key is unique
in the result set.type
- The entity type.java.lang.IllegalArgumentException
- If the argument field name is not
contained in fieldsRow()
InvalidResultException
- if the key is non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<K,E> java.util.Map<K,E> intoMap(Field<K> key, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given key and mapped by
the given mapper.
An InvalidResultException
is thrown, if the key is non-unique in
the result set. Use intoGroups(Field, Class)
instead, if your
key is non-unique.
key
- The key. Client code must assure that key is unique in the
result set.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
InvalidResultException
- if the key is non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<?,E> intoMap(int keyFieldIndex, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given key and mapped by
the given mapper.
An InvalidResultException
is thrown, if the key is non-unique in
the result set. Use intoGroups(int, Class)
instead, if your key
is non-unique.
keyFieldIndex
- The key. Client code must assure that key is unique
in the result set.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If the argument field index is not
contained in fieldsRow()
InvalidResultException
- if the key is non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<?,E> intoMap(java.lang.String keyFieldName, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given key and mapped by
the given mapper.
An InvalidResultException
is thrown, if the key is non-unique in
the result set. Use intoGroups(String, Class)
instead, if your key
is non-unique.
keyFieldName
- The key. Client code must assure that key is unique
in the result set.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If the argument field name is not
contained in fieldsRow()
InvalidResultException
- if the key is non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
java.util.Map<Record,R> intoMap(Field<?>[] keys) throws java.lang.IllegalArgumentException, InvalidResultException
Map
with the given keys as a map key and the
corresponding record as value.
An InvalidResultException
is thrown, if the keys are non-unique
in the result set. Use intoGroups(Field[])
instead, if your keys
are non-unique.
keys
- The keys. Client code must assure that keys are unique in the
result set. If this is null
or an empty array,
the resulting map will contain at most one entry.java.lang.IllegalArgumentException
- If any of the argument fields is not
contained in fieldsRow()
InvalidResultException
- if the keys are non-unique in the result
set.java.util.Map<Record,R> intoMap(int[] keyFieldIndexes) throws java.lang.IllegalArgumentException, InvalidResultException
Map
with the given keys as a map key and the
corresponding record as value.
An InvalidResultException
is thrown, if the keys are non-unique
in the result set. Use intoGroups(int[])
instead, if your keys
are non-unique.
keyFieldIndexes
- The keys. Client code must assure that keys are
unique in the result set. If this is null
or an
empty array, the resulting map will contain at most one entry.java.lang.IllegalArgumentException
- If any of the argument field indexes is
not contained in fieldsRow()
InvalidResultException
- if the keys are non-unique in the result
set.java.util.Map<Record,R> intoMap(java.lang.String[] keyFieldNames) throws java.lang.IllegalArgumentException, InvalidResultException
Map
with the given keys as a map key and the
corresponding record as value.
An InvalidResultException
is thrown, if the keys are non-unique
in the result set. Use intoGroups(String[])
instead, if your
keys are non-unique.
keyFieldNames
- The keys. Client code must assure that keys are
unique in the result set. If this is null
or an
empty array, the resulting map will contain at most one entry.java.lang.IllegalArgumentException
- If any of the argument field names is
not contained in fieldsRow()
InvalidResultException
- if the keys are non-unique in the result
set.<E> java.util.Map<java.util.List<?>,E> intoMap(Field<?>[] keys, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given keys and mapped
into the given entity type.
An InvalidResultException
is thrown, if the keys are non-unique
in the result set. Use intoGroups(Field[], Class)
instead, if
your keys are non-unique.
keys
- The keys. Client code must assure that keys are unique in the
result set. If this is null
or an empty array,
the resulting map will contain at most one entry.type
- The entity type.java.lang.IllegalArgumentException
- If any of the argument fields is not
contained in fieldsRow()
InvalidResultException
- if the keys are non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<java.util.List<?>,E> intoMap(int[] keyFieldIndexes, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given keys and mapped
into the given entity type.
An InvalidResultException
is thrown, if the keys are non-unique
in the result set. Use intoGroups(int[], Class)
instead, if your
keys are non-unique.
keyFieldIndexes
- The keys. Client code must assure that keys are
unique in the result set. If this is null
or an
empty array, the resulting map will contain at most one entry.type
- The entity type.java.lang.IllegalArgumentException
- If any of the argument field indexes is
not contained in fieldsRow()
InvalidResultException
- if the keys are non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<java.util.List<?>,E> intoMap(java.lang.String[] keyFieldNames, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given keys and mapped
into the given entity type.
An InvalidResultException
is thrown, if the keys are non-unique
in the result set. Use intoGroups(String[], Class)
instead, if your
keys are non-unique.
keyFieldNames
- The keys. Client code must assure that keys are
unique in the result set. If this is null
or an
empty array, the resulting map will contain at most one entry.type
- The entity type.java.lang.IllegalArgumentException
- If any of the argument field names is
not contained in fieldsRow()
InvalidResultException
- if the keys are non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<java.util.List<?>,E> intoMap(Field<?>[] keys, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given keys and mapped by
the given mapper.
An InvalidResultException
is thrown, if the keys are non-unique
in the result set. Use intoGroups(Field[], Class)
instead, if
your keys are non-unique.
keys
- The keys. Client code must assure that keys are unique in the
result set. If this is null
or an empty array,
the resulting map will contain at most one entry.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If any of the argument fields is not
contained in fieldsRow()
InvalidResultException
- if the keys are non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<java.util.List<?>,E> intoMap(int[] keyFieldIndexes, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given keys and mapped by
the given mapper.
An InvalidResultException
is thrown, if the keys are non-unique
in the result set. Use intoGroups(int[], Class)
instead, if your
keys are non-unique.
keyFieldIndexes
- The keys. Client code must assure that keys are
unique in the result set. If this is null
or an
empty array, the resulting map will contain at most one entry.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If any of the argument field indexes is
not contained in fieldsRow()
InvalidResultException
- if the keys are non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<java.util.List<?>,E> intoMap(java.lang.String[] keyFieldNames, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given keys and mapped by
the given mapper.
An InvalidResultException
is thrown, if the keys are non-unique
in the result set. Use intoGroups(String[], Class)
instead, if
your keys are non-unique.
keyFieldNames
- The keys. Client code must assure that keys are
unique in the result set. If this is null
or an
empty array, the resulting map will contain at most one entry.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If any of the argument field names is
not contained in fieldsRow()
InvalidResultException
- if the keys are non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<S extends Record> java.util.Map<S,R> intoMap(Table<S> table) throws java.lang.IllegalArgumentException, InvalidResultException
Map
with the given key table as a map key and the
corresponding record as value.
An InvalidResultException
is thrown, if the keys are non-unique
in the result set. Use intoGroups(Table)
instead, if your keys
are non-unique.
table
- The key table. Client code must assure that keys are unique
in the result set. May not be null
.java.lang.IllegalArgumentException
- If any of the argument fields is not
contained in fieldsRow()
InvalidResultException
- if the keys are non-unique in the result
set.<E,S extends Record> java.util.Map<S,E> intoMap(Table<S> table, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given key table and
mapped into the given entity type.
An InvalidResultException
is thrown, if the keys are non-unique
in the result set. Use intoGroups(Table, Class)
instead, if your
keys are non-unique.
table
- The key table. Client code must assure that keys are unique
in the result set. May not be null
.type
- The entity type.java.lang.IllegalArgumentException
- If any of the argument fields is not
contained in fieldsRow()
InvalidResultException
- if the keys are non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E,S extends Record> java.util.Map<S,E> intoMap(Table<S> table, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, InvalidResultException, MappingException
Map
with results grouped by the given key table and
mapped by the given mapper.
An InvalidResultException
is thrown, if the keys are non-unique
in the result set. Use intoGroups(Table, Class)
instead, if your
keys are non-unique.
table
- The key table. Client code must assure that keys are unique
in the result set. May not be null
.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If any of the argument fields is not
contained in fieldsRow()
InvalidResultException
- if the keys are non-unique in the result
set.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<K> java.util.Map<K,Result<R>> intoGroups(Field<K> key) throws java.lang.IllegalArgumentException
Map
with one of the result's columns as key and a list
of corresponding records as value.
Unlike intoMap(Field)
, this method allows for non-unique keys in
the result set.
K
- The key's generic field typekey
- The key field.java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
java.util.Map<?,Result<R>> intoGroups(int keyFieldIndex) throws java.lang.IllegalArgumentException
Map
with one of the result's columns as key and a list
of corresponding records as value.
Unlike intoMap(int)
, this method allows for non-unique keys in
the result set.
keyFieldIndex
- The key field index.java.lang.IllegalArgumentException
- If the argument field index is not
contained in fieldsRow()
java.util.Map<?,Result<R>> intoGroups(java.lang.String keyFieldName) throws java.lang.IllegalArgumentException
Map
with one of the result's columns as key and a list
of corresponding records as value.
Unlike intoMap(String)
, this method allows for non-unique keys in
the result set.
keyFieldName
- The key field name.java.lang.IllegalArgumentException
- If the argument field name is not
contained in fieldsRow()
<K,V> java.util.Map<K,java.util.List<V>> intoGroups(Field<K> key, Field<V> value) throws java.lang.IllegalArgumentException
Map
with one of the result's columns as key and another
one of the result's columns as value.
Unlike intoMap(Field, Field)
, this method allows for non-unique
keys in the result set.
K
- The key's generic field typeV
- The value's generic field typekey
- The key field.value
- The value fieldjava.lang.IllegalArgumentException
- If any of the argument fields is not
contained in fieldsRow()
java.util.Map<?,java.util.List<?>> intoGroups(int keyFieldIndex, int valueFieldIndex) throws java.lang.IllegalArgumentException
Map
with one of the result's columns as key and another
one of the result's columns as value.
Unlike intoMap(int, int)
, this method allows for non-unique keys
in the result set.
keyFieldIndex
- The key field index.valueFieldIndex
- The value field index.java.lang.IllegalArgumentException
- If any of the argument field indexes is
not contained in fieldsRow()
java.util.Map<?,java.util.List<?>> intoGroups(java.lang.String keyFieldName, java.lang.String valueFieldName) throws java.lang.IllegalArgumentException
Map
with one of the result's columns as key and another
one of the result's columns as value.
Unlike intoMap(String, String)
, this method allows for
non-unique keys in the result set.
keyFieldName
- The key field name.valueFieldName
- The value field name.java.lang.IllegalArgumentException
- If any of the argument field names is
not contained in fieldsRow()
<K,E> java.util.Map<K,java.util.List<E>> intoGroups(Field<K> key, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given key and mapped
into the given entity type.
K
- The key's generic field typeE
- The generic entity type.key
- The key field.type
- The entity type.java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<?,java.util.List<E>> intoGroups(int keyFieldIndex, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given key and mapped
into the given entity type.
keyFieldIndex
- The key field index.type
- The entity type.java.lang.IllegalArgumentException
- If the argument field index is not
contained in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<?,java.util.List<E>> intoGroups(java.lang.String keyFieldName, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given key and mapped
into the given entity type.
keyFieldName
- The key field name.type
- The entity type.java.lang.IllegalArgumentException
- If the argument field name is not
contained in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<K,E> java.util.Map<K,java.util.List<E>> intoGroups(Field<K> key, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given key and mapped by
the given mapper.K
- The key's generic field typeE
- The generic entity type.key
- The key field.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping records<E> java.util.Map<?,java.util.List<E>> intoGroups(int keyFieldIndex, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given key and mapped by
the given mapper.keyFieldIndex
- The key field index.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If the argument field index is not
contained in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping records<E> java.util.Map<?,java.util.List<E>> intoGroups(java.lang.String keyFieldName, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given key and mapped by
the given mapper.keyFieldName
- The key field name.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If the argument field name is not
contained in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsjava.util.Map<Record,Result<R>> intoGroups(Field<?>[] keys) throws java.lang.IllegalArgumentException
Map
with the result grouped by the given keys.
Unlike intoMap(Field[])
, this method allows for non-unique keys
in the result set.
keys
- The keys. If this is null
or an empty array, the
resulting map will contain at most one entry.java.lang.IllegalArgumentException
- If any of the argument fields is not
contained in fieldsRow()
java.util.Map<Record,Result<R>> intoGroups(int[] keyFieldIndexes) throws java.lang.IllegalArgumentException
Map
with the result grouped by the given keys.
Unlike intoMap(int[])
, this method allows for non-unique keys
in the result set.
keyFieldIndexes
- The keys. If this is null
or an empty
array, the resulting map will contain at most one entry.java.lang.IllegalArgumentException
- If any of the argument field indexes is
not contained in fieldsRow()
java.util.Map<Record,Result<R>> intoGroups(java.lang.String[] keyFieldNames) throws java.lang.IllegalArgumentException
Map
with the result grouped by the given keys.
Unlike intoMap(String[])
, this method allows for non-unique keys
in the result set.
keyFieldNames
- The keys. If this is null
or an empty
array, the resulting map will contain at most one entry.java.lang.IllegalArgumentException
- If any of the argument field names is
not contained in fieldsRow()
<E> java.util.Map<Record,java.util.List<E>> intoGroups(Field<?>[] keys, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given keys and mapped
into the given entity type.
Unlike intoMap(Field[], Class)
, this method allows for
non-unique keys in the result set.
keys
- The keys. If this is null
or an empty array, the
resulting map will contain at most one entry.type
- The entity type.java.lang.IllegalArgumentException
- If the any of the argument fields is not
contained in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<Record,java.util.List<E>> intoGroups(int[] keyFieldIndexes, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given keys and mapped
into the given entity type.
Unlike intoMap(int[], Class)
, this method allows for non-unique
keys in the result set.
keyFieldIndexes
- The keys. If this is null
or an empty
array, the resulting map will contain at most one entry.type
- The entity type.java.lang.IllegalArgumentException
- If the any of the argument field indexes
is not contained in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<Record,java.util.List<E>> intoGroups(java.lang.String[] keyFieldNames, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given keys and mapped
into the given entity type.
Unlike intoMap(String[], Class)
, this method allows for
non-unique keys in the result set.
keyFieldNames
- The keys. If this is null
or an empty
array, the resulting map will contain at most one entry.type
- The entity type.java.lang.IllegalArgumentException
- If the any of the argument field names
is not contained in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<Record,java.util.List<E>> intoGroups(Field<?>[] keys, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given keys and mapped
into the given entity type.
Unlike intoMap(Field[], RecordMapper)
, this method allows for
non-unique keys in the result set.
keys
- The keys. If this is null
or an empty array, the
resulting map will contain at most one entry.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If the any of the argument fields is not
contained in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<Record,java.util.List<E>> intoGroups(int[] keyFieldIndexes, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given keys and mapped
into the given entity type.
Unlike intoMap(int[], RecordMapper)
, this method allows for
non-unique keys in the result set.
keyFieldIndexes
- The keys. If this is null
or an empty
array, the resulting map will contain at most one entry.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If the any of the argument field indexes
is not contained in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E> java.util.Map<Record,java.util.List<E>> intoGroups(java.lang.String[] keyFieldNames, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given keys and mapped
into the given entity type.
Unlike intoMap(String[], RecordMapper)
, this method allows for
non-unique keys in the result set.
keyFieldNames
- The keys. If this is null
or an empty
array, the resulting map will contain at most one entry.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If the any of the argument field indexes
is not contained in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<S extends Record> java.util.Map<S,Result<R>> intoGroups(Table<S> table) throws java.lang.IllegalArgumentException
Map
with the result grouped by the given key table.
Unlike intoMap(Table)
, this method allows for non-unique keys in
the result set.
table
- The key table. May not be null
.java.lang.IllegalArgumentException
- If any of the argument fields is not
contained in fieldsRow()
<E,S extends Record> java.util.Map<S,java.util.List<E>> intoGroups(Table<S> table, java.lang.Class<? extends E> type) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given key table and
mapped into the given entity type.
Unlike intoMap(Table, Class)
, this method allows for non-unique
keys in the result set.
table
- The key table. May not be null
.type
- The entity type.java.lang.IllegalArgumentException
- If the any of the argument fields is not
contained in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
<E,S extends Record> java.util.Map<S,java.util.List<E>> intoGroups(Table<S> table, RecordMapper<? super R,E> mapper) throws java.lang.IllegalArgumentException, MappingException
Map
with results grouped by the given key table and
mapped into the given entity type.
Unlike intoMap(Table, RecordMapper)
, this method allows for
non-unique keys in the result set.
table
- The key table. May not be null
.mapper
- The mapper callback.java.lang.IllegalArgumentException
- If the any of the argument fields is not
contained in fieldsRow()
MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsDefaultRecordMapper
@Deprecated java.lang.Object[][] intoArray()
intoArrays()
instead.java.lang.Object[][] intoArrays()
The resulting array has the same number of first-dimension elements as this result has records. It has the same number of second-dimension elements as this result's records have fields. The resulting array contains data as such:
// For arbitrary values of i, j
result.getValue(i, j) == result.intoArray()[i][j]
Record.intoArray()
java.lang.Object[] intoArray(int fieldIndex) throws java.lang.IllegalArgumentException
You can access data like this
result.intoArray(fieldIndex)[recordIndex]
Object[]
, depending on whether jOOQ has any
knowledge about fieldIndex
's actual type.java.lang.IllegalArgumentException
- If the argument fieldIndex is not
contained in fieldsRow()
getValues(int)
<T> T[] intoArray(int fieldIndex, java.lang.Class<? extends T> type) throws java.lang.IllegalArgumentException, DataTypeException
You can access data like this
result.intoArray(fieldIndex)[recordIndex]
java.lang.IllegalArgumentException
- If the argument fieldIndex is not
contained in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredgetValues(int, Class)
<U> U[] intoArray(int fieldIndex, Converter<?,U> converter) throws java.lang.IllegalArgumentException, DataTypeException
You can access data like this
result.intoArray(fieldIndex)[recordIndex]
java.lang.IllegalArgumentException
- If the argument fieldIndex is not
contained in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredgetValues(int, Converter)
java.lang.Object[] intoArray(java.lang.String fieldName) throws java.lang.IllegalArgumentException
You can access data like this
result.intoArray(fieldName)[recordIndex]
Object[]
, depending on whether jOOQ has any
knowledge about fieldName
's actual type.java.lang.IllegalArgumentException
- If the argument fieldName is not
contained in fieldsRow()
getValues(String)
<T> T[] intoArray(java.lang.String fieldName, java.lang.Class<? extends T> type) throws java.lang.IllegalArgumentException, DataTypeException
You can access data like this
result.intoArray(fieldName)[recordIndex]
java.lang.IllegalArgumentException
- If the argument fieldName is not
contained in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredgetValues(String, Class)
<U> U[] intoArray(java.lang.String fieldName, Converter<?,U> converter) throws java.lang.IllegalArgumentException, DataTypeException
You can access data like this
result.intoArray(fieldName)[recordIndex]
java.lang.IllegalArgumentException
- If the argument fieldName is not
contained in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredgetValues(String, Converter)
<T> T[] intoArray(Field<T> field) throws java.lang.IllegalArgumentException
You can access data like this
result.intoArray(field)[recordIndex]
java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
getValues(Field)
<T> T[] intoArray(Field<?> field, java.lang.Class<? extends T> type) throws java.lang.IllegalArgumentException, DataTypeException
You can access data like this
result.intoArray(field)[recordIndex]
java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredgetValues(Field, Class)
<T,U> U[] intoArray(Field<T> field, Converter<? super T,U> converter) throws java.lang.IllegalArgumentException, DataTypeException
You can access data like this
result.intoArray(field)[recordIndex]
java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredgetValues(Field, Converter)
java.util.Set<?> intoSet(int fieldIndex) throws java.lang.IllegalArgumentException
Object[]
, depending on whether jOOQ has any
knowledge about fieldIndex
's actual type.java.lang.IllegalArgumentException
- If the argument fieldIndex is not
contained in fieldsRow()
getValues(int)
<T> java.util.Set<T> intoSet(int fieldIndex, java.lang.Class<? extends T> type) throws java.lang.IllegalArgumentException, DataTypeException
java.lang.IllegalArgumentException
- If the argument fieldIndex is not
contained in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredgetValues(int, Class)
<U> java.util.Set<U> intoSet(int fieldIndex, Converter<?,U> converter) throws java.lang.IllegalArgumentException, DataTypeException
java.lang.IllegalArgumentException
- If the argument fieldIndex is not
contained in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredgetValues(int, Converter)
java.util.Set<?> intoSet(java.lang.String fieldName) throws java.lang.IllegalArgumentException
Object[]
, depending on whether jOOQ has any
knowledge about fieldName
's actual type.java.lang.IllegalArgumentException
- If the argument fieldName is not
contained in fieldsRow()
getValues(String)
<T> java.util.Set<T> intoSet(java.lang.String fieldName, java.lang.Class<? extends T> type) throws java.lang.IllegalArgumentException, DataTypeException
java.lang.IllegalArgumentException
- If the argument fieldName is not
contained in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredgetValues(String, Class)
<U> java.util.Set<U> intoSet(java.lang.String fieldName, Converter<?,U> converter) throws java.lang.IllegalArgumentException, DataTypeException
java.lang.IllegalArgumentException
- If the argument fieldName is not
contained in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredgetValues(String, Converter)
<T> java.util.Set<T> intoSet(Field<T> field) throws java.lang.IllegalArgumentException
java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
getValues(Field)
<T> java.util.Set<T> intoSet(Field<?> field, java.lang.Class<? extends T> type) throws java.lang.IllegalArgumentException, DataTypeException
java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredgetValues(Field, Class)
<T,U> java.util.Set<U> intoSet(Field<T> field, Converter<? super T,U> converter) throws java.lang.IllegalArgumentException, DataTypeException
java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
DataTypeException
- wrapping any data type conversion exception
that might have occurredgetValues(Field, Converter)
Result<Record> into(Field<?>... fields)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1> Result<Record1<T1>> into(Field<T1> field1)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2> Result<Record2<T1,T2>> into(Field<T1> field1, Field<T2> field2)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3> Result<Record3<T1,T2,T3>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4> Result<Record4<T1,T2,T3,T4>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5> Result<Record5<T1,T2,T3,T4,T5>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6> Result<Record6<T1,T2,T3,T4,T5,T6>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7> Result<Record7<T1,T2,T3,T4,T5,T6,T7>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8> Result<Record8<T1,T2,T3,T4,T5,T6,T7,T8>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9> Result<Record9<T1,T2,T3,T4,T5,T6,T7,T8,T9>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9,T10> Result<Record10<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9, Field<T10> field10)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11> Result<Record11<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9, Field<T10> field10, Field<T11> field11)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12> Result<Record12<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9, Field<T10> field10, Field<T11> field11, Field<T12> field12)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13> Result<Record13<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9, Field<T10> field10, Field<T11> field11, Field<T12> field12, Field<T13> field13)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14> Result<Record14<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9, Field<T10> field10, Field<T11> field11, Field<T12> field12, Field<T13> field13, Field<T14> field14)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15> Result<Record15<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9, Field<T10> field10, Field<T11> field11, Field<T12> field12, Field<T13> field13, Field<T14> field14, Field<T15> field15)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16> Result<Record16<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9, Field<T10> field10, Field<T11> field11, Field<T12> field12, Field<T13> field13, Field<T14> field14, Field<T15> field15, Field<T16> field16)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17> Result<Record17<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9, Field<T10> field10, Field<T11> field11, Field<T12> field12, Field<T13> field13, Field<T14> field14, Field<T15> field15, Field<T16> field16, Field<T17> field17)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18> Result<Record18<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9, Field<T10> field10, Field<T11> field11, Field<T12> field12, Field<T13> field13, Field<T14> field14, Field<T15> field15, Field<T16> field16, Field<T17> field17, Field<T18> field18)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18,T19> Result<Record19<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18,T19>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9, Field<T10> field10, Field<T11> field11, Field<T12> field12, Field<T13> field13, Field<T14> field14, Field<T15> field15, Field<T16> field16, Field<T17> field17, Field<T18> field18, Field<T19> field19)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18,T19,T20> Result<Record20<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18,T19,T20>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9, Field<T10> field10, Field<T11> field11, Field<T12> field12, Field<T13> field13, Field<T14> field14, Field<T15> field15, Field<T16> field16, Field<T17> field17, Field<T18> field18, Field<T19> field19, Field<T20> field20)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18,T19,T20,T21> Result<Record21<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18,T19,T20,T21>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9, Field<T10> field10, Field<T11> field11, Field<T12> field12, Field<T13> field13, Field<T14> field14, Field<T15> field15, Field<T16> field16, Field<T17> field17, Field<T18> field18, Field<T19> field19, Field<T20> field20, Field<T21> field21)
fields
- The fields of the new records@Generated(value="This class was generated using jOOQ-tools") <T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18,T19,T20,T21,T22> Result<Record22<T1,T2,T3,T4,T5,T6,T7,T8,T9,T10,T11,T12,T13,T14,T15,T16,T17,T18,T19,T20,T21,T22>> into(Field<T1> field1, Field<T2> field2, Field<T3> field3, Field<T4> field4, Field<T5> field5, Field<T6> field6, Field<T7> field7, Field<T8> field8, Field<T9> field9, Field<T10> field10, Field<T11> field11, Field<T12> field12, Field<T13> field13, Field<T14> field14, Field<T15> field15, Field<T16> field16, Field<T17> field17, Field<T18> field18, Field<T19> field19, Field<T20> field20, Field<T21> field21, Field<T22> field22)
fields
- The fields of the new records<E> java.util.List<E> into(java.lang.Class<? extends E> type) throws MappingException
This is the same as calling record.into(type)
on every
record contained in this Result
. See
Record.into(Class)
for more details
E
- The generic entity type.type
- The entity type.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsRecord.into(Class)
,
DefaultRecordMapper
<Z extends Record> Result<Z> into(Table<Z> table) throws MappingException
This is the same as calling record.into(table)
on every
record contained in this Result
. See
Record.into(Table)
for more details
Z
- The generic table record type.table
- The table type.MappingException
- wrapping any reflection or data type conversion
exception that might have occurred while mapping recordsRecord.into(Table)
<H extends RecordHandler<? super R>> H into(H handler)
handler
- The handler callbackjava.sql.ResultSet intoResultSet()
ResultSet
containing the data of this
Result
.
Use this as an adapter for JDBC-compliant code that expects a
ResultSet
to operate on, rather than a jOOQ Result
. The
returned ResultSet
allows for the following behaviour
according to the JDBC specification:
ResultSet.CLOSE_CURSORS_AT_COMMIT
: The cursors (i.e.
Statement
object) are no longer availableResultSet.CONCUR_READ_ONLY
: You cannot update the database
through this ResultSet
, as the underlying Result
object does not hold any open database refences anymoreResultSet.FETCH_FORWARD
: The fetch direction is forward only,
and cannot be changedResultSet.TYPE_SCROLL_INSENSITIVE
: You can use any of the
ResultSet
's scrolling methods, e.g. ResultSet.next()
or ResultSet.previous()
, etc.
You may use DSLContext.fetch(ResultSet)
to unwind this wrapper
again.
ResultSet
<E> java.util.List<E> map(RecordMapper<? super R,E> mapper)
mapper
- The mapper callback<T extends java.lang.Comparable<? super T>> Result<R> sortAsc(Field<T> field) throws java.lang.IllegalArgumentException
nulls
are sorted last by this method.
field
- The sort fieldjava.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
<T extends java.lang.Comparable<? super T>> Result<R> sortDesc(Field<T> field) throws java.lang.IllegalArgumentException
nulls
are sorted last by this method.
field
- The sort fieldjava.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
Result<R> sortAsc(int fieldIndex) throws java.lang.IllegalArgumentException
nulls
are sorted last by this method.
fieldIndex
- The sort field indexjava.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
Result<R> sortDesc(int fieldIndex) throws java.lang.IllegalArgumentException
nulls
are sorted last by this method.
fieldIndex
- The sort field indexjava.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
Result<R> sortAsc(java.lang.String fieldName) throws java.lang.IllegalArgumentException
nulls
are sorted last by this method.
fieldName
- The sort field namejava.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
Result<R> sortDesc(java.lang.String fieldName) throws java.lang.IllegalArgumentException
nulls
are sorted last by this method.
fieldName
- The sort field namejava.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
<T> Result<R> sortAsc(Field<T> field, java.util.Comparator<? super T> comparator) throws java.lang.IllegalArgumentException
null
sorting must be handled by the supplied
comparator
.
field
- The sort fieldcomparator
- The comparator used to sort this result.java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
<T> Result<R> sortDesc(Field<T> field, java.util.Comparator<? super T> comparator) throws java.lang.IllegalArgumentException
null
sorting must be handled by the supplied
comparator
.
field
- The sort fieldcomparator
- The comparator used to sort this result.java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
Result<R> sortAsc(int fieldIndex, java.util.Comparator<?> comparator) throws java.lang.IllegalArgumentException
null
sorting must be handled by the supplied
comparator
.
fieldIndex
- The sort field indexcomparator
- The comparator used to sort this result.java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
Result<R> sortDesc(int fieldIndex, java.util.Comparator<?> comparator) throws java.lang.IllegalArgumentException
null
sorting must be handled by the supplied
comparator
.
fieldIndex
- The sort field indexcomparator
- The comparator used to sort this result.java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
Result<R> sortAsc(java.lang.String fieldName, java.util.Comparator<?> comparator) throws java.lang.IllegalArgumentException
null
sorting must be handled by the supplied
comparator
.
fieldName
- The sort field namecomparator
- The comparator used to sort this result.java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
Result<R> sortDesc(java.lang.String fieldName, java.util.Comparator<?> comparator) throws java.lang.IllegalArgumentException
null
sorting must be handled by the supplied
comparator
.
fieldName
- The sort field namecomparator
- The comparator used to sort this result.java.lang.IllegalArgumentException
- If the argument field is not contained
in fieldsRow()
Result<R> sortAsc(java.util.Comparator<? super R> comparator)
comparator
- The comparator used to sort this result.Result<R> sortDesc(java.util.Comparator<? super R> comparator)
comparator
- The comparator used to sort this result.Result<R> intern(Field<?>... fields)
See intern(int...)
for more details.
fields
- The fields whose values should be internedintern(Field...)
,
String.intern()
Result<R> intern(int... fieldIndexes)
This traverses all records and interns String
values for a
given set of field indexes. Use this method to save memory when a large
result set contains many identical string literals.
Please refer to String.intern()
and to publicly available
literature to learn more about potential side-effects of string
interning.
Future versions of jOOQ may also "intern" other data types, such as
Integer
, Long
, within a Result
object.
fieldIndexes
- The field indexes whose values should be internedintern(Field...)
,
String.intern()
Result<R> intern(java.lang.String... fieldNames)
See intern(int...)
for more details.
fieldNames
- The field names whose values should be internedintern(Field...)
,
String.intern()
<O extends UpdatableRecord<O>> Result<O> fetchParents(ForeignKey<R,O> key) throws DataAccessException
DataAccessException
- if something went wrong executing the query.ForeignKey.fetchParent(Record)
,
ForeignKey.fetchParents(java.util.Collection)
,
ForeignKey.fetchParents(Record...)
<O extends TableRecord<O>> Result<O> fetchChildren(ForeignKey<O,R> key) throws DataAccessException
DataAccessException
- if something went wrong executing the query.ForeignKey.fetchChildren(java.util.Collection)
,
ForeignKey.fetchChildren(Record)
,
ForeignKey.fetchChildren(Record...)
void attach(Configuration configuration)
Configuration
.attach
in interface Attachable
configuration
- A configuration or null
, if you wish to
detach this Attachable
from its previous
configuration.void detach()
Configuration
.
This is the same as calling attach(null)
.
detach
in interface Attachable
Copyright © 2015. All Rights Reserved.