FileDocCategorySizeDatePackage
Handler.javaAPI DocAndroid 1.5 API3849Wed May 06 22:41:04 BST 2009org.apache.harmony.luni.internal.net.www.protocol.jar

Handler.java

/*
 *  Licensed to the Apache Software Foundation (ASF) under one or more
 *  contributor license agreements.  See the NOTICE file distributed with
 *  this work for additional information regarding copyright ownership.
 *  The ASF licenses this file to You under the Apache License, Version 2.0
 *  (the "License"); you may not use this file except in compliance with
 *  the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */

package org.apache.harmony.luni.internal.net.www.protocol.jar;

import java.io.IOException;
import java.net.MalformedURLException;
import java.net.URL;
import java.net.URLConnection;
import java.net.URLStreamHandler;

import org.apache.harmony.luni.util.Msg;
import org.apache.harmony.luni.util.URLUtil;

public class Handler extends URLStreamHandler {
    /**
     * Returns a connection to the jar file pointed by this <code>URL</code>
     * in the file system
     * 
     * @return java.net.URLConnection A connection to the resource pointed by
     *         this url.
     * @param u
     *            java.net.URL The URL to which the connection is pointing to
     * 
     * @thows IOException thrown if an IO error occurs when this method tries to
     *        establish connection.
     */
    @Override
    protected URLConnection openConnection(URL u) throws IOException {
        return new JarURLConnection(u);
    }

    /**
     * 
     * @param url
     *            URL the context URL
     * @param spec
     *            java.lang.String the spec string
     * @param start
     *            int the location to start parsing from
     * @param limit
     *            int the location where parsing ends
     */
    @Override
    protected void parseURL(URL url, String spec, int start, int limit) {
        String file = url.getFile();
        if (file == null) {
            file = ""; //$NON-NLS-1$
        }
        if (limit > start) {
            spec = spec.substring(start, limit);
        } else {
            spec = ""; //$NON-NLS-1$
        }
        if (spec.indexOf("!/") == -1 && (file.indexOf("!/") == -1)) { //$NON-NLS-1$ //$NON-NLS-2$
            throw new NullPointerException(Msg.getString("K01b6")); //$NON-NLS-1$
        }
        if (file.equals("")) {
            file = spec;
        } else if (spec.charAt(0) == '/') {
            file = file.substring(0, file.indexOf('!') + 1) + spec;
        } else {
            int idx = file.indexOf('!');
            String tmpFile = file.substring(idx + 1, file.lastIndexOf('/') + 1) + spec;
            tmpFile = URLUtil.canonicalizePath(tmpFile);
            file = file.substring(0, idx + 1) + tmpFile;
        }
        try {
            // check that the embedded url is valid
            new URL(file);
        } catch (MalformedURLException e) {
            throw new NullPointerException(e.toString());
        }
        setURL(url, "jar", "", -1, null, null, file, null, null); //$NON-NLS-1$//$NON-NLS-2$
    }

    /**
     * Build and return the externalized string representation of url.
     * 
     * @return String the externalized string representation of url
     * @param url
     *            a URL
     */
    @Override
    protected String toExternalForm(URL url) {
        StringBuffer sb = new StringBuffer();
        sb.append("jar:"); //$NON-NLS-1$
        sb.append(url.getFile());
        String ref = url.getRef();
        if (ref != null) {
            sb.append(ref);
        }
        return sb.toString();
    }
}