-
Notifications
You must be signed in to change notification settings - Fork 0
/
IDataSource.xml
167 lines (167 loc) · 10.8 KB
/
IDataSource.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
<Type Name="IDataSource" FullName="Javax.Sql.IDataSource">
<TypeSignature Language="C#" Value="public interface IDataSource : IDisposable, Java.Interop.IJavaPeerable, Java.Sql.IWrapper, Javax.Sql.ICommonDataSource" />
<TypeSignature Language="ILAsm" Value=".class public interface auto ansi abstract beforefieldinit IDataSource implements class Android.Runtime.IJavaObject, class Java.Interop.IJavaPeerable, class Java.Sql.IWrapper, class Javax.Sql.ICommonDataSource, class System.IDisposable" />
<TypeSignature Language="DocId" Value="T:Javax.Sql.IDataSource" />
<TypeSignature Language="F#" Value="type IDataSource = interface
 interface IWrapper
 interface IJavaObject
 interface IDisposable
 interface IJavaPeerable
 interface ICommonDataSource" />
<AssemblyInfo>
<AssemblyName>Mono.Android</AssemblyName>
<AssemblyVersion>0.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Interfaces>
<Interface>
<InterfaceName>Android.Runtime.IJavaObject</InterfaceName>
</Interface>
<Interface>
<InterfaceName>Java.Interop.IJavaPeerable</InterfaceName>
</Interface>
<Interface>
<InterfaceName>Java.Sql.IWrapper</InterfaceName>
</Interface>
<Interface>
<InterfaceName>Javax.Sql.ICommonDataSource</InterfaceName>
</Interface>
<Interface>
<InterfaceName>System.IDisposable</InterfaceName>
</Interface>
</Interfaces>
<Attributes>
<Attribute>
<AttributeName Language="C#">[Android.Runtime.Register("javax/sql/DataSource", "", "Javax.Sql.IDataSourceInvoker")]</AttributeName>
<AttributeName Language="F#">[<Android.Runtime.Register("javax/sql/DataSource", "", "Javax.Sql.IDataSourceInvoker")>]</AttributeName>
</Attribute>
</Attributes>
<Docs since="1">
<summary>A factory for connections to the physical data source that this
<c>DataSource</c> object represents.</summary>
<remarks>
<para>A factory for connections to the physical data source that this
<c>DataSource</c> object represents. An alternative to the
<c>DriverManager</c> facility, a <c>DataSource</c> object
is the preferred means of getting a connection. An object that implements
the <c>DataSource</c> interface will typically be
registered with a naming service based on the
Java<sup><font size=-2>TM</font></sup> Naming and Directory (JNDI) API.</para>
<para>The <c>DataSource</c> interface is implemented by a driver vendor.
There are three types of implementations:
<OL>
<LI>Basic implementation -- produces a standard <c>Connection</c>
object
<LI>Connection pooling implementation -- produces a <c>Connection</c>
object that will automatically participate in connection pooling. This
implementation works with a middle-tier connection pooling manager.
<LI>Distributed transaction implementation -- produces a
<c>Connection</c> object that may be used for distributed
transactions and almost always participates in connection pooling.
This implementation works with a middle-tier
transaction manager and almost always with a connection
pooling manager.
</OL></para>
<para>A <c>DataSource</c> object has properties that can be modified
when necessary. For example, if the data source is moved to a different
server, the property for the server can be changed. The benefit is that
because the data source's properties can be changed, any code accessing
that data source does not need to be changed.</para>
<para>A driver that is accessed via a <c>DataSource</c> object does not
register itself with the <c>DriverManager</c>. Rather, a
<c>DataSource</c> object is retrieved though a lookup operation
and then used to create a <c>Connection</c> object. With a basic
implementation, the connection obtained through a <c>DataSource</c>
object is identical to a connection obtained through the
<c>DriverManager</c> facility.</para>
<para>Added in 1.4.</para>
<para>
<format type="text/html">
<a href="https://developer.android.com/reference/javax/sql/DataSource" title="Reference documentation">Java documentation for <code>javax.sql.DataSource</code>.</a>
</format>
</para>
<para>
Portions of this page are modifications based on work created and shared by the
<format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
and used according to terms described in the
<format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
<since version="Added in API level 1" />
</Docs>
<Members>
<Member MemberName="Connection">
<MemberSignature Language="C#" Value="public Java.Sql.IConnection? Connection { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class Java.Sql.IConnection Connection" />
<MemberSignature Language="DocId" Value="P:Javax.Sql.IDataSource.Connection" />
<MemberSignature Language="F#" Value="member this.Connection : Java.Sql.IConnection" Usage="Javax.Sql.IDataSource.Connection" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyName>Mono.Android</AssemblyName>
<AssemblyVersion>0.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName Language="C#">[get: Android.Runtime.Register("getConnection", "()Ljava/sql/Connection;", "GetGetConnectionHandler:Javax.Sql.IDataSourceInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]</AttributeName>
<AttributeName Language="F#">[<get: Android.Runtime.Register("getConnection", "()Ljava/sql/Connection;", "GetGetConnectionHandler:Javax.Sql.IDataSourceInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>Java.Sql.IConnection</ReturnType>
</ReturnValue>
<Docs>
<summary>Creates a connection to the database represented by this <c>DataSource</c>.</summary>
<value>To be added.</value>
<remarks>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
<since version="Added in API level 1" />
<exception cref="T:Java.Sql.SQLException">if there is a problem accessing the database.
</exception>
</Docs>
</Member>
<Member MemberName="GetConnection">
<MemberSignature Language="C#" Value="public Java.Sql.IConnection? GetConnection (string? username, string? password);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class Java.Sql.IConnection GetConnection(string username, string password) cil managed" />
<MemberSignature Language="DocId" Value="M:Javax.Sql.IDataSource.GetConnection(System.String,System.String)" />
<MemberSignature Language="F#" Value="abstract member GetConnection : string * string -> Java.Sql.IConnection" Usage="iDataSource.GetConnection (username, password)" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Mono.Android</AssemblyName>
<AssemblyVersion>0.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName Language="C#">[Android.Runtime.Register("getConnection", "(Ljava/lang/String;Ljava/lang/String;)Ljava/sql/Connection;", "GetGetConnection_Ljava_lang_String_Ljava_lang_String_Handler:Javax.Sql.IDataSourceInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]</AttributeName>
<AttributeName Language="F#">[<Android.Runtime.Register("getConnection", "(Ljava/lang/String;Ljava/lang/String;)Ljava/sql/Connection;", "GetGetConnection_Ljava_lang_String_Ljava_lang_String_Handler:Javax.Sql.IDataSourceInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>Java.Sql.IConnection</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="username" Type="System.String" />
<Parameter Name="password" Type="System.String" />
</Parameters>
<Docs>
<param name="username">the database user on whose behalf the connection is
being made</param>
<param name="password">the user's password</param>
<summary>Attempts to establish a connection with the data source that
this <c>DataSource</c> object represents.</summary>
<returns>a connection to the data source</returns>
<remarks>
<para>Attempts to establish a connection with the data source that
this <c>DataSource</c> object represents.</para>
<para>Added in 1.4.</para>
<para>
<format type="text/html">
<a href="https://developer.android.com/reference/javax/sql/DataSource#getConnection(java.lang.String,%20java.lang.String)" title="Reference documentation">Java documentation for <code>javax.sql.DataSource.getConnection(java.lang.String, java.lang.String)</code>.</a>
</format>
</para>
<para>
Portions of this page are modifications based on work created and shared by the
<format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
and used according to terms described in the
<format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
<since version="Added in API level 1" />
<exception cref="T:Java.Sql.SQLException">if there is a problem accessing the database.
</exception>
</Docs>
</Member>
</Members>
</Type>