bundles/org.eclipse.equinox.simpleconfigurator/src/org/eclipse/equinox/internal/simpleconfigurator/utils/URIUtil.java - equinox/rt.equinox.p2 - Git at Google

 /*******************************************************************************
  * Copyright (c) 2008, 2009 IBM Corporation and others. All rights reserved.
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
  * and is available at http://www.eclipse.org/legal/epl-v10.html
  *
  * Contributors: IBM Corporation - initial API and implementation
  *******************************************************************************/
 package org.eclipse.equinox.internal.simpleconfigurator.utils;

 import java.io.File;
 import java.net.*;

 /**
  * This class copies various methods from the URIUtil class in
  * org.eclipse.equinox.common. Unless otherwise noted the implementations here
  * should mirror those in the common implementation.
  */
 public class URIUtil {

 	private static final String SCHEME_FILE = "file"; //$NON-NLS-1$
 	private static final String UNC_PREFIX = "//"; //$NON-NLS-1$

 	/**
 	 * Appends the given extension to the path of the give base URI and returns
 	 * the corresponding new path.
 	 * @param base The base URI to append to
 	 * @param extension The path extension to be added
 	 * @return The appended URI
 	 */
 	public static URI append(URI base, String extension) {
 		try {
 			String path = base.getPath();
 			if (path == null)
 				return appendOpaque(base, extension);
 			//if the base is already a directory then resolve will just do the right thing
 			if (path.endsWith("/")) {//$NON-NLS-1$
 				URI result = base.resolve(extension);
 				//Fix UNC paths that are incorrectly normalized by URI#resolve (see Java bug 4723726)
 				String resultPath = result.getPath();
 				if (path.startsWith(UNC_PREFIX) && (resultPath == null || !resultPath.startsWith(UNC_PREFIX)))
 					result = new URI(result.getScheme(), "///" + result.getSchemeSpecificPart(), result.getFragment()); //$NON-NLS-1$
 				return result;
 			}
 			path = path + "/" + extension; //$NON-NLS-1$
 			return new URI(base.getScheme(), base.getUserInfo(), base.getHost(), base.getPort(), path, base.getQuery(), base.getFragment());
 		} catch (URISyntaxException e) {
 			//shouldn't happen because we started from a valid URI
 			throw new RuntimeException(e);
 		}
 	}

 	/**
 	 * Special case of appending to an opaque URI. Since opaque URIs
 	 * have no path segment the best we can do is append to the scheme-specific part
 	 */
 	private static URI appendOpaque(URI base, String extension) throws URISyntaxException {
 		String ssp = base.getSchemeSpecificPart();
 		if (ssp.endsWith("/")) //$NON-NLS-1$
 			ssp += extension;
 		else
 			ssp = ssp + "/" + extension; //$NON-NLS-1$
 		return new URI(base.getScheme(), ssp, base.getFragment());
 	}

 	/**
 	 * Returns a URI corresponding to the given unencoded string.
 	 * @throws URISyntaxException If the string cannot be formed into a valid URI
 	 */
 	public static URI fromString(String uriString) throws URISyntaxException {
 		int colon = uriString.indexOf(':');
 		int hash = uriString.lastIndexOf('#');
 		boolean noHash = hash < 0;
 		if (noHash)
 			hash = uriString.length();
 		String scheme = colon < 0 ? null : uriString.substring(0, colon);
 		String ssp = uriString.substring(colon + 1, hash);
 		String fragment = noHash ? null : uriString.substring(hash + 1);
 		//use java.io.File for constructing file: URIs
 		if (scheme != null && scheme.equals(SCHEME_FILE)) {
 			File file = new File(uriString.substring(5));
 			if (file.isAbsolute())
 				return file.toURI();
 			scheme = null;
 			if (File.separatorChar != '/')
 				ssp = ssp.replace(File.separatorChar, '/');
 		}
 		return new URI(scheme, ssp, fragment);
 	}

 	/*
 	 * Compares two URI for equality.
 	 * Return false if one of them is null
 	 */
 	public static boolean sameURI(URI url1, URI url2) {
 		if (url1 == url2)
 			return true;
 		if (url1 == null || url2 == null)
 			return false;
 		if (url1.equals(url2))
 			return true;

 		if (url1.isAbsolute() != url2.isAbsolute())
 			return false;

 		// check if we have two local file references that are case variants
 		File file1 = toFile(url1);
 		return file1 == null ? false : file1.equals(toFile(url2));
 	}

 	/**
 	 * Returns the URI as a local file, or <code>null</code> if the given
 	 * URI does not represent a local file.
 	 * @param uri The URI to return the file for
 	 * @return The local file corresponding to the given URI, or <code>null</code>
 	 */
 	public static File toFile(URI uri) {
 		try {
 			if (!SCHEME_FILE.equalsIgnoreCase(uri.getScheme()))
 				return null;
 			//assume all illegal characters have been properly encoded, so use URI class to unencode
 			return new File(uri);
 		} catch (IllegalArgumentException e) {
 			//File constructor does not support non-hierarchical URI
 			String path = uri.getPath();
 			//path is null for non-hierarchical URI such as file:c:/tmp
 			if (path == null)
 				path = uri.getSchemeSpecificPart();
 			return new File(path);
 		}
 	}

 	/**
 	 * Returns a string representation of the given URI that doesn't have illegal
 	 * characters encoded. This string is suitable for later passing to {@link #fromString(String)}.
 	 * @param uri The URI to convert to string format
 	 * @return An unencoded string representation of the URI
 	 */
 	public static String toUnencodedString(URI uri) {
 		StringBuffer result = new StringBuffer();
 		String scheme = uri.getScheme();
 		if (scheme != null)
 			result.append(scheme).append(':');
 		//there is always a ssp
 		result.append(uri.getSchemeSpecificPart());
 		String fragment = uri.getFragment();
 		if (fragment != null)
 			result.append('#').append(fragment);
 		return result.toString();
 	}

 	/**
 	 * Returns the URL as a URI. This method will handle broken URLs that are
 	 * not properly encoded (for example they contain unencoded space characters).
 	 */
 	public static URI toURI(URL url) throws URISyntaxException {
 		//URL behaves differently across platforms so for file: URLs we parse from string form
 		if (SCHEME_FILE.equals(url.getProtocol())) {
 			String pathString = url.toExternalForm().substring(5);
 			//ensure there is a leading slash to handle common malformed URLs such as file:c:/tmp
 			if (pathString.indexOf('/') != 0)
 				pathString = '/' + pathString;
 			else if (pathString.startsWith(UNC_PREFIX) && !pathString.startsWith(UNC_PREFIX, 2)) {
 				//URL encodes UNC path with two slashes, but URI uses four (see bug 207103)
 				pathString = UNC_PREFIX + pathString;
 			}
 			return new URI(SCHEME_FILE, pathString, null);
 		}
 		try {
 			return new URI(url.toExternalForm());
 		} catch (URISyntaxException e) {
 			//try multi-argument URI constructor to perform encoding
 			return new URI(url.getProtocol(), url.getUserInfo(), url.getHost(), url.getPort(), url.getPath(), url.getQuery(), url.getRef());
 		}
 	}

 	/**
 	 * Returns a URI as a URL.
 	 *
 	 * @throws MalformedURLException
 	 */
 	public static URL toURL(URI uri) throws MalformedURLException {
 		return new URL(uri.toString());
 	}
 }
	/*******************************************************************************
	* Copyright (c) 2008, 2009 IBM Corporation and others. All rights reserved.
	* This program and the accompanying materials are made available under the
	* terms of the Eclipse Public License v1.0 which accompanies this distribution,
	* and is available at http://www.eclipse.org/legal/epl-v10.html
	*
	* Contributors: IBM Corporation - initial API and implementation
	*******************************************************************************/
	package org.eclipse.equinox.internal.simpleconfigurator.utils;

	import java.io.File;
	import java.net.*;

	/**
	* This class copies various methods from the URIUtil class in
	* org.eclipse.equinox.common. Unless otherwise noted the implementations here
	* should mirror those in the common implementation.
	*/
	public class URIUtil {

	private static final String SCHEME_FILE = "file"; //$NON-NLS-1$
	private static final String UNC_PREFIX = "//"; //$NON-NLS-1$

	/**
	* Appends the given extension to the path of the give base URI and returns
	* the corresponding new path.
	* @param base The base URI to append to
	* @param extension The path extension to be added
	* @return The appended URI
	*/
	public static URI append(URI base, String extension) {
	try {
	String path = base.getPath();
	if (path == null)
	return appendOpaque(base, extension);
	//if the base is already a directory then resolve will just do the right thing
	if (path.endsWith("/")) {//$NON-NLS-1$
	URI result = base.resolve(extension);
	//Fix UNC paths that are incorrectly normalized by URI#resolve (see Java bug 4723726)
	String resultPath = result.getPath();
	if (path.startsWith(UNC_PREFIX) && (resultPath == null \|\| !resultPath.startsWith(UNC_PREFIX)))
	result = new URI(result.getScheme(), "///" + result.getSchemeSpecificPart(), result.getFragment()); //$NON-NLS-1$
	return result;
	}
	path = path + "/" + extension; //$NON-NLS-1$
	return new URI(base.getScheme(), base.getUserInfo(), base.getHost(), base.getPort(), path, base.getQuery(), base.getFragment());
	} catch (URISyntaxException e) {
	//shouldn't happen because we started from a valid URI
	throw new RuntimeException(e);
	}
	}

	/**
	* Special case of appending to an opaque URI. Since opaque URIs
	* have no path segment the best we can do is append to the scheme-specific part
	*/
	private static URI appendOpaque(URI base, String extension) throws URISyntaxException {
	String ssp = base.getSchemeSpecificPart();
	if (ssp.endsWith("/")) //$NON-NLS-1$
	ssp += extension;
	else
	ssp = ssp + "/" + extension; //$NON-NLS-1$
	return new URI(base.getScheme(), ssp, base.getFragment());
	}

	/**
	* Returns a URI corresponding to the given unencoded string.
	* @throws URISyntaxException If the string cannot be formed into a valid URI
	*/
	public static URI fromString(String uriString) throws URISyntaxException {
	int colon = uriString.indexOf(':');
	int hash = uriString.lastIndexOf('#');
	boolean noHash = hash < 0;
	if (noHash)
	hash = uriString.length();
	String scheme = colon < 0 ? null : uriString.substring(0, colon);
	String ssp = uriString.substring(colon + 1, hash);
	String fragment = noHash ? null : uriString.substring(hash + 1);
	//use java.io.File for constructing file: URIs
	if (scheme != null && scheme.equals(SCHEME_FILE)) {
	File file = new File(uriString.substring(5));
	if (file.isAbsolute())
	return file.toURI();
	scheme = null;
	if (File.separatorChar != '/')
	ssp = ssp.replace(File.separatorChar, '/');
	}
	return new URI(scheme, ssp, fragment);
	}

	/*
	* Compares two URI for equality.
	* Return false if one of them is null
	*/
	public static boolean sameURI(URI url1, URI url2) {
	if (url1 == url2)
	return true;
	if (url1 == null \|\| url2 == null)
	return false;
	if (url1.equals(url2))
	return true;

	if (url1.isAbsolute() != url2.isAbsolute())
	return false;

	// check if we have two local file references that are case variants
	File file1 = toFile(url1);
	return file1 == null ? false : file1.equals(toFile(url2));
	}

	/**
	* Returns the URI as a local file, or <code>null</code> if the given
	* URI does not represent a local file.
	* @param uri The URI to return the file for
	* @return The local file corresponding to the given URI, or <code>null</code>
	*/
	public static File toFile(URI uri) {
	try {
	if (!SCHEME_FILE.equalsIgnoreCase(uri.getScheme()))
	return null;
	//assume all illegal characters have been properly encoded, so use URI class to unencode
	return new File(uri);
	} catch (IllegalArgumentException e) {
	//File constructor does not support non-hierarchical URI
	String path = uri.getPath();
	//path is null for non-hierarchical URI such as file:c:/tmp
	if (path == null)
	path = uri.getSchemeSpecificPart();
	return new File(path);
	}
	}

	/**
	* Returns a string representation of the given URI that doesn't have illegal
	* characters encoded. This string is suitable for later passing to {@link #fromString(String)}.
	* @param uri The URI to convert to string format
	* @return An unencoded string representation of the URI
	*/
	public static String toUnencodedString(URI uri) {
	StringBuffer result = new StringBuffer();
	String scheme = uri.getScheme();
	if (scheme != null)
	result.append(scheme).append(':');
	//there is always a ssp
	result.append(uri.getSchemeSpecificPart());
	String fragment = uri.getFragment();
	if (fragment != null)
	result.append('#').append(fragment);
	return result.toString();
	}

	/**
	* Returns the URL as a URI. This method will handle broken URLs that are
	* not properly encoded (for example they contain unencoded space characters).
	*/
	public static URI toURI(URL url) throws URISyntaxException {
	//URL behaves differently across platforms so for file: URLs we parse from string form
	if (SCHEME_FILE.equals(url.getProtocol())) {
	String pathString = url.toExternalForm().substring(5);
	//ensure there is a leading slash to handle common malformed URLs such as file:c:/tmp
	if (pathString.indexOf('/') != 0)
	pathString = '/' + pathString;
	else if (pathString.startsWith(UNC_PREFIX) && !pathString.startsWith(UNC_PREFIX, 2)) {
	//URL encodes UNC path with two slashes, but URI uses four (see bug 207103)
	pathString = UNC_PREFIX + pathString;
	}
	return new URI(SCHEME_FILE, pathString, null);
	}
	try {
	return new URI(url.toExternalForm());
	} catch (URISyntaxException e) {
	//try multi-argument URI constructor to perform encoding
	return new URI(url.getProtocol(), url.getUserInfo(), url.getHost(), url.getPort(), url.getPath(), url.getQuery(), url.getRef());
	}
	}

	/**
	* Returns a URI as a URL.
	*
	* @throws MalformedURLException
	*/
	public static URL toURL(URI uri) throws MalformedURLException {
	return new URL(uri.toString());
	}
	}