RFR [9] 8139179: URLStreamHandler* should link to URL ctor that specifies how factories/providers are located
Chris Hegarty
chris.hegarty at oracle.com
Fri Oct 9 13:52:02 UTC 2015
It was pointed out that the updated URL spec that describes how
URL protocol handlers are located isn't prominent in the
avadoc. In particular it was noted that it's not linked from
URLStreamHandlerFactory or URLStreamHandlerProvider.
Adding such links will make it clear how these classes tie
together.
diff --git
a/src/java.base/share/classes/java/net/URLStreamHandlerFactory.java
b/src/java.base/share/classes/java/net/URLStreamHandlerFactory.java
--- a/src/java.base/share/classes/java/net/URLStreamHandlerFactory.java
+++ b/src/java.base/share/classes/java/net/URLStreamHandlerFactory.java
@@ -28,9 +28,9 @@
/**
* This interface defines a factory for {@code URL} stream
* protocol handlers.
- * <p>
- * It is used by the {@code URL} class to create a
- * {@code URLStreamHandler} for a specific protocol.
+ *
+ * <p> A URL stream handler factory is used as specified in the
+ * {@linkplain java.net.URL#URL(String,String,int,String) URL constructor}.
*
* @author Arthur van Hoff
* @see java.net.URL
diff --git
a/src/java.base/share/classes/java/net/spi/URLStreamHandlerProvider.java
b/src/java.base/share/classes/java/net/spi/URLStreamHandlerProvider.java
--- a/src/java.base/share/classes/java/net/spi/URLStreamHandlerProvider.java
+++ b/src/java.base/share/classes/java/net/spi/URLStreamHandlerProvider.java
@@ -41,6 +41,9 @@
* fully-qualified concrete URL stream handler provider class names,
one per
* line.
*
+ * <p> URL stream handler providers are located at runtime, as
specified in the
+ * {@linkplain java.net.URL#URL(String,String,int,String) URL constructor}.
+ *
* @since 1.9
*/
public abstract class URLStreamHandlerProvider
-Chris.
More information about the net-dev
mailing list