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

   1 // Copyright 2012 Google Inc. All rights reserved.
   2
   3 package com.google.appengine.api.search;
   4
   5 /**
   6  * An factory that creates default implementation of {@link SearchService}.
   7  *
   8  */
   9 public interface ISearchServiceFactory {
  10
  11   /**
  12    * Returns an instance of the {@link SearchService}.  The instance
  13    * will exist in the user provided namespace. The namespace must be
  14    * valid, as per {@link NamespaceManager#validateNamespace(String)}
  15    * method.
  16    *
  17    * @param namespace a namespace to be assigned to the returned
  18    * search service.
  19    * @return the default implementation of {@link SearchService}.
  20    * @throws IllegalArgumentException if the namespace is invalid
  21    */
  22   SearchService getSearchService(String namespace);
  23
  24 }