/* * 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.catalina.util;
import java.util.Locale;
/** * Utility class to manage context names so there is one place where the * conversions between baseName, path and version take place.
*/ publicfinalclass ContextName { publicstaticfinal String ROOT_NAME = "ROOT"; privatestaticfinal String VERSION_MARKER = "##"; privatestaticfinalchar FWD_SLASH_REPLACEMENT = '#';
/** * Creates an instance from a context name, display name, base name, * directory name, WAR name or context.xml name. * * @param name The name to use as the basis for this object * @param stripFileExtension If a .war or .xml file extension is present * at the end of the provided name should it be * removed?
*/ public ContextName(String name, boolean stripFileExtension) {
String tmp1 = name;
// Convert Context names and display names to base names
// Strip off any leading "/" if (tmp1.startsWith("/")) {
tmp1 = tmp1.substring(1);
}
// Replace any remaining /
tmp1 = tmp1.replace('/', FWD_SLASH_REPLACEMENT);
// Insert the ROOT name if required if (tmp1.startsWith(VERSION_MARKER) || tmp1.isEmpty()) {
tmp1 = ROOT_NAME + tmp1;
}
// Remove any file extensions if (stripFileExtension &&
(tmp1.toLowerCase(Locale.ENGLISH).endsWith(".war") ||
tmp1.toLowerCase(Locale.ENGLISH).endsWith(".xml"))) {
tmp1 = tmp1.substring(0, tmp1.length() -4);
}
baseName = tmp1;
String tmp2; // Extract version number int versionIndex = baseName.indexOf(VERSION_MARKER); if (versionIndex > -1) {
version = baseName.substring(versionIndex + 2);
tmp2 = baseName.substring(0, versionIndex);
} else {
version = "";
tmp2 = baseName;
}
/** * Construct an instance from a path and version. * * @param path Context path to use * @param version Context version to use
*/ public ContextName(String path, String version) { // Path should never be null, '/' or '/ROOT' if (path == null || "/".equals(path) || "/ROOT".equals(path)) { this.path = "";
} else { this.path = path;
}
// Version should never be null if (version == null) { this.version = "";
} else { this.version = version;
}
// Name is path + version if (this.version.isEmpty()) {
name = this.path;
} else {
name = this.path + VERSION_MARKER + this.version;
}
// Base name is converted path + version
StringBuilder tmp = new StringBuilder(); if (this.path.isEmpty()) {
tmp.append(ROOT_NAME);
} else {
tmp.append(this.path.substring(1).replace('/',
FWD_SLASH_REPLACEMENT));
} if (!this.version.isEmpty()) {
tmp.append(VERSION_MARKER);
tmp.append(this.version);
} this.baseName = tmp.toString();
}
public String getBaseName() { return baseName;
}
public String getPath() { return path;
}
public String getVersion() { return version;
}
public String getName() { return name;
}
public String getDisplayName() {
StringBuilder tmp = new StringBuilder(); if ("".equals(path)) {
tmp.append('/');
} else {
tmp.append(path);
}
if (!version.isEmpty()) {
tmp.append(VERSION_MARKER);
tmp.append(version);
}
return tmp.toString();
}
@Override public String toString() { return getDisplayName();
}
/** * Extract the final component of the given path which is assumed to be a * base name and generate a {@link ContextName} from that base name. * * @param path The path that ends in a base name * * @return the {@link ContextName} generated from the given base name
*/ publicstatic ContextName extractFromPath(String path) { // Convert '\' to '/'
path = path.replace("\\", "/"); // Remove trailing '/'. Use while just in case a value ends in /// while (path.endsWith("/")) {
path = path.substring(0, path.length() - 1);
}
int lastSegment = path.lastIndexOf('/'); if (lastSegment > 0) {
path = path.substring(lastSegment + 1);
}
returnnew ContextName(path, true);
}
}
¤ Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.0.17Bemerkung:
(vorverarbeitet)
¤
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung ist noch experimentell.