From 192119f591f13f968eb9c3ce0a0665e0e59ab6ff Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Mon, 17 Aug 2026 08:33:19 -0500 Subject: [PATCH 1/5] Document JDBC connection properties Refs #189 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- docs/xml/Java.Sql/IConnection.xml | 70 ++++++++++++++++++++++++++----- 1 file changed, 60 insertions(+), 10 deletions(-) diff --git a/docs/xml/Java.Sql/IConnection.xml b/docs/xml/Java.Sql/IConnection.xml index 4ec1959d0..8ecd02e15 100644 --- a/docs/xml/Java.Sql/IConnection.xml +++ b/docs/xml/Java.Sql/IConnection.xml @@ -111,8 +111,13 @@ Returns a boolean indicating whether or not this connection is in the auto-commit operating mode. - To be added. + The current state of this Connection object's auto-commit mode. + + + Android reference for java.sql.Connection.getAutoCommit(). + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -145,8 +150,13 @@ Gets this Connection object's current catalog name. - To be added. + The current catalog name, or null if there is none. + + + Android reference for java.sql.Connection.getCatalog(). + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -222,8 +232,13 @@ Returns a object containing all client info properties. - To be added. + A Properties object containing the name and current value of each client info property supported by the driver. + + + Android reference for java.sql.Connection.getClientInfo(). + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -904,8 +919,13 @@ Returns the holdability property that any ResultSet produced by this instance will have. - To be added. + The holdability, one of ResultSet.HOLD_CURSORS_OVER_COMMIT or ResultSet.CLOSE_CURSORS_AT_COMMIT. + + + Android reference for java.sql.Connection.getHoldability(). + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -937,8 +957,13 @@ Returns a boolean indicating whether or not this connection is in the closed state. - To be added. + true if this Connection object is closed; false if it is still open. + + + Android reference for java.sql.Connection.isClosed(). + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -1023,8 +1048,13 @@ Gets the metadata about the database referenced by this connection. - To be added. + A DatabaseMetaData object for this Connection object. + + + Android reference for java.sql.Connection.getMetaData(). + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -1743,8 +1773,13 @@ Returns a boolean indicating whether or not this connection is currently in the read-only state. - To be added. + true if this Connection object is read-only; otherwise, false. + + + Android reference for java.sql.Connection.isReadOnly(). + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -2099,8 +2134,13 @@ Returns the transaction isolation level for this connection. - To be added. + The current transaction isolation level, which will be one of the following constants: Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ, Connection.TRANSACTION_SERIALIZABLE, or Connection.TRANSACTION_NONE. + + + Android reference for java.sql.Connection.getTransactionIsolation(). + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -2358,8 +2398,13 @@ Returns the type mapping associated with this Connection object. - To be added. + The java.util.Map object associated with this Connection object. + + + Android reference for java.sql.Connection.getTypeMap(). + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -2389,8 +2434,13 @@ Gets the first instance of any SQLWarning objects that may have been created in the use of this connection. - To be added. + The first SQLWarning object or null if there are none. + + + Android reference for java.sql.Connection.getWarnings(). + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. From 910fc743b3faa00a1960a3735f85f63c68bdee91 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Mon, 17 Aug 2026 20:16:40 -0500 Subject: [PATCH 2/5] Correct JDBC property constant references Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: f7bb4d04-d38f-491b-bca9-805acbe0ccf3 --- docs/xml/Java.Sql/IConnection.xml | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/docs/xml/Java.Sql/IConnection.xml b/docs/xml/Java.Sql/IConnection.xml index 8ecd02e15..756a92bb6 100644 --- a/docs/xml/Java.Sql/IConnection.xml +++ b/docs/xml/Java.Sql/IConnection.xml @@ -919,7 +919,7 @@ Returns the holdability property that any ResultSet produced by this instance will have. - The holdability, one of ResultSet.HOLD_CURSORS_OVER_COMMIT or ResultSet.CLOSE_CURSORS_AT_COMMIT. + The holdability, one of or . @@ -2134,7 +2134,7 @@ Returns the transaction isolation level for this connection. - The current transaction isolation level, which will be one of the following constants: Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ, Connection.TRANSACTION_SERIALIZABLE, or Connection.TRANSACTION_NONE. + When getting this property, the current transaction isolation level: , , , , or . When setting this property, one of the same values except . @@ -2150,9 +2150,7 @@ - if there is a problem with the database or if the value of - level is not one of the expected constant values. - + if there is a problem with the database or if this property is set to a value other than , , , or . From dabfc952acd7fa0122c2dc2a809fa5e8a93ae110 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Tue, 18 Aug 2026 08:04:21 -0500 Subject: [PATCH 3/5] Use managed JDBC type references Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: f7bb4d04-d38f-491b-bca9-805acbe0ccf3 --- docs/xml/Java.Sql/IConnection.xml | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/xml/Java.Sql/IConnection.xml b/docs/xml/Java.Sql/IConnection.xml index 756a92bb6..8f5999876 100644 --- a/docs/xml/Java.Sql/IConnection.xml +++ b/docs/xml/Java.Sql/IConnection.xml @@ -2145,11 +2145,11 @@ if there is a problem accessing the database. - - - - - + + + + + if there is a problem with the database or if this property is set to a value other than , , , or . @@ -2396,7 +2396,7 @@ Returns the type mapping associated with this Connection object. - The java.util.Map object associated with this Connection object. + The IDictionary<string, Java.Lang.Class> object associated with this Connection object. From ba1565d3b977baa78076e906d3028af83957e6d6 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Tue, 18 Aug 2026 09:23:06 -0500 Subject: [PATCH 4/5] Clarify JDBC type map updates Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: f7bb4d04-d38f-491b-bca9-805acbe0ccf3 --- docs/xml/Java.Sql/IConnection.xml | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/xml/Java.Sql/IConnection.xml b/docs/xml/Java.Sql/IConnection.xml index 8f5999876..9bb67b203 100644 --- a/docs/xml/Java.Sql/IConnection.xml +++ b/docs/xml/Java.Sql/IConnection.xml @@ -2396,13 +2396,19 @@ Returns the type mapping associated with this Connection object. - The IDictionary<string, Java.Lang.Class> object associated with this Connection object. + The current IDictionary<string, Java.Lang.Class> type map. + After modifying the dictionary returned by this property, assign it back to this property because a JDBC driver may keep an internal copy of the type map. Android reference for java.sql.Connection.getTypeMap(). + + + Android reference for java.sql.Connection.setTypeMap(java.util.Map). + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. From f7e5efd6350bba2f35f1f38bd52666c0b9d05fb7 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Tue, 18 Aug 2026 11:45:58 -0500 Subject: [PATCH 5/5] Reference managed database metadata Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: f7bb4d04-d38f-491b-bca9-805acbe0ccf3 --- docs/xml/Java.Sql/IConnection.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/xml/Java.Sql/IConnection.xml b/docs/xml/Java.Sql/IConnection.xml index 9bb67b203..759f49983 100644 --- a/docs/xml/Java.Sql/IConnection.xml +++ b/docs/xml/Java.Sql/IConnection.xml @@ -1048,7 +1048,7 @@ Gets the metadata about the database referenced by this connection. - A DatabaseMetaData object for this Connection object. + An object for this Connection object.