org.unitedinternet.cosmo.server.CollectionPath Maven / Gradle / Ivy
/*
* Copyright 2006 Open Source Applications Foundation
*
* 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.unitedinternet.cosmo.server;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
/**
* This class represents a URL that addresses a collection by uid.
*
* Collections in the Cosmo database are addressed similarly
* regardless of which protocol is used to access the data. An
* collection URL includes the service mount URL, the literal path
* component collection, the uid of the collection, and any
* extra path information used by the protocol handler.
*
* For example, the URL
* http://localhost:8080/cosmo/dav/collection/cafebebe-deadbeef
* is the WebDAV home collection address for the collection with the
* specified uid.
*/
public class CollectionPath {
private static final Pattern PATTERN_COLLECTION_UID =
Pattern.compile("^/collection/([^/]+)(/.*)?$");
private String urlPath;
private String uid;
private String pathInfo;
/**
* Constructs a CollectionPath instance based on the
* servlet-relative component of the url-path from a collection
* URL.
*
* @param urlPath the servlet-relative url-path
*
* @throws IllegalArgumentException if the given url-path is not
* servlet-relative (starts with a "/")
* @throws IllegalStateException if the given url-path does not
* represent a collection path
*/
public CollectionPath(String urlPath) {
if (! urlPath.startsWith("/")) {
throw new IllegalArgumentException("urlPath must start with /");
}
this.urlPath = urlPath;
Matcher collectionMatcher = PATTERN_COLLECTION_UID.matcher(urlPath);
if (! collectionMatcher.matches()) {
throw new IllegalStateException("urlPath is not a collection path");
}
this.uid = collectionMatcher.group(1);
this.pathInfo = collectionMatcher.group(2);
}
/** */
public String getUrlPath() {
return urlPath;
}
/** */
public String getUid() {
return uid;
}
/** */
public String getPathInfo() {
return pathInfo;
}
/**
* Parses the given url-path, returning an instance of
* CollectionPath. Extra path info is disallowed.
*
* @param urlPath the servlet-relative url-path
* @return an instance of CollectionPath if the
* url-path represents a collection path, or null
* otherwise.
*
* @throws IllegalArgumentException if the given url-path is not
* servlet-relative (starts with a "/") or if disallowed path
* info is present
*/
public static CollectionPath parse(String urlPath) {
return parse(urlPath, false);
}
/**
* Parses the given url-path, returning an instance of
* CollectionPath.
*
* @param urlPath the servlet-relative url-path
* @param allowPathInfo determines whether or not extra path info
* is allowed
* @return an instance of CollectionPath if the
* url-path represents a collection path, or null
* otherwise.
*
* @throws IllegalArgumentException if the given url-path is not
* servlet-relative (starts with a "/")
*/
public static CollectionPath parse(String urlPath,
boolean allowPathInfo) {
if (urlPath == null) {
return null;
}
try {
CollectionPath cp = new CollectionPath(urlPath);
if (! allowPathInfo && cp.getPathInfo() != null) {
return null;
}
return cp;
} catch (IllegalStateException e) {
return null;
}
}
}