/*******************************************************************************
 * Copyright (c) 2004 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.wst.command.internal.provisional.env.core.uri;

import java.net.URL;

/**
 * This is a factory for creating new URI and URIScheme objects.
 */
public interface URIFactory
{
  /**
   * Creates and returns a new URI for the given string.
   */
  public URI newURI ( String uri ) throws URIException;

  /**
   * Creates and returns a new URI for the given URL.
   */
  public URI newURI ( URL url ) throws URIException;

  /**
   * Creates and returns a new URIScheme for the given scheme string.
   * If the string contains no colons, the entire string is interpretted
   * as the name of the scheme. If the string contains a colon, then the
   * substring up to but excluding the first colon is interpretted as the
   * name of the scheme, meaning the caller can pass in any URI string in
   * order to get a URIScheme object.
   */
  public URIScheme newURIScheme ( String schemeOrURI ) throws URIException;
}