src/java.base/share/classes/java/net/package-info.java
author chegar
Fri, 18 Oct 2019 21:25:01 +0100
branchdatagramsocketimpl-branch
changeset 58697 e3ff12d14d43
parent 52700 b206bdfb9fe2
permissions -rw-r--r--
datagramsocketimpl-branch: minor refactoring
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
19069
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
     1
/*
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
     2
 * Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
     4
 *
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    10
 *
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    15
 * accompanied this code).
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    16
 *
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    20
 *
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    23
 * questions.
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    24
 */
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
    25
19069
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    26
/**
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    27
 * Provides the classes for implementing networking applications.
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    28
 *
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    29
 * <p> The java.net package can be roughly divided in two sections:</p>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    30
 * <ul>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    31
 *     <li><p><i>A Low Level API</i>, which deals with the
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    32
 *               following abstractions:</p>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    33
 *     <ul>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    34
 *       <li><p><i>Addresses</i>, which are networking identifiers,
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    35
 *              like IP addresses.</p></li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    36
 *       <li><p><i>Sockets</i>, which are basic bidirectional data communication
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    37
 *              mechanisms.</p></li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    38
 *       <li><p><i>Interfaces</i>, which describe network interfaces. </p></li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    39
 *     </ul></li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    40
 *     <li> <p><i>A High Level API</i>, which deals with the following
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    41
 *          abstractions:</p>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    42
 *     <ul>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    43
 *       <li><p><i>URIs</i>, which represent
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    44
 *               Universal Resource Identifiers.</p></li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    45
 *       <li><p><i>URLs</i>, which represent
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    46
 *               Universal Resource Locators.</p></li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    47
 *       <li><p><i>Connections</i>, which represents connections to the resource
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    48
 *               pointed to by <i>URLs</i>.</p></li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    49
 *       </ul></li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    50
 * </ul>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    51
 * <h2>Addresses</h2>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    52
 * <p>Addresses are used throughout the java.net APIs as either host
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    53
 *    identifiers, or socket endpoint identifiers.</p>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    54
 * <p>The {@link java.net.InetAddress} class is the abstraction representing an
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    55
 *    IP (Internet Protocol) address.  It has two subclasses:
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    56
 * <ul>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    57
 *       <li>{@link java.net.Inet4Address} for IPv4 addresses.</li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    58
 *       <li>{@link java.net.Inet6Address} for IPv6 addresses.</li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    59
 * </ul>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    60
 * <p>But, in most cases, there is no need to deal directly with the subclasses,
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    61
 *    as the InetAddress abstraction should cover most of the needed
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    62
 *    functionality.</p>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    63
 * <h3><b>About IPv6</b></h3>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    64
 * <p>Not all systems have support for the IPv6 protocol, and while the Java
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    65
 *    networking stack will attempt to detect it and use it transparently when
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    66
 *    available, it is also possible to disable its use with a system property.
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    67
 *    In the case where IPv6 is not available, or explicitly disabled,
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    68
 *    Inet6Address are not valid arguments for most networking operations any
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    69
 *    more. While methods like {@link java.net.InetAddress#getByName} are
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    70
 *    guaranteed not to return an Inet6Address when looking up host names, it
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    71
 *    is possible, by passing literals, to create such an object. In which
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    72
 *    case, most methods, when called with an Inet6Address will throw an
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    73
 *    Exception.</p>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    74
 * <h2>Sockets</h2>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    75
 * <p>Sockets are means to establish a communication link between machines over
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    76
 *    the network. The java.net package provides 4 kinds of Sockets:</p>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    77
 * <ul>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    78
 *       <li>{@link java.net.Socket} is a TCP client API, and will typically
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    79
 *            be used to {@linkplain java.net.Socket#connect(SocketAddress)
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    80
 *            connect} to a remote host.</li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    81
 *       <li>{@link java.net.ServerSocket} is a TCP server API, and will
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    82
 *            typically {@linkplain java.net.ServerSocket#accept accept}
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    83
 *            connections from client sockets.</li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    84
 *       <li>{@link java.net.DatagramSocket} is a UDP endpoint API and is used
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    85
 *            to {@linkplain java.net.DatagramSocket#send send} and
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    86
 *            {@linkplain java.net.DatagramSocket#receive receive}
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    87
 *            {@linkplain java.net.DatagramPacket datagram packets}.</li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    88
 *       <li>{@link java.net.MulticastSocket} is a subclass of
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    89
 *            {@code DatagramSocket} used when dealing with multicast
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    90
 *            groups.</li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    91
 * </ul>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    92
 * <p>Sending and receiving with TCP sockets is done through InputStreams and
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    93
 *    OutputStreams which can be obtained via the
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    94
 *    {@link java.net.Socket#getInputStream} and
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    95
 *    {@link java.net.Socket#getOutputStream} methods.</p>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    96
 * <h2>Interfaces</h2>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    97
 * <p>The {@link java.net.NetworkInterface} class provides APIs to browse and
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    98
 *    query all the networking interfaces (e.g. ethernet connection or PPP
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
    99
 *    endpoint) of the local machine. It is through that class that you can
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   100
 *    check if any of the local interfaces is configured to support IPv6.</p>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   101
 * <p>Note, all conforming implementations must support at least one
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   102
 *    {@code NetworkInterface} object, which must either be connected to a
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   103
 *    network, or be a "loopback" interface that can only communicate with
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   104
 *    entities on the same machine.</p>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   105
 *
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   106
 * <h2>High level API</h2>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   107
 * <p>A number of classes in the java.net package do provide for a much higher
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   108
 *    level of abstraction and allow for easy access to resources on the
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   109
 *    network. The classes are:
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   110
 * <ul>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   111
 *       <li>{@link java.net.URI} is the class representing a
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   112
 *            Universal Resource Identifier, as specified in RFC 2396.
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   113
 *            As the name indicates, this is just an Identifier and doesn't
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   114
 *            provide directly the means to access the resource.</li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   115
 *       <li>{@link java.net.URL} is the class representing a
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   116
 *            Universal Resource Locator, which is both an older concept for
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   117
 *            URIs and a means to access the resources.</li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   118
 *       <li>{@link java.net.URLConnection} is created from a URL and is the
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   119
 *            communication link used to access the resource pointed by the
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   120
 *            URL. This abstract class will delegate most of the work to the
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   121
 *            underlying protocol handlers like http or https.</li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   122
 *       <li>{@link java.net.HttpURLConnection} is a subclass of URLConnection
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   123
 *            and provides some additional functionalities specific to the
49765
ee6f7a61f3a5 8197564: HTTP Client implementation
chegar
parents: 47216
diff changeset
   124
 *            HTTP protocol. This API has been superseded by the newer
ee6f7a61f3a5 8197564: HTTP Client implementation
chegar
parents: 47216
diff changeset
   125
 *            {@linkplain java.net.http HTTP Client API}.</li>
19069
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   126
 * </ul>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   127
 * <p>The recommended usage is to use {@link java.net.URI} to identify
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   128
 *    resources, then convert it into a {@link java.net.URL} when it is time to
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   129
 *    access the resource. From that URL, you can either get the
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   130
 *    {@link java.net.URLConnection} for fine control, or get directly the
21334
c60dfce46a77 8026982: javadoc errors in core libs
rriggs
parents: 19069
diff changeset
   131
 *    InputStream.
19069
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   132
 * <p>Here is an example:</p>
21334
c60dfce46a77 8026982: javadoc errors in core libs
rriggs
parents: 19069
diff changeset
   133
 * <pre>
52700
b206bdfb9fe2 8213911: Use example.com in java.net and other examples
darcy
parents: 49765
diff changeset
   134
 * URI uri = new URI("http://www.example.com/");
19069
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   135
 * URL url = uri.toURL();
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   136
 * InputStream in = url.openStream();
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   137
 * </pre>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   138
 * <h2>Protocol Handlers</h2>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   139
 * As mentioned, URL and URLConnection rely on protocol handlers which must be
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   140
 * present, otherwise an Exception is thrown. This is the major difference with
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   141
 * URIs which only identify resources, and therefore don't need to have access
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   142
 * to the protocol handler. So, while it is possible to create an URI with any
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   143
 * kind of protocol scheme (e.g. {@code myproto://myhost.mydomain/resource/}),
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   144
 * a similar URL will try to instantiate the handler for the specified protocol;
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   145
 * if it doesn't exist an exception will be thrown.
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   146
 * <p>By default the protocol handlers are loaded dynamically from the default
29097
01a70c01f5a1 8064924: Update java.net.URL to work with modules
chegar
parents: 25859
diff changeset
   147
 *    location. It is, however, possible to deploy additional protocols handlers
01a70c01f5a1 8064924: Update java.net.URL to work with modules
chegar
parents: 25859
diff changeset
   148
 *    as {@link java.util.ServiceLoader services}. Service providers of type
01a70c01f5a1 8064924: Update java.net.URL to work with modules
chegar
parents: 25859
diff changeset
   149
 *    {@linkplain java.net.spi.URLStreamHandlerProvider} are located at
01a70c01f5a1 8064924: Update java.net.URL to work with modules
chegar
parents: 25859
diff changeset
   150
 *    runtime, as specified in the {@linkplain
01a70c01f5a1 8064924: Update java.net.URL to work with modules
chegar
parents: 25859
diff changeset
   151
 *    java.net.URL#URL(String,String,int,String) URL constructor}.
19069
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   152
 * <h2>Additional Specification</h2>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   153
 * <ul>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   154
 *       <li><a href="doc-files/net-properties.html">
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   155
 *            Networking System Properties</a></li>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   156
 * </ul>
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   157
 *
24865
09b1d992ca72 8044740: Convert all JDK versions used in @since tag to 1.n[.n] in jdk repo
henryjen
parents: 21334
diff changeset
   158
 * @since 1.0
19069
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   159
 */
1d9cb0d080e3 8021833: javadoc cleanup in java.net
juh
parents: 14342
diff changeset
   160
package java.net;