IConnection Interfaz

Definición

Una conexión (sesión) con una base de datos específica.

[Android.Runtime.Register("java/sql/Connection", "", "Java.Sql.IConnectionInvoker")]
public interface IConnection : IDisposable, Java.Interop.IJavaPeerable, Java.Sql.IWrapper
[<Android.Runtime.Register("java/sql/Connection", "", "Java.Sql.IConnectionInvoker")>]
type IConnection = interface
    interface IWrapper
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
Atributos
Implementaciones

Comentarios

Una conexión (sesión) con una base de datos específica. Las instrucciones SQL se ejecutan y los resultados se devuelven en el contexto de una conexión.

La base de datos de un Connection objeto puede proporcionar información que describa sus tablas, su gramática SQL admitida, sus procedimientos almacenados, las funcionalidades de esta conexión, etc. Esta información se obtiene con el getMetaData método .

<B>Nota:</B> Al configurar una Connection, las aplicaciones JDBC deben usar el método adecuado Connection , como setAutoCommit o setTransactionIsolation. Las aplicaciones no deben invocar comandos SQL directamente para cambiar la configuración de la conexión cuando hay un método JDBC disponible. De forma predeterminada, un Connection objeto está en modo de confirmación automática, lo que significa que confirma automáticamente los cambios después de ejecutar cada instrucción. Si se ha deshabilitado el modo de confirmación automática, se debe llamar al método commit explícitamente para confirmar los cambios; de lo contrario, no se guardarán los cambios de la base de datos.

Un nuevo Connection objeto creado mediante la API principal de JDBC 2.1 tiene un mapa de tipos inicialmente vacío asociado. Un usuario puede escribir una asignación personalizada para un UDT en este mapa de tipos. Cuando se recupera un UDT de un origen de datos con el método , el getObject método ResultSet.getObjectcomprobará la asignación de tipos de la conexión para ver si hay una entrada para ese UDT. Si es así, el getObject método asignará el UDT a la clase indicada. Si no hay ninguna entrada, el UDT se asignará mediante la asignación estándar.

Un usuario puede crear una nueva asignación de tipos, que es un java.util.Map objeto, crear una entrada en él y pasarla a los java.sql métodos que pueden realizar una asignación personalizada. En este caso, el método usará el mapa de tipos especificado en lugar del asociado a la conexión.

Por ejemplo, el siguiente fragmento de código especifica que el tipo ATHLETES SQL se asignará a la clase Athletes en el lenguaje de programación Java. El fragmento de código recupera el mapa de tipos para el Connection objeto con, inserta la entrada en él y, a continuación, establece el mapa de tipos con la nueva entrada como mapa de tipos de la conexión.

java.util.Map map = con.getTypeMap();
                 map.put("mySchemaName.ATHLETES", Class.forName("Athletes"));
                 con.setTypeMap(map);

Documentación de Java para java.sql.Connection.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código y se usan según los términos descritos en la creative Commons 2.5.

Campos

TransactionNone

Constante que indica que no se admiten transacciones.

TransactionReadCommitted

Constante que indica que se impiden las lecturas desfasadas; Se pueden producir lecturas no repetibles y lecturas fantasma.

TransactionReadUncommitted

Constante que indica que se pueden producir lecturas sucias, lecturas no repetibles y lecturas fantasma.

TransactionRepeatableRead

Constante que indica que se impiden lecturas sucias y lecturas no repetibles; Se pueden producir lecturas fantasma.

TransactionSerializable

Constante que indica que se impiden las lecturas sucias, las lecturas no repetibles y las lecturas fantasma.

Propiedades

AutoCommit

Devuelve un boolean valor de tipo que indica si esta conexión está en modo auto-commit operativo o no.

Catalog

Obtiene el nombre del catálogo actual de este Connection objeto.

ClientInfo

Devuelve un Properties objeto que contiene todas las propiedades de información de cliente.

Handle

Obtiene el valor JNI del objeto Android subyacente.

(Heredado de IJavaObject)
Holdability

Devuelve la propiedad de capacidad de suspensión que tendrá cualquier ResultSet generado por esta instancia.

IsClosed

Devuelve un boolean valor de tipo que indica si esta conexión está o no en el closed estado .

JniIdentityHashCode

Devuelve el valor de java.lang.System.identityHashCode() para la instancia ajustada.

(Heredado de IJavaPeerable)
JniManagedPeerState

Estado del mismo nivel administrado.

(Heredado de IJavaPeerable)
JniPeerMembers

Compatibilidad con la invocación y el acceso a miembros.

(Heredado de IJavaPeerable)
MetaData

Obtiene los metadatos sobre la base de datos a la que hace referencia esta conexión.

PeerReference

Devuelve una JniObjectReference de la instancia de objeto java ajustada.

(Heredado de IJavaPeerable)
ReadOnly

Devuelve un boolean valor de tipo que indica si esta conexión está o no en el read-only estado.

TransactionIsolation

Devuelve el nivel de aislamiento de transacción para esta conexión.

TypeMap

Devuelve la asignación de tipos asociada a este Connection objeto.

Warnings

Obtiene la primera instancia de los SQLWarning objetos que se pueden haber creado en el uso de esta conexión.

Métodos

ClearWarnings()

Borra todas las advertencias notificadas para este Connection objeto.

Close()

Libera inmediatamente la base de datos de este Connection objeto y los recursos JDBC en lugar de esperar a que se liberen automáticamente.

Commit()

Realiza todos los cambios realizados desde la confirmación o reversión anterior permanente y libera los bloqueos de base de datos que este objeto mantiene Connection actualmente.

CreateArrayOf(String, Object[])

Método factory para crear objetos Array.

CreateBlob()

Construye un objeto que implementa la Blob interfaz .

CreateClob()

Construye un objeto que implementa la Clob interfaz .

CreateNClob()

Construye un objeto que implementa la NClob interfaz .

CreateSQLXML()

Construye un objeto que implementa la SQLXML interfaz .

CreateStatement()

Crea un Statement objeto para enviar instrucciones SQL a la base de datos.

CreateStatement(Int32, Int32)

Crea un Statement objeto que generará ResultSet objetos con el tipo y la simultaneidad especificados.

CreateStatement(Int32, Int32, Int32)

Crea un Statement objeto que generará ResultSet objetos con el tipo, la simultaneidad y la capacidad de retención especificados.

CreateStruct(String, Object[])

Método factory para crear objetos Struct.

Disposed()

Se llama cuando se ha eliminado la instancia.

(Heredado de IJavaPeerable)
DisposeUnlessReferenced()

Si no hay referencias pendientes a esta instancia, llama a Dispose(); de lo contrario, no hace nada.

(Heredado de IJavaPeerable)
Finalized()

Se llama cuando se ha finalizado la instancia.

(Heredado de IJavaPeerable)
GetClientInfo(String)

Devuelve el valor de la propiedad de información de cliente especificada por nombre.

IsValid(Int32)

Devuelve true si la conexión no se ha cerrado y sigue siendo válida.

IsWrapperFor(Class)

Devuelve true si esto implementa el argumento de interfaz o es directa o indirectamente un contenedor para un objeto que sí lo hace.

(Heredado de IWrapper)
NativeSQL(String)

Convierte la instrucción SQL dada en la gramática SQL nativa del sistema.

PrepareCall(String)

Crea un CallableStatement objeto para llamar a procedimientos almacenados de base de datos.

PrepareCall(String, Int32, Int32)

Crea un CallableStatement objeto que generará ResultSet objetos con el tipo y la simultaneidad especificados.

PrepareCall(String, Int32, Int32, Int32)

Crea un CallableStatement objeto que generará ResultSet objetos con el tipo y la simultaneidad especificados.

PrepareStatement(String)

Crea un PreparedStatement objeto para enviar instrucciones SQL con parámetros a la base de datos.

PrepareStatement(String, Int32)

Crea un objeto predeterminado PreparedStatement que tiene la capacidad de recuperar claves generadas automáticamente.

PrepareStatement(String, Int32, Int32)

Crea un PreparedStatement objeto que generará ResultSet objetos con el tipo y la simultaneidad especificados.

PrepareStatement(String, Int32, Int32, Int32)

Crea un PreparedStatement objeto que generará ResultSet objetos con el tipo, la simultaneidad y la capacidad de retención especificados.

PrepareStatement(String, Int32[])

Crea un objeto predeterminado PreparedStatement capaz de devolver las claves generadas automáticamente designadas por la matriz especificada.

PrepareStatement(String, String[])

Crea un objeto predeterminado PreparedStatement capaz de devolver las claves generadas automáticamente designadas por la matriz especificada.

ReleaseSavepoint(ISavepoint)

Quita los objetos especificados Savepoint y posteriores Savepoint de la transacción actual.

Rollback()

Deshace todos los cambios realizados en la transacción actual y libera los bloqueos de base de datos mantenidos actualmente por este Connection objeto.

Rollback(ISavepoint)

Deshace todos los cambios realizados después de establecer el objeto especificado Savepoint .

SetClientInfo(String, String)

Establece el valor de la propiedad de información de cliente especificada por nombre en el valor especificado por value.

SetJniIdentityHashCode(Int32)

Establezca el valor devuelto por JniIdentityHashCode.

(Heredado de IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)

Una conexión (sesión) con una base de datos específica.

(Heredado de IJavaPeerable)
SetPeerReference(JniObjectReference)

Establezca el valor devuelto por PeerReference.

(Heredado de IJavaPeerable)
SetSavepoint()

Crea un punto de retorno sin nombre en la transacción actual y devuelve el nuevo Savepoint objeto que lo representa.

SetSavepoint(String)

Crea un punto de retorno con el nombre especificado en la transacción actual y devuelve el nuevo Savepoint objeto que lo representa.

UnregisterFromRuntime()

Anule el registro de esta instancia para que el entorno de ejecución no lo devuelva de Java.Interop.JniRuntime+JniValueManager.PeekValue futuras invocaciones.

(Heredado de IJavaPeerable)
Unwrap(Class)

Devuelve un objeto que implementa la interfaz especificada para permitir el acceso a métodos no estándar o métodos estándar no expuestos por el proxy.

(Heredado de IWrapper)

Métodos de extensión

JavaCast<TResult>(IJavaObject)

Realiza una conversión de tipos comprobados en tiempo de ejecución de Android.

JavaCast<TResult>(IJavaObject)

Una conexión (sesión) con una base de datos específica.

GetJniTypeName(IJavaPeerable)

Una conexión (sesión) con una base de datos específica.

Se aplica a