net.zer0bandwidth.android.lib.database.sqlitehouse

Class SQLiteHouse.QueryContext<DBH extends SQLiteHouse>

java.lang.Object

net.zer0bandwidth.android.lib.database.sqlitehouse.SQLiteHouse.QueryContext<DBH>

Enclosing class:

SQLiteHouse<DSC extends SQLiteHouse>

Deprecated.

zer0bandwidth-net/android 0.2.1 (#56) — use SQLightable.Reflection instead, by using SQLiteHouse.getReflection(Class) to fetch the one that the database class has already generated, or by using SQLightable.Reflection.reflect(Class) to generate a new one.

public static class SQLiteHouse.QueryContext<DBH extends SQLiteHouse>
extends java.lang.Object

A short-lived, open data structure which provides context for various operations within the class. Because so many of the values fetched here must be reused multiple times within the body of certain larger functions, or must be passed between functions, it is useful to have all of these fields gathered in a single contextual container. Since 0.1.7 (#50), this class is not particularly different from SQLightable.Reflection.

Since:

zer0bandwidth-net/android 0.1.4 (#26)

Field Summary

Fields

Modifier and Type	Field and Description
SQLiteColumn	antColumn Deprecated. The context field's column-defining annotation.
SQLiteTable	antTable Deprecated. The schematic class's table-defining annotation.
boolean	bColumnIsKey Deprecated. Indicates whether the column is annotated as a key.
java.lang.Class<? extends SQLightable>	clsTable Deprecated. The schematic class providing this context.
java.lang.reflect.Field	fldColumn Deprecated. The field of the schematic class in this context, if any.
DBH	house Deprecated. A persistent reference back to a database portal.
Refractor	lens Deprecated. The refractor appropriate for this column type.
java.lang.String	sColumnName Deprecated. The name of the column.
java.lang.String	sColumnSQLValue Deprecated. The value of this column in some instance, if set.
java.lang.String	sTableName Deprecated. The name of the table.

Constructor Summary

Constructors

Constructor and Description
QueryContext(DBH dbh) Deprecated. Constructs the instance and binds it back to a SQLiteHouse.

Method Summary

Modifier and Type	Method and Description
protected SQLiteHouse.QueryContext<DBH>	clearColumnDef() Deprecated. Clears any and all contextual data pertaining to a table column.
SQLiteHouse.QueryContext<DBH>	loadColumnDef(java.lang.reflect.Field fld) Deprecated. Loads contextual information pertaining to a column of the table already set by loadTableDef(java.lang.Class<SC>).
SQLiteHouse.QueryContext<DBH>	loadColumnDef(java.lang.String sSoughtName) Deprecated. Loads contextual information pertaining to a column of the table set by loadTableDef(java.lang.Class<SC>), by searching for that column by its name.
<SC extends SQLightable> SQLiteHouse.QueryContext<DBH>	loadColumnValue(SC o) Deprecated. If the context is bound to a specific column, then this method will try to discover the value of the field corresponding to that column in the specified object instance.
<SC extends SQLightable> SQLiteHouse.QueryContext<DBH>	loadTableDef(java.lang.Class<SC> cls) Deprecated. Loads contextual information pertaining to the table defined by the specified schematic class.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

house

public DBH extends SQLiteHouse house

Deprecated.

A persistent reference back to a database portal.

clsTable

public java.lang.Class<? extends SQLightable> clsTable

Deprecated.

The schematic class providing this context.

antTable

public SQLiteTable antTable

Deprecated.

The schematic class's table-defining annotation.

sTableName

public java.lang.String sTableName

Deprecated.

The name of the table.

fldColumn

public java.lang.reflect.Field fldColumn

Deprecated.

The field of the schematic class in this context, if any.

antColumn

public SQLiteColumn antColumn

Deprecated.

The context field's column-defining annotation.

sColumnName

public java.lang.String sColumnName

Deprecated.

The name of the column.

bColumnIsKey

public boolean bColumnIsKey

Deprecated.

Indicates whether the column is annotated as a key.

lens

public Refractor lens

Deprecated.

The refractor appropriate for this column type.

sColumnSQLValue

public java.lang.String sColumnSQLValue

Deprecated.

The value of this column in some instance, if set.

Constructor Detail

QueryContext

public QueryContext(DBH dbh)

Deprecated.

Constructs the instance and binds it back to a SQLiteHouse.

Parameters:

dbh - the helper instance

See Also:

SQLiteHouse.getQueryContext()

Method Detail

loadTableDef

public <SC extends SQLightable> SQLiteHouse.QueryContext<DBH> loadTableDef(java.lang.Class<SC> cls)
                                                                    throws SchematicException

Deprecated.

Loads contextual information pertaining to the table defined by the specified schematic class. This operation clears all previously-loaded table data, and any data that might have been loaded for a column of that table.

Type Parameters:

SC - the schematic class

Parameters:

cls - the schematic class

Returns:

(fluid)

Throws:

SchematicException - if the class isn't part of the schema

loadColumnDef

public SQLiteHouse.QueryContext<DBH> loadColumnDef(java.lang.reflect.Field fld)

Deprecated.

Loads contextual information pertaining to a column of the table already set by loadTableDef(java.lang.Class<SC>). This operation will clear the value of any previously-analyzed column.

Parameters:

fld - the field to be set for context

Returns:

(fluid)

loadColumnDef

public SQLiteHouse.QueryContext<DBH> loadColumnDef(java.lang.String sSoughtName)

Deprecated.

Loads contextual information pertaining to a column of the table set by loadTableDef(java.lang.Class<SC>), by searching for that column by its name. This operation will clear the value of any previously-analyzed column.

Parameters:

sSoughtName - the name of the column to be set for context

Returns:

(fluid)

clearColumnDef

protected SQLiteHouse.QueryContext<DBH> clearColumnDef()

Deprecated.

Clears any and all contextual data pertaining to a table column.

Returns:

(fluid)

loadColumnValue

public <SC extends SQLightable> SQLiteHouse.QueryContext<DBH> loadColumnValue(SC o)
                                                                       throws java.lang.IllegalStateException,
                                                                              java.lang.NullPointerException,
                                                                              SchematicException

Deprecated.

If the context is bound to a specific column, then this method will try to discover the value of the field corresponding to that column in the specified object instance.

Type Parameters:

SC - the schematic class

Parameters:

o - the schematic object that contains the column field

Returns:

(fluid)

Throws:

java.lang.IllegalStateException - if inadequate context has been loaded

java.lang.NullPointerException - if the schematic object is null

SchematicException - if something goes wrong while setting the value