java/src/main/com/google/appengine/api/search/SearchServiceConfig.java

   1 package com.google.appengine.api.search;
   2
   3 import com.google.appengine.api.NamespaceManager;
   4
   5 /**
   6  * Configuration options for Search API.
   7  */
   8 public final class SearchServiceConfig {
   9
  10   private final Double deadline;
  11   private final String namespace;
  12
  13   private SearchServiceConfig(SearchServiceConfig.Builder builder) {
  14     deadline = builder.deadline;
  15     namespace = builder.namespace;
  16   }
  17
  18   /**
  19    * Builder for {@link SearchServiceConfig}.
  20    */
  21   public static final class Builder {
  22
  23     private Double deadline;
  24     private String namespace;
  25
  26     private Builder(SearchServiceConfig config) {
  27       deadline = config.deadline;
  28       namespace = config.namespace;
  29     }
  30
  31     private Builder() {
  32     }
  33
  34     public SearchServiceConfig.Builder setDeadline(Double deadlineInSeconds)
  35         throws SearchServiceException {
  36       if (deadlineInSeconds != null && deadlineInSeconds <= 0.0) {
  37         throw new IllegalArgumentException("Invalid Deadline. Must be a positive number.");
  38       }
  39       this.deadline = deadlineInSeconds;
  40       return this;
  41     }
  42
  43     public SearchServiceConfig.Builder setNamespace(String namespace) {
  44       if (namespace != null) {
  45         NamespaceManager.validateNamespace(namespace);
  46       }
  47       this.namespace = namespace;
  48       return this;
  49     }
  50
  51     /**
  52      * Builds a configuration.
  53      *
  54      * @return the configuration built by this builder
  55      */
  56     public SearchServiceConfig build() {
  57       return new SearchServiceConfig(this);
  58     }
  59   }
  60
  61   /**
  62    * Creates a new {@link SearchServiceConfig.Builder}.
  63    *
  64    * @return the newly created {@link SearchServiceConfig.Builder} instance
  65    */
  66   public static SearchServiceConfig.Builder newBuilder() {
  67     return new SearchServiceConfig.Builder();
  68   }
  69
  70   /**
  71    * Converts this config instance to a builder.
  72    *
  73    * @return the newly created {@link SearchServiceConfig.Builder} instance
  74    */
  75   public SearchServiceConfig.Builder toBuilder() {
  76     return new SearchServiceConfig.Builder(this);
  77   }
  78
  79   /**
  80    * Returns the API deadline in seconds.
  81    *
  82    * @return the deadline in seconds or null if no deadline has been set
  83    */
  84   public Double getDeadline() {
  85     return deadline;
  86   }
  87
  88   public String getNamespace() {
  89     return namespace;
  90   }
  91 }