From a2bd5c5563261309cb14a7f233d9fc89a2873c8a Mon Sep 17 00:00:00 2001 From: Daniel Theophanes Date: Wed, 23 Nov 2016 15:51:45 -0800 Subject: [PATCH] doc: add database/sql and os changes to go1.8 release notes Change-Id: Ib936539946f43556a7dd501f8127054f6a27861f Reviewed-on: https://go-review.googlesource.com/33553 Reviewed-by: Brad Fitzpatrick --- doc/go1.8.html | 69 ++++++++++++++++++++++++++++++++++++++++++++++++++ doc/go1.8.txt | 19 +++++++------- 2 files changed, 78 insertions(+), 10 deletions(-) diff --git a/doc/go1.8.html b/doc/go1.8.html index 90878a0a31..9080840fc2 100644 --- a/doc/go1.8.html +++ b/doc/go1.8.html @@ -422,6 +422,65 @@ in mind. +
database/sql
+
+

+ The package now supports context.Context. There are new methods + ending in Context such as + DB.QueryContext and + DB.PrepareContext + that support Context. By using the new Context methods it ensures + connections are closed and returned to the connection pool when the + request is done. It also enables canceling in-progress queries + should the driver support it. Finally, using the Context + methods allows the database pool to cancel waiting for the next + available connection. +

+

+ The IsolationLevel + can now be set when starting a transaction by setting the isolation level + on the Context then passing that Context to + DB.BeginContext. + An error will be returned if an isolation level is selected that the driver + does not support. A read-only attribute may also be set on the transaction + with ReadOnlyContext +

+

+ Queries now expose the SQL column type information for drivers that support it. + Rows can return ColumnTypes + which can include SQL type information, column type lengths, and the Go type. +

+

+ Multiple result sets are now supported on Rows. After + Rows.Next returns false + Rows.NextResultSet + may be called to advance to the next result set. The existing Rows + should be continued to be used after it advances to the next result set. +

+

+ NamedParam may be used + as query arguments. The new function Param + helps create a NamedParam + more succinctly. +

+ Drivers that support the new Pinger + interface can now check if the server is still alive when the the + DB.Ping + or DB.PingContext + is called. +

+

+ The new Context query methods work for all drivers, but + Context cancelation is not responsive unless the driver has been + updated to used them. The other features require driver support in + database/sql/driver. + Driver authors should review the new interfaces. Users of existing + driver should review the driver documentation to see what + it supports and any system specific documentation on each feature. +

+
+
+
debug/pe

@@ -749,6 +808,16 @@ pkg debug/pe, type StringTable []uint8

+
os
+
+

+ The new function + Executable returns + the running executable path name. +

+
+
+
reflect

diff --git a/doc/go1.8.txt b/doc/go1.8.txt index 0c9f6ce249..5d2f6b5aa7 100644 --- a/doc/go1.8.txt +++ b/doc/go1.8.txt @@ -125,15 +125,6 @@ crypto/x509: return error for missing SerialNumber (CL 27238) crypto/x509: support PSS signatures (CL 24743) crypto/x509: support RHEL 7 cert bundle (CL 30375) -database/sql: accept nil pointers to Valuers implemented on value receivers (CL 31259) -database/sql: add Pinger interface to driver Conn (CL 32136) -database/sql: add context helper methods and transaction types (CL 31258) -database/sql: add context methods (CL 29381) -database/sql: add option to use named parameter in query arguments (CL 30166) -database/sql: add support for multiple result sets (CL 30592) -database/sql: don't hang if the driver Exec method panics (CL 23576) -database/sql: support returning query database types (CL 29961) - encoding/asn1: return error for unexported fields in Marshal, Unmarshal (CL 31540) encoding/xml: add wildcard support for collecting all attributes (CL 30946) @@ -190,7 +181,6 @@ net: use libresolv rules for ndots range and validation (CL 24901) os, syscall: fix incorrect offset calculation in Readlink on windows (CL 31118) os: add ErrClosed, return for use of closed File (CL 30614) -os: add Executable() (CL 16551) os: consider only files from #M as regular on Plan 9 (CL 32152) os: don't let File.Readdir return an empty slice and nil error (CL 28056) os: make IsExist report true on ERROR_DIR_NOT_EMPTY on Windows (CL 29753) @@ -412,6 +402,14 @@ compress/flate: make compression level 0 consistent (CL 31174) compress/flate: tighten the BestSpeed max match offset bound. (CL 32149) compress/gzip: only encode MTIME if it is valid (CL 32325) context: make DeadlineExceeded implement net.Error (CL 30370) +database/sql: accept nil pointers to Valuers implemented on value receivers (CL 31259) +database/sql: add Pinger interface to driver Conn (CL 32136) +database/sql: add context helper methods and transaction types (CL 31258) +database/sql: add context methods (CL 29381) +database/sql: add option to use named parameter in query arguments (CL 30166) +database/sql: add support for multiple result sets (CL 30592) +database/sql: don't hang if the driver Exec method panics (CL 23576) +database/sql: support returning query database types (CL 29961) debug/pe: revert CL 22720 (CL 27212) encoding/base64: add Encoding.Strict (CL 24964) encoding/binary: add bool support (CL 28514) @@ -471,6 +469,7 @@ net: always wake up the readers on close on Plan 9 (CL 31390) net: close the connection gracefully on Plan 9 (CL 31271) net: implement network interface API for Plan 9 (CL 29963) net: make lookupPort case-insensitive on Plan 9 (CL 29051) +os: add Executable() (CL 16551) plugin: darwin support (CL 29392) plugin: mention OS X support and concurrency (CL 31463) plugin: new package for loading plugins (CL 27823)