/*
* Copyright (c) 2008, 2020, 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
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package sun.nio.fs;
import java.net.URI;
import java.net.URISyntaxException;
Utility methods to convert between Path and URIs.
/**
* Utility methods to convert between Path and URIs.
*/
class WindowsUriSupport {
private WindowsUriSupport() {
}
// suffix for IPv6 literal address
private static final String IPV6_LITERAL_SUFFIX = ".ipv6-literal.net";
Returns URI to represent the given (absolute) path
/**
* Returns URI to represent the given (absolute) path
*/
private static URI toUri(String path, boolean isUnc, boolean addSlash) {
String uriHost;
String uriPath;
if (isUnc) {
int slash = path.indexOf('\\', 2);
uriHost = path.substring(2, slash);
uriPath = path.substring(slash).replace('\\', '/');
// handle IPv6 literal addresses
// 1. drop .ivp6-literal.net
// 2. replace "-" with ":"
// 3. replace "s" with "%" (zone/scopeID delimiter)
if (uriHost.endsWith(IPV6_LITERAL_SUFFIX)) {
uriHost = uriHost
.substring(0, uriHost.length() - IPV6_LITERAL_SUFFIX.length())
.replace('-', ':')
.replace('s', '%');
}
} else {
uriHost = "";
uriPath = "/" + path.replace('\\', '/');
}
// append slash if known to be directory
if (addSlash)
uriPath += "/";
// return file:///C:/My%20Documents or file://server/share/foo
try {
return new URI("file", uriHost, uriPath, null);
} catch (URISyntaxException x) {
if (!isUnc)
throw new AssertionError(x);
}
// if we get here it means we've got a UNC with reserved characters
// in the server name. The authority component cannot contain escaped
// octets so fallback to encoding the server name into the URI path
// component.
uriPath = "//" + path.replace('\\', '/');
if (addSlash)
uriPath += "/";
try {
return new URI("file", null, uriPath, null);
} catch (URISyntaxException x) {
throw new AssertionError(x);
}
}
Converts given Path to a URI
/**
* Converts given Path to a URI
*/
static URI toUri(WindowsPath path) {
path = path.toAbsolutePath();
String s = path.toString();
// trailing slash will be added if file is a directory. Skip check if
// already have trailing space
boolean addSlash = false;
if (!s.endsWith("\\")) {
try {
path.checkRead();
addSlash = WindowsFileAttributes.get(path, true).isDirectory();
} catch (SecurityException | WindowsException x) {
}
}
return toUri(s, path.isUnc(), addSlash);
}
Converts given URI to a Path
/**
* Converts given URI to a Path
*/
static WindowsPath fromUri(WindowsFileSystem fs, URI uri) {
if (!uri.isAbsolute())
throw new IllegalArgumentException("URI is not absolute");
if (uri.isOpaque())
throw new IllegalArgumentException("URI is not hierarchical");
String scheme = uri.getScheme();
if ((scheme == null) || !scheme.equalsIgnoreCase("file"))
throw new IllegalArgumentException("URI scheme is not \"file\"");
if (uri.getRawFragment() != null)
throw new IllegalArgumentException("URI has a fragment component");
if (uri.getRawQuery() != null)
throw new IllegalArgumentException("URI has a query component");
String path = uri.getPath();
if (path.isEmpty())
throw new IllegalArgumentException("URI path component is empty");
// UNC
String auth = uri.getRawAuthority();
if (auth != null && !auth.isEmpty()) {
String host = uri.getHost();
if (host == null)
throw new IllegalArgumentException("URI authority component has undefined host");
if (uri.getUserInfo() != null)
throw new IllegalArgumentException("URI authority component has user-info");
if (uri.getPort() != -1)
throw new IllegalArgumentException("URI authority component has port number");
// IPv6 literal
// 1. drop enclosing brackets
// 2. replace ":" with "-"
// 3. replace "%" with "s" (zone/scopeID delimiter)
// 4. Append .ivp6-literal.net
if (host.startsWith("[")) {
host = host.substring(1, host.length()-1)
.replace(':', '-')
.replace('%', 's');
host += IPV6_LITERAL_SUFFIX;
}
// reconstitute the UNC
path = "\\\\" + host + path;
} else {
if ((path.length() > 2) && (path.charAt(2) == ':')) {
// "/c:/foo" --> "c:/foo"
path = path.substring(1);
}
}
return WindowsPath.parse(fs, path);
}
}