// Copyright 2008 Google Inc. All Rights Reserved.
package com.google.appengine.tools.admin;
import com.google.appengine.tools.info.Version;
import com.google.apphosting.utils.config.AppEngineConfigException;
import com.google.apphosting.utils.config.AppEngineWebXml;
import com.google.apphosting.utils.config.AppEngineWebXml.AdminConsolePage;
import com.google.apphosting.utils.config.AppEngineWebXml.ApiConfig;
import com.google.apphosting.utils.config.AppEngineWebXml.CpuUtilization;
import com.google.apphosting.utils.config.AppEngineWebXml.ErrorHandler;
import com.google.apphosting.utils.config.AppEngineWebXml.Pagespeed;
import com.google.apphosting.utils.config.AppEngineWebXml.VmHealthCheck;
import com.google.apphosting.utils.config.BackendsXml;
import com.google.apphosting.utils.config.WebXml;
import com.google.apphosting.utils.config.WebXml.SecurityConstraint;
import com.google.apphosting.utils.glob.ConflictResolver;
import com.google.apphosting.utils.glob.Glob;
import com.google.apphosting.utils.glob.GlobFactory;
import com.google.apphosting.utils.glob.GlobIntersector;
import com.google.apphosting.utils.glob.LongestPatternConflictResolver;
import com.google.common.collect.Maps;
import net.sourceforge.yamlbeans.YamlConfig;
import net.sourceforge.yamlbeans.YamlException;
import net.sourceforge.yamlbeans.YamlWriter;
import java.io.StringWriter;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Set;
/**
* Generates {@code app.yaml} files suitable for uploading as part of
* a Google App Engine application.
*
*/
public class AppYamlTranslator {
private static final String NO_API_VERSION = "none";
private static final ConflictResolver RESOLVER =
new LongestPatternConflictResolver();
private static final String DYNAMIC_PROPERTY = "dynamic";
private static final String STATIC_PROPERTY = "static";
private static final String WELCOME_FILES = "welcome";
private static final String TRANSPORT_GUARANTEE_PROPERTY = "transportGuarantee";
private static final String REQUIRED_ROLE_PROPERTY = "requiredRole";
private static final String EXPIRATION_PROPERTY = "expiration";
private static final String HTTP_HEADERS_PROPERTY = "http_headers";
private static final String API_ENDPOINT_REGEX = "/_ah/spi/*";
private static final String[] PROPERTIES = new String[] {
DYNAMIC_PROPERTY,
STATIC_PROPERTY,
WELCOME_FILES,
TRANSPORT_GUARANTEE_PROPERTY,
REQUIRED_ROLE_PROPERTY,
EXPIRATION_PROPERTY,
};
private static final int MAX_HANDLERS = 100;
private final AppEngineWebXml appEngineWebXml;
private final WebXml webXml;
private final BackendsXml backendsXml;
private final String apiVersion;
private final Set<String> staticFiles;
private final String runtime;
private final Version sdkVersion;
public AppYamlTranslator(AppEngineWebXml appEngineWebXml,
WebXml webXml,
BackendsXml backendsXml,
String apiVersion,
Set<String> staticFiles,
ApiConfig apiConfig,
String runtime,
Version sdkVersion) {
this.appEngineWebXml = appEngineWebXml;
this.webXml = webXml;
this.backendsXml = backendsXml;
this.apiVersion = apiVersion;
this.staticFiles = staticFiles;
this.runtime = runtime;
this.sdkVersion = sdkVersion;
}
public String getYaml() {
StringBuilder builder = new StringBuilder();
translateAppEngineWebXml(builder);
translateApiVersion(builder);
translateWebXml(builder);
return builder.toString();
}
private void appendIfNotNull(StringBuilder builder, String tag, Object value) {
if (value != null) {
builder.append(tag);
builder.append(value);
builder.append("\n");
}
}
private void translateAppEngineWebXml(StringBuilder builder) {
builder.append("application: '" + appEngineWebXml.getAppId() + "'\n");
builder.append("runtime: " + runtime + "\n");
if (appEngineWebXml.getUseVm()) {
builder.append("vm: True\n");
}
if (appEngineWebXml.getSourceLanguage() != null) {
builder.append("source_language: '" + appEngineWebXml.getSourceLanguage() + "'\n");
}
if (appEngineWebXml.getMajorVersionId() != null) {
builder.append("version: '" + appEngineWebXml.getMajorVersionId() + "'\n");
}
if (appEngineWebXml.getModule() != null) {
builder.append("module: '" + appEngineWebXml.getModule() + "'\n");
}
if (appEngineWebXml.getInstanceClass() != null) {
builder.append("instance_class: " + appEngineWebXml.getInstanceClass() + "\n");
}
if (!appEngineWebXml.getAutomaticScaling().isEmpty()) {
builder.append("automatic_scaling:\n");
AppEngineWebXml.AutomaticScaling settings = appEngineWebXml.getAutomaticScaling();
appendIfNotNull(builder, " min_pending_latency: ", settings.getMinPendingLatency());
appendIfNotNull(builder, " max_pending_latency: ", settings.getMaxPendingLatency());
appendIfNotNull(builder, " min_idle_instances: ", settings.getMinIdleInstances());
appendIfNotNull(builder, " max_idle_instances: ", settings.getMaxIdleInstances());
appendIfNotNull(builder, " max_concurrent_requests: ", settings.getMaxConcurrentRequests());
appendIfNotNull(builder, " min_num_instances: ", settings.getMinNumInstances());
appendIfNotNull(builder, " max_num_instances: ", settings.getMaxNumInstances());
appendIfNotNull(builder, " cool_down_period_sec: ", settings.getCoolDownPeriodSec());
CpuUtilization cpuUtil = settings.getCpuUtilization();
if (cpuUtil != null
&& (cpuUtil.getTargetUtilization() != null
|| cpuUtil.getAggregationWindowLengthSec() != null)) {
builder.append(" cpu_utilization:\n");
appendIfNotNull(builder, " target_utilization: ", cpuUtil.getTargetUtilization());
appendIfNotNull(
builder, " aggregation_window_length_sec: ",
cpuUtil.getAggregationWindowLengthSec());
}
}
if (!appEngineWebXml.getManualScaling().isEmpty()) {
builder.append("manual_scaling:\n");
AppEngineWebXml.ManualScaling settings = appEngineWebXml.getManualScaling();
builder.append(" instances: " + settings.getInstances() + "\n");
}
if (!appEngineWebXml.getBasicScaling().isEmpty()) {
builder.append("basic_scaling:\n");
AppEngineWebXml.BasicScaling settings = appEngineWebXml.getBasicScaling();
builder.append(" max_instances: " + settings.getMaxInstances() + "\n");
appendIfNotNull(builder, " idle_timeout: ", settings.getIdleTimeout());
}
Collection<String> services = appEngineWebXml.getInboundServices();
if (!services.isEmpty()) {
builder.append("inbound_services:\n");
for (String service : services) {
builder.append("- " + service + "\n");
}
}
if (appEngineWebXml.getPrecompilationEnabled()) {
builder.append("derived_file_type:\n");
builder.append("- java_precompiled\n");
}
if (appEngineWebXml.getThreadsafe()) {
builder.append("threadsafe: True\n");
}
if (appEngineWebXml.getAutoIdPolicy() != null) {
builder.append("auto_id_policy: " + appEngineWebXml.getAutoIdPolicy() + "\n");
} else {
builder.append("auto_id_policy: default\n");
}
if (appEngineWebXml.getCodeLock()) {
builder.append("code_lock: True\n");
}
List<AdminConsolePage> adminConsolePages = appEngineWebXml.getAdminConsolePages();
if (!adminConsolePages.isEmpty()) {
builder.append("admin_console:\n");
builder.append(" pages:\n");
for (AdminConsolePage page : adminConsolePages) {
builder.append(" - name: " + page.getName() + "\n");
builder.append(" url: " + page.getUrl() + "\n");
}
}
List<ErrorHandler> errorHandlers = appEngineWebXml.getErrorHandlers();
if (!errorHandlers.isEmpty()) {
builder.append("error_handlers:\n");
for (ErrorHandler handler : errorHandlers) {
String fileName = handler.getFile();
if (!fileName.startsWith("/")) {
fileName = "/" + fileName;
}
if (!staticFiles.contains("__static__" + fileName)) {
throw new AppEngineConfigException("No static file found for error handler: "
+ fileName + ", out of " + staticFiles);
}
builder.append("- file: __static__" + fileName + "\n");
if (handler.getErrorCode() != null) {
builder.append(" error_code: " + handler.getErrorCode() + "\n");
}
String mimeType = webXml.getMimeTypeForPath(handler.getFile());
if (mimeType != null) {
builder.append(" mime_type: " + mimeType + "\n");
}
}
}
if (backendsXml != null) {
builder.append(backendsXml.toYaml());
}
ApiConfig apiConfig = appEngineWebXml.getApiConfig();
if (apiConfig != null) {
builder.append("api_config:\n");
builder.append(" url: " + apiConfig.getUrl() + "\n");
builder.append(" script: unused\n");
}
if (appEngineWebXml.getPagespeed() != null) {
builder.append("pagespeed:\n");
appendPagespeed(appEngineWebXml.getPagespeed(), builder, 2);
}
if (appEngineWebXml.getUseVm()) {
appendEnvVariables(appEngineWebXml.getEnvironmentVariables(), builder);
appendVmSettings(appEngineWebXml.getVmSettings(), builder);
appendVmHealthCheck(appEngineWebXml.getVmHealthCheck(), builder);
}
}
/**
* Appends the given VM Settings as YAML to the given StringBuilder.
*
* @param vmSettings The vm settings map to append as YAML.
* @param builder The StringBuilder to append to.
*/
private void appendEnvVariables(Map<String, String> envVariables, StringBuilder builder) {
if (envVariables.size() > 0) {
builder.append("env_variables:\n");
for (Map.Entry<String, String> envVariable : envVariables.entrySet()) {
String k = envVariable.getKey();
String v = envVariable.getValue();
builder.append(" ").append(yamlQuote(k)).append(": ").append(yamlQuote(v)).append("\n");
}
}
}
/**
* Appends the given VM Settings as YAML to the given StringBuilder.
*
* @param vmSettings The vm settings map to append as YAML.
* @param builder The StringBuilder to append to.
*/
private void appendVmSettings(Map<String, String> vmSettings, StringBuilder builder) {
builder.append("vm_settings:\n");
if (vmSettings == null || !vmSettings.containsKey("image")) {
if (sdkVersion != null && sdkVersion.getRelease() != null) {
builder.append(" 'image': " + yamlQuote(sdkVersion.getRelease()) + "\n");
}
}
if (vmSettings != null) {
for (Map.Entry<String, String> setting : vmSettings.entrySet()) {
builder.append(
" " + yamlQuote(setting.getKey()) + ": " + yamlQuote(setting.getValue()) + "\n");
}
}
}
private void appendVmHealthCheck(VmHealthCheck vmHealthCheck, StringBuilder builder) {
builder.append("vm_health_check:\n");
if (vmHealthCheck.getEnableHealthCheck()) {
builder.append(" enable_health_check: True\n");
} else {
builder.append(" enable_health_check: False\n");
}
appendIfNotNull(builder, " check_interval_sec: ", vmHealthCheck.getCheckIntervalSec());
appendIfNotNull(builder, " timeout_sec: ", vmHealthCheck.getTimeoutSec());
appendIfNotNull(builder, " unhealthy_threshold: ", vmHealthCheck.getUnhealthyThreshold());
appendIfNotNull(builder, " healthy_threshold: ", vmHealthCheck.getHealthyThreshold());
appendIfNotNull(builder, " restart_threshold: ", vmHealthCheck.getRestartThreshold());
appendIfNotNull(builder, " host: ", vmHealthCheck.getHost());
}
/**
* Append the given Pagespeed node as YAML to the given StringBuilder.
* @param pagespeed The Pagespeed instance to append as YAML.
* @param builder The StringBuilder to append to.
* @param indent The number of spaces to indent the pagespeed YAML.
*/
public static void appendPagespeed(Pagespeed pagespeed, StringBuilder builder, int indent) {
if (pagespeed != null && !pagespeed.isEmpty()) {
Map<String, List<String>> config = Maps.newTreeMap();
putListInMapIfNotEmpty(config, "url_blacklist", pagespeed.getUrlBlacklist());
putListInMapIfNotEmpty(config, "domains_to_rewrite", pagespeed.getDomainsToRewrite());
putListInMapIfNotEmpty(config, "enabled_rewriters", pagespeed.getEnabledRewriters());
putListInMapIfNotEmpty(config, "disabled_rewriters", pagespeed.getDisabledRewriters());
appendObjectAsYaml(builder, config, indent);
}
}
/**
* Adds the list to the given map, using the specified name, if the list is non-null and not
* empty.
*/
private static void putListInMapIfNotEmpty(Map<String, List<String>> map, String name,
List<String> values) {
if (values != null && !values.isEmpty()) {
map.put(name, values);
}
}
/**
* Appends the given collection to the StringBuilder as YAML, indenting each emitted line by
* numIndentSpaces.
*/
private static void appendObjectAsYaml(
StringBuilder builder, Object collection, int numIndentSpaces) {
StringBuilder prefixBuilder = new StringBuilder();
for (int i = 0; i < numIndentSpaces; ++i) {
prefixBuilder.append(' ');
}
final String indentPrefix = prefixBuilder.toString();
StringWriter stringWriter = new StringWriter();
YamlConfig yamlConfig = new YamlConfig();
yamlConfig.writeConfig.setIndentSize(2);
yamlConfig.writeConfig.setWriteRootTags(false);
YamlWriter writer = new YamlWriter(stringWriter, yamlConfig);
try {
writer.write(collection);
writer.close();
} catch (YamlException e) {
throw new AppEngineConfigException("Unable to generate YAML.", e);
}
for (String line : stringWriter.toString().split("\n")) {
builder.append(indentPrefix);
builder.append(line);
builder.append("\n");
}
}
/**
* Surrounds the provided string with single quotes, escaping any single
* quotes in the string by replacing them with ''.
*/
private String yamlQuote(String str) {
return "'" + str.replace("'", "''") + "'";
}
private void translateApiVersion(StringBuilder builder) {
if (apiVersion == null) {
builder.append("api_version: '" + NO_API_VERSION + "'\n");
} else {
builder.append("api_version: '" + apiVersion + "'\n");
}
}
private void translateWebXml(StringBuilder builder) {
builder.append("handlers:\n");
AbstractHandlerGenerator staticGenerator = null;
if (staticFiles.isEmpty()) {
staticGenerator = new EmptyHandlerGenerator();
} else {
staticGenerator = new StaticHandlerGenerator(appEngineWebXml.getPublicRoot());
}
DynamicHandlerGenerator dynamicGenerator =
new DynamicHandlerGenerator(webXml.getFallThroughToRuntime());
if (staticGenerator.size() + dynamicGenerator.size() > MAX_HANDLERS) {
dynamicGenerator = new DynamicHandlerGenerator(true);
}
staticGenerator.translate(builder);
dynamicGenerator.translate(builder);
}
class StaticHandlerGenerator extends AbstractHandlerGenerator {
private final String root;
public StaticHandlerGenerator(String root) {
this.root = root;
}
@Override
protected Map<String, Object> getWelcomeProperties() {
List<String> staticWelcomeFiles = new ArrayList<String>();
for (String welcomeFile : webXml.getWelcomeFiles()) {
for (String staticFile : staticFiles) {
if (staticFile.endsWith("/" + welcomeFile)) {
staticWelcomeFiles.add(welcomeFile);
break;
}
}
}
return Collections.<String,Object>singletonMap(WELCOME_FILES, staticWelcomeFiles);
}
@Override
protected void addPatterns(GlobIntersector intersector) {
List<AppEngineWebXml.StaticFileInclude> includes = appEngineWebXml.getStaticFileIncludes();
if (includes.isEmpty()) {
intersector.addGlob(GlobFactory.createGlob("/*", STATIC_PROPERTY, true));
} else {
for (AppEngineWebXml.StaticFileInclude include : includes) {
String pattern = include.getPattern().replaceAll("\\*\\*", "*");
if (!pattern.startsWith("/")) {
pattern = "/" + pattern;
}
Map<String, Object> props = new HashMap<String, Object>();
props.put(STATIC_PROPERTY, true);
if (include.getExpiration() != null) {
props.put(EXPIRATION_PROPERTY, include.getExpiration());
}
if (include.getHttpHeaders() != null) {
props.put(HTTP_HEADERS_PROPERTY, include.getHttpHeaders());
}
intersector.addGlob(GlobFactory.createGlob(pattern, props));
}
}
}
@Override
public void translateGlob(StringBuilder builder, Glob glob) {
String regex = glob.getRegularExpression().pattern();
if (!root.isEmpty()) {
if (regex.startsWith(root)){
regex = regex.substring(root.length(), regex.length());
}
}
@SuppressWarnings("unchecked")
List<String> welcomeFiles =
(List<String>) glob.getProperty(WELCOME_FILES, RESOLVER);
if (welcomeFiles != null) {
for (String welcomeFile : welcomeFiles) {
builder.append("- url: (" + regex + ")\n");
builder.append(" static_files: __static__" + root + "\\1" + welcomeFile + "\n");
builder.append(" upload: __NOT_USED__\n");
builder.append(" require_matching_file: True\n");
translateHandlerOptions(builder, glob);
translateAdditionalStaticOptions(builder, glob);
}
} else {
Boolean isStatic = (Boolean) glob.getProperty(STATIC_PROPERTY, RESOLVER);
if (isStatic != null && isStatic.booleanValue()) {
builder.append("- url: (" + regex + ")\n");
builder.append(" static_files: __static__" + root + "\\1\n");
builder.append(" upload: __NOT_USED__\n");
builder.append(" require_matching_file: True\n");
translateHandlerOptions(builder, glob);
translateAdditionalStaticOptions(builder, glob);
}
}
}
private void translateAdditionalStaticOptions(StringBuilder builder, Glob glob)
throws AppEngineConfigException {
String expiration = (String) glob.getProperty(EXPIRATION_PROPERTY, RESOLVER);
if (expiration != null) {
builder.append(" expiration: " + expiration + "\n");
}
@SuppressWarnings("unchecked")
Map<String, String> httpHeaders =
(Map<String, String>) glob.getProperty(HTTP_HEADERS_PROPERTY, RESOLVER);
if (httpHeaders != null && !httpHeaders.isEmpty()) {
builder.append(" http_headers:\n");
appendObjectAsYaml(builder, httpHeaders, 4);
}
}
}
/**
* According to the example In section 12.2.2 of Servlet Spec 3.0 , /baz/* should also match /baz,
* so add an additional glob for that.
*/
private static void extendMeaningOfTrailingStar(
GlobIntersector intersector, String pattern, String property, Object value) {
if (pattern.endsWith("/*") && pattern.length() > 2) {
intersector.addGlob(
GlobFactory.createGlob(pattern.substring(0, pattern.length() - 2), property, value));
}
}
class DynamicHandlerGenerator extends AbstractHandlerGenerator {
private final List<String> patterns;
private boolean fallthrough;
private boolean hasJsps;
DynamicHandlerGenerator(boolean alwaysFallthrough) {
fallthrough = alwaysFallthrough;
patterns = new ArrayList<String>();
for (String servletPattern : webXml.getServletPatterns()) {
if (servletPattern.equals("/") || servletPattern.equals("/*")) {
fallthrough = true;
} else if (servletPattern.equals(API_ENDPOINT_REGEX)) {
hasApiEndpoint = true;
} else if (servletPattern.endsWith(".jsp")) {
hasJsps = true;
} else {
patterns.add(servletPattern);
}
}
}
@Override
protected Map<String, Object> getWelcomeProperties() {
if (fallthrough) {
return null;
} else {
return Collections.<String,Object>singletonMap(DYNAMIC_PROPERTY, true);
}
}
@Override
protected void addPatterns(GlobIntersector intersector) {
if (fallthrough) {
intersector.addGlob(GlobFactory.createGlob(
"/*",
DYNAMIC_PROPERTY, true));
} else {
for (String servletPattern : patterns) {
intersector.addGlob(GlobFactory.createGlob(
servletPattern,
DYNAMIC_PROPERTY, true));
extendMeaningOfTrailingStar(intersector, servletPattern, DYNAMIC_PROPERTY, true);
}
if (hasJsps) {
intersector.addGlob(GlobFactory.createGlob(
"*.jsp",
DYNAMIC_PROPERTY, true));
} else if (appEngineWebXml.getUseVm()) {
intersector.addGlob(GlobFactory.createGlob(
"*.jsp",
DYNAMIC_PROPERTY, true));
}
intersector.addGlob(GlobFactory.createGlob(
"/_ah/*",
DYNAMIC_PROPERTY, true));
}
}
@Override
public void translateGlob(StringBuilder builder, Glob glob) {
String regex = glob.getRegularExpression().pattern();
Boolean isDynamic = (Boolean) glob.getProperty(DYNAMIC_PROPERTY, RESOLVER);
if (isDynamic != null && isDynamic.booleanValue()) {
builder.append("- url: " + regex + "\n");
builder.append(" script: unused\n");
translateHandlerOptions(builder, glob);
}
}
}
/**
* An {@code AbstractHandlerGenerator} that returns no globs.
*/
class EmptyHandlerGenerator extends AbstractHandlerGenerator {
@Override
protected void addPatterns(GlobIntersector intersector) {
}
@Override
protected void translateGlob(StringBuilder builder, Glob glob) {
}
@Override
protected Map<String, Object> getWelcomeProperties() {
return Collections.emptyMap();
}
}
abstract class AbstractHandlerGenerator {
private List<Glob> globs = null;
protected boolean hasApiEndpoint;
public int size() {
return getGlobPatterns().size();
}
public void translate(StringBuilder builder) {
for (Glob glob : getGlobPatterns()) {
translateGlob(builder, glob);
}
}
abstract protected void addPatterns(GlobIntersector intersector);
abstract protected void translateGlob(StringBuilder builder, Glob glob);
/**
* @returns a map of welcome properties to apply to the welcome
* file entries, or {@code null} if no welcome file entries are
* necessary.
*/
abstract protected Map<String, Object> getWelcomeProperties();
protected List<Glob> getGlobPatterns() {
if (globs == null) {
GlobIntersector intersector = new GlobIntersector();
addPatterns(intersector);
addSecurityConstraints(intersector);
addWelcomeFiles(intersector);
globs = intersector.getIntersection();
removeNearDuplicates(globs);
if (hasApiEndpoint) {
globs.add(GlobFactory.createGlob(API_ENDPOINT_REGEX, DYNAMIC_PROPERTY, true));
}
}
return globs;
}
protected void addWelcomeFiles(GlobIntersector intersector) {
Map<String, Object> welcomeProperties = getWelcomeProperties();
if (welcomeProperties != null) {
intersector.addGlob(GlobFactory.createGlob("/", welcomeProperties));
intersector.addGlob(GlobFactory.createGlob("/*/", welcomeProperties));
}
}
protected void addSecurityConstraints(GlobIntersector intersector) {
for (SecurityConstraint constraint : webXml.getSecurityConstraints()) {
for (String pattern : constraint.getUrlPatterns()) {
intersector.addGlob(GlobFactory.createGlob(
pattern,
TRANSPORT_GUARANTEE_PROPERTY,
constraint.getTransportGuarantee()));
extendMeaningOfTrailingStar(intersector, pattern, TRANSPORT_GUARANTEE_PROPERTY,
constraint.getTransportGuarantee());
intersector.addGlob(GlobFactory.createGlob(
pattern,
REQUIRED_ROLE_PROPERTY,
constraint.getRequiredRole()));
extendMeaningOfTrailingStar(
intersector, pattern, REQUIRED_ROLE_PROPERTY, constraint.getRequiredRole());
}
}
}
protected void translateHandlerOptions(StringBuilder builder, Glob glob) {
SecurityConstraint.RequiredRole requiredRole =
(SecurityConstraint.RequiredRole) glob.getProperty(REQUIRED_ROLE_PROPERTY, RESOLVER);
if (requiredRole == null) {
requiredRole = SecurityConstraint.RequiredRole.NONE;
}
switch (requiredRole) {
case NONE:
builder.append(" login: optional\n");
break;
case ANY_USER:
builder.append(" login: required\n");
break;
case ADMIN:
builder.append(" login: admin\n");
break;
}
SecurityConstraint.TransportGuarantee transportGuarantee =
(SecurityConstraint.TransportGuarantee) glob.getProperty(TRANSPORT_GUARANTEE_PROPERTY,
RESOLVER);
if (transportGuarantee == null) {
transportGuarantee = SecurityConstraint.TransportGuarantee.NONE;
}
switch (transportGuarantee) {
case NONE:
if (appEngineWebXml.getSslEnabled()) {
builder.append(" secure: optional\n");
} else {
builder.append(" secure: never\n");
}
break;
case INTEGRAL:
case CONFIDENTIAL:
if (!appEngineWebXml.getSslEnabled()) {
throw new AppEngineConfigException(
"SSL must be enabled in appengine-web.xml to use transport-guarantee");
}
builder.append(" secure: always\n");
break;
}
String pattern = glob.getRegularExpression().pattern();
String id = webXml.getHandlerIdForPattern(pattern);
if (id != null) {
if (appEngineWebXml.isApiEndpoint(id)) {
builder.append(" api_endpoint: True\n");
}
}
}
private void removeNearDuplicates(List<Glob> globs) {
for (int i = 0; i < globs.size(); i++) {
Glob topGlob = globs.get(i);
for (int j = i + 1; j < globs.size(); j++) {
Glob bottomGlob = globs.get(j);
if (bottomGlob.matchesAll(topGlob)) {
if (propertiesMatch(topGlob, bottomGlob)) {
globs.remove(i);
i--;
}
break;
}
}
}
}
private boolean propertiesMatch(Glob glob1, Glob glob2) {
for (String property : PROPERTIES) {
Object value1 = glob1.getProperty(property, RESOLVER);
Object value2 = glob2.getProperty(property, RESOLVER);
if (value1 != value2 && (value1 == null || !value1.equals(value2))) {
return false;
}
}
return true;
}
}
}