This is an automated email from the ASF dual-hosted git repository. markt pushed a commit to branch 9.0.x in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/9.0.x by this push: new 35e31d9b1c Update Javadoc links to reference Java 8 35e31d9b1c is described below commit 35e31d9b1c9768673d34dc0ec5b1f330a4a3f63c Author: Mark Thomas <ma...@apache.org> AuthorDate: Tue Aug 6 13:22:34 2024 +0100 Update Javadoc links to reference Java 8 --- java/org/apache/tomcat/util/codec/binary/StringUtils.java | 2 +- java/org/apache/tomcat/util/digester/package.html | 4 ++-- java/org/apache/tomcat/util/net/SocketProperties.java | 6 +++--- java/org/apache/tomcat/util/net/openssl/OpenSSLEngine.java | 2 +- java/org/apache/tomcat/util/net/openssl/panama/OpenSSLEngine.java | 2 +- modules/jdbc-pool/build.xml | 2 +- modules/jdbc-pool/doc/jdbc-pool.xml | 4 ++-- webapps/docs/config/ajp.xml | 6 +++--- webapps/docs/config/cluster-sender.xml | 2 +- webapps/docs/config/context.xml | 4 ++-- webapps/docs/config/http.xml | 6 +++--- webapps/docs/config/http2.xml | 2 +- webapps/docs/config/realm.xml | 2 +- webapps/docs/jndi-datasource-examples-howto.xml | 2 +- 14 files changed, 23 insertions(+), 23 deletions(-) diff --git a/java/org/apache/tomcat/util/codec/binary/StringUtils.java b/java/org/apache/tomcat/util/codec/binary/StringUtils.java index 619964105b..cbc97cead6 100644 --- a/java/org/apache/tomcat/util/codec/binary/StringUtils.java +++ b/java/org/apache/tomcat/util/codec/binary/StringUtils.java @@ -21,7 +21,7 @@ import java.nio.charset.StandardCharsets; /** * Converts String to and from bytes using the encodings required by the Java specification. These encodings are - * specified in <a href="http://download.oracle.com/javase/7/docs/api/java/nio/charset/Charset.html"> + * specified in <a href="https://docs.oracle.com/javase/8/docs/api/java/nio/charset/Charset.html"> * Standard charsets</a>. * * <p>This class is immutable and thread-safe.</p> diff --git a/java/org/apache/tomcat/util/digester/package.html b/java/org/apache/tomcat/util/digester/package.html index ee4d8381d1..833e32fd6a 100644 --- a/java/org/apache/tomcat/util/digester/package.html +++ b/java/org/apache/tomcat/util/digester/package.html @@ -867,8 +867,8 @@ There are many good regex libraries available. (For example <a href='https://jakarta.apache.org/oro/index.html'>Jakarta ORO</a>, <a href='https://jakarta.apache.org/regexp/index.html'>Jakarta Regex</a>, <a href='http://www.cacas.org/java/gnu/regexp/'>GNU Regex</a> and -<a href='http://java.sun.com/j2se/1.4.2/docs/api/java/util/regex/package-summary.html'> -Java 1.4 Regex</a>) +<a href='https://docs.oracle.com/javase/8/docs/api/java/util/regex/package-summary.html'> +Java Regex</a>) Not only do different people have different personal tastes when it comes to regular expression matching but these products all offer different functionality and different strengths. diff --git a/java/org/apache/tomcat/util/net/SocketProperties.java b/java/org/apache/tomcat/util/net/SocketProperties.java index d71f6bffb8..cd2e70e4ea 100644 --- a/java/org/apache/tomcat/util/net/SocketProperties.java +++ b/java/org/apache/tomcat/util/net/SocketProperties.java @@ -163,7 +163,7 @@ public class SocketProperties { /** * Performance preferences according to - * http://docs.oracle.com/javase/1.5.0/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int) + * https://docs.oracle.com/javase/8/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int) * All three performance attributes must be set or the JVM defaults will be * used. */ @@ -171,7 +171,7 @@ public class SocketProperties { /** * Performance preferences according to - * http://docs.oracle.com/javase/1.5.0/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int) + * https://docs.oracle.com/javase/8/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int) * All three performance attributes must be set or the JVM defaults will be * used. */ @@ -179,7 +179,7 @@ public class SocketProperties { /** * Performance preferences according to - * http://docs.oracle.com/javase/1.5.0/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int) + * https://docs.oracle.com/javase/8/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int) * All three performance attributes must be set or the JVM defaults will be * used. */ diff --git a/java/org/apache/tomcat/util/net/openssl/OpenSSLEngine.java b/java/org/apache/tomcat/util/net/openssl/OpenSSLEngine.java index cbfebdd3a9..e3eb30c13b 100644 --- a/java/org/apache/tomcat/util/net/openssl/OpenSSLEngine.java +++ b/java/org/apache/tomcat/util/net/openssl/OpenSSLEngine.java @@ -144,7 +144,7 @@ public final class OpenSSLEngine extends SSLEngine implements SSLUtil.ProtocolIn private volatile boolean destroyed; // Use an invalid cipherSuite until the handshake is completed - // See http://docs.oracle.com/javase/7/docs/api/javax/net/ssl/SSLEngine.html#getSession() + // See https://docs.oracle.com/javase/8/docs/api/javax/net/ssl/SSLEngine.html#getSession() private volatile String version; private volatile String cipher; private volatile String applicationProtocol; diff --git a/java/org/apache/tomcat/util/net/openssl/panama/OpenSSLEngine.java b/java/org/apache/tomcat/util/net/openssl/panama/OpenSSLEngine.java index cf768e19a5..5ab85f6e8c 100644 --- a/java/org/apache/tomcat/util/net/openssl/panama/OpenSSLEngine.java +++ b/java/org/apache/tomcat/util/net/openssl/panama/OpenSSLEngine.java @@ -131,7 +131,7 @@ public final class OpenSSLEngine extends SSLEngine implements SSLUtil.ProtocolIn private volatile boolean destroyed; // Use an invalid cipherSuite until the handshake is completed - // See http://docs.oracle.com/javase/7/docs/api/javax/net/ssl/SSLEngine.html#getSession() + // See https://docs.oracle.com/javase/8/docs/api/javax/net/ssl/SSLEngine.html#getSession() private volatile String version; private volatile String cipher; private volatile String applicationProtocol; diff --git a/modules/jdbc-pool/build.xml b/modules/jdbc-pool/build.xml index da4f801221..82cef18e4b 100644 --- a/modules/jdbc-pool/build.xml +++ b/modules/jdbc-pool/build.xml @@ -145,7 +145,7 @@ additionalparam="-breakiterator -notimestamp" verbose="false"> <classpath refid="tomcat.jdbc.classpath"/> - <link href="http://docs.oracle.com/javase/7/docs/api/"/> + <link href="https://docs.oracle.com/javase/8/docs/api/"/> <sourcepath location="${basedir}/src/main/java"/> </javadoc> <!-- connection pool API file--> diff --git a/modules/jdbc-pool/doc/jdbc-pool.xml b/modules/jdbc-pool/doc/jdbc-pool.xml index f0b5e00639..308ff33cf9 100644 --- a/modules/jdbc-pool/doc/jdbc-pool.xml +++ b/modules/jdbc-pool/doc/jdbc-pool.xml @@ -510,13 +510,13 @@ </attribute> <attribute name="alternateUsernameAllowed" required="false"> <p>(boolean) By default, the jdbc-pool will ignore the - <a href="http://docs.oracle.com/javase/6/docs/api/javax/sql/DataSource.html#getConnection(java.lang.String,%20java.lang.String)"><code>DataSource.getConnection(username,password)</code></a> + <a href="https://docs.oracle.com/javase/8/docs/api/javax/sql/DataSource.html#getConnection(java.lang.String,%20java.lang.String)"><code>DataSource.getConnection(username,password)</code></a> call, and simply return a previously pooled connection under the globally configured properties <code>username</code> and <code>password</code>, for performance reasons. </p> <p> The pool can however be configured to allow use of different credentials each time a connection is requested. To enable the functionality described in the - <a href="http://docs.oracle.com/javase/6/docs/api/javax/sql/DataSource.html#getConnection(java.lang.String,%20java.lang.String)"><code>DataSource.getConnection(username,password)</code></a> + <a href="https://docs.oracle.com/javase/8/docs/api/javax/sql/DataSource.html#getConnection(java.lang.String,%20java.lang.String)"><code>DataSource.getConnection(username,password)</code></a> call, simply set the property <code>alternateUsernameAllowed</code> to <code>true</code>.<br /> Should you request a connection with the credentials user1/password1 and the connection diff --git a/webapps/docs/config/ajp.xml b/webapps/docs/config/ajp.xml index 4a0a76b36a..4c450e94f8 100644 --- a/webapps/docs/config/ajp.xml +++ b/webapps/docs/config/ajp.xml @@ -639,19 +639,19 @@ </attribute> <attribute name="socket.performanceConnectionTime" required="false"> <p>(int)The first value for the performance settings. See - <a href="http://docs.oracle.com/javase/6/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int)">Socket Performance Options</a> + <a href="https://docs.oracle.com/javase/8/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int)">Socket Performance Options</a> All three performance attributes must be set else the JVM defaults will be used for all three.</p> </attribute> <attribute name="socket.performanceLatency" required="false"> <p>(int)The second value for the performance settings. See - <a href="http://docs.oracle.com/javase/6/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int)">Socket Performance Options</a> + <a href="https://docs.oracle.com/javase/8/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int)">Socket Performance Options</a> All three performance attributes must be set else the JVM defaults will be used for all three.</p> </attribute> <attribute name="socket.performanceBandwidth" required="false"> <p>(int)The third value for the performance settings. See - <a href="http://docs.oracle.com/javase/6/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int)">Socket Performance Options</a> + <a href="https://docs.oracle.com/javase/8/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int)">Socket Performance Options</a> All three performance attributes must be set else the JVM defaults will be used for all three.</p> </attribute> diff --git a/webapps/docs/config/cluster-sender.xml b/webapps/docs/config/cluster-sender.xml index 516a79210b..bce7a97711 100644 --- a/webapps/docs/config/cluster-sender.xml +++ b/webapps/docs/config/cluster-sender.xml @@ -147,7 +147,7 @@ <attribute name="soTrafficClass" required="false"> Sets the traffic class level for the socket, the value is between 0 and 255. Default value is <code>int soTrafficClass = 0x04 | 0x08 | 0x010;</code> - Different values are defined in <a href="http://docs.oracle.com/javase/7/docs/api/java/net/Socket.html#setTrafficClass(int)"> + Different values are defined in <a href="https://docs.oracle.com/javase/8/docs/api/java/net/Socket.html#setTrafficClass(int)"> java.net.Socket#setTrafficClass(int)</a>. </attribute> <attribute name="tcpNoDelay" required="false"> diff --git a/webapps/docs/config/context.xml b/webapps/docs/config/context.xml index 6ceff061f2..b559d3efd9 100644 --- a/webapps/docs/config/context.xml +++ b/webapps/docs/config/context.xml @@ -1340,8 +1340,8 @@ two additional attributes to allow a shared data source to be used with different credentials. When these two additional attributes are used in combination with the <code>javax.sql.DataSource</code> type, different contexts can share a global data source with different credentials. - Under the hood, what happens is that a call to <a href="http://docs.oracle.com/javase/7/docs/api/javax/sql/DataSource.html#getConnection()"><code>getConnection()</code></a> - is simply translated to a call <a href="http://docs.oracle.com/javase/7/docs/api/javax/sql/DataSource.html#getConnection(java.lang.String,%20java.lang.String)"> + Under the hood, what happens is that a call to <a href="https://docs.oracle.com/javase/8/docs/api/javax/sql/DataSource.html#getConnection()"><code>getConnection()</code></a> + is simply translated to a call <a href="https://docs.oracle.com/javase/8/docs/api/javax/sql/DataSource.html#getConnection(java.lang.String,%20java.lang.String)"> <code>getConnection(username, password)</code></a> on the global data source. This is an easy way to get code to be transparent to what schemas are being used, yet be able to control connections (or pools) in the global configuration. </p> diff --git a/webapps/docs/config/http.xml b/webapps/docs/config/http.xml index e591e9fc6d..d9fc77058f 100644 --- a/webapps/docs/config/http.xml +++ b/webapps/docs/config/http.xml @@ -837,19 +837,19 @@ </attribute> <attribute name="socket.performanceConnectionTime" required="false"> <p>(int)The first value for the performance settings. See - <a href="http://docs.oracle.com/javase/7/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int)">Socket Performance Options</a>. + <a href="https://docs.oracle.com/javase/8/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int)">Socket Performance Options</a>. All three performance attributes must be set else the JVM defaults will be used for all three.</p> </attribute> <attribute name="socket.performanceLatency" required="false"> <p>(int)The second value for the performance settings. See - <a href="http://docs.oracle.com/javase/7/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int)">Socket Performance Options</a>. + <a href="https://docs.oracle.com/javase/8/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int)">Socket Performance Options</a>. All three performance attributes must be set else the JVM defaults will be used for all three.</p> </attribute> <attribute name="socket.performanceBandwidth" required="false"> <p>(int)The third value for the performance settings. See - <a href="http://docs.oracle.com/javase/7/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int)">Socket Performance Options</a>. + <a href="https://docs.oracle.com/javase/8/docs/api/java/net/Socket.html#setPerformancePreferences(int,%20int,%20int)">Socket Performance Options</a>. All three performance attributes must be set else the JVM defaults will be used for all three.</p> </attribute> diff --git a/webapps/docs/config/http2.xml b/webapps/docs/config/http2.xml index 3a261cc328..78cd8bc904 100644 --- a/webapps/docs/config/http2.xml +++ b/webapps/docs/config/http2.xml @@ -298,7 +298,7 @@ <strong>useAsyncIO</strong> attribute of the associated <strong>Connector</strong> is set to <code>false</code>.</p> <p>The HTTP/2 sendfile capability uses <a - href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/nio/MappedByteBuffer.html" + href="https://docs.oracle.com/javase/8/docs/api/java/nio/MappedByteBuffer.html" >MappedByteBuffer</a> which is known to cause file locking on Windows.</p> </attribute> diff --git a/webapps/docs/config/realm.xml b/webapps/docs/config/realm.xml index a198950b63..8db7609703 100644 --- a/webapps/docs/config/realm.xml +++ b/webapps/docs/config/realm.xml @@ -470,7 +470,7 @@ connection. This attribute should be a comma-separated list of values selected from <code>auth-conf</code>, <code>auth-int</code> and <code>auth</code>. See <a - href="http://docs.oracle.com/javase/7/docs/api/javax/security/sasl/Sasl.html#QOP" + href="https://docs.oracle.com/javase/8/docs/api/javax/security/sasl/Sasl.html#QOP" rel="nofollow">Java documentation</a> for more details.</p> <p>The default value is <code>auth-conf</code>.</p> </attribute> diff --git a/webapps/docs/jndi-datasource-examples-howto.xml b/webapps/docs/jndi-datasource-examples-howto.xml index 36b691facc..97f83d5607 100644 --- a/webapps/docs/jndi-datasource-examples-howto.xml +++ b/webapps/docs/jndi-datasource-examples-howto.xml @@ -72,7 +72,7 @@ the section about Automatic Application Deployment in the latter reference. <section name="DriverManager, the service provider mechanism and memory leaks"> <p><code>java.sql.DriverManager</code> supports the -<a href="http://docs.oracle.com/javase/6/docs/api/index.html?java/sql/DriverManager.html">service +<a href="https://docs.oracle.com/javase/8/docs/api/index.html?java/sql/DriverManager.html">service provider</a> mechanism. This feature is that all the available JDBC drivers that announce themselves by providing a <code>META-INF/services/java.sql.Driver</code> file are automatically discovered, loaded and registered, --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org