Partager via


IConnection Interface

Définition

Connexion (session) avec une base de données spécifique.

[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
Attributs
Implémente

Remarques

Connexion (session) avec une base de données spécifique. Les instructions SQL sont exécutées et les résultats sont retournés dans le contexte d’une connexion.

La base de données d’un Connection objet peut fournir des informations décrivant ses tables, sa grammaire SQL prise en charge, ses procédures stockées, les fonctionnalités de cette connexion, et ainsi de suite. Ces informations sont obtenues avec la getMetaData méthode.

<B>Remarque :</B> lors de la configuration d’une Connectionapplication JDBC doit utiliser la méthode appropriée Connection telle que setAutoCommit ou setTransactionIsolation. Les applications ne doivent pas appeler directement des commandes SQL pour modifier la configuration de la connexion lorsqu’il existe une méthode JDBC disponible. Par défaut, un Connection objet est en mode de validation automatique, ce qui signifie qu’il valide automatiquement les modifications après l’exécution de chaque instruction. Si le mode de validation automatique a été désactivé, la méthode commit doit être appelée explicitement pour valider les modifications ; sinon, les modifications de base de données ne sont pas enregistrées.

Un nouvel Connection objet créé à l’aide de l’API principale JDBC 2.1 a un mappage de type initialement vide associé. Un utilisateur peut entrer un mappage personnalisé pour un UDT dans ce mappage de type. Lorsqu’un UDT est récupéré à partir d’une source de données avec la méthode ResultSet.getObject, la getObject méthode vérifie la carte de type de la connexion pour voir s’il existe une entrée pour cette UDT. Si c’est le cas, la getObject méthode mappe l’UDT à la classe indiquée. S’il n’y a pas d’entrée, l’UDT est mappé à l’aide du mappage standard.

Un utilisateur peut créer un mappage de type, qui est un java.util.Map objet, y créer une entrée et le transmettre aux java.sql méthodes qui peuvent effectuer un mappage personnalisé. Dans ce cas, la méthode utilise le mappage de type donné au lieu de celui associé à la connexion.

Par exemple, le fragment de code suivant spécifie que le type ATHLETES SQL sera mappé à la classe Athletes dans le langage de programmation Java. Le fragment de code récupère le mappage de type pour l’objet Connection con, insère l’entrée dans celui-ci, puis définit le mappage de types avec la nouvelle entrée comme mappage de type de la connexion.

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

Documentation Java pour java.sql.Connection.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

Champs

TransactionNone

Constante indiquant que les transactions ne sont pas prises en charge.

TransactionReadCommitted

Constante indiquant que les lectures incorrectes sont empêchées ; Des lectures non reproductibles et des lectures fantômes peuvent se produire.

TransactionReadUncommitted

Constante indiquant que des lectures incorrectes, des lectures non reproductibles et des lectures fantômes peuvent se produire.

TransactionRepeatableRead

Constante indiquant que les lectures incorrectes et les lectures non reproductibles sont empêchées ; les lectures fantômes peuvent se produire.

TransactionSerializable

Constante indiquant que les lectures incorrectes, les lectures non reproductibles et les lectures fantômes sont empêchées.

Propriétés

AutoCommit

Retourne un boolean indicateur indiquant si cette connexion est en auto-commit mode d’exploitation ou non.

Catalog

Obtient le nom du catalogue actuel de cet Connection objet.

ClientInfo

Retourne un Properties objet contenant toutes les propriétés d’informations du client.

Handle

Obtient la valeur JNI de l’objet Android sous-jacent.

(Hérité de IJavaObject)
Holdability

Retourne la propriété de conservation que toutes ResultSet les propriétés produites par cette instance auront.

IsClosed

Retourne un boolean indicateur indiquant si cette connexion est dans l’état closed ou non.

JniIdentityHashCode

Retourne la valeur de java.lang.System.identityHashCode() l’instance encapsulée.

(Hérité de IJavaPeerable)
JniManagedPeerState

État de l’homologue managé.

(Hérité de IJavaPeerable)
JniPeerMembers

Prise en charge de l’accès aux membres et de l’appel.

(Hérité de IJavaPeerable)
MetaData

Obtient les métadonnées relatives à la base de données référencée par cette connexion.

PeerReference

Retourne une JniObjectReference instance d’objet Java encapsulée.

(Hérité de IJavaPeerable)
ReadOnly

Retourne un boolean indicateur indiquant si cette connexion est actuellement dans l’état read-only .

TransactionIsolation

Retourne le niveau d’isolation des transactions pour cette connexion.

TypeMap

Retourne le mappage de type associé à cet Connection objet.

Warnings

Obtient la première instance de tous les SQLWarning objets qui ont pu être créés lors de l’utilisation de cette connexion.

Méthodes

ClearWarnings()

Efface tous les avertissements signalés pour cet Connection objet.

Close()

Libère immédiatement la base de données et les ressources JDBC de cet Connection objet au lieu d’attendre qu’elles soient automatiquement libérées.

Commit()

Apporte toutes les modifications apportées depuis la validation/restauration précédente permanente et libère tous les verrous de base de données actuellement détenus par cet Connection objet.

CreateArrayOf(String, Object[])

Méthode de fabrique pour la création d’objets Array.

CreateBlob()

Construit un objet qui implémente l’interface Blob .

CreateClob()

Construit un objet qui implémente l’interface Clob .

CreateNClob()

Construit un objet qui implémente l’interface NClob .

CreateSQLXML()

Construit un objet qui implémente l’interface SQLXML .

CreateStatement()

Crée un Statement objet pour l’envoi d’instructions SQL à la base de données.

CreateStatement(Int32, Int32)

Crée un Statement objet qui génère ResultSet des objets avec le type et la concurrence donnés.

CreateStatement(Int32, Int32, Int32)

Crée un objet qui génère ResultSet des Statement objets avec le type, la concurrence et la conservation donnés.

CreateStruct(String, Object[])

Méthode de fabrique pour la création d’objets struct.

Disposed()

Appelé lorsque l’instance a été supprimée.

(Hérité de IJavaPeerable)
DisposeUnlessReferenced()

S’il n’existe aucune référence en suspens à cette instance, les appels Dispose(); sinon, ne fait rien.

(Hérité de IJavaPeerable)
Finalized()

Appelé lorsque l’instance a été finalisée.

(Hérité de IJavaPeerable)
GetClientInfo(String)

Retourne la valeur de la propriété d’informations client spécifiée par nom.

IsValid(Int32)

Retourne true si la connexion n’a pas été fermée et est toujours valide.

IsWrapperFor(Class)

Retourne true si cela implémente l’argument d’interface ou est directement ou indirectement un wrapper pour un objet qui le fait.

(Hérité de IWrapper)
NativeSQL(String)

Convertit l’instruction SQL donnée en grammaire SQL native du système.

PrepareCall(String)

Crée un CallableStatement objet pour appeler des procédures stockées de base de données.

PrepareCall(String, Int32, Int32)

Crée un CallableStatement objet qui génère ResultSet des objets avec le type et la concurrence donnés.

PrepareCall(String, Int32, Int32, Int32)

Crée un CallableStatement objet qui génère ResultSet des objets avec le type et la concurrence donnés.

PrepareStatement(String)

Crée un PreparedStatement objet pour l’envoi d’instructions SQL paramétrables à la base de données.

PrepareStatement(String, Int32)

Crée un objet par défaut PreparedStatement qui a la possibilité de récupérer des clés générées automatiquement.

PrepareStatement(String, Int32, Int32)

Crée un PreparedStatement objet qui génère ResultSet des objets avec le type et la concurrence donnés.

PrepareStatement(String, Int32, Int32, Int32)

Crée un objet qui génère ResultSet des PreparedStatement objets avec le type, la concurrence et la conservation donnés.

PrepareStatement(String, Int32[])

Crée un objet par défaut PreparedStatement capable de retourner les clés générées automatiquement désignées par le tableau donné.

PrepareStatement(String, String[])

Crée un objet par défaut PreparedStatement capable de retourner les clés générées automatiquement désignées par le tableau donné.

ReleaseSavepoint(ISavepoint)

Supprime les objets spécifiés Savepoint et suivants Savepoint de la transaction actuelle.

Rollback()

Annule toutes les modifications apportées à la transaction actuelle et libère tous les verrous de base de données actuellement détenus par cet Connection objet.

Rollback(ISavepoint)

Annule toutes les modifications apportées après la définition de l’objet donné Savepoint .

SetClientInfo(String, String)

Définit la valeur de la propriété d’informations cliente spécifiée par nom sur la valeur spécifiée par valeur.

SetJniIdentityHashCode(Int32)

Définissez la valeur retournée par JniIdentityHashCode.

(Hérité de IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)

Connexion (session) avec une base de données spécifique.

(Hérité de IJavaPeerable)
SetPeerReference(JniObjectReference)

Définissez la valeur retournée par PeerReference.

(Hérité de IJavaPeerable)
SetSavepoint()

Crée un point d’enregistrement sans nom dans la transaction actuelle et retourne le nouvel Savepoint objet qui le représente.

SetSavepoint(String)

Crée un point d’enregistrement avec le nom donné dans la transaction actuelle et retourne le nouvel Savepoint objet qui le représente.

UnregisterFromRuntime()

Annulez l’inscription de cette instance afin que le runtime ne le retourne pas à partir d’appels futurs Java.Interop.JniRuntime+JniValueManager.PeekValue .

(Hérité de IJavaPeerable)
Unwrap(Class)

Retourne un objet qui implémente l’interface donnée pour autoriser l’accès aux méthodes non standard ou aux méthodes standard non exposées par le proxy.

(Hérité de IWrapper)

Méthodes d’extension

JavaCast<TResult>(IJavaObject)

Effectue une conversion de type vérifiée par le runtime Android.

JavaCast<TResult>(IJavaObject)

Connexion (session) avec une base de données spécifique.

GetJniTypeName(IJavaPeerable)

Connexion (session) avec une base de données spécifique.

S’applique à