# Deprecated API

## Contents

- Deprecated Interfaces
- Deprecated Classes
- Deprecated Enums
- Deprecated Exceptions
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors
- Deprecated Enum Constants

- Deprecated Interfaces
  Interface and Description
  com.google.appengine.api.conversion.ConversionService This API will be decommissioned in November 2012 and all calls to it will return an error.
  com.google.appengine.api.datastore.DatastoreConfig Use `DatastoreServiceConfig` instead.
  com.google.appengine.api.memcache.ErrorHandler Use `ConsistentErrorHandler` instead

- Deprecated Classes
  Class and Description
  com.google.appengine.api.search.AddResponse as of 1.7.3. Use `PutResponse` instead.
  com.google.appengine.api.search.ListIndexesResponse as of 1.7.3. Use `GetResponse` instead
  com.google.appengine.api.search.ListRequest as of 1.7.3. Use `GetRequest` instead
  com.google.appengine.api.search.ListResponse as of 1.7.3. Use `GetResponse` instead
  com.google.appengine.api.memcache.LogAndContinueErrorHandler Use `ConsistentLogAndContinueErrorHandler` instead

- Deprecated Enums
  Enum and Description
  com.google.appengine.api.search.Consistency As of 1.7.3. PER_DOCUMENT is the only mode now supported, so Consistency is not required.

- Deprecated Exceptions
  Exceptions and Description
  com.google.appengine.api.search.AddException as of 1.7.3. Use `PutException` instead.

- Deprecated Fields
  Field and Description
  com.google.appengine.api.datastore.DatastoreConfig.DEFAULT Use `DatastoreServiceConfig` instead.
  com.google.appengine.api.datastore.FetchOptions.DEFAULT_CHUNK_SIZE Instead of using DEFAULT_CHUNK_SIZE, do not specify a chunk size.
  com.google.appengine.api.utils.SystemProperty.instanceReplicaId Use `com.google.appengine.api.servers.ServerService#getCurrentInstance()`
  com.google.appengine.api.datastore.Query.KIND_METADATA_KIND
  com.google.appengine.api.search.DateUtil.MAX_DATE Starting from SDK version 1.7.4, use `com.google.appengine.api.search.checkers.FieldChecker#MAX_DATE`.
  com.google.appengine.api.search.DateUtil.MIN_DATE Starting from SDK version 1.7.4, use `com.google.appengine.api.search.checkers.FieldChecker#MIN_DATE`.
  com.google.appengine.api.datastore.Query.NAMESPACE_METADATA_KIND
  com.google.appengine.api.search.SortExpression.ORDER_ID_FIELD_NAME Use `SortExpression.RANK_FIELD_NAME` instead.
  com.google.appengine.api.datastore.Query.PROPERTY_METADATA_KIND
  com.google.appengine.api.images.ImagesService.SERVING_CROP_SIZES
  com.google.appengine.api.images.ImagesService.SERVING_SIZES

- Deprecated Methods
  Method and Description
  com.google.appengine.api.search.Index.add(Document...) as of 1.7.3. Use `Index.put(Document...)` instead
  com.google.appengine.api.search.Index.add(Document.Builder...) as of 1.7.3. Use `Index.put(Document.Builder...)` instead
  com.google.appengine.api.search.Index.add(Iterable) as of 1.7.3. Use `#put(Iterable)` instead
  com.google.appengine.api.search.Index.addAsync(Document...) as of 1.7.3. Use `Index.putAsync(Document...)` instead
  com.google.appengine.api.search.Index.addAsync(Document.Builder...) as of 1.7.3. Use `Index.putAsync(Document.Builder...)` instead
  com.google.appengine.api.search.Index.addAsync(Iterable) as of 1.7.3. Use `#putAsync(Iterable)` instead
  com.google.appengine.api.datastore.Query.addFilter(String, Query.FilterOperator, Object) Use `Query.setFilter(Filter)`
  com.google.appengine.api.datastore.TransactionOptions.Builder.allowMultipleEntityGroups(boolean)
  com.google.appengine.api.datastore.TransactionOptions.allowsMultipleEntityGroups()
  com.google.appengine.api.datastore.TransactionOptions.clearMultipleEntityGroups()
  com.google.appengine.api.datastore.PreparedQuery.countEntities() Use `PreparedQuery.countEntities(FetchOptions)` instead. Calling this function imposes a maximum result limit of 1000.
  com.google.appengine.api.datastore.FetchOptions.cursor(Cursor) use `FetchOptions.startCursor` instead.
  com.google.appengine.api.search.Field.date(Date) as of 1.7.2 this is no longer required for Date fields
  com.google.appengine.api.search.Index.deleteSchema() as of 1.7.4
  com.google.appengine.api.search.Index.deleteSchemaAsync() as of 1.7.4
  com.google.appengine.api.log.RequestLogs.getApiMcycles() This value is no longer meaningful.
  com.google.appengine.api.quota.QuotaService.getApiTimeInMegaCycles() This value is no longer meaningful.
  com.google.appengine.api.search.IndexSpec.getConsistency()
  com.google.appengine.api.search.Index.getConsistency() As of 1.7.3 Consistency is deprecated since only PER_DOCUMENT mode is supported
  com.google.appengine.api.datastore.FetchOptions.getCursor() use `FetchOptions.getStartCursor()` instead
  com.google.appengine.api.datastore.DatastoreServiceFactory.getDatastoreService(DatastoreConfig) Use `DatastoreServiceFactory.getDatastoreService(DatastoreServiceConfig)` instead.
  com.google.appengine.api.datastore.DatastoreServiceFactory.getDefaultDatastoreConfig() Use `DatastoreServiceConfig.Builder.withDefaults()` instead.
  com.google.appengine.api.search.Document.getField(String) Use `Document.getFields(String)` to get all fields with a specific name.
  com.google.appengine.api.search.Document.getFields(String)
  com.google.appengine.api.datastore.Query.getFilterPredicates() Use `Query.setFilter(Filter)` and `Query.getFilter()` instead
  com.google.appengine.api.datastore.DatastoreConfig.getImplicitTransactionManagementPolicy() Use `DatastoreServiceConfig.getImplicitTransactionManagementPolicy()`
  com.google.appengine.api.search.Util.getIntForDate(Date) as of 1.7.2
  com.google.appengine.api.memcache.ErrorHandlers.getLogAndContinue(Level) Use `ErrorHandlers.getConsistentLogAndContinue(Level)` instead
  com.google.apphosting.api.ApiProxy.Environment.getRequestNamespace() Use `NamespaceManager`.getGoogleAppsNamespace()
  com.google.appengine.api.images.ImagesService.getServingUrl(BlobKey) Replaced by `ImagesService.getServingUrl(ServingUrlOptions)`.
  com.google.appengine.api.images.ImagesService.getServingUrl(BlobKey, boolean) Replaced by `ImagesService.getServingUrl(ServingUrlOptions)`.
  com.google.appengine.api.images.ImagesService.getServingUrl(BlobKey, int, boolean) Replaced by `ImagesService.getServingUrl(ServingUrlOptions)`.
  com.google.appengine.api.images.ImagesService.getServingUrl(BlobKey, int, boolean, boolean) Replaced by `ImagesService.getServingUrl(ServingUrlOptions)`.
  com.google.appengine.api.blobstore.BlobstoreService.getUploadedBlobs(HttpServletRequest) Use `BlobstoreService.getUploads(HttpServletRequest)` instead. Note that getUploadedBlobs does not handle cases where blobs have been uploaded using the multiple="true" attribute of the file input form element.
  com.google.appengine.api.search.Index.listDocuments(ListRequest) as of 1.7.3. Use `Index.getRange(GetRequest)` instead.
  com.google.appengine.api.search.Index.listDocumentsAsync(ListRequest) as of 1.7.3. Use `Index.getRangeAsync(GetRequest)`
  com.google.appengine.api.search.SearchService.listIndexes(ListIndexesRequest) in 1.7.3. Use `SearchService.getIndexes(GetIndexesRequest)` instead
  com.google.appengine.api.search.SearchService.listIndexesAsync(ListIndexesRequest) in 1.7.3. Use `SearchService.getIndexesAsync(GetIndexesRequest)` instead
  com.google.appengine.api.taskqueue.QueueConstants.maxTaskSizeBytes() Use `QueueConstants.maxPushTaskSizeBytes()`
  com.google.appengine.api.datastore.TransactionOptions.multipleEntityGroups(boolean)
  com.google.appengine.api.search.Index.remove(Iterable) as of 1.7.3. Use `#delete(Iterable)` instead
  com.google.appengine.api.search.Index.remove(String...) as of 1.7.3. Use `Index.delete(String...)` instead
  com.google.appengine.api.search.Index.removeAsync(Iterable) as of 1.7.3. Use `#deleteAsync(Iterable)` instead
  com.google.appengine.api.search.Index.removeAsync(String...) as of 1.7.3. Use `Index.deleteAsync(String...)` instead
  com.google.appengine.api.search.IndexSpec.Builder.setConsistency(Consistency) As of 1.7.3, consistency setting is no longer required, since PER_DOCUMENT is the only mode supported.
  com.google.appengine.api.memcache.MemcacheService.setNamespace(String) use `MemcacheServiceFactory.getMemcacheService(String)` instead.
  com.google.appengine.api.search.Field.truncate(Date, int) as of 1.7.2 this is no longer required for Date fields
  com.google.appengine.api.datastore.FetchOptions.Builder.withCursor(Cursor) use `FetchOptions.Builder.withStartCursor(com.google.appengine.api.datastore.Cursor)` instead.

- Deprecated Constructors
  Constructor and Description
  com.google.appengine.api.datastore.DatastoreServiceFactory() Exposed by accident, do not instantiate.
  com.google.appengine.api.taskqueue.TaskHandle(String, String, long) Use `TaskHandle.TaskHandle(TaskOptions, String)`

- Deprecated Enum Constants
  Enum Constant and Description
  com.google.appengine.api.search.Consistency.GLOBAL As of 1.7.3. GLOBAL mode is no longer supported.