java/src/main/com/google/apphosting/utils/config/AppEngineWebXml.java

   1 // Copyright 2008 Google Inc. All Rights Reserved.
   2 package com.google.apphosting.utils.config;
   3
   4 import com.google.common.base.StringUtil;
   5 import com.google.common.collect.Lists;
   6 import com.google.common.collect.Maps;
   7
   8 import java.security.Permissions;
   9 import java.security.UnresolvedPermission;
  10 import java.util.ArrayList;
  11 import java.util.Collections;
  12 import java.util.LinkedHashMap;
  13 import java.util.LinkedHashSet;
  14 import java.util.List;
  15 import java.util.Map;
  16 import java.util.Objects;
  17 import java.util.Set;
  18 import java.util.regex.Pattern;
  19
  20 /**
  21  * Struct describing the config data that lives in WEB-INF/appengine-web.xml.
  22  *
  23  * Any additions to this class should also be made to the YAML
  24  * version in AppYaml.java.
  25  *
  26  */
  27 public class AppEngineWebXml {
  28   /**
  29    * Enumeration of supported scaling types.
  30    */
  31   public static enum ScalingType {AUTOMATIC, MANUAL, BASIC}
  32
  33   private final Map<String, String> systemProperties = Maps.newHashMap();
  34
  35   private final Map<String, String> betaSettings = Maps.newLinkedHashMap();
  36
  37   private final HealthCheck healthCheck;
  38
  39   private final Resources resources;
  40
  41   private final Network network;
  42
  43   private final Map<String, String> envVariables = Maps.newHashMap();
  44
  45   private final List<UserPermission> userPermissions = new ArrayList<UserPermission>();
  46
  47   public static final String WARMUP_SERVICE = "warmup";
  48
  49   public static final String URL_HANDLER_URLFETCH = "urlfetch";
  50   public static final String URL_HANDLER_NATIVE= "native";
  51
  52   private String appId;
  53
  54   private String majorVersionId;
  55
  56   private String module;
  57   private String instanceClass;
  58
  59   private final AutomaticScaling automaticScaling;
  60   private final ManualScaling manualScaling;
  61   private final BasicScaling basicScaling;
  62
  63   private String sourceLanguage;
  64   private boolean sslEnabled = true;
  65   private boolean useSessions = false;
  66   private boolean asyncSessionPersistence = false;
  67   private String asyncSessionPersistenceQueueName;
  68
  69   private final List<StaticFileInclude> staticFileIncludes;
  70   private final List<String> staticFileExcludes;
  71   private final List<String> resourceFileIncludes;
  72   private final List<String> resourceFileExcludes;
  73
  74   private Pattern staticIncludePattern;
  75   private Pattern staticExcludePattern;
  76   private Pattern resourceIncludePattern;
  77   private Pattern resourceExcludePattern;
  78
  79   private String publicRoot = "";
  80
  81   private String appRoot;
  82
  83   private final Set<String> inboundServices;
  84   private boolean precompilationEnabled = true;
  85
  86   private final List<AdminConsolePage> adminConsolePages = new ArrayList<AdminConsolePage>();
  87   private final List<ErrorHandler> errorHandlers = new ArrayList<ErrorHandler>();
  88
  89   private ClassLoaderConfig classLoaderConfig;
  90
  91   private String urlStreamHandlerType = null;
  92
  93   private boolean threadsafe = false;
  94   private boolean threadsafeValueProvided = false;
  95
  96   private String autoIdPolicy;
  97
  98   private boolean codeLock = false;
  99   private boolean useVm = false;
 100   private ApiConfig apiConfig;
 101   private final List<String> apiEndpointIds;
 102   private Pagespeed pagespeed;
 103
 104   /**
 105    * Represent user's choice w.r.t the usage of Google's customized connector-j.
 106    */
 107   public static enum UseGoogleConnectorJ {
 108     NOT_STATED_BY_USER,
 109     TRUE,
 110     FALSE,
 111   }
 112   private UseGoogleConnectorJ useGoogleConnectorJ = UseGoogleConnectorJ.NOT_STATED_BY_USER;
 113
 114   public AppEngineWebXml() {
 115     automaticScaling = new AutomaticScaling();
 116     manualScaling = new ManualScaling();
 117     basicScaling = new BasicScaling();
 118     healthCheck = new HealthCheck();
 119     resources = new Resources();
 120     network = new Network();
 121
 122     staticFileIncludes = new ArrayList<StaticFileInclude>();
 123     staticFileExcludes = new ArrayList<String>();
 124     staticFileExcludes.add("WEB-INF/**");
 125     staticFileExcludes.add("**.jsp");
 126     resourceFileIncludes = new ArrayList<String>();
 127     resourceFileExcludes = new ArrayList<String>();
 128     inboundServices = new LinkedHashSet<String>();
 129     apiEndpointIds = new ArrayList<String>();
 130   }
 131
 132   /**
 133    * @return An unmodifiable map whose entries correspond to the
 134    * system properties defined in appengine-web.xml.
 135    */
 136   public Map<String, String> getSystemProperties() {
 137     return Collections.unmodifiableMap(systemProperties);
 138   }
 139
 140   public void addSystemProperty(String key, String value) {
 141     systemProperties.put(key, value);
 142   }
 143
 144   /**
 145    * @return An unmodifiable map whose entires correspond to the
 146    * vm settings defined in appengine-web.xml.
 147    */
 148   public Map<String, String> getBetaSettings() {
 149     return Collections.unmodifiableMap(betaSettings);
 150   }
 151
 152   public void addBetaSetting(String key, String value) {
 153     betaSettings.put(key, value);
 154   }
 155
 156   public HealthCheck getHealthCheck() {
 157     return healthCheck;
 158   }
 159
 160   public Resources getResources() {
 161     return resources;
 162   }
 163
 164   public Network getNetwork() {
 165     return network;
 166   }
 167
 168   /**
 169    * @return An unmodifiable map whose entires correspond to the
 170    * environment variables defined in appengine-web.xml.
 171    */
 172   public Map<String, String> getEnvironmentVariables() {
 173     return Collections.unmodifiableMap(envVariables);
 174   }
 175
 176   public void addEnvironmentVariable(String key, String value) {
 177     envVariables.put(key, value);
 178   }
 179
 180   public String getAppId() {
 181     return appId;
 182   }
 183
 184   public void setAppId(String appId) {
 185     this.appId = appId;
 186   }
 187
 188   public String getMajorVersionId() {
 189     return majorVersionId;
 190   }
 191
 192   public void setMajorVersionId(String majorVersionId) {
 193     this.majorVersionId = majorVersionId;
 194   }
 195
 196   public String getSourceLanguage() {
 197     return this.sourceLanguage;
 198   }
 199
 200   public void setSourceLanguage(String sourceLanguage) {
 201     this.sourceLanguage = sourceLanguage;
 202   }
 203
 204   public String getModule() {
 205     return module;
 206   }
 207
 208   /**
 209    * Sets instanceClass (aka class in the xml/yaml files). Normalizes empty and null
 210    * inputs to null.
 211    */
 212   public void setInstanceClass(String instanceClass) {
 213     this.instanceClass = StringUtil.toNullIfEmptyOrWhitespace(instanceClass);
 214   }
 215
 216   public String getInstanceClass() {
 217     return instanceClass;
 218   }
 219
 220   public AutomaticScaling getAutomaticScaling() {
 221     return automaticScaling;
 222   }
 223
 224   public ManualScaling getManualScaling() {
 225     return manualScaling;
 226   }
 227
 228   public BasicScaling getBasicScaling() {
 229     return basicScaling;
 230   }
 231
 232   public ScalingType getScalingType() {
 233     if (!getBasicScaling().isEmpty()) {
 234       return ScalingType.BASIC;
 235     } else if (!getManualScaling().isEmpty()) {
 236       return ScalingType.MANUAL;
 237     } else {
 238       return ScalingType.AUTOMATIC;
 239     }
 240   }
 241
 242   public void setModule(String module) {
 243     this.module = module;
 244   }
 245
 246   public void setSslEnabled(boolean ssl) {
 247     sslEnabled = ssl;
 248   }
 249
 250   public boolean getSslEnabled() {
 251     return sslEnabled;
 252   }
 253
 254   public void setSessionsEnabled(boolean sessions) {
 255     useSessions = sessions;
 256   }
 257
 258   public boolean getSessionsEnabled() {
 259     return useSessions;
 260   }
 261
 262   public void setAsyncSessionPersistence(boolean asyncSessionPersistence) {
 263     this.asyncSessionPersistence = asyncSessionPersistence;
 264   }
 265
 266   public boolean getAsyncSessionPersistence() {
 267     return asyncSessionPersistence;
 268   }
 269
 270   public void setAsyncSessionPersistenceQueueName(String asyncSessionPersistenceQueueName) {
 271     this.asyncSessionPersistenceQueueName = asyncSessionPersistenceQueueName;
 272   }
 273
 274   public String getAsyncSessionPersistenceQueueName() {
 275     return asyncSessionPersistenceQueueName;
 276   }
 277
 278   public List<StaticFileInclude> getStaticFileIncludes() {
 279     return staticFileIncludes;
 280   }
 281
 282   public List<String> getStaticFileExcludes() {
 283     return staticFileExcludes;
 284   }
 285
 286   public StaticFileInclude includeStaticPattern(String pattern, String expiration) {
 287     staticIncludePattern = null;
 288     StaticFileInclude staticFileInclude = new StaticFileInclude(pattern, expiration);
 289     staticFileIncludes.add(staticFileInclude);
 290     return staticFileInclude;
 291   }
 292
 293   public void excludeStaticPattern(String url) {
 294     staticExcludePattern = null;
 295     staticFileExcludes.add(url);
 296   }
 297
 298   public List<String> getResourcePatterns() {
 299     return resourceFileIncludes;
 300   }
 301
 302   public List<String> getResourceFileExcludes() {
 303     return resourceFileExcludes;
 304   }
 305
 306   public void includeResourcePattern(String url) {
 307     resourceExcludePattern = null;
 308     resourceFileIncludes.add(url);
 309   }
 310
 311   public void excludeResourcePattern(String url) {
 312     resourceIncludePattern = null;
 313     resourceFileExcludes.add(url);
 314   }
 315
 316   public void addUserPermission(String className, String name, String actions) {
 317     if (className.startsWith("java.")) {
 318       throw new AppEngineConfigException("Cannot specify user-permissions for " +
 319                                          "classes in java.* packages.");
 320     }
 321
 322     userPermissions.add(new UserPermission(className, name, actions));
 323   }
 324
 325   public Permissions getUserPermissions() {
 326     Permissions permissions = new Permissions();
 327     for (UserPermission permission : userPermissions) {
 328       permissions.add(new UnresolvedPermission(permission.getClassName(),
 329                                                permission.getName(),
 330                                                permission.getActions(),
 331                                                null));
 332     }
 333     permissions.setReadOnly();
 334     return permissions;
 335   }
 336
 337   public void setPublicRoot(String root) {
 338     if (root.indexOf('*') != -1) {
 339       throw new AppEngineConfigException("public-root cannot contain wildcards");
 340     }
 341     if (root.endsWith("/")) {
 342         root = root.substring(0, root.length() - 1);
 343     }
 344     if (root.length() > 0 && !root.startsWith("/")) {
 345       root = "/" + root;
 346     }
 347     staticIncludePattern = null;
 348     publicRoot = root;
 349   }
 350
 351   public String getPublicRoot() {
 352     return publicRoot;
 353   }
 354
 355   public void addInboundService(String service) {
 356     inboundServices.add(service);
 357   }
 358
 359   public Set<String> getInboundServices() {
 360     return inboundServices;
 361   }
 362
 363   public boolean getPrecompilationEnabled() {
 364     return precompilationEnabled;
 365   }
 366
 367   public void setPrecompilationEnabled(boolean precompilationEnabled) {
 368     this.precompilationEnabled = precompilationEnabled;
 369   }
 370
 371   public boolean getWarmupRequestsEnabled() {
 372     return inboundServices.contains(WARMUP_SERVICE);
 373   }
 374
 375   public void setWarmupRequestsEnabled(boolean warmupRequestsEnabled) {
 376     if (warmupRequestsEnabled) {
 377       inboundServices.add(WARMUP_SERVICE);
 378     } else {
 379       inboundServices.remove(WARMUP_SERVICE);
 380     }
 381   }
 382
 383   public List<AdminConsolePage> getAdminConsolePages() {
 384     return Collections.unmodifiableList(adminConsolePages);
 385   }
 386
 387   public void addAdminConsolePage(AdminConsolePage page) {
 388     adminConsolePages.add(page);
 389   }
 390
 391   public List<ErrorHandler> getErrorHandlers() {
 392     return Collections.unmodifiableList(errorHandlers);
 393   }
 394
 395   public void addErrorHandler(ErrorHandler handler) {
 396     errorHandlers.add(handler);
 397   }
 398
 399   public boolean getThreadsafe() {
 400     return threadsafe;
 401   }
 402
 403   public boolean getThreadsafeValueProvided() {
 404     return threadsafeValueProvided;
 405   }
 406
 407   public void setThreadsafe(boolean threadsafe) {
 408     this.threadsafe = threadsafe;
 409     this.threadsafeValueProvided = true;
 410   }
 411
 412   public void setAutoIdPolicy(String policy) {
 413     autoIdPolicy = policy;
 414   }
 415
 416   public String getAutoIdPolicy() {
 417     return autoIdPolicy;
 418   }
 419
 420   public boolean getCodeLock() {
 421     return codeLock;
 422   }
 423
 424   public void setCodeLock(boolean codeLock) {
 425     this.codeLock = codeLock;
 426   }
 427
 428   public void setUseVm(boolean useVm) {
 429     this.useVm = useVm;
 430   }
 431
 432   public boolean getUseVm() {
 433     return useVm;
 434   }
 435
 436   public ApiConfig getApiConfig() {
 437     return apiConfig;
 438   }
 439
 440   public void setApiConfig(ApiConfig config) {
 441     apiConfig = config;
 442   }
 443
 444   public ClassLoaderConfig getClassLoaderConfig() {
 445     return classLoaderConfig;
 446   }
 447
 448   public void setClassLoaderConfig(ClassLoaderConfig classLoaderConfig) {
 449     if (this.classLoaderConfig != null) {
 450       throw new AppEngineConfigException("class-loader-config may only be specified once.");
 451     }
 452     this.classLoaderConfig = classLoaderConfig;
 453   }
 454
 455   public String getUrlStreamHandlerType() {
 456     return urlStreamHandlerType;
 457   }
 458
 459   public void setUrlStreamHandlerType(String urlStreamHandlerType) {
 460     if (this.classLoaderConfig != null) {
 461       throw new AppEngineConfigException("url-stream-handler may only be specified once.");
 462     }
 463     if (!URL_HANDLER_URLFETCH.equals(urlStreamHandlerType)
 464         && !URL_HANDLER_NATIVE.equals(urlStreamHandlerType)) {
 465       throw new AppEngineConfigException(
 466           "url-stream-handler must be " + URL_HANDLER_URLFETCH + " or " + URL_HANDLER_NATIVE +
 467           " given " + urlStreamHandlerType);
 468     }
 469     this.urlStreamHandlerType = urlStreamHandlerType;
 470   }
 471
 472   /**
 473    * Returns true if {@code url} matches one of the servlets or servlet
 474    * filters listed in this web.xml that has api-endpoint set to true.
 475    */
 476   public boolean isApiEndpoint(String id) {
 477     return apiEndpointIds.contains(id);
 478   }
 479
 480   public void addApiEndpoint(String id) {
 481     apiEndpointIds.add(id);
 482   }
 483
 484   public Pagespeed getPagespeed() {
 485     return pagespeed;
 486   }
 487
 488   public void setPagespeed(Pagespeed pagespeed) {
 489     this.pagespeed = pagespeed;
 490   }
 491
 492   public void setUseGoogleConnectorJ(boolean useGoogleConnectorJ) {
 493     if (useGoogleConnectorJ) {
 494       this.useGoogleConnectorJ = UseGoogleConnectorJ.TRUE;
 495     } else {
 496       this.useGoogleConnectorJ = UseGoogleConnectorJ.FALSE;
 497     }
 498   }
 499
 500   public UseGoogleConnectorJ getUseGoogleConnectorJ() {
 501     return useGoogleConnectorJ;
 502   }
 503
 504   @Override
 505   public String toString() {
 506     return "AppEngineWebXml{" +
 507         "systemProperties=" + systemProperties +
 508         ", envVariables=" + envVariables +
 509         ", userPermissions=" + userPermissions +
 510         ", appId='" + appId + '\'' +
 511         ", majorVersionId='" + majorVersionId + '\'' +
 512         ", sourceLanguage='" + sourceLanguage + '\'' +
 513         ", module='" + module + '\'' +
 514         ", instanceClass='" + instanceClass + '\'' +
 515         ", automaticScaling=" + automaticScaling  +
 516         ", manualScaling=" + manualScaling  +
 517         ", basicScaling=" + basicScaling  +
 518         ", healthCheck=" + healthCheck +
 519         ", resources=" + resources +
 520         ", network=" + network +
 521         ", sslEnabled=" + sslEnabled +
 522         ", useSessions=" + useSessions +
 523         ", asyncSessionPersistence=" + asyncSessionPersistence +
 524         ", asyncSessionPersistenceQueueName='" + asyncSessionPersistenceQueueName + '\'' +
 525         ", staticFileIncludes=" + staticFileIncludes +
 526         ", staticFileExcludes=" + staticFileExcludes +
 527         ", resourceFileIncludes=" + resourceFileIncludes +
 528         ", resourceFileExcludes=" + resourceFileExcludes +
 529         ", staticIncludePattern=" + staticIncludePattern +
 530         ", staticExcludePattern=" + staticExcludePattern +
 531         ", resourceIncludePattern=" + resourceIncludePattern +
 532         ", resourceExcludePattern=" + resourceExcludePattern +
 533         ", publicRoot='" + publicRoot + '\'' +
 534         ", appRoot='" + appRoot + '\'' +
 535         ", inboundServices=" + inboundServices +
 536         ", precompilationEnabled=" + precompilationEnabled +
 537         ", adminConsolePages=" + adminConsolePages +
 538         ", errorHandlers=" + errorHandlers +
 539         ", threadsafe=" + threadsafe +
 540         ", threadsafeValueProvided=" + threadsafeValueProvided +
 541         ", autoIdPolicy=" + autoIdPolicy +
 542         ", codeLock=" + codeLock +
 543         ", apiConfig=" + apiConfig +
 544         ", apiEndpointIds=" + apiEndpointIds +
 545         ", pagespeed=" + pagespeed +
 546         ", classLoaderConfig=" + classLoaderConfig +
 547         ", urlStreamHandlerType=" +
 548             (urlStreamHandlerType == null ? URL_HANDLER_URLFETCH : urlStreamHandlerType) +
 549         ", useGoogleConnectorJ=" + useGoogleConnectorJ +
 550         '}';
 551   }
 552
 553   @Override
 554   public boolean equals(Object o) {
 555     if (this == o) {
 556       return true;
 557     }
 558     if (o == null || getClass() != o.getClass()) {
 559       return false;
 560     }
 561
 562     AppEngineWebXml that = (AppEngineWebXml) o;
 563
 564     if (asyncSessionPersistence != that.asyncSessionPersistence) {
 565       return false;
 566     }
 567     if (precompilationEnabled != that.precompilationEnabled) {
 568       return false;
 569     }
 570     if (sslEnabled != that.sslEnabled) {
 571       return false;
 572     }
 573     if (threadsafe != that.threadsafe) {
 574       return false;
 575     }
 576     if (threadsafeValueProvided != that.threadsafeValueProvided) {
 577       return false;
 578     }
 579     if (autoIdPolicy != null ? !autoIdPolicy.equals(that.autoIdPolicy)
 580         : that.autoIdPolicy != null) {
 581       return false;
 582     }
 583     if (codeLock != that.codeLock) {
 584       return false;
 585     }
 586     if (useSessions != that.useSessions) {
 587       return false;
 588     }
 589     if (adminConsolePages != null ? !adminConsolePages.equals(that.adminConsolePages)
 590         : that.adminConsolePages != null) {
 591       return false;
 592     }
 593     if (appId != null ? !appId.equals(that.appId) : that.appId != null) {
 594       return false;
 595     }
 596     if (majorVersionId != null ? !majorVersionId.equals(that.majorVersionId)
 597         : that.majorVersionId != null) {
 598       return false;
 599     }
 600     if (module != null ? !module.equals(that.module) : that.module != null) {
 601       return false;
 602     }
 603     if (instanceClass != null ? !instanceClass.equals(that.instanceClass)
 604         : that.instanceClass != null) {
 605       return false;
 606     }
 607     if (!automaticScaling.equals(that.automaticScaling)) {
 608       return false;
 609     }
 610     if (!manualScaling.equals(that.manualScaling)) {
 611       return false;
 612     }
 613     if (!basicScaling.equals(that.basicScaling)) {
 614       return false;
 615     }
 616     if (appRoot != null ? !appRoot.equals(that.appRoot) : that.appRoot != null) {
 617       return false;
 618     }
 619     if (asyncSessionPersistenceQueueName != null ? !asyncSessionPersistenceQueueName
 620         .equals(that.asyncSessionPersistenceQueueName)
 621         : that.asyncSessionPersistenceQueueName != null) {
 622       return false;
 623     }
 624     if (envVariables != null ? !envVariables.equals(that.envVariables)
 625         : that.envVariables != null) {
 626       return false;
 627     }
 628     if (errorHandlers != null ? !errorHandlers.equals(that.errorHandlers)
 629         : that.errorHandlers != null) {
 630       return false;
 631     }
 632     if (inboundServices != null ? !inboundServices.equals(that.inboundServices)
 633         : that.inboundServices != null) {
 634       return false;
 635     }
 636     if (majorVersionId != null ? !majorVersionId.equals(that.majorVersionId)
 637         : that.majorVersionId != null) {
 638       return false;
 639     }
 640     if (sourceLanguage != null ? !sourceLanguage.equals(that.sourceLanguage)
 641         : that.sourceLanguage != null) {
 642       return false;
 643     }
 644     if (publicRoot != null ? !publicRoot.equals(that.publicRoot) : that.publicRoot != null) {
 645       return false;
 646     }
 647     if (resourceExcludePattern != null ? !resourceExcludePattern.equals(that.resourceExcludePattern)
 648         : that.resourceExcludePattern != null) {
 649       return false;
 650     }
 651     if (resourceFileExcludes != null ? !resourceFileExcludes.equals(that.resourceFileExcludes)
 652         : that.resourceFileExcludes != null) {
 653       return false;
 654     }
 655     if (resourceFileIncludes != null ? !resourceFileIncludes.equals(that.resourceFileIncludes)
 656         : that.resourceFileIncludes != null) {
 657       return false;
 658     }
 659     if (resourceIncludePattern != null ? !resourceIncludePattern.equals(that.resourceIncludePattern)
 660         : that.resourceIncludePattern != null) {
 661       return false;
 662     }
 663     if (staticExcludePattern != null ? !staticExcludePattern.equals(that.staticExcludePattern)
 664         : that.staticExcludePattern != null) {
 665       return false;
 666     }
 667     if (staticFileExcludes != null ? !staticFileExcludes.equals(that.staticFileExcludes)
 668         : that.staticFileExcludes != null) {
 669       return false;
 670     }
 671     if (staticFileIncludes != null ? !staticFileIncludes.equals(that.staticFileIncludes)
 672         : that.staticFileIncludes != null) {
 673       return false;
 674     }
 675     if (staticIncludePattern != null ? !staticIncludePattern.equals(that.staticIncludePattern)
 676         : that.staticIncludePattern != null) {
 677       return false;
 678     }
 679     if (systemProperties != null ? !systemProperties.equals(that.systemProperties)
 680         : that.systemProperties != null) {
 681       return false;
 682     }
 683     if (betaSettings != null ? !betaSettings.equals(that.betaSettings) : that.betaSettings != null) {
 684       return false;
 685     }
 686     if (healthCheck != null ? !healthCheck.equals(that.healthCheck)
 687         : that.healthCheck != null) {
 688       return false;
 689     }
 690     if (resources != null ? !resources.equals(that.resources) : that.resources != null) {
 691       return false;
 692     }
 693     if (network != null ? !network.equals(that.network) : that.network != null) {
 694       return false;
 695     }
 696     if (userPermissions != null ? !userPermissions.equals(that.userPermissions)
 697         : that.userPermissions != null) {
 698       return false;
 699     }
 700     if (apiConfig != null ? !apiConfig.equals(that.apiConfig)
 701         : that.apiConfig != null) {
 702       return false;
 703     }
 704     if (apiEndpointIds != null ? !apiEndpointIds.equals(that.apiEndpointIds)
 705         : that.apiEndpointIds != null) {
 706       return false;
 707     }
 708     if (pagespeed != null ? !pagespeed.equals(that.pagespeed) : that.pagespeed != null) {
 709       return false;
 710     }
 711     if (classLoaderConfig != null ? !classLoaderConfig.equals(that.classLoaderConfig) :
 712         that.classLoaderConfig != null) {
 713       return false;
 714     }
 715     if (urlStreamHandlerType != null ? !urlStreamHandlerType.equals(that.urlStreamHandlerType) :
 716         that.urlStreamHandlerType != null) {
 717       return false;
 718     }
 719     if (useGoogleConnectorJ != that.useGoogleConnectorJ) {
 720       return false;
 721     }
 722
 723     return true;
 724   }
 725
 726   @Override
 727   public int hashCode() {
 728     int result = systemProperties != null ? systemProperties.hashCode() : 0;
 729     result = 31 * result + (envVariables != null ? envVariables.hashCode() : 0);
 730     result = 31 * result + (userPermissions != null ? userPermissions.hashCode() : 0);
 731     result = 31 * result + (appId != null ? appId.hashCode() : 0);
 732     result = 31 * result + (majorVersionId != null ? majorVersionId.hashCode() : 0);
 733     result = 31 * result + (sourceLanguage != null ? sourceLanguage.hashCode() : 0);
 734     result = 31 * result + (module != null ? module.hashCode() : 0);
 735     result = 31 * result + (instanceClass != null ? instanceClass.hashCode() : 0);
 736     result = 31 * result + automaticScaling.hashCode();
 737     result = 31 * result + manualScaling.hashCode();
 738     result = 31 * result + basicScaling.hashCode();
 739     result = 31 * result + (sslEnabled ? 1 : 0);
 740     result = 31 * result + (useSessions ? 1 : 0);
 741     result = 31 * result + (asyncSessionPersistence ? 1 : 0);
 742     result =
 743         31 * result + (asyncSessionPersistenceQueueName != null ? asyncSessionPersistenceQueueName
 744             .hashCode() : 0);
 745     result = 31 * result + (staticFileIncludes != null ? staticFileIncludes.hashCode() : 0);
 746     result = 31 * result + (staticFileExcludes != null ? staticFileExcludes.hashCode() : 0);
 747     result = 31 * result + (resourceFileIncludes != null ? resourceFileIncludes.hashCode() : 0);
 748     result = 31 * result + (resourceFileExcludes != null ? resourceFileExcludes.hashCode() : 0);
 749     result = 31 * result + (staticIncludePattern != null ? staticIncludePattern.hashCode() : 0);
 750     result = 31 * result + (staticExcludePattern != null ? staticExcludePattern.hashCode() : 0);
 751     result = 31 * result + (resourceIncludePattern != null ? resourceIncludePattern.hashCode() : 0);
 752     result = 31 * result + (resourceExcludePattern != null ? resourceExcludePattern.hashCode() : 0);
 753     result = 31 * result + (publicRoot != null ? publicRoot.hashCode() : 0);
 754     result = 31 * result + (appRoot != null ? appRoot.hashCode() : 0);
 755     result = 31 * result + (inboundServices != null ? inboundServices.hashCode() : 0);
 756     result = 31 * result + (precompilationEnabled ? 1 : 0);
 757     result = 31 * result + (adminConsolePages != null ? adminConsolePages.hashCode() : 0);
 758     result = 31 * result + (errorHandlers != null ? errorHandlers.hashCode() : 0);
 759     result = 31 * result + (threadsafe ? 1 : 0);
 760     result = 31 * result + (autoIdPolicy != null ? autoIdPolicy.hashCode() : 0);
 761     result = 31 * result + (threadsafeValueProvided ? 1 : 0);
 762     result = 31 * result + (codeLock ? 1 : 0);
 763     result = 31 * result + (apiConfig != null ? apiConfig.hashCode() : 0);
 764     result = 31 * result + (apiEndpointIds != null ? apiEndpointIds.hashCode() : 0);
 765     result = 31 * result + (pagespeed != null ? pagespeed.hashCode() : 0);
 766     result = 31 * result + (classLoaderConfig != null ? classLoaderConfig.hashCode() : 0);
 767     result = 31 * result + (urlStreamHandlerType != null ? urlStreamHandlerType.hashCode() : 0);
 768     result = 31 * result + (useGoogleConnectorJ.hashCode());
 769     result = 31 * result + (betaSettings != null ? betaSettings.hashCode() : 0);
 770     result = 31 * result + (healthCheck != null ? healthCheck.hashCode() : 0);
 771     result = 31 * result + (resources != null ? resources.hashCode() : 0);
 772     result = 31 * result + (network != null ? network.hashCode() : 0);
 773     return result;
 774   }
 775
 776   public boolean includesResource(String path) {
 777     if (resourceIncludePattern == null) {
 778       if (resourceFileIncludes.size() == 0) {
 779         resourceIncludePattern = Pattern.compile(".*");
 780       } else {
 781         resourceIncludePattern = Pattern.compile(makeRegexp(resourceFileIncludes));
 782       }
 783     }
 784     if (resourceExcludePattern == null && resourceFileExcludes.size() > 0) {
 785       resourceExcludePattern = Pattern.compile(makeRegexp(resourceFileExcludes));
 786     } else {
 787     }
 788     return includes(path, resourceIncludePattern, resourceExcludePattern);
 789   }
 790
 791   public boolean includesStatic(String path) {
 792     if (staticIncludePattern == null) {
 793       if (staticFileIncludes.size() == 0) {
 794         String staticRoot;
 795         if (publicRoot.length() > 0) {
 796           staticRoot = publicRoot + "/**";
 797         } else {
 798           staticRoot = "**";
 799         }
 800         staticIncludePattern = Pattern.compile(
 801             makeRegexp(Collections.singletonList(staticRoot)));
 802       } else {
 803         List<String> patterns = new ArrayList<String>();
 804         for (StaticFileInclude include : staticFileIncludes) {
 805           patterns.add(include.getPattern());
 806         }
 807         staticIncludePattern = Pattern.compile(makeRegexp(patterns));
 808       }
 809     }
 810     if (staticExcludePattern == null && staticFileExcludes.size() > 0) {
 811       staticExcludePattern = Pattern.compile(makeRegexp(staticFileExcludes));
 812     } else {
 813     }
 814     return includes(path, staticIncludePattern, staticExcludePattern);
 815   }
 816
 817   /**
 818    * Tests whether {@code path} is covered by the pattern {@code includes}
 819    * while not being blocked by matching {@code excludes}.
 820    *
 821    * @param path a URL to test
 822    * @param includes a non-{@code null} pattern for included URLs
 823    * @param excludes a pattern for exclusion, or {@code null} to not exclude
 824    *    anything from the {@code includes} set.
 825    */
 826   public boolean includes(String path, Pattern includes, Pattern excludes) {
 827     assert(includes != null);
 828     if (!includes.matcher(path).matches()) {
 829       return false;
 830     }
 831     if (excludes != null && excludes.matcher(path).matches()) {
 832       return false;
 833     }
 834     return true;
 835   }
 836
 837   public String makeRegexp(List<String> patterns) {
 838     StringBuilder builder = new StringBuilder();
 839     boolean first = true;
 840     for (String item : patterns) {
 841       if (first) {
 842         first = false;
 843       } else {
 844         builder.append('|');
 845       }
 846
 847       while (item.charAt(0) == '/') {
 848         item = item.substring(1);
 849       }
 850
 851       builder.append('(');
 852       if (appRoot != null) {
 853         builder.append(makeFileRegex(appRoot));
 854       }
 855       builder.append("/");
 856       builder.append(makeFileRegex(item));
 857       builder.append(')');
 858     }
 859     return builder.toString();
 860   }
 861
 862   /**
 863    * Helper method to translate from appengine-web.xml "file globs" to
 864    * proper regular expressions as used in app.yaml.
 865    *
 866    * @param fileGlob the glob to translate
 867    * @return the regular expression string matching the input {@code file} pattern.
 868    */
 869   static String makeFileRegex(String fileGlob) {
 870     fileGlob = fileGlob.replaceAll("([^A-Za-z0-9\\-_/])", "\\\\$1");
 871     fileGlob = fileGlob.replaceAll("\\\\\\*\\\\\\*", ".*");
 872     fileGlob = fileGlob.replaceAll("\\\\\\*", "[^/]*");
 873     return fileGlob;
 874   }
 875   /**
 876    * Sets the application root directory, as a prefix for the regexps in
 877    * {@link #includeResourcePattern(String)} and friends.  This is needed
 878    * because we want to match complete filenames relative to root.
 879    *
 880    * @param appRoot
 881    */
 882   public void setSourcePrefix(String appRoot) {
 883     this.appRoot = appRoot;
 884     this.resourceIncludePattern = null;
 885     this.resourceExcludePattern = null;
 886     this.staticIncludePattern = null;
 887     this.staticExcludePattern = null;
 888   }
 889
 890   public String getSourcePrefix() {
 891     return this.appRoot;
 892   }
 893
 894   /**
 895    * Represents a {@link java.security.Permission} that needs to be
 896    * granted to user code.
 897    */
 898   private static class UserPermission {
 899     private final String className;
 900     private final String name;
 901     private final String actions;
 902
 903     private boolean hasHashCode = false;
 904     private int hashCode;
 905
 906     public UserPermission(String className, String name, String actions) {
 907       this.className = className;
 908       this.name = name;
 909       this.actions = actions;
 910     }
 911
 912     public String getClassName() {
 913       return className;
 914     }
 915
 916     public String getName() {
 917       return name;
 918     }
 919
 920     public String getActions() {
 921       return actions;
 922     }
 923
 924     @Override
 925     public int hashCode() {
 926       if (hasHashCode) {
 927         return hashCode;
 928       }
 929
 930       int hash = className.hashCode();
 931       hash = 31 * hash + name.hashCode();
 932       if (actions != null) {
 933         hash = 31 * hash + actions.hashCode();
 934       }
 935
 936       hashCode = hash;
 937       hasHashCode = true;
 938       return hashCode;
 939     }
 940
 941     @Override
 942     public boolean equals(Object obj) {
 943       if (obj instanceof UserPermission) {
 944         UserPermission perm = (UserPermission) obj;
 945         if (className.equals(perm.className) && name.equals(perm.name)) {
 946           if (actions == null ? perm.actions == null : actions.equals(perm.actions)) {
 947             return true;
 948           }
 949         }
 950       }
 951       return false;
 952     }
 953   }
 954
 955   /**
 956    * Represents an &lt;include&gt; element within the
 957    * &lt;static-files&gt; element.  Currently this includes both a
 958    * pattern and an optional expiration time specification.
 959    */
 960   public static class StaticFileInclude {
 961     private final String pattern;
 962     private final String expiration;
 963     private final Map<String, String> httpHeaders;
 964
 965     public StaticFileInclude(String pattern, String expiration) {
 966       this.pattern = pattern;
 967       this.expiration = expiration;
 968       this.httpHeaders = new LinkedHashMap<>();
 969     }
 970
 971     public String getPattern() {
 972       return pattern;
 973     }
 974
 975     public Pattern getRegularExpression() {
 976       return Pattern.compile(makeFileRegex(pattern));
 977     }
 978
 979     public String getExpiration() {
 980       return expiration;
 981     }
 982
 983     public Map<String, String> getHttpHeaders() {
 984       return httpHeaders;
 985     }
 986
 987     @Override
 988     public int hashCode() {
 989       return Objects.hash(pattern, expiration, httpHeaders);
 990     }
 991
 992     @Override
 993     public boolean equals(Object obj) {
 994       if (!(obj instanceof StaticFileInclude)) {
 995         return false;
 996       }
 997
 998       StaticFileInclude other = (StaticFileInclude) obj;
 999
1000       if (pattern != null) {
1001         if (!pattern.equals(other.pattern)) {
1002           return false;
1003         }
1004       } else {
1005         if (other.pattern != null) {
1006           return false;
1007         }
1008       }
1009
1010       if (expiration != null) {
1011         if (!expiration.equals(other.expiration)) {
1012           return false;
1013         }
1014       } else {
1015         if (other.expiration != null) {
1016           return false;
1017         }
1018       }
1019
1020       if (httpHeaders != null) {
1021         if (!httpHeaders.equals(other.httpHeaders)) {
1022           return false;
1023         }
1024       } else {
1025         if (other.httpHeaders != null) {
1026           return false;
1027         }
1028       }
1029
1030       return true;
1031     }
1032   }
1033
1034   public static class AdminConsolePage {
1035     private final String name;
1036     private final String url;
1037
1038     public AdminConsolePage(String name, String url) {
1039       this.name = name;
1040       this.url = url;
1041     }
1042
1043     public String getName() {
1044       return name;
1045     }
1046
1047     public String getUrl() {
1048       return url;
1049     }
1050
1051     @Override
1052     public int hashCode() {
1053       final int prime = 31;
1054       int result = 1;
1055       result = prime * result + ((name == null) ? 0 : name.hashCode());
1056       result = prime * result + ((url == null) ? 0 : url.hashCode());
1057       return result;
1058     }
1059
1060     @Override
1061     public boolean equals(Object obj) {
1062       if (this == obj) return true;
1063       if (obj == null) return false;
1064       if (getClass() != obj.getClass()) return false;
1065       AdminConsolePage other = (AdminConsolePage) obj;
1066       if (name == null) {
1067         if (other.name != null) return false;
1068       } else if (!name.equals(other.name)) return false;
1069       if (url == null) {
1070         if (other.url != null) return false;
1071       } else if (!url.equals(other.url)) return false;
1072       return true;
1073     }
1074   }
1075
1076   /**
1077    * Represents an &lt;error-handler&gt; element.  Currently this includes both
1078    * a file name and an optional error code.
1079    */
1080   public static class ErrorHandler {
1081     private final String file;
1082     private final String errorCode;
1083
1084     public ErrorHandler(String file, String errorCode) {
1085       this.file = file;
1086       this.errorCode = errorCode;
1087     }
1088
1089     public String getFile() {
1090       return file;
1091     }
1092
1093     public String getErrorCode() {
1094       return errorCode;
1095     }
1096
1097     @Override
1098     public int hashCode() {
1099       final int prime = 31;
1100       int result = 1;
1101       result = prime * result + ((file == null) ? 0 : file.hashCode());
1102       result = prime * result +
1103           ((errorCode == null) ? 0 : errorCode.hashCode());
1104       return result;
1105     }
1106
1107     @Override
1108     public boolean equals(Object obj) {
1109       if (!(obj instanceof ErrorHandler)) {
1110         return false;
1111       }
1112
1113       ErrorHandler handler = (ErrorHandler) obj;
1114       if (!file.equals(handler.file)) {
1115         return false;
1116       }
1117
1118       if (errorCode == null) {
1119         if (handler.errorCode != null) {
1120           return false;
1121         }
1122       } else {
1123         if (!errorCode.equals(handler.errorCode)) {
1124           return false;
1125         }
1126       }
1127
1128       return true;
1129     }
1130   }
1131
1132   /**
1133    * Represents an &lt;api-config&gt; element.  This is a singleton specifying
1134    * url-pattern and servlet-class for the api config server.
1135    */
1136   public static class ApiConfig {
1137     private final String servletClass;
1138     private final String url;
1139
1140     public ApiConfig(String servletClass, String url) {
1141       this.servletClass = servletClass;
1142       this.url = url;
1143     }
1144
1145     public String getservletClass() {
1146       return servletClass;
1147     }
1148
1149     public String getUrl() {
1150       return url;
1151     }
1152
1153     @Override
1154     public int hashCode() {
1155       final int prime = 31;
1156       int result = 1;
1157       result = prime * result + ((servletClass == null) ? 0 : servletClass.hashCode());
1158       result = prime * result + ((url == null) ? 0 : url.hashCode());
1159       return result;
1160     }
1161
1162     @Override
1163     public boolean equals(Object obj) {
1164       if (this == obj) { return true; }
1165       if (obj == null) { return false; }
1166       if (getClass() != obj.getClass()) { return false; }
1167       ApiConfig other = (ApiConfig) obj;
1168       if (servletClass == null) {
1169         if (other.servletClass != null) { return false; }
1170       } else if (!servletClass.equals(other.servletClass)) { return false; }
1171       if (url == null) {
1172         if (other.url != null) { return false; }
1173       } else if (!url.equals(other.url)) { return false; }
1174       return true;
1175     }
1176
1177     @Override
1178     public String toString() {
1179       return "ApiConfig{servletClass=\"" + servletClass + "\", url=\"" + url + "\"}";
1180     }
1181   }
1182
1183   /**
1184    * Holder for automatic settings.
1185    */
1186   public static class AutomaticScaling {
1187     private static final AutomaticScaling EMPTY_SETTINGS = new AutomaticScaling();
1188
1189     public static final String AUTOMATIC = "automatic";
1190     private String minPendingLatency;
1191     private String maxPendingLatency;
1192     private String minIdleInstances;
1193     private String maxIdleInstances;
1194     private String maxConcurrentRequests;
1195
1196     private Integer minNumInstances;
1197     private Integer maxNumInstances;
1198     private Integer coolDownPeriodSec;
1199     private CpuUtilization cpuUtilization;
1200
1201     public String getMinPendingLatency() {
1202       return minPendingLatency;
1203     }
1204
1205     /**
1206      * Sets minPendingLatency. Normalizes empty and null inputs to null.
1207      */
1208     public void setMinPendingLatency(String minPendingLatency) {
1209       this.minPendingLatency = StringUtil.toNullIfEmptyOrWhitespace(minPendingLatency);
1210     }
1211
1212     public String getMaxPendingLatency() {
1213       return maxPendingLatency;
1214     }
1215
1216     /**
1217      * Sets maxPendingLatency. Normalizes empty and null inputs to null.
1218      */
1219     public void setMaxPendingLatency(String maxPendingLatency) {
1220       this.maxPendingLatency =  StringUtil.toNullIfEmptyOrWhitespace(maxPendingLatency);
1221     }
1222
1223     public String getMinIdleInstances() {
1224       return minIdleInstances;
1225     }
1226
1227     /**
1228      * Sets minIdleInstances. Normalizes empty and null inputs to null.
1229      */
1230     public void setMinIdleInstances(String minIdleInstances) {
1231       this.minIdleInstances =  StringUtil.toNullIfEmptyOrWhitespace(minIdleInstances);
1232     }
1233
1234     public String getMaxIdleInstances() {
1235       return maxIdleInstances;
1236     }
1237
1238     /**
1239      * Sets maxIdleInstances. Normalizes empty and null inputs to null.
1240      */
1241     public void setMaxIdleInstances(String maxIdleInstances) {
1242       this.maxIdleInstances =  StringUtil.toNullIfEmptyOrWhitespace(maxIdleInstances);
1243     }
1244
1245     public boolean isEmpty() {
1246       return this.equals(EMPTY_SETTINGS);
1247     }
1248
1249     public String getMaxConcurrentRequests() {
1250       return maxConcurrentRequests;
1251     }
1252
1253     /**
1254      * Sets maxConcurrentRequests. Normalizes empty and null inputs to null.
1255      */
1256     public void setMaxConcurrentRequests(String maxConcurrentRequests) {
1257       this.maxConcurrentRequests =  StringUtil.toNullIfEmptyOrWhitespace(maxConcurrentRequests);
1258     }
1259
1260     public Integer getMinNumInstances() {
1261       return minNumInstances;
1262     }
1263
1264     public void setMinNumInstances(Integer minNumInstances) {
1265       this.minNumInstances = minNumInstances;
1266     }
1267
1268     public Integer getMaxNumInstances() {
1269       return maxNumInstances;
1270     }
1271
1272     public void setMaxNumInstances(Integer maxNumInstances) {
1273       this.maxNumInstances = maxNumInstances;
1274     }
1275
1276     public Integer getCoolDownPeriodSec() {
1277       return coolDownPeriodSec;
1278     }
1279
1280     public void setCoolDownPeriodSec(Integer coolDownPeriodSec) {
1281       this.coolDownPeriodSec = coolDownPeriodSec;
1282     }
1283
1284     public CpuUtilization getCpuUtilization() {
1285       return cpuUtilization;
1286     }
1287
1288     public void setCpuUtilization(CpuUtilization cpuUtilization) {
1289       this.cpuUtilization = cpuUtilization;
1290     }
1291
1292     @Override
1293     public int hashCode() {
1294       return Objects.hash(maxPendingLatency, minPendingLatency, maxIdleInstances,
1295                               minIdleInstances, maxConcurrentRequests, minNumInstances,
1296                               maxNumInstances, coolDownPeriodSec, cpuUtilization);
1297     }
1298
1299     @Override
1300     public boolean equals(Object obj) {
1301       if (this == obj) {
1302         return true;
1303       }
1304       if (obj == null) {
1305         return false;
1306       }
1307       if (getClass() != obj.getClass()) {
1308         return false;
1309       }
1310       AutomaticScaling other = (AutomaticScaling) obj;
1311       return Objects.equals(maxPendingLatency, other.maxPendingLatency)
1312           && Objects.equals(minPendingLatency, other.minPendingLatency)
1313           && Objects.equals(maxIdleInstances, other.maxIdleInstances)
1314           && Objects.equals(minIdleInstances, other.minIdleInstances)
1315           && Objects.equals(maxConcurrentRequests, other.maxConcurrentRequests)
1316           && Objects.equals(minNumInstances, other.minNumInstances)
1317           && Objects.equals(maxNumInstances, other.maxNumInstances)
1318           && Objects.equals(coolDownPeriodSec, other.coolDownPeriodSec)
1319           && Objects.equals(cpuUtilization, other.cpuUtilization);
1320     }
1321
1322     @Override
1323     public String toString() {
1324       return "AutomaticScaling [minPendingLatency=" + minPendingLatency
1325           + ", maxPendingLatency=" + maxPendingLatency
1326           + ", minIdleInstances=" + minIdleInstances
1327           + ", maxIdleInstances=" + maxIdleInstances
1328           + ", maxConcurrentRequests=" + maxConcurrentRequests
1329           + ", minNumInstances=" + minNumInstances
1330           + ", maxNumInstances=" + maxNumInstances
1331           + ", coolDownPeriodSec=" + coolDownPeriodSec
1332           + ", cpuUtilization=" + cpuUtilization + "]";
1333     }
1334   }
1335
1336   /**
1337    * Holder for CPU utilization.
1338    */
1339   public static class CpuUtilization {
1340     private static final CpuUtilization EMPTY_SETTINGS = new CpuUtilization();
1341     private Double targetUtilization;
1342     private Integer aggregationWindowLengthSec;
1343
1344     public Double getTargetUtilization() {
1345       return targetUtilization;
1346     }
1347
1348     public void setTargetUtilization(Double targetUtilization) {
1349       this.targetUtilization = targetUtilization;
1350     }
1351
1352     public Integer getAggregationWindowLengthSec() {
1353       return aggregationWindowLengthSec;
1354     }
1355
1356     public void setAggregationWindowLengthSec(Integer aggregationWindowLengthSec) {
1357       this.aggregationWindowLengthSec = aggregationWindowLengthSec;
1358     }
1359
1360     public boolean isEmpty() {
1361       return this.equals(EMPTY_SETTINGS);
1362     }
1363
1364     @Override
1365     public int hashCode() {
1366       return Objects.hash(targetUtilization, aggregationWindowLengthSec);
1367     }
1368
1369     @Override
1370     public boolean equals(Object obj) {
1371       if (this == obj) {
1372         return true;
1373       }
1374       if (obj == null) {
1375         return false;
1376       }
1377       if (getClass() != obj.getClass()) {
1378         return false;
1379       }
1380       CpuUtilization other = (CpuUtilization) obj;
1381       return Objects.equals(targetUtilization, other.targetUtilization)
1382           && Objects.equals(aggregationWindowLengthSec, other.aggregationWindowLengthSec);
1383     }
1384
1385     @Override
1386     public String toString() {
1387       return "CpuUtilization [targetUtilization=" + targetUtilization
1388           + ", aggregationWindowLengthSec=" + aggregationWindowLengthSec + "]";
1389     }
1390   }
1391
1392   /**
1393    * Holder for health check.
1394    */
1395   public static class HealthCheck {
1396     private static final HealthCheck EMPTY_SETTINGS = new HealthCheck();
1397
1398     private boolean enableHealthCheck = true;
1399     private Integer checkIntervalSec;
1400     private Integer timeoutSec;
1401     private Integer unhealthyThreshold;
1402     private Integer healthyThreshold;
1403     private Integer restartThreshold;
1404     private String host;
1405
1406     public boolean getEnableHealthCheck() {
1407       return enableHealthCheck;
1408     }
1409     /**
1410      * Sets enableHealthCheck.
1411      */
1412     public void setEnableHealthCheck(boolean enableHealthCheck) {
1413       this.enableHealthCheck = enableHealthCheck;
1414     }
1415
1416     public Integer getCheckIntervalSec() {
1417       return checkIntervalSec;
1418     }
1419     /**
1420      * Sets checkIntervalSec.
1421      */
1422     public void setCheckIntervalSec(Integer checkIntervalSec) {
1423       this.checkIntervalSec = checkIntervalSec;
1424     }
1425
1426     public Integer getTimeoutSec() {
1427       return timeoutSec;
1428     }
1429     /**
1430      * Sets timeoutSec.
1431      */
1432     public void setTimeoutSec(Integer timeoutSec) {
1433       this.timeoutSec = timeoutSec;
1434     }
1435
1436     public Integer getUnhealthyThreshold() {
1437       return unhealthyThreshold;
1438     }
1439
1440     /**
1441      * Sets unhealthyThreshold.
1442      */
1443     public void setUnhealthyThreshold(Integer unhealthyThreshold) {
1444       this.unhealthyThreshold = unhealthyThreshold;
1445     }
1446
1447     public Integer getHealthyThreshold() {
1448       return healthyThreshold;
1449     }
1450
1451     /**
1452      * Sets healthyThreshold.
1453      */
1454
1455     public void setHealthyThreshold(Integer healthyThreshold) {
1456       this.healthyThreshold = healthyThreshold;
1457     }
1458
1459     public Integer getRestartThreshold() {
1460       return restartThreshold;
1461     }
1462
1463     /**
1464      * Sets restartThreshold.
1465      */
1466     public void setRestartThreshold(Integer restartThreshold) {
1467       this.restartThreshold = restartThreshold;
1468     }
1469
1470     public String getHost() {
1471       return host;
1472     }
1473
1474     /**
1475      * Sets host. Normalizes empty and null inputs to null.
1476      */
1477     public void setHost(String host) {
1478       this.host = StringUtil.toNullIfEmptyOrWhitespace(host);
1479     }
1480
1481     public boolean isEmpty() {
1482       return this.equals(EMPTY_SETTINGS);
1483     }
1484
1485     @Override
1486     public int hashCode() {
1487       return Objects.hash(enableHealthCheck, checkIntervalSec, timeoutSec, unhealthyThreshold,
1488                               healthyThreshold, restartThreshold, host);
1489     }
1490
1491     @Override
1492     public boolean equals(Object obj) {
1493       if (this == obj) {
1494         return true;
1495       }
1496       if (obj == null) {
1497         return false;
1498       }
1499       if (getClass() != obj.getClass()) {
1500         return false;
1501       }
1502       HealthCheck other = (HealthCheck) obj;
1503       return Objects.equals(enableHealthCheck, other.enableHealthCheck)
1504           && Objects.equals(checkIntervalSec, other.checkIntervalSec)
1505           && Objects.equals(timeoutSec, other.timeoutSec)
1506           && Objects.equals(unhealthyThreshold, other.unhealthyThreshold)
1507           && Objects.equals(healthyThreshold, other.healthyThreshold)
1508           && Objects.equals(restartThreshold, other.restartThreshold)
1509           && Objects.equals(host, other.host);
1510     }
1511
1512     @Override
1513     public String toString() {
1514       return "HealthCheck [enableHealthCheck=" + enableHealthCheck
1515           + ", checkIntervalSec=" + checkIntervalSec
1516           + ", timeoutSec=" + timeoutSec
1517           + ", unhealthyThreshold=" + unhealthyThreshold
1518           + ", healthyThreshold=" + healthyThreshold
1519           + ", restartThreshold=" + restartThreshold
1520           + ", host=" + host + "]";
1521     }
1522   }
1523
1524   /**
1525    * Holder for Resources
1526    */
1527   public static class Resources {
1528     private static final Resources EMPTY_SETTINGS = new Resources();
1529
1530     private double cpu;
1531
1532     public double getCpu() {
1533       return cpu;
1534     }
1535
1536     public void setCpu(double cpu) {
1537       this.cpu = cpu;
1538     }
1539
1540     private double memory_gb;
1541
1542     public double getMemoryGb() {
1543       return memory_gb;
1544     }
1545
1546     public void setMemoryGb(double memory_gb) {
1547       this.memory_gb = memory_gb;
1548     }
1549
1550     private int disk_size_gb;
1551
1552     public int getDiskSizeGb() {
1553       return disk_size_gb;
1554     }
1555
1556     public void setDiskSizeGb(int disk_size_gb) {
1557       this.disk_size_gb = disk_size_gb;
1558     }
1559
1560     public boolean isEmpty() {
1561       return this.equals(EMPTY_SETTINGS);
1562     }
1563
1564     @Override
1565     public int hashCode() {
1566       return Objects.hash(cpu, memory_gb, disk_size_gb);
1567     }
1568
1569     @Override
1570     public boolean equals(Object obj) {
1571       if (this == obj) {
1572         return true;
1573       }
1574       if (obj == null) {
1575         return false;
1576       }
1577       if (getClass() != obj.getClass()) {
1578         return false;
1579       }
1580       Resources other = (Resources) obj;
1581       return Objects.equals(cpu, other.cpu) &&
1582           Objects.equals(memory_gb, other.memory_gb) &&
1583           Objects.equals(disk_size_gb, other.disk_size_gb);
1584     }
1585
1586     @Override
1587     public String toString() {
1588       return "Resources [" + "cpu=" + cpu +
1589           ", memory_gb=" + memory_gb +
1590           ", disk_size_gb=" + disk_size_gb + "]";
1591     }
1592   }
1593
1594   /**
1595    * Holder for network.
1596    */
1597   public static class Network {
1598     private static final Network EMPTY_SETTINGS = new Network();
1599
1600     private String instanceTag;
1601
1602     public String getInstanceTag() {
1603       return instanceTag;
1604     }
1605
1606     public void setInstanceTag(String instanceTag) {
1607       this.instanceTag = instanceTag;
1608     }
1609
1610     private final List<String> forwardedPorts = Lists.newArrayList();
1611
1612     public List<String> getForwardedPorts() {
1613       return Collections.unmodifiableList(forwardedPorts);
1614     }
1615
1616     public void addForwardedPort(String forwardedPort) {
1617       forwardedPorts.add(forwardedPort);
1618     }
1619
1620     private String name;
1621
1622     public String getName() {
1623       return name;
1624     }
1625
1626     public void setName(String name) {
1627       this.name = name;
1628     }
1629
1630     public boolean isEmpty() {
1631       return this.equals(EMPTY_SETTINGS);
1632     }
1633
1634     @Override
1635     public int hashCode() {
1636       return Objects.hash(forwardedPorts, instanceTag);
1637     }
1638
1639     @Override
1640     public boolean equals(Object obj) {
1641       if (this == obj) {
1642         return true;
1643       }
1644       if (obj == null) {
1645         return false;
1646       }
1647       if (getClass() != obj.getClass()) {
1648         return false;
1649       }
1650       Network other = (Network) obj;
1651       return Objects.equals(forwardedPorts, other.forwardedPorts)
1652           && Objects.equals(instanceTag, other.instanceTag);
1653     }
1654
1655     @Override
1656     public String toString() {
1657       return "Network [forwardedPorts=" + forwardedPorts + ", instanceTag=" + instanceTag + "]";
1658     }
1659   }
1660
1661   /**
1662    * Holder for manual settings.
1663    */
1664   public static class ManualScaling {
1665     private static final ManualScaling EMPTY_SETTINGS = new ManualScaling();
1666
1667     private String instances;
1668
1669     public String getInstances() {
1670       return instances;
1671     }
1672
1673     /**
1674      * Sets instances. Normalizes empty and null inputs to null.
1675      */
1676     public void setInstances(String instances) {
1677       this.instances = StringUtil.toNullIfEmptyOrWhitespace(instances);
1678     }
1679
1680     public boolean isEmpty() {
1681       return this.equals(EMPTY_SETTINGS);
1682     }
1683
1684     @Override
1685     public int hashCode() {
1686       return Objects.hash(instances);
1687     }
1688
1689     @Override
1690     public boolean equals(Object obj) {
1691       if (this == obj) {
1692         return true;
1693       }
1694       if (obj == null) {
1695         return false;
1696       }
1697       if (getClass() != obj.getClass()) {
1698         return false;
1699       }
1700       ManualScaling other = (ManualScaling) obj;
1701       return Objects.equals(instances, other.instances);
1702     }
1703
1704     @Override
1705     public String toString() {
1706       return "ManualScaling [" + "instances=" + instances + "]";
1707     }
1708   }
1709
1710   /**
1711    * Holder for basic settings.
1712    */
1713   public static class BasicScaling {
1714     private static final BasicScaling EMPTY_SETTINGS = new BasicScaling();
1715
1716     private String maxInstances;
1717     private String idleTimeout;
1718
1719     public String getMaxInstances() {
1720       return maxInstances;
1721     }
1722
1723     public String getIdleTimeout() {
1724       return idleTimeout;
1725     }
1726
1727     /**
1728      * Sets maxInstances. Normalizes empty and null inputs to null.
1729      */
1730     public void setMaxInstances(String maxInstances) {
1731       this.maxInstances = StringUtil.toNullIfEmptyOrWhitespace(maxInstances);
1732     }
1733
1734     /**
1735      * Sets idleTimeout. Normalizes empty and null inputs to null.
1736      */
1737     public void setIdleTimeout(String idleTimeout) {
1738       this.idleTimeout = StringUtil.toNullIfEmptyOrWhitespace(idleTimeout);
1739     }
1740
1741     public boolean isEmpty() {
1742       return this.equals(EMPTY_SETTINGS);
1743     }
1744
1745     @Override
1746     public int hashCode() {
1747       return Objects.hash(maxInstances, idleTimeout);
1748     }
1749
1750     @Override
1751     public boolean equals(Object obj) {
1752       if (this == obj) {
1753         return true;
1754       }
1755       if (obj == null) {
1756         return false;
1757       }
1758       if (getClass() != obj.getClass()) {
1759         return false;
1760       }
1761       BasicScaling other = (BasicScaling) obj;
1762       return Objects.equals(maxInstances, other.maxInstances)
1763           && Objects.equals(idleTimeout, other.idleTimeout);
1764     }
1765
1766     @Override
1767     public String toString() {
1768       return "BasicScaling [" + "maxInstances=" + maxInstances
1769           + ", idleTimeout=" + idleTimeout + "]";
1770     }
1771   }
1772
1773   /**
1774    * Represents a &lt;pagespeed&gt; element. This is used to specify configuration for the Page
1775    * Speed Service, which can be used to automatically optimize the loading speed of app engine
1776    * sites.
1777    */
1778   public static class Pagespeed {
1779     private final List<String> urlBlacklist = Lists.newArrayList();
1780     private final List<String> domainsToRewrite = Lists.newArrayList();
1781     private final List<String> enabledRewriters = Lists.newArrayList();
1782     private final List<String> disabledRewriters = Lists.newArrayList();
1783
1784     public void addUrlBlacklist(String url) {
1785       urlBlacklist.add(url);
1786     }
1787
1788     public List<String> getUrlBlacklist() {
1789       return Collections.unmodifiableList(urlBlacklist);
1790     }
1791
1792     public void addDomainToRewrite(String domain) {
1793       domainsToRewrite.add(domain);
1794     }
1795
1796     public List<String> getDomainsToRewrite() {
1797       return Collections.unmodifiableList(domainsToRewrite);
1798     }
1799
1800     public void addEnabledRewriter(String rewriter) {
1801       enabledRewriters.add(rewriter);
1802     }
1803
1804     public List<String> getEnabledRewriters() {
1805       return Collections.unmodifiableList(enabledRewriters);
1806     }
1807
1808     public void addDisabledRewriter(String rewriter) {
1809       disabledRewriters.add(rewriter);
1810     }
1811
1812     public List<String> getDisabledRewriters() {
1813       return Collections.unmodifiableList(disabledRewriters);
1814     }
1815
1816     public boolean isEmpty() {
1817       return urlBlacklist.isEmpty() && domainsToRewrite.isEmpty() && enabledRewriters.isEmpty()
1818           && disabledRewriters.isEmpty();
1819     }
1820
1821     @Override
1822     public int hashCode() {
1823       return Objects.hash(urlBlacklist, domainsToRewrite, enabledRewriters, disabledRewriters);
1824     }
1825
1826     @Override
1827     public boolean equals(Object obj) {
1828       if (this == obj) {
1829         return true;
1830       }
1831       if (obj == null) {
1832         return false;
1833       }
1834       if (getClass() != obj.getClass()) {
1835         return false;
1836       }
1837       Pagespeed other = (Pagespeed) obj;
1838       return Objects.equals(urlBlacklist, other.urlBlacklist)
1839           && Objects.equals(domainsToRewrite, other.domainsToRewrite)
1840           && Objects.equals(enabledRewriters, other.enabledRewriters)
1841           && Objects.equals(disabledRewriters, other.disabledRewriters);
1842     }
1843
1844     @Override
1845     public String toString() {
1846       return "Pagespeed [urlBlacklist=" + urlBlacklist + ", domainsToRewrite=" + domainsToRewrite
1847           + ", enabledRewriters=" + enabledRewriters + ", disabledRewriters=" + disabledRewriters
1848           + "]";
1849     }
1850   }
1851
1852   public static class ClassLoaderConfig {
1853     private final List<PrioritySpecifierEntry> entries = Lists.newArrayList();
1854
1855     public void add(PrioritySpecifierEntry entry) {
1856       entries.add(entry);
1857     }
1858
1859     public List<PrioritySpecifierEntry> getEntries() {
1860       return entries;
1861     }
1862
1863     @Override
1864     public int hashCode() {
1865       final int prime = 31;
1866       int result = 1;
1867       result = prime * result + ((entries == null) ? 0 : entries.hashCode());
1868       return result;
1869     }
1870
1871     @Override
1872     public boolean equals(Object obj) {
1873       if (this == obj) return true;
1874       if (obj == null) return false;
1875       if (getClass() != obj.getClass()) return false;
1876       ClassLoaderConfig other = (ClassLoaderConfig) obj;
1877       if (entries == null) {
1878         if (other.entries != null) return false;
1879       } else if (!entries.equals(other.entries)) return false;
1880       return true;
1881     }
1882
1883     @Override
1884     public String toString() {
1885       return "ClassLoaderConfig{entries=\"" + entries + "\"}";
1886     }
1887   }
1888
1889   public static class PrioritySpecifierEntry {
1890     private String filename;
1891     private Double priority;
1892
1893     private void checkNotAlreadySet() {
1894       if (filename != null) {
1895         throw new AppEngineConfigException("Found more that one file name matching tag. "
1896             + "Only one of 'filename' attribute allowed.");
1897       }
1898     }
1899
1900     public String getFilename() {
1901       return filename;
1902     }
1903
1904     public void setFilename(String filename) {
1905       checkNotAlreadySet();
1906       this.filename = filename;
1907     }
1908
1909     public Double getPriority() {
1910       return priority;
1911     }
1912
1913     public double getPriorityValue() {
1914       if (priority == null) {
1915         return 1.0d;
1916       }
1917       return priority;
1918     }
1919
1920     public void setPriority(String priority) {
1921       if (this.priority != null) {
1922         throw new AppEngineConfigException("The 'priority' tag may only be specified once.");
1923       }
1924
1925       if (priority == null) {
1926         this.priority = null;
1927         return;
1928       }
1929
1930       this.priority = Double.parseDouble(priority);
1931     }
1932
1933     public void checkClassLoaderConfig() {
1934       if (filename == null) {
1935         throw new AppEngineConfigException("Must have a filename attribute.");
1936       }
1937     }
1938
1939     @Override
1940     public int hashCode() {
1941       final int prime = 31;
1942       int result = 1;
1943       result = prime * result + ((filename == null) ? 0 : filename.hashCode());
1944       result = prime * result + ((priority == null) ? 0 : priority.hashCode());
1945       return result;
1946     }
1947
1948     @Override
1949     public boolean equals(Object obj) {
1950       if (this == obj) return true;
1951       if (obj == null) return false;
1952       if (getClass() != obj.getClass()) return false;
1953       PrioritySpecifierEntry other = (PrioritySpecifierEntry) obj;
1954       if (filename == null) {
1955         if (other.filename != null) return false;
1956       } else if (!filename.equals(other.filename)) return false;
1957       if (priority == null) {
1958         if (other.priority != null) return false;
1959       } else if (!priority.equals(other.priority)) return false;
1960       return true;
1961     }
1962
1963     @Override
1964     public String toString() {
1965       return "PrioritySpecifierEntry{filename=\"" + filename + "\", priority=\"" + priority + "\"}";
1966     }
1967   }
1968 }