Author: paul
Date: 2006-05-18 22:21:07 +0200 (Thu, 18 May 2006)
New Revision: 2125
Log:
r7608@polar: paul | 2006-05-18 14:44:08 -0500
Add markup.
Modified:
trunk/
trunk/refman-common/news-connector-j.xml
Property changes on: trunk
___________________________________________________________________
Name: svk:merge
- 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:7607
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:10508
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:4886
+ 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:7608
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:10508
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:4886
Modified: trunk/refman-common/news-connector-j.xml
===================================================================
--- trunk/refman-common/news-connector-j.xml 2006-05-18 20:20:29 UTC (rev 2124)
+++ trunk/refman-common/news-connector-j.xml 2006-05-18 20:21:07 UTC (rev 2125)
@@ -63,7 +63,7 @@
<para>
If the connection <literal>useTimezone</literal> is set to
<literal>true</literal>, then also respect time zone
- conversions in escape-processed string literals (e.g.
+ conversions in escape-processed string literals (for example,
<literal>"{ts ...}"</literal> and <literal>"{t
...}"</literal>).
</para>
@@ -1706,7 +1706,7 @@
<listitem>
<para>
More tests in <literal>Field.isOpaqueBinary()</literal> to
- distinguish opaque binary (i.e. fields with type
+ distinguish opaque binary (that is, fields with type
<literal>CHAR(n)</literal> and <literal>CHARACTER SET
BINARY</literal>) from output of various scalar and aggregate
functions that return strings.
@@ -4485,63 +4485,66 @@
<listitem>
<para>
- Fixed MysqlPooledConnection.close() calling wrong event type.
+ Fixed <literal>MysqlPooledConnection.close()</literal> calling
+ wrong event type.
</para>
</listitem>
<listitem>
<para>
- Fixed StringIndexOutOfBoundsException in PreparedStatement.
- setClob().
+ Fixed <literal>StringIndexOutOfBoundsException</literal> in
+ <literal>PreparedStatement.setClob()</literal>.
</para>
</listitem>
<listitem>
<para>
- 4.1 Column Metadata fixes
+ 4.1 Column Metadata fixes.
</para>
</listitem>
<listitem>
<para>
- Remove synchronization from Driver.connect() and
- Driver.acceptsUrl().
+ Remove synchronization from
+ <literal>Driver.connect()</literal> and
+ <literal>Driver.acceptsUrl()</literal>.
</para>
</listitem>
<listitem>
<para>
- IOExceptions during a transaction now cause the Connection to
- be closed.
+ <literal>IOExceptions</literal> during a transaction now cause
+ the <literal>Connection</literal> to be closed.
</para>
</listitem>
<listitem>
<para>
- Fixed missing conversion for 'YEAR' type in ResultSetMetaData.
- getColumnTypeName().
+ Fixed missing conversion for <literal>YEAR</literal> type in
+ <literal>ResultSetMetaData.getColumnTypeName()</literal>.
</para>
</listitem>
<listitem>
<para>
- Don't pick up indexes that start with 'pri' as primary keys
- for DBMD.getPrimaryKeys().
+ Don't pick up indexes that start with <literal>pri</literal>
+ as primary keys for <literal>DBMD.getPrimaryKeys()</literal>.
</para>
</listitem>
<listitem>
<para>
- Throw SQLExceptions when trying to do operations on a
- forcefully closed Connection (i.e. when a communication link
- failure occurs).
+ Throw <literal>SQLExceptions</literal> when trying to do
+ operations on a forcefully closed
+ <literal>Connection</literal> (that is, when a communication
+ link failure occurs).
</para>
</listitem>
<listitem>
<para>
You can now toggle profiling on/off using
- Connection.setProfileSql(boolean).
+ <literal>Connection.setProfileSql(boolean)</literal>.
</para>
</listitem>
@@ -4554,42 +4557,44 @@
<listitem>
<para>
- Updatable ResultSets can now be created for aliased
- tables/columns when connected to MySQL-4.1 or newer.
+ Updatable <literal>ResultSets</literal> can now be created for
+ aliased tables/columns when connected to MySQL-4.1 or newer.
</para>
</listitem>
<listitem>
<para>
- Fixed 'LOAD DATA LOCAL INFILE' bug when file >
- max_allowed_packet.
+ Fixed <literal>LOAD DATA LOCAL INFILE</literal> bug when file
+ > <literal>max_allowed_packet</literal>.
</para>
</listitem>
<listitem>
<para>
- Fixed escaping of 0x5c ('\') character for GBK and Big5
- charsets.
+ Fixed escaping of 0x5c (<literal>'\'</literal>) character for
+ GBK and Big5 charsets.
</para>
</listitem>
<listitem>
<para>
- Fixed ResultSet.getTimestamp() when underlying field is of
- type DATE.
+ Fixed <literal>ResultSet.getTimestamp()</literal> when
+ underlying field is of type <literal>DATE</literal>.
</para>
</listitem>
<listitem>
<para>
- Ensure that packet size from alignPacketSize() does not exceed
- MAX_ALLOWED_PACKET (JVM bug)
+ Ensure that packet size from
+ <literal>alignPacketSize()</literal> does not exceed
+ <literal>max_allowed_packet</literal> (JVM bug)
</para>
</listitem>
<listitem>
<para>
- Don't reset Connection.isReadOnly() when autoReconnecting.
+ Don't reset <literal>Connection.isReadOnly()</literal> when
+ autoReconnecting.
</para>
</listitem>
@@ -4605,79 +4610,91 @@
<listitem>
<para>
- Fixed ResultSetMetaData to return "" when catalog not known.
- Fixes NullPointerExceptions with Sun's CachedRowSet.
+ Fixed <literal>ResultSetMetaData</literal> to return
+ <literal>""</literal> when catalog not known. Fixes
+ <literal>NullPointerExceptions</literal> with Sun's
+ <literal>CachedRowSet</literal>.
</para>
</listitem>
<listitem>
<para>
- Fixed DBMD.getTypeInfo() and DBMD.getColumns() returning
- different value for precision in TEXT/BLOB types.
+ Fixed <literal>DBMD.getTypeInfo()</literal> and
+ <literal>DBMD.getColumns()</literal> returning different value
+ for precision in <literal>TEXT</literal> and
+ <literal>BLOB</literal> types.
</para>
</listitem>
<listitem>
<para>
- Allow ignoring of warning for 'non transactional tables'
- during rollback (compliance/usability) by setting
- 'ignoreNonTxTables' property to <literal>true</literal>.
+ Allow ignoring of warning for <quote>non transactional
+ tables</quote> during rollback (compliance/usability) by
+ setting <literal>ignoreNonTxTables</literal> property to
+ <literal>true</literal>.
</para>
</listitem>
<listitem>
<para>
- Fixed SQLExceptions getting swallowed on initial connect.
+ Fixed <literal>SQLExceptions</literal> getting swallowed on
+ initial connect.
</para>
</listitem>
<listitem>
<para>
- Fixed Statement.setMaxRows() to stop sending 'LIMIT' type
- queries when not needed (performance)
+ Fixed <literal>Statement.setMaxRows()</literal> to stop
+ sending <literal>LIMIT</literal> type queries when not needed
+ (performance).
</para>
</listitem>
<listitem>
<para>
- Clean up Statement query/method mismatch tests (i.e. INSERT
- not allowed with .executeQuery()).
+ Clean up <literal>Statement</literal> query/method mismatch
+ tests (that is, <literal>INSERT</literal> not allowed with
+ <literal>.executeQuery()</literal>).
</para>
</listitem>
<listitem>
<para>
- More checks added in ResultSet traversal method to catch when
- in closed state.
+ More checks added in <literal>ResultSet</literal> traversal
+ method to catch when in closed state.
</para>
</listitem>
<listitem>
<para>
- Fixed ResultSetMetaData.isWritable() to return correct value.
+ Fixed <literal>ResultSetMetaData.isWritable()</literal> to
+ return correct value.
</para>
</listitem>
<listitem>
<para>
- Add 'window' of different NULL sorting behavior to
- DBMD.nullsAreSortedAtStart (4.0.2 to 4.0.10, true, otherwise,
- no).
+ Add <quote>window</quote> of different <literal>NULL</literal>
+ sorting behavior to
+ <literal>DBMD.nullsAreSortedAtStart</literal> (4.0.2 to
+ 4.0.10, true; otherwise, no).
</para>
</listitem>
<listitem>
<para>
- Implemented Blob.setBytes(). You still need to pass the
- resultant Blob back into an updatable ResultSet or
- PreparedStatement to persist the changes, as MySQL does not
- support 'locators'.
+ Implemented <literal>Blob.setBytes()</literal>. You still need
+ to pass the resultant <literal>Blob</literal> back into an
+ updatable <literal>ResultSet</literal> or
+ <literal>PreparedStatement</literal> to persist the changes,
+ because MySQL does not support <quote>locators</quote>.
</para>
</listitem>
<listitem>
<para>
- Backported 4.1 charset field info changes from Connector/J 3.1
+ Backported 4.1 charset field info changes from Connector/J
+ 3.1.
</para>
</listitem>
@@ -4693,50 +4710,59 @@
<listitem>
<para>
- Fixed Buffer.fastSkipLenString() causing ArrayIndexOutOfBounds
- exceptions with some queries when unpacking fields.
+ Fixed <literal>Buffer.fastSkipLenString()</literal> causing
+ <literal>ArrayIndexOutOfBounds</literal> exceptions with some
+ queries when unpacking fields.
</para>
</listitem>
<listitem>
<para>
- Implemented an empty TypeMap for Connection.getTypeMap() so
- that some third-party apps work with MySQL (IBM WebSphere 5.0
- Connection pool).
+ Implemented an empty <literal>TypeMap</literal> for
+ <literal>Connection.getTypeMap()</literal> so that some
+ third-party apps work with MySQL (IBM WebSphere 5.0 Connection
+ pool).
</para>
</listitem>
<listitem>
<para>
- Added missing LONGTEXT type to DBMD.getColumns().
+ Added missing <literal>LONGTEXT</literal> type to
+ <literal>DBMD.getColumns()</literal>.
</para>
</listitem>
<listitem>
<para>
- Retrieve TX_ISOLATION from database for
- Connection.getTransactionIsolation() when the MySQL version
- supports it, instead of an instance variable.
+ Retrieve <literal>TX_ISOLATION</literal> from database for
+ <literal>Connection.getTransactionIsolation()</literal> when
+ the MySQL version supports it, instead of an instance
+ variable.
</para>
</listitem>
<listitem>
<para>
- Quote table names in DatabaseMetaData.getColumns(),
- getPrimaryKeys(), getIndexInfo(), getBestRowIdentifier()
+ Quote table names in
+ <literal>DatabaseMetaData.getColumns()</literal>,
+ <literal>getPrimaryKeys()</literal>,
+ <literal>getIndexInfo()</literal>,
+ <literal>getBestRowIdentifier()</literal>.
</para>
</listitem>
<listitem>
<para>
- Greatly reduce memory required for setBinaryStream() in
- PreparedStatements.
+ Greatly reduce memory required for
+ <literal>setBinaryStream()</literal> in
+ <literal>PreparedStatements</literal>.
</para>
</listitem>
<listitem>
<para>
- Fixed ResultSet.isBeforeFirst() for empty result sets.
+ Fixed <literal>ResultSet.isBeforeFirst()</literal> for empty
+ result sets.
</para>
</listitem>
@@ -4759,37 +4785,40 @@
<listitem>
<para>
Added quoted identifiers to database names for
- Connection.setCatalog.
+ <literal>Connection.setCatalog</literal>.
</para>
</listitem>
<listitem>
<para>
- Added support for quoted identifiers in PreparedStatement
- parser.
+ Added support for quoted identifiers in
+ <literal>PreparedStatement</literal> parser.
</para>
</listitem>
<listitem>
<para>
- Streamlined character conversion and byte[] handling in
- PreparedStatements for setByte().
+ Streamlined character conversion and <literal>byte[]</literal>
+ handling in <literal>PreparedStatements</literal> for
+ <literal>setByte()</literal>.
</para>
</listitem>
<listitem>
<para>
- Reduce memory footprint of PreparedStatements by sharing
- outbound packet with MysqlIO.
+ Reduce memory footprint of
+ <literal>PreparedStatements</literal> by sharing outbound
+ packet with <literal>MysqlIO</literal>.
</para>
</listitem>
<listitem>
<para>
- Added 'strictUpdates' property to allow control of amount of
- checking for 'correctness' of updatable result sets. Set this
- to <literal>false</literal> if you want faster updatable
- result sets and you know that you create them from SELECTs on
+ Added <literal>strictUpdates</literal> property to allow
+ control of amount of checking for <quote>correctness</quote>
+ of updatable result sets. Set this to <literal>false</literal>
+ if you want faster updatable result sets and you know that you
+ create them from <literal>SELECT</literal> statements on
tables with primary keys and that you have selected all
primary keys in your query.
</para>
@@ -4803,7 +4832,8 @@
<listitem>
<para>
- Fixed PreparedStatement.executeBatch() parameter overwriting.
+ Fixed <literal>PreparedStatement.executeBatch()</literal>
+ parameter overwriting.
</para>
</listitem>
@@ -4819,144 +4849,157 @@
<listitem>
<para>
- Changed charsToByte in SingleByteCharConverter to be
- non-static
+ Changed <literal>charsToByte</literal> in
+ <literal>SingleByteCharConverter</literal> to be non-static.
</para>
</listitem>
<listitem>
<para>
- Changed SingleByteCharConverter to use lazy initialization of
- each converter.
+ Changed <literal>SingleByteCharConverter</literal> to use lazy
+ initialization of each converter.
</para>
</listitem>
<listitem>
<para>
- Fixed charset handling in Fields.java
+ Fixed charset handling in <literal>Fields.java</literal>.
</para>
</listitem>
<listitem>
<para>
- Implemented Connection.nativeSQL()
+ Implemented <literal>Connection.nativeSQL()</literal>.
</para>
</listitem>
<listitem>
<para>
- More robust escape tokenizer -- recognize '--' comments, and
- allow nested escape sequences (see
- testsuite.EscapeProcessingTest)
+ More robust escape tokenizer: Recognize <literal>--</literal>
+ comments, and allow nested escape sequences (see
+ <literal>testsuite.EscapeProcessingTest</literal>).
</para>
</listitem>
<listitem>
<para>
- DBMD.getImported/ExportedKeys() now handles multiple foreign
- keys per table.
+ <literal>DBMD.getImported/ExportedKeys()</literal> now handles
+ multiple foreign keys per table.
</para>
</listitem>
<listitem>
<para>
- Fixed ResultSetMetaData.getPrecision() returning incorrect
- values for some floating point types.
+ Fixed <literal>ResultSetMetaData.getPrecision()</literal>
+ returning incorrect values for some floating-point types.
</para>
</listitem>
<listitem>
<para>
- Fixed ResultSetMetaData.getColumnTypeName() returning BLOB for
- TEXT and TEXT for BLOB types.
+ Fixed <literal>ResultSetMetaData.getColumnTypeName()</literal>
+ returning <literal>BLOB</literal> for <literal>TEXT</literal>
+ and <literal>TEXT</literal> for <literal>BLOB</literal> types.
</para>
</listitem>
<listitem>
<para>
- Fixed Buffer.isLastDataPacket() for 4.1 and newer servers.
+ Fixed <literal>Buffer.isLastDataPacket()</literal> for 4.1 and
+ newer servers.
</para>
</listitem>
<listitem>
<para>
- Added CLIENT_LONG_FLAG to be able to get more column flags
- (isAutoIncrement() being the most important)
+ Added <literal>CLIENT_LONG_FLAG</literal> to be able to get
+ more column flags (<literal>isAutoIncrement()</literal> being
+ the most important).
</para>
</listitem>
<listitem>
<para>
Because of above, implemented
- ResultSetMetaData.isAutoIncrement() to use
- Field.isAutoIncrement().
+ <literal>ResultSetMetaData.isAutoIncrement()</literal> to use
+ <literal>Field.isAutoIncrement()</literal>.
</para>
</listitem>
<listitem>
<para>
- Honor 'lower_case_table_names' when enabled in the server when
- doing table name comparisons in DatabaseMetaData methods.
+ Honor <literal>lower_case_table_names</literal> when enabled
+ in the server when doing table name comparisons in
+ <literal>DatabaseMetaData</literal> methods.
</para>
</listitem>
<listitem>
<para>
Some MySQL-4.1 protocol support (extended field info from
- selects)
+ selects).
</para>
</listitem>
<listitem>
<para>
Use non-aliased table/column names and database names to
- fullly qualify tables and columns in UpdatableResultSet
- (requires MySQL-4.1 or newer)
+ fullly qualify tables and columns in
+ <literal>UpdatableResultSet</literal> (requires MySQL-4.1 or
+ newer).
</para>
</listitem>
<listitem>
<para>
- Allow user to alter behavior of Statement/
- PreparedStatement.executeBatch() via 'continueBatchOnError'
- property (defaults to <literal>true</literal>).
+ Allow user to alter behavior of <literal>Statement</literal>/
+ <literal>PreparedStatement.executeBatch()</literal> via
+ <literal>continueBatchOnError</literal> property (defaults to
+ <literal>true</literal>).
</para>
</listitem>
<listitem>
<para>
- Check for connection closed in more Connection methods
- (createStatement, prepareStatement, setTransactionIsolation,
- setAutoCommit).
+ Check for connection closed in more
+ <literal>Connection</literal> methods
+ (<literal>createStatement</literal>,
+ <literal>prepareStatement</literal>,
+ <literal>setTransactionIsolation</literal>,
+ <literal>setAutoCommit</literal>).
</para>
</listitem>
<listitem>
<para>
More robust implementation of updatable result sets. Checks
- that _all_ primary keys of the table have been selected.
+ that <emphasis>all</emphasis> primary keys of the table have
+ been selected.
</para>
</listitem>
<listitem>
<para>
- 'LOAD DATA LOCAL INFILE ...' now works, if your server is
- configured to allow it. Can be turned off with the
- 'allowLoadLocalInfile' property (see the README).
+ <literal>LOAD DATA LOCAL INFILE ...</literal> now works, if
+ your server is configured to allow it. Can be turned off with
+ the <literal>allowLoadLocalInfile</literal> property (see the
+ <filename>README</filename>).
</para>
</listitem>
<listitem>
<para>
- Substitute '?' for unknown character conversions in
- single-byte character sets instead of '\0'.
+ Substitute <literal>'?'</literal> for unknown character
+ conversions in single-byte character sets instead of
+ <literal>'\0'</literal>.
</para>
</listitem>
<listitem>
<para>
- NamedPipeSocketFactory now works (only intended for Windows),
- see README for instructions.
+ <literal>NamedPipeSocketFactory</literal> now works (only
+ intended for Windows), see <filename>README</filename> for
+ instructions.
</para>
</listitem>
@@ -4972,49 +5015,54 @@
<listitem>
<para>
- Fixed issue with updatable result sets and PreparedStatements
- not working
+ Fixed issue with updatable result sets and
+ <literal>PreparedStatements</literal> not working.
</para>
</listitem>
<listitem>
<para>
- Fixed ResultSet.setFetchDirection(FETCH_UNKNOWN)
+ Fixed
+ <literal>ResultSet.setFetchDirection(FETCH_UNKNOWN)</literal>.
</para>
</listitem>
<listitem>
<para>
- Fixed issue when calling Statement.setFetchSize() when using
- arbitrary values
+ Fixed issue when calling
+ <literal>Statement.setFetchSize()</literal> when using
+ arbitrary values.
</para>
</listitem>
<listitem>
<para>
- Fixed incorrect conversion in ResultSet.getLong()
+ Fixed incorrect conversion in
+ <literal>ResultSet.getLong()</literal>.
</para>
</listitem>
<listitem>
<para>
- Implemented ResultSet.updateBlob().
+ Implemented <literal>ResultSet.updateBlob()</literal>.
</para>
</listitem>
<listitem>
<para>
- Removed duplicate code from UpdatableResultSet (it can be
- inherited from ResultSet, the extra code for each method to
- handle updatability I thought might someday be necessary has
- not been needed).
+ Removed duplicate code from
+ <literal>UpdatableResultSet</literal> (it can be inherited
+ from <literal>ResultSet</literal>, the extra code for each
+ method to handle updatability I thought might someday be
+ necessary has not been needed).
</para>
</listitem>
<listitem>
<para>
- Fixed "UnsupportedEncodingException" thrown when "forcing" a
- character encoding via properties.
+ Fixed <literal>UnsupportedEncodingException</literal> thrown
+ when <quote>forcing</quote> a character encoding via
+ properties.
</para>
</listitem>
@@ -5026,140 +5074,153 @@
<listitem>
<para>
- Added driver property 'useHostsInPrivileges'. Defaults to
- true. Affects whether or not '@hostname' will be used in
- DBMD.getColumn/TablePrivileges.
+ Added driver property <literal>useHostsInPrivileges</literal>.
+ Defaults to true. Affects whether or not
+ <literal>@hostname</literal> will be used in
+ <literal>DBMD.getColumn/TablePrivileges</literal>.
</para>
</listitem>
<listitem>
<para>
- All DBMD result set columns describing schemas now return NULL
- to be more compliant with the behavior of other JDBC drivers
- for other database systems (MySQL does not support schemas).
+ All <literal>DBMD</literal> result set columns describing
+ schemas now return <literal>NULL</literal> to be more
+ compliant with the behavior of other JDBC drivers for other
+ database systems (MySQL does not support schemas).
</para>
</listitem>
<listitem>
<para>
- Added SSL support. See README for information on how to use
- it.
+ Added SSL support. See <filename>README</filename> for
+ information on how to use it.
</para>
</listitem>
<listitem>
<para>
Properly restore connection properties when autoReconnecting
- or failing-over, including autoCommit state, and isolation
- level.
+ or failing-over, including <literal>autoCommit</literal>
+ state, and isolation level.
</para>
</listitem>
<listitem>
<para>
- Use 'SHOW CREATE TABLE' when possible for determining foreign
- key information for DatabaseMetaData...also allows cascade
- options for DELETE information to be returned
+ Use <literal>SHOW CREATE TABLE</literal> when possible for
+ determining foreign key information for
+ <literal>DatabaseMetaData</literal>. Also allows cascade
+ options for <literal>DELETE</literal> information to be
+ returned.
</para>
</listitem>
<listitem>
<para>
- Escape 0x5c character in strings for the SJIS charset.
+ Escape <literal>0x5c</literal> character in strings for the
+ SJIS charset.
</para>
</listitem>
<listitem>
<para>
- Fixed start position off-by-1 error in Clob.getSubString()
+ Fixed start position off-by-1 error in
+ <literal>Clob.getSubString()</literal>.
</para>
</listitem>
<listitem>
<para>
- Implemented Clob.truncate()
+ Implemented <literal>Clob.truncate()</literal>.
</para>
</listitem>
<listitem>
<para>
- Implemented Clob.setString()
+ Implemented <literal>Clob.setString()</literal>.
</para>
</listitem>
<listitem>
<para>
- Implemented Clob.setAsciiStream()
+ Implemented <literal>Clob.setAsciiStream()</literal>.
</para>
</listitem>
<listitem>
<para>
- Implemented Clob.setCharacterStream()
+ Implemented <literal>Clob.setCharacterStream()</literal>.
</para>
</listitem>
<listitem>
<para>
- Added com.mysql.jdbc.MiniAdmin class, which allows you to send
- 'shutdown' command to MySQL server...Intended to be used when
- 'embedding' Java and MySQL server together in an end-user
- application.
+ Added <literal>com.mysql.jdbc.MiniAdmin</literal> class, which
+ allows you to send <literal>shutdown</literal> command to
+ MySQL server. This is intended to be used when
+ <quote>embedding</quote> Java and MySQL server together in an
+ end-user application.
</para>
</listitem>
<listitem>
<para>
- Added 'connectTimeout' parameter that allows users of JDK-1.4
- and newer to specify a maxium time to wait to establish a
- connection.
+ Added <literal>connectTimeout</literal> parameter that allows
+ users of JDK-1.4 and newer to specify a maxium time to wait to
+ establish a connection.
</para>
</listitem>
<listitem>
<para>
- Failover and autoReconnect only work when the connection is in
- a autoCommit(false) state, in order to stay transaction safe
+ Failover and <literal>autoReconnect</literal> work only when
+ the connection is in an <literal>autoCommit(false)</literal>
+ state, in order to stay transaction-safe.
</para>
</listitem>
<listitem>
<para>
- Added 'queriesBeforeRetryMaster' property that specifies how
- many queries to issue when failed over before attempting to
- reconnect to the master (defaults to 50)
+ Added <literal>queriesBeforeRetryMaster</literal> property
+ that specifies how many queries to issue when failed over
+ before attempting to reconnect to the master (defaults to 50).
</para>
</listitem>
<listitem>
<para>
- Fixed DBMD.supportsResultSetConcurrency() so that it returns
- true for ResultSet.TYPE_SCROLL_INSENSITIVE and
- ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE
+ Fixed <literal>DBMD.supportsResultSetConcurrency()</literal>
+ so that it returns true for
+ <literal>ResultSet.TYPE_SCROLL_INSENSITIVE</literal> and
+ <literal>ResultSet.CONCUR_READ_ONLY</literal> or
+ <literal>ResultSet.CONCUR_UPDATABLE</literal>.
</para>
</listitem>
<listitem>
<para>
- Fixed ResultSet.isLast() for empty result sets (should return
- false).
+ Fixed <literal>ResultSet.isLast()</literal> for empty result
+ sets (should return <literal>false</literal>).
</para>
</listitem>
<listitem>
<para>
- PreparedStatement now honors stream lengths in
- setBinary/Ascii/Character Stream() unless you set the
- connection property 'useStreamLengthsInPrepStmts' to
+ <literal>PreparedStatement</literal> now honors stream lengths
+ in setBinary/Ascii/Character Stream() unless you set the
+ connection property
+ <literal>useStreamLengthsInPrepStmts</literal> to
<literal>false</literal>.
</para>
</listitem>
<listitem>
<para>
- Removed some not-needed temporary object creation by using
- Strings smarter in EscapeProcessor, Connection and
- DatabaseMetaData classes.
+ Removed some not-needed temporary object creation by smarter
+ use of <literal>Strings</literal> in
+ <literal>EscapeProcessor</literal>,
+ <literal>Connection</literal> and
+ <literal>DatabaseMetaData</literal> classes.
</para>
</listitem>
@@ -5175,55 +5236,61 @@
<listitem>
<para>
- Fixed ResultSet.getRow() off-by-one bug.
+ Fixed <literal>ResultSet.getRow()</literal> off-by-one bug.
</para>
</listitem>
<listitem>
<para>
- Fixed RowDataStatic.getAt() off-by-one bug.
+ Fixed <literal>RowDataStatic.getAt()</literal> off-by-one bug.
</para>
</listitem>
<listitem>
<para>
- Added limited Clob functionality (ResultSet.getClob(),
- PreparedStatemtent.setClob(),
- PreparedStatement.setObject(Clob).
+ Added limited <literal>Clob</literal> functionality
+ (<literal>ResultSet.getClob()</literal>,
+ <literal>PreparedStatemtent.setClob()</literal>,
+ <literal>PreparedStatement.setObject(Clob)</literal>.
</para>
</listitem>
<listitem>
<para>
- Added socketTimeout parameter to URL.
+ Added <literal>socketTimeout</literal> parameter to URL.
</para>
</listitem>
<listitem>
<para>
- Connection.isClosed() no longer "pings" the server.
+ <literal>Connection.isClosed()</literal> no longer
+ <quote>pings</quote> the server.
</para>
</listitem>
<listitem>
<para>
- Connection.close() issues rollback() when getAutoCommit() ==
- false
+ <literal>Connection.close()</literal> issues
+ <literal>rollback()</literal> when
+ <literal>getAutoCommit()</literal> is
+ <literal>false</literal>.
</para>
</listitem>
<listitem>
<para>
- Added "paranoid" parameter...sanitizes error messages removing
- "sensitive" information from them (such as hostnames, ports,
- or usernames), as well as clearing "sensitive" data structures
- when possible.
+ Added <literal>paranoid</literal> parameter, which sanitizes
+ error messages by removing <quote>sensitive</quote>
+ information from them (such as hostnames, ports, or
+ usernames), as well as clearing <quote>sensitive</quote> data
+ structures when possible.
</para>
</listitem>
<listitem>
<para>
- Fixed ResultSetMetaData.isSigned() for TINYINT and BIGINT.
+ Fixed <literal>ResultSetMetaData.isSigned()</literal> for
+ <literal>TINYINT</literal> and <literal>BIGINT</literal>.
</para>
</listitem>
@@ -5236,21 +5303,21 @@
<listitem>
<para>
- Implemented ResultSet.getCharacterStream()
+ Implemented <literal>ResultSet.getCharacterStream()</literal>.
</para>
</listitem>
<listitem>
<para>
- Added "LOCAL TEMPORARY" to table types in
- DatabaseMetaData.getTableTypes()
+ Added <literal>LOCAL TEMPORARY</literal> to table types in
+ <literal>DatabaseMetaData.getTableTypes()</literal>.
</para>
</listitem>
<listitem>
<para>
Massive code clean-up to follow Java coding conventions (the
- time had come)
+ time had come).
</para>
</listitem>
@@ -5266,95 +5333,98 @@
<listitem>
<para>
- !!! LICENSE CHANGE !!! The driver is now GPL. If you need
- non-GPL licenses, please contact me <mark@stripped>
+ <emphasis role="bold">!!! LICENSE CHANGE !!!</emphasis> The
+ driver is now GPL. If you need non-GPL licenses, please
+ contact me <literal><mark@stripped></literal>.
</para>
</listitem>
<listitem>
<para>
JDBC-3.0 functionality including
- Statement/PreparedStatement.getGeneratedKeys() and
- ResultSet.getURL()
+ <literal>Statement/PreparedStatement.getGeneratedKeys()</literal>
+ and <literal>ResultSet.getURL()</literal>.
</para>
</listitem>
<listitem>
<para>
- Performance enchancements - driver is now 50-100% faster in
- most situations, and creates fewer temporary objects
+ Performance enchancements: Driver is now 50-100% faster in
+ most situations, and creates fewer temporary objects.
</para>
</listitem>
<listitem>
<para>
- Repackaging...new driver name is "com.mysql.jdbc.Driver", old
- name still works, though (the driver is now provided by
- MySQL-AB)
+ Repackaging: New driver name is
+ <literal>com.mysql.jdbc.Driver</literal>, old name still
+ works, though (the driver is now provided by MySQL-AB).
</para>
</listitem>
<listitem>
<para>
- Better checking for closed connections in Statement and
- PreparedStatement.
+ Better checking for closed connections in
+ <literal>Statement</literal> and
+ <literal>PreparedStatement</literal>.
</para>
</listitem>
<listitem>
<para>
- Support for streaming (row-by-row) result sets (see README)
- Thanks to Doron.
+ Support for streaming (row-by-row) result sets (see
+ <filename>README</filename>) Thanks to Doron.
</para>
</listitem>
<listitem>
<para>
Support for large packets (new addition to MySQL-4.0
- protocol), see README for more information.
+ protocol), see <filename>README</filename> for more
+ information.
</para>
</listitem>
<listitem>
<para>
- JDBC Compliance -- Passes all tests besides stored procedure
- tests
+ JDBC Compliance: Passes all tests besides stored procedure
+ tests.
</para>
</listitem>
<listitem>
<para>
- Fix and sort primary key names in DBMetaData (SF bugs 582086
- and 582086)
+ Fix and sort primary key names in
+ <literal>DBMetaData</literal> (SF bugs 582086 and 582086).
</para>
</listitem>
<listitem>
<para>
- Float types now reported as java.sql.Types.FLOAT (SF bug
- 579573)
+ Float types now reported as
+ <literal>java.sql.Types.FLOAT</literal> (SF bug 579573).
</para>
</listitem>
<listitem>
<para>
- ResultSet.getTimestamp() now works for DATE types (SF bug
- 559134)
+ <literal>ResultSet.getTimestamp()</literal> now works for
+ <literal>DATE</literal> types (SF bug 559134).
</para>
</listitem>
<listitem>
<para>
- ResultSet.getDate/Time/Timestamp now recognizes all forms of
- invalid values that have been set to all zeroes by MySQL (SF
- bug 586058)
+ <literal>ResultSet.getDate/Time/Timestamp</literal> now
+ recognizes all forms of invalid values that have been set to
+ all zeroes by MySQL (SF bug 586058).
</para>
</listitem>
<listitem>
<para>
Testsuite now uses Junit (which you can get from
- www.junit.org)
+ <ulink url="http://www.junit.org"/>.
</para>
</listitem>
@@ -5366,7 +5436,8 @@
<listitem>
<para>
- Added multi-host failover support (see README)
+ Added multi-host failover support (see
+ <filename>README</filename>).
</para>
</listitem>
@@ -5379,7 +5450,8 @@
<listitem>
<para>
Overall speed improvements via controlling transient object
- creation in MysqlIO class when reading packets
+ creation in <literal>MysqlIO</literal> class when reading
+ packets.
</para>
</listitem>
@@ -5387,7 +5459,7 @@
<para>
Performance improvements in string handling and field metadata
creation (lazily instantiated) contributed by Alex
- Twisleton-Wykeham-Fiennes
+ Twisleton-Wykeham-Fiennes.
</para>
</listitem>
@@ -6753,10 +6825,10 @@
You may also change the number of reconnect tries, and the
initial timeout value via "maxReconnects=n" (default 3) and
"initialTimeout=n" (seconds, default 2) parameters. The
- timeout is an exponential backoff type of timeout, e.g. if you
- have initial timeout of 2 seconds, and maxReconnects of 3,
- then the driver will timeout 2 seconds, 4 seconds, then 16
- seconds between each re-connection attempt.
+ timeout is an exponential backoff type of timeout; for
+ example, if you have initial timeout of 2 seconds, and
+ maxReconnects of 3, then the driver will timeout 2 seconds, 4
+ seconds, then 16 seconds between each re-connection attempt.
</para>
</listitem>
| Thread |
|---|
| • svn commit - mysqldoc@docsrva: r2125 - in trunk: . refman-common | paul | 18 May |
