jdillon 2003/09/03 06:49:06
Added: modules/common/src/java/org/apache/geronimo/common/net
URLFactory.java
Log:
o moved URL bits to seperate class, cleaning up cruft
Revision Changes Path
1.1
incubator-geronimo/modules/common/src/java/org/apache/geronimo/common/net/URLFactory.java
Index: URLFactory.java
===================================================================
/* ====================================================================
* The Apache Software License, Version 1.1
*
* Copyright (c) 2003 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The end-user documentation included with the redistribution,
* if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
*
* 4. The names "Apache" and "Apache Software Foundation" and
* "Apache Geronimo" must not be used to endorse or promote products
* derived from this software without prior written permission. For
* written permission, please contact [EMAIL PROTECTED]
*
* 5. Products derived from this software may not be called "Apache",
* "Apache Geronimo", nor may "Apache" appear in their name, without
* prior written permission of the Apache Software Foundation.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation. For more
* information on the Apache Software Foundation, please see
* <http://www.apache.org/>.
*
* ====================================================================
*/
package org.apache.geronimo.common.net;
import java.net.URL;
import java.net.MalformedURLException;
import java.io.IOException;
import java.io.File;
import org.apache.geronimo.common.NullArgumentException;
/**
* A helper for creating URL instances.
*
* @version $Revision: 1.1 $ $Date: 2003/09/03 13:49:06 $
*/
public class URLFactory
{
/**
* Make a URL from the given string.
*
* <p>If the string is an invalid URL then it will be converted into a
* file URL.
*
* @param urlspec The string to construct a URL for.
* @param relativePrefix The string to prepend to relative file
* paths, or null to disable prepending.
* @return A URL for the given string.
*
* @throws MalformedURLException Could not make a URL for the given
string.
*/
public static URL create(String urlspec, final String relativePrefix)
throws MalformedURLException
{
if (urlspec == null) {
throw new NullArgumentException("urlspec");
}
urlspec = urlspec.trim();
URL url;
try {
url = new URL(urlspec);
if (url.getProtocol().equals("file")) {
url = createFromFilespec(url.getFile(), relativePrefix);
}
}
catch (Exception e) {
url = createFromFilespec(urlspec, relativePrefix);
}
return url;
}
/**
* Make a URL from the given string.
*
* @see #create(String,String)
*
* @param urlspec The string to construct a URL for.
* @return A URL for the given string.
*
* @throws MalformedURLException Could not make a URL for the given
string.
*/
public static URL create(final String urlspec) throws
MalformedURLException
{
return create(urlspec, null);
}
public static URL createFromFilespec(final String filespec, final String
relativePrefix)
throws MalformedURLException
{
// make sure the file is absolute
File file = new File(filespec);
// if we have a prefix and the file is not abs then prepend
if (relativePrefix != null && !file.isAbsolute()) {
file = new File(relativePrefix, filespec);
}
return create(file);
}
public static URL create(final File file)
throws MalformedURLException
{
return file.toURI().toURL();
}
}
