IDataSource Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Eine Factory für Verbindungen mit der physischen Datenquelle, die dieses DataSource Objekt darstellt.
[Android.Runtime.Register("javax/sql/DataSource", "", "Javax.Sql.IDataSourceInvoker")]
public interface IDataSource : IDisposable, Java.Interop.IJavaPeerable, Java.Sql.IWrapper, Javax.Sql.ICommonDataSource
[<Android.Runtime.Register("javax/sql/DataSource", "", "Javax.Sql.IDataSourceInvoker")>]
type IDataSource = interface
interface IWrapper
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface ICommonDataSource
- Attribute
- Implementiert
Hinweise
Eine Factory für Verbindungen mit der physischen Datenquelle, die dieses DataSource Objekt darstellt. Eine Alternative zur DriverManager Einrichtung ist ein DataSource Objekt die bevorzugte Methode zum Abrufen einer Verbindung. Ein Objekt, das die Schnittstelle implementiert, wird in der DataSource Regel mit einem Benennungsdienst basierend auf der Java< sup><font size=-2>TM</font></sup> Naming and Directory (JNDI)-API registriert.
Die DataSource Schnittstelle wird von einem Treiberanbieter implementiert. Es gibt drei Arten von Implementierungen: <OL><LI>Basic-Implementierung - erzeugt eine Implementierung des Standardobjekts Connection<LI-Verbindungspooling>- erzeugt ein Connection Objekt, das automatisch an der Verbindungspoolung beteiligt wird. Diese Implementierung funktioniert mit einem Verbindungspool-Manager auf mittlerer Ebene.
<LI>Distributed Transaction Implementation - erzeugt ein Connection Objekt, das für verteilte Transaktionen verwendet werden kann und fast immer an der Verbindungspooling beteiligt ist. Diese Implementierung funktioniert mit einem Transaktions-Manager auf mittlerer Ebene und fast immer mit einem Verbindungspooling-Manager.
</OL>
Ein DataSource Objekt verfügt über Eigenschaften, die bei Bedarf geändert werden können. Wenn die Datenquelle beispielsweise auf einen anderen Server verschoben wird, kann die Eigenschaft für den Server geändert werden. Der Vorteil besteht darin, dass der Code, der auf diese Datenquelle zugreift, nicht geändert werden muss, da die Eigenschaften der Datenquelle geändert werden können.
Ein Treiber, auf den über ein DataSource Objekt zugegriffen wird, registriert sich nicht bei der DriverManager. Stattdessen wird ein DataSource Objekt durch einen Nachschlagevorgang abgerufen und dann zum Erstellen eines Connection Objekts verwendet. Mit einer grundlegenden Implementierung ist die durch ein DataSource Objekt erhaltene Verbindung mit einer Verbindung identisch, die über die DriverManager Anlage abgerufen wird.
In 1.4 hinzugefügt.
Java Dokumentation für javax.sql.DataSource.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Eigenschaften
| Name | Beschreibung |
|---|---|
| Connection |
Erstellt eine Verbindung mit der Datenbank, die durch diese |
| Handle |
Ruft den JNI-Wert des zugrunde liegenden Android-Objekts ab. (Geerbt von IJavaObject) |
| JniIdentityHashCode |
Gibt den Wert |
| JniManagedPeerState |
Status des verwalteten Peers. (Geerbt von IJavaPeerable) |
| JniPeerMembers |
Mitgliedszugriff und Aufrufunterstützung. (Geerbt von IJavaPeerable) |
| LoginTimeout |
Beim Versuch, eine Verbindung mit einer Datenbank herzustellen, ruft diese Methode die maximale Zeit in Sekunden ab, die diese Datenquelle warten kann. (Geerbt von ICommonDataSource) |
| LogWriter |
Ruft einen Protokollschreiber ab, der ein Zeichenausgabedatenstrom ist, in den alle Protokollierungs- und Ablaufverfolgungsmeldungen für diese Datenquelle gedruckt werden. (Geerbt von ICommonDataSource) |
| ParentLogger |
Ruft den übergeordneten Logger für alle Logger ab, die von dieser Datenquelle verwendet werden. (Geerbt von ICommonDataSource) |
| PeerReference |
Gibt eine JniObjectReference der umbrochenen Java Objektinstanz zurück. (Geerbt von IJavaPeerable) |
Methoden
| Name | Beschreibung |
|---|---|
| Disposed() |
Wird aufgerufen, wenn die Instanz verworfen wurde. (Geerbt von IJavaPeerable) |
| DisposeUnlessReferenced() |
Wenn keine offenen Verweise auf diese Instanz vorhanden sind, wird nichts aufgerufen |
| Finalized() |
Wird aufgerufen, wenn die Instanz abgeschlossen wurde. (Geerbt von IJavaPeerable) |
| GetConnection(String, String) |
Versucht, eine Verbindung mit der Datenquelle herzustellen, die dieses |
| IsWrapperFor(Class) |
Gibt true zurück, wenn dies entweder das Schnittstellenargument implementiert oder direkt oder indirekt ein Wrapper für ein Objekt ist, das ausgeführt wird. (Geerbt von IWrapper) |
| SetJniIdentityHashCode(Int32) |
Legen Sie den von |
| SetJniManagedPeerState(JniManagedPeerStates) |
Eine Factory für Verbindungen mit der physischen Datenquelle, die dieses |
| SetPeerReference(JniObjectReference) |
Legen Sie den von |
| UnregisterFromRuntime() |
Heben Sie die Registrierung dieser Instanz auf, damit die Laufzeit sie nicht aus zukünftigen Java.Interop.JniRuntime+JniValueManager.PeekValue Aufrufen zurückgibt. (Geerbt von IJavaPeerable) |
| Unwrap(Class) |
Gibt ein Objekt zurück, das die angegebene Schnittstelle implementiert, um den Zugriff auf nicht standardmäßige Methoden oder Standardmethoden zu ermöglichen, die vom Proxy nicht verfügbar gemacht werden. (Geerbt von IWrapper) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ruft den JNI-Namen des Typs der Instanz |
| JavaAs<TResult>(IJavaPeerable) |
Versuchen Sie, die Eingabe |
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
Eine Factory für Verbindungen mit der physischen Datenquelle, die dieses |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Versuchen Sie, die Eingabe |