net.zer0bandwidth.android.lib.database.sqlitehouse.exceptions

Class SchematicException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

net.zer0bandwidth.android.lib.database.sqlitehouse.exceptions.SchematicException

All Implemented Interfaces:

java.io.Serializable

public class SchematicException
extends java.lang.RuntimeException

Thrown by SQLiteHouse whenever a method encounters a problem with the schema definition discovered in some schematic class.

Since:

zer0bandwidth-net/android 0.1.4 (#26)

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_MESSAGE

Constructor Summary

Constructors

Constructor and Description
SchematicException()
SchematicException(java.lang.String sMessage)
SchematicException(java.lang.String sMessage, java.lang.Throwable xCause)
SchematicException(java.lang.Throwable xCause)

Method Summary

Modifier and Type	Method and Description
static SchematicException	classNotInSchema(java.lang.Class<? extends SQLightable> cls, java.util.List<java.lang.Class<? extends SQLightable>> aclsSchema) Returns an exception to be thrown when a method tries to operate on a schematic class that is not actually part of a defined schema.
static SchematicException	columnNotFound(java.lang.String sClassName, java.lang.String sFieldName, java.lang.String sTableName, java.lang.Throwable x) Returns a new exception to be thrown when a field's mapping into an existing table can't be resolved.
static SchematicException	fieldNotAnnotated(java.lang.reflect.Field fld) Returns an exception to be thrown when a field that was supposed to represent a column isn't properly annotated.
static SchematicException	fieldWasInaccessible(java.lang.String sClassName, java.lang.String sFieldName, java.lang.IllegalAccessException xAccess) Returns a new exception that notes a condition that can't happen: namely, that a field we had previously made accessible wasn't accessible when subsequently accessed.
static SchematicException	noLensForColumn(SQLightable.Reflection.Column col, java.lang.Throwable xCause) Returns an exception to be thrown when a column operation cannot continue because the column's Refractor implementation cannot be determined.
static SchematicException	noLensForField(java.lang.reflect.Field fld, java.lang.Throwable xCause) Returns an exception to be thrown when an operation cannot continue because a field/column's Refractor implementation cannot be determined
static SchematicException	tableCreationOrUpdateFailed(SQLightable.Reflection refl, java.lang.String sSQL, java.lang.Throwable xCause) Returns an exception to be thrown when an attempt to create or update the SQLite database fails because the SQL statement failed.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MESSAGE

public static final java.lang.String DEFAULT_MESSAGE

See Also:

Constant Field Values

Constructor Detail

SchematicException

public SchematicException()

SchematicException

public SchematicException(java.lang.String sMessage)

SchematicException

public SchematicException(java.lang.Throwable xCause)

SchematicException

public SchematicException(java.lang.String sMessage,
                          java.lang.Throwable xCause)

Method Detail

fieldWasInaccessible

public static SchematicException fieldWasInaccessible(java.lang.String sClassName,
                                                      java.lang.String sFieldName,
                                                      java.lang.IllegalAccessException xAccess)

Returns a new exception that notes a condition that can't happen: namely, that a field we had previously made accessible wasn't accessible when subsequently accessed.

Parameters:

sClassName - the name of the schematic class (since 0.1.6 #47)

sFieldName - the name of the field (since 0.1.6 #47)

xAccess - the exception

Returns:

a new exception with an appropriate message.

columnNotFound

public static SchematicException columnNotFound(java.lang.String sClassName,
                                                java.lang.String sFieldName,
                                                java.lang.String sTableName,
                                                java.lang.Throwable x)

Returns a new exception to be thrown when a field's mapping into an existing table can't be resolved. This shouldn't be possible when a SQLiteHouse database is used from the beginning, but might arise when there are mismatches in the annotations, or when migrating from a non-SQLiteHouse database implementation.

Parameters:

sClassName - the name of the field's class

sFieldName - the name of the sought field

sTableName - the table in which the column was expected

x - root-cause exception, if any

Returns:

a new exception with an informative message

Since:

zer0bandwidth-net/android 0.1.6 (#47)

fieldNotAnnotated

public static SchematicException fieldNotAnnotated(java.lang.reflect.Field fld)

Returns an exception to be thrown when a field that was supposed to represent a column isn't properly annotated.

Parameters:

fld - the field

Returns:

a new exception with an informative message

Since:

zer0bandwidth-net/android 0.1.7 (#50)

tableCreationOrUpdateFailed

public static SchematicException tableCreationOrUpdateFailed(SQLightable.Reflection refl,
                                                             java.lang.String sSQL,
                                                             java.lang.Throwable xCause)

Returns an exception to be thrown when an attempt to create or update the SQLite database fails because the SQL statement failed.

Parameters:

refl - a reflection of the schematic class that failed

sSQL - the SQL statement that was executed

xCause - the root cause of the failure, if any (may be null)

Returns:

a new exception with an informative message

Since:

zer0bandwidth-net/android 0.1.7 (#50)

noLensForColumn

public static SchematicException noLensForColumn(SQLightable.Reflection.Column col,
                                                 java.lang.Throwable xCause)

Returns an exception to be thrown when a column operation cannot continue because the column's Refractor implementation cannot be determined.

Parameters:

col - the column on which the operation would be performed

xCause - the cause of the failure, if any (may be null)

Returns:

a new exception with an informative error message

Since:

zer0bandwidth-net/android 0.1.7 (#50)

noLensForField

public static SchematicException noLensForField(java.lang.reflect.Field fld,
                                                java.lang.Throwable xCause)

Returns an exception to be thrown when an operation cannot continue because a field/column's Refractor implementation cannot be determined

Parameters:

fld - the field on which the operation would be performed

xCause - the cause of the failure, if any (may be null)

Returns:

a new exception with an informative error message

Since:

zer0bandwidth-net/android 0.1.7 (#50)

classNotInSchema

public static SchematicException classNotInSchema(java.lang.Class<? extends SQLightable> cls,
                                                  java.util.List<java.lang.Class<? extends SQLightable>> aclsSchema)

Returns an exception to be thrown when a method tries to operate on a schematic class that is not actually part of a defined schema.

Parameters:

cls - the class that is not part of the schema

aclsSchema - the classes that are part of the schema

Returns:

a new exception with an informative error message

Since:

zer0bandwidth-net/android 0.1.7 (#50)