001: /*
002: License $Id: URLHelper.java,v 1.6 2005/03/15 21:47:12 hendriks73 Exp $
003:
004: Copyright (c) 2001-2005 tagtraum industries.
005:
006: LGPL
007: ====
008:
009: jo! is free software; you can redistribute it and/or
010: modify it under the terms of the GNU Lesser General Public
011: License as published by the Free Software Foundation; either
012: version 2.1 of the License, or (at your option) any later version.
013:
014: jo! is distributed in the hope that it will be useful,
015: but WITHOUT ANY WARRANTY; without even the implied warranty of
016: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
017: Lesser General Public License for more details.
018:
019: You should have received a copy of the GNU Lesser General Public
020: License along with this library; if not, write to the Free Software
021: Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
022:
023: For LGPL see <http://www.fsf.org/copyleft/lesser.txt>
024:
025:
026: Sun license
027: ===========
028:
029: This release contains software by Sun Microsystems. Therefore
030: the following conditions have to be met, too. They apply to the
031: files
032:
033: - lib/mail.jar
034: - lib/activation.jar
035: - lib/jsse.jar
036: - lib/jcert.jar
037: - lib/jaxp.jar
038: - lib/crimson.jar
039: - lib/servlet.jar
040: - lib/jnet.jar
041: - lib/jaas.jar
042: - lib/jaasmod.jar
043:
044: contained in this release.
045:
046: a. Licensee may not modify the Java Platform
047: Interface (JPI, identified as classes contained within the javax
048: package or any subpackages of the javax package), by creating additional
049: classes within the JPI or otherwise causing the addition to or modification
050: of the classes in the JPI. In the event that Licensee creates any
051: Java-related API and distribute such API to others for applet or
052: application development, you must promptly publish broadly, an accurate
053: specification for such API for free use by all developers of Java-based
054: software.
055:
056: b. Software is confidential copyrighted information of Sun and
057: title to all copies is retained by Sun and/or its licensors. Licensee
058: shall not modify, decompile, disassemble, decrypt, extract, or otherwise
059: reverse engineer Software. Software may not be leased, assigned, or
060: sublicensed, in whole or in part. Software is not designed or intended
061: for use in on-line control of aircraft, air traffic, aircraft navigation
062: or aircraft communications; or in the design, construction, operation or
063: maintenance of any nuclear facility. Licensee warrants that it will not
064: use or redistribute the Software for such purposes.
065:
066: c. Software is provided "AS IS," without a warranty
067: of any kind. ALL EXPRESS OR IMPLIED REPRESENTATIONS AND WARRANTIES,
068: INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
069: PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED.
070:
071: d. This License is effective until terminated. Licensee may
072: terminate this License at any time by destroying all copies of Software.
073: This License will terminate immediately without notice from Sun if Licensee
074: fails to comply with any provision of this License. Upon such termination,
075: Licensee must destroy all copies of Software.
076:
077: e. Software, including technical data, is subject to U.S.
078: export control laws, including the U.S. Export Administration Act and its
079: associated regulations, and may be subject to export or import regulations
080: in other countries. Licensee agrees to comply strictly with all such
081: regulations and acknowledges that it has the responsibility to obtain
082: licenses to export, re-export, or import Software. Software may not be
083: downloaded, or otherwise exported or re-exported (i) into, or to a national
084: or resident of, Cuba, Iraq, Iran, North Korea, Libya, Sudan, Syria or any
085: country to which the U.S. has embargoed goods; or (ii) to anyone on the
086: U.S. Treasury Department's list of Specially Designated Nations or the U.S.
087: Commerce Department's Table of Denial Orders.
088:
089:
090: Feedback
091: ========
092:
093: We encourage your feedback and suggestions and want to use your feedback to
094: improve the Software. Send all such feedback to:
095: <feedback@tagtraum.com>
096:
097: For more information on tagtraum industries and jo!
098: please see <http://www.tagtraum.com/>.
099:
100:
101: */
102: package com.tagtraum.framework.util;
103:
104: import java.net.MalformedURLException;
105: import java.net.URL;
106:
107: /**
108: * Helpermethods for URL-Handling.
109: *
110: * TODO: Translate comments to English!
111: *
112: * @author Hendrik Schreiber
113: * @version 1.1beta1 $Id: URLHelper.java,v 1.6 2005/03/15 21:47:12 hendriks73 Exp $
114: */
115: public final class URLHelper {
116:
117: /**
118: * Source-Version
119: */
120: public static String vcid = "$Id: URLHelper.java,v 1.6 2005/03/15 21:47:12 hendriks73 Exp $";
121:
122: /**
123: * Translates a String to A URL. If no protocol is given,
124: * <code>file:</code> is used.
125: *
126: * @param aDirtyURL zu transformierender String
127: * @return sauberer URL
128: * @exception MalformedURLException falls der String nicht
129: * wohlgeformt war.
130: */
131: public final static URL make(String aDirtyURL)
132: throws MalformedURLException {
133: return make(null, aDirtyURL);
134: }
135:
136: /**
137: * Translates a String to A URL. If no protocol is given,
138: * <code>file:</code> is used.
139: *
140: * @param aBaseURL Basis-URL
141: * @param aDirtyURL zu transformierender String
142: * @return sauberer URL
143: * @exception MalformedURLException falls der String nicht
144: * wohlgeformt war.
145: */
146: public final static URL make(URL aBaseURL, String aDirtyURL)
147: throws MalformedURLException {
148: // FIXME!! Was passiert bei QueryStrings, die '\\' enthalten? (rik)
149: // what happens when aDirtyURL == null?
150: URL theURL = null;
151:
152: if (aDirtyURL != null) {
153: aDirtyURL = aDirtyURL.replace('\\', '/');
154: }
155:
156: try {
157: theURL = new URL(aBaseURL, aDirtyURL);
158: } catch (MalformedURLException mue) {
159: StringBuffer sb = new StringBuffer("file:");
160:
161: if (!aDirtyURL.startsWith("/")
162: && !aDirtyURL.startsWith("\\")
163: && aDirtyURL.indexOf(":") != 1) {
164: sb.append(System.getProperty("user.dir").replace('\\',
165: '/'));
166: sb.append('/');
167: }
168:
169: sb.append(aDirtyURL);
170:
171: theURL = new URL(PlatformHelper.removeDoubleDots(sb
172: .toString(), '/'));
173: }
174:
175: return theURL;
176: }
177:
178: /**
179: * Returns an URL pointing at a jar file if the URL points at a file, i.e.
180: * does not end with slash.
181: */
182: public static final URL makeJarURL(URL aURL, String aFile)
183: throws MalformedURLException {
184: if (!aURL.getFile().endsWith("/")
185: && !aURL.getProtocol().startsWith("jar")) {
186: return new URL("jar:" + aURL + "!/" + aFile);
187: }
188:
189: return new URL(aURL, aFile);
190: }
191:
192: /**
193: * Returns an URL pointing at a jar file if the URL points at a file, i.e.
194: * does not end with slash.
195: */
196: public static final URL makeJarURL(URL aURL)
197: throws MalformedURLException {
198: return makeJarURL(aURL, "");
199: }
200:
201: /**
202: * Returns the filenhame. Makes sure we don't get filenames like /d:/somefile, but d:/somefile.
203: */
204: public static final String getFile(URL aURL) {
205: String file = null;
206: try {
207: file = URLDecoder.decode(aURL.getFile());
208: } catch (Exception e) {
209: file = aURL.getFile();
210: }
211: if (aURL.getProtocol().equals("file") && file.indexOf(':') == 2) {
212: return file.substring(1);
213: }
214: return file;
215: }
216:
217: /**
218: * Replaces all spaces in the URL with %20.
219: *
220: * @param url URL to encode
221: * @return URL with %20 instead of spaces
222: * @throws MalformedURLException if the encoded URL becomes invalid for some reason.
223: */
224: public static URL encodeSpaces(URL url)
225: throws MalformedURLException {
226: // Java 5 version of the same thing
227: //return new URL(url.toString().replace(" ", "%20"));
228: return new URL(StringHelper.replace(url.toString(), " ", "%20"));
229: }
230: }
|