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

   1 // Copyright 2012 Google Inc. All rights reserved.
   2
   3 package com.google.appengine.api.datastore;
   4
   5 /**
   6  * This interface should be implemented by providers of the {@link DatastoreService} and registered
   7  * with {@link com.google.appengine.spi.ServiceFactoryFactory}.
   8  *
   9  */
  10 public interface IDatastoreServiceFactory {
  11   /**
  12    * Creates a {@code DatastoreService} using the provided config.
  13    */
  14   DatastoreService getDatastoreService(DatastoreServiceConfig config);
  15
  16   /**
  17    * Creates an {@code AsyncDatastoreService} using the provided config. The async datastore service
  18    * does not support implicit transaction management policy
  19    * {@link ImplicitTransactionManagementPolicy#AUTO}.
  20    *
  21    * @throws IllegalArgumentException If the provided {@link DatastoreServiceConfig} has an implicit
  22    *         transaction management policy of {@link ImplicitTransactionManagementPolicy#AUTO}.
  23    */
  24   AsyncDatastoreService getAsyncDatastoreService(DatastoreServiceConfig config);
  25
  26 }