| /* |
| * Copyright 2004-2005 The Apache Software Foundation or its licensors, |
| * as applicable. |
| * |
| * Licensed 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.jackrabbit.net; |
| |
| import java.net.MalformedURLException; |
| import java.net.URL; |
| |
| import javax.jcr.Session; |
| |
| /** |
| * The <code>URLFactory</code> class provides factory methods for creating |
| * JCR Repository and JCRJar URLs. |
| * <p> |
| * This class is not intended to be subclassed or instantiated by clients. |
| * |
| * @author Felix Meschberger |
| * @version $Rev:$, $Date:$ |
| */ |
| public final class URLFactory { |
| |
| /** |
| * The scheme for JCR Repository URLs (value is "jcr"). |
| */ |
| public static final String REPOSITORY_SCHEME = "jcr"; |
| |
| /** |
| * The scheme for JCRJar URLs (value is "jar"). |
| */ |
| public static final String REPOSITORY_JAR_SCHEME = "jar"; |
| |
| /** Private default constructor, not to be instantiated */ |
| private URLFactory() { |
| } |
| |
| /** |
| * Creates a new JCR Repository URL for the given session and item path. |
| * |
| * @param session The repository session providing access to the item. |
| * @param path The absolute path to the item. This must be an absolute |
| * path with a leading slash character. If this is <code>null</code> |
| * the root node path - <code>/</code> - is assumed. |
| * |
| * @return The JCR Repository URL |
| * |
| * @throws MalformedURLException If an error occurrs creating the |
| * <code>URL</code> instance. |
| */ |
| public static URL createURL(Session session, String path) |
| throws MalformedURLException { |
| |
| return new URL(REPOSITORY_SCHEME, "", -1, |
| new FileParts(session, path, null).toString(), |
| new JCRURLHandler(session)); |
| } |
| |
| /** |
| * Creates a new JCRJar URL for the given session, archive and entry. |
| * |
| * @param session The repository session providing access to the archive. |
| * @param path The absolute path to the archive. This must either be the |
| * property containing the archive or an item which resolves to such |
| * a property through its primary item chain. This must be an absolute |
| * path with a leading slash character. If this is <code>null</code> |
| * the root node path - <code>/</code> - is assumed. |
| * @param entry The entry within the archive. If <code>null</code>, the URL |
| * provides access to the archive itself. |
| * |
| * @return The JCRJar URL |
| * |
| * @throws MalformedURLException If an error occurrs creating the |
| * <code>URL</code> instance. |
| */ |
| public static URL createJarURL(Session session, String path, String entry) |
| throws MalformedURLException { |
| |
| JCRJarURLHandler handler = new JCRJarURLHandler(session); |
| String file = createURL(session, path).toExternalForm(); |
| |
| // append entry spec if not null |
| if (entry != null) { |
| file += "!/" + entry; |
| } |
| |
| return new URL(REPOSITORY_JAR_SCHEME, "", -1, file, handler); |
| } |
| } |