RFR 8215008: Clear confusion between URL/URI paths and file system paths

[Alan Bateman]

On 07/12/2018 15:13, Daniel Fuchs wrote:
> Hi,
>
> Please find below a fix for
> 8215008: Clear confusion between URL/URI paths and file system paths
> https://bugs.openjdk.java.net/browse/JDK-8215008
>
> It adds a small non normative @apiNote to java.net.URL and java.net.URI.
>
> http://cr.openjdk.java.net/~dfuchs/webrev_8215008/webrev.00/
I've come across dozens of cases where code has been trying to use a URL 
path as a file path so an API note is a good idea. On the wording then 
"there is not necessarily any direct relationship ..." is a bit 
confusing to read, at least for file URIs where the file path is encoded 
as a URI. I also think it would be useful to link to the APIs that do 
the encoding/decoding, as in File(URI), File::toURI, Path.of(URI), 
Path::toUri.

-Alan