java/src/main/com/google/appengine/api/datastore/DatastoreServiceFactory.java

   1 // Copyright 2008 Google Inc. All rights reserved.
   2
   3 package com.google.appengine.api.datastore;
   4
   5 import static com.google.appengine.api.datastore.DatastoreServiceConfig.Builder.withDefaults;
   6 import static com.google.appengine.api.datastore.DatastoreServiceConfig.Builder.withImplicitTransactionManagementPolicy;
   7
   8 /**
   9  * Creates DatastoreService implementations.
  10  *
  11  */
  12 public final class DatastoreServiceFactory {
  13
  14   /**
  15    * @deprecated Exposed by accident, do not instantiate.
  16    */
  17   @Deprecated
  18   public DatastoreServiceFactory() { }
  19
  20   /**
  21    * Creates a {@code DatastoreService} using the default config
  22    * ({@link DatastoreServiceConfig.Builder#withDefaults()}).
  23    */
  24   public static DatastoreService getDatastoreService() {
  25     return getDatastoreService(withDefaults());
  26   }
  27
  28   /**
  29    * Creates a {@code AsyncDatastoreService} using the default config
  30    * ({@link DatastoreServiceConfig.Builder#withDefaults()}).
  31    */
  32   public static AsyncDatastoreService getAsyncDatastoreService() {
  33     return getAsyncDatastoreService(withDefaults());
  34   }
  35
  36   /**
  37    * Creates a {@code DatastoreService} using the provided config.
  38    * @deprecated Use {@link #getDatastoreService(DatastoreServiceConfig)}
  39    * instead.
  40    */
  41   @Deprecated
  42   public static DatastoreService getDatastoreService(DatastoreConfig oldConfig) {
  43     DatastoreServiceConfig newConfig =
  44         withImplicitTransactionManagementPolicy(oldConfig.getImplicitTransactionManagementPolicy());
  45     return getDatastoreService(newConfig);
  46   }
  47
  48   /**
  49    * Creates a {@code DatastoreService} using the provided config.
  50    */
  51   public static DatastoreService getDatastoreService(DatastoreServiceConfig config) {
  52     return new DatastoreServiceImpl(config, new TransactionStackImpl());
  53   }
  54
  55   /**
  56    * Creates a {@code AsyncDatastoreService} using the provided config.  The
  57    * async datastore service does not support implicit transaction management
  58    * policy {@link ImplicitTransactionManagementPolicy#AUTO}.
  59    *
  60    * @throws IllegalArgumentException If the provided {@link
  61    * DatastoreServiceConfig} has an implicit transaction management policy of
  62    * {@link ImplicitTransactionManagementPolicy#AUTO}.
  63    */
  64   public static AsyncDatastoreService getAsyncDatastoreService(DatastoreServiceConfig config) {
  65     return new AsyncDatastoreServiceImpl(config, new TransactionStackImpl());
  66   }
  67
  68   /**
  69    * @deprecated Use {@link DatastoreServiceConfig.Builder#withDefaults()}
  70    * instead.
  71    */
  72   @Deprecated
  73   public static DatastoreConfig getDefaultDatastoreConfig() {
  74     return DatastoreConfig.DEFAULT;
  75   }
  76 }