stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8184311: Update java.sql and java.sql.rowset API docs for accessibility

Browse Source 
Reviewed-by: lancea
This commit is contained in:
Jonathan Gibbons 2017-07-13 17:45:10 -07:00
parent f4514d5f5d
commit 40accfdf57
6 changed files with 49 additions and 51 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
jdk/src/java.sql.rowset/share/classes/javax/sql/rowset/package.html
View File

@ -177,13 +177,13 @@ abstract class provides.
<caption>Features in <code>BaseRowSet</code></caption>
<thead>
<tr>
<th>Feature</th>
<th>Details</th>
<th scope="col">Feature</th>
<th scope="col">Details</th>
</tr>
</thead>
<tbody>
<tr>
<td>Properties</td>
<th scope="row">Properties</th>
<td>Provides standard JavaBeans property manipulation
mechanisms to allow applications to get and set <code>RowSet</code> command and
property values. Refer to the documentation of the <code>javax.sql.RowSet</code>
@ -191,7 +191,7 @@ interface (available in the JDBC 3.0 specification) for more details on
the standard <code>RowSet</code> properties.</td>
</tr>
<tr>
<td>Event notification</td>
<th scope="row">Event notification</th>
<td>Provides standard JavaBeans event notifications
to registered event listeners. Refer to the documentation of <code>javax.sql.RowSetEvent</code>
interface (available in the JDBC 3.0 specification) for
@ -199,12 +199,12 @@ more details on how to register and handle standard RowSet events generated
by compliant implementations.</td>
</tr>
<tr>
<td>Setters for a RowSet object's command</td>
<th scope="row">Setters for a RowSet object's command</th>
<td>Provides a complete set of setter methods
for setting RowSet command parameters.</td>
</tr>
<tr>
<td>Streams</td>
<th scope="row">Streams</th>
<td>Provides fields for storing of stream instances
in addition to providing a set of constants for stream type designation.</td>
</tr>

4
jdk/src/java.sql/share/classes/java/sql/Connection.java
View File

@ -1,5 +1,5 @@
/*
* Copyright (c) 1996, 2015, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -1523,7 +1523,7 @@ throws SQLException;
*
* @implSpec
* The default implementation is a no-op.
* <p>
*
* @apiNote
* This method is to be used by Connection pooling managers.
* <p>

3
jdk/src/java.sql/share/classes/java/sql/DriverManager.java
View File

@ -1,5 +1,5 @@
/*
* Copyright (c) 1996, 2016, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -63,7 +63,6 @@ import jdk.internal.reflect.Reflection;
* via the {@linkplain ServiceLoader#load service-provider loading} mechanism.
*</ul>
*
*<P>
* @implNote
* {@code DriverManager} initialization is done lazily and looks up service
* providers using the thread context class loader. The drivers loaded and

16
jdk/src/java.sql/share/classes/java/sql/SQLPermission.java
View File

@ -62,29 +62,29 @@ import java.security.*;
* <caption style="display:none">permission target name, what the permission allows, and associated risks</caption>
* <thead>
* <tr>
* <th>Permission Target Name</th>
* <th>What the Permission Allows</th>
* <th>Risks of Allowing this Permission</th>
* <th scope="col">Permission Target Name</th>
* <th scope="col">What the Permission Allows</th>
* <th scope="col">Risks of Allowing this Permission</th>
* </tr>
* </thead>
*
* <tbody>
* <tr>
* <td>setLog</td>
* <th scope="row">setLog</th>
* <td>Setting of the logging stream</td>
* <td>This is a dangerous permission to grant.
* The contents of the log may contain usernames and passwords,
* SQL statements, and SQL data.</td>
* </tr>
* <tr>
* <td>callAbort</td>
* <th scope="row">callAbort</th>
* <td>Allows the invocation of the {@code Connection} method
* {@code abort}</td>
* <td>Permits an application to terminate a physical connection to a
* database.</td>
* </tr>
* <tr>
* <td>setSyncFactory</td>
* <th scope="row">setSyncFactory</th>
* <td>Allows the invocation of the {@code SyncFactory} methods
* {@code setJNDIContext} and {@code setLogger}</td>
* <td>Permits an application to specify the JNDI context from which the
@ -93,7 +93,7 @@ import java.security.*;
* </tr>
*
* <tr>
* <td>setNetworkTimeout</td>
* <th scope="row">setNetworkTimeout</th>
* <td>Allows the invocation of the {@code Connection} method
* {@code setNetworkTimeout}</td>
* <td>Permits an application to specify the maximum period a
@ -101,7 +101,7 @@ import java.security.*;
* objects created from the <code>Connection</code>
* will wait for the database to reply to any one request.</td>
* <tr>
* <td>deregisterDriver</td>
* <th scope="row">deregisterDriver</th>
* <td>Allows the invocation of the {@code DriverManager}
* method {@code deregisterDriver}</td>
* <td>Permits an application to remove a JDBC driver from the list of

64
jdk/src/java.sql/share/classes/java/sql/Statement.java
View File

@ -1379,17 +1379,17 @@ public interface Statement extends Wrapper, AutoCloseable {
* single quote within the string will be replaced by two single quotes.
*
* <blockquote>
* <table class="striped" >
* <table class="striped">
* <caption>Examples of the conversion:</caption>
* <thead>
* <tr><th>Value</th><th>Result</th></tr>
* <tr><th scope="col">Value</th><th scope="col">Result</th></tr>
* </thead>
* <tbody style="text-align:center">
* <tr> <td>Hello</td> <td>'Hello'</td> </tr>
* <tr> <td>G'Day</td> <td>'G''Day'</td> </tr>
* <tr> <td>'G''Day'</td>
* <tr> <th scope="row">Hello</th> <td>'Hello'</td> </tr>
* <tr> <th scope="row">G'Day</th> <td>'G''Day'</td> </tr>
* <tr> <th scope="row">'G''Day'</th>
* <td>'''G''''Day'''</td> </tr>
* <tr> <td>I'''M</td> <td>'I''''''M'</td>
* <tr> <th scope="row">I'''M</th> <td>'I''''''M'</td>
* </tr>
*
* </tbody>
@ -1454,48 +1454,48 @@ public interface Statement extends Wrapper, AutoCloseable {
* <caption>Examples of the conversion:</caption>
* <thead>
* <tr>
* <th>identifier</th>
* <th>alwaysQuote</th>
* <th>Result</th></tr>
* <th scope="col">identifier</th>
* <th scope="col">alwaysQuote</th>
* <th scope="col">Result</th></tr>
* </thead>
* <tbody>
* <tr>
* <td>Hello</td>
* <th scope="row">Hello</th>
* <td>false</td>
* <td>Hello</td>
* </tr>
* <tr>
* <td>Hello</td>
* <th scope="row">Hello</th>
* <td>true</td>
* <td>"Hello"</td>
* </tr>
* <tr>
* <td>G'Day</td>
* <th scope="row">G'Day</th>
* <td>false</td>
* <td>"G'Day"</td>
* </tr>
* <tr>
* <td>"Bruce Wayne"</td>
* <th scope="row">"Bruce Wayne"</th>
* <td>false</td>
* <td>"Bruce Wayne"</td>
* </tr>
* <tr>
* <td>"Bruce Wayne"</td>
* <th scope="row">"Bruce Wayne"</th>
* <td>true</td>
* <td>"Bruce Wayne"</td>
* </tr>
* <tr>
* <td>GoodDay$</td>
* <th scope="row">GoodDay$</th>
* <td>false</td>
* <td>"GoodDay$"</td>
* </tr>
* <tr>
* <td>Hello"World</td>
* <th scope="row">Hello"World</th>
* <td>false</td>
* <td>SQLException</td>
* </tr>
* <tr>
* <td>"Hello"World"</td>
* <th scope="row">"Hello"World"</th>
* <td>false</td>
* <td>SQLException</td>
* </tr>
@ -1554,33 +1554,33 @@ public interface Statement extends Wrapper, AutoCloseable {
* <caption>Examples of the conversion:</caption>
* <thead>
* <tr>
* <th>identifier</th>
* <th>Simple Identifier</th>
* <th scope="col">identifier</th>
* <th scope="col">Simple Identifier</th>
* </thead>
*
* <tbody>
* <tr>
* <td>Hello</td>
* <th scope="row">Hello</th>
* <td>true</td>
* </tr>
* <tr>
* <td>G'Day</td>
* <th scope="row">G'Day</th>
* <td>false</td>
* </tr>
* <tr>
* <td>"Bruce Wayne"</td>
* <th scope="row">"Bruce Wayne"</th>
* <td>false</td>
* </tr>
* <tr>
* <td>GoodDay$</td>
* <th scope="row">GoodDay$</th>
* <td>false</td>
* </tr>
* <tr>
* <td>Hello"World</td>
* <th scope="row">Hello"World</th>
* <td>false</td>
* </tr>
* <tr>
* <td>"Hello"World"</td>
* <th scope="row">"Hello"World"</th>
* <td>false</td>
* </tr>
* </tbody>
@ -1613,17 +1613,17 @@ public interface Statement extends Wrapper, AutoCloseable {
* <caption>Examples of the conversion:</caption>
* <thead>
* <tr>
* <th>Value</th>
* <th>Result</th>
* <th scope="col">Value</th>
* <th scope="col">Result</th>
* </tr>
* </thead>
* <tbody>
* <tr> <td>Hello</td> <td>N'Hello'</td> </tr>
* <tr> <td>G'Day</td> <td>N'G''Day'</td> </tr>
* <tr> <td>'G''Day'</td>
* <tr> <th scope="row">Hello</th> <td>N'Hello'</td> </tr>
* <tr> <th scope="row">G'Day</th> <td>N'G''Day'</td> </tr>
* <tr> <th scope="row">'G''Day'</th>
* <td>N'''G''''Day'''</td> </tr>
* <tr> <td>I'''M</td> <td>N'I''''''M'</td>
* <tr> <td>N'Hello'</td> <td>N'N''Hello'''</td> </tr>
* <tr> <th scope="row">I'''M</th> <td>N'I''''''M'</td>
* <tr> <th scope="row">N'Hello'</th> <td>N'N''Hello'''</td> </tr>
*
* </tbody>
* </table>

1
jdk/src/java.sql/share/classes/javax/sql/package.html
View File

@ -280,7 +280,6 @@ generally, a writer will do the following:
The <code>RowSet</code> interface may be implemented in any number of
ways, and anyone may write an implementation. Developers are encouraged
to use their imaginations in coming up with new ways to use rowsets.
<P>
<h2>Package Specification</h2>