Note: Java 8 has reached end of support on January 31, 2024. Your existing Java 8 applications will continue to run and receive traffic. However, App Engine might block re-deployment of applications that use runtimes after their end of support date. We recommend that you migrate to the latest supported version of Java.

Deprecated List (Google App Engine API for Java)

Deprecated Packages
Package and Description
com.google.appengine.api.channel This API has been deprecated.
com.google.appengine.api.files This api has been deprecated in favor of the Google App Engine client for Google Cloud Storage.
com.google.appengine.api.prospectivesearch This API has been shut down.
com.google.appengine.api.xmpp This API has been deprecated.

Deprecated Interfaces
Interface and Description
com.google.appengine.api.backends.BackendService
com.google.appengine.api.channel.ChannelService This API has been deprecated.
com.google.appengine.api.datastore.DatastoreConfig Use `DatastoreServiceConfig` instead.
com.google.appengine.api.files.FileReadChannel
com.google.appengine.api.files.FileService This api has been deprecated in favor of the App Engine GCS client.
com.google.appengine.api.files.FileWriteChannel
com.google.appengine.api.channel.IChannelServiceFactory This API has been deprecated.
com.google.appengine.api.files.IFileServiceFactory
com.google.appengine.api.xmpp.IXMPPServiceFactory This API has been deprecated.
com.google.appengine.api.files.RecordReadChannel
com.google.appengine.api.files.RecordWriteChannel
com.google.appengine.api.xmpp.XMPPService This API has been deprecated.

Deprecated Classes
Class and Description
com.google.appengine.api.files.AppEngineFile
com.google.appengine.api.files.BufferedFileReadChannelImpl
com.google.appengine.api.channel.ChannelMessage This API has been deprecated.
com.google.appengine.api.channel.ChannelPresence This API has been deprecated.
com.google.appengine.api.channel.ChannelServiceFactory This API has been deprecated.
com.google.appengine.api.files.Crc32c
com.google.appengine.api.xmpp.Error This API has been deprecated.
com.google.appengine.api.xmpp.ErrorBuilder This API has been deprecated.
com.google.appengine.api.files.FileServiceFactory This api has been deprecated in favor of the App Engine GCS client.
com.google.appengine.api.files.FileStat
com.google.appengine.api.files.GSFileOptions
com.google.appengine.api.channel.IChannelServiceFactoryProvider This API has been deprecated.
com.google.appengine.api.files.IFileServiceFactoryProvider
com.google.appengine.api.xmpp.IXMPPServiceFactoryProvider This API has been deprecated.
com.google.appengine.api.xmpp.JID This API has been deprecated.
com.google.appengine.api.xmpp.Message This API has been deprecated.
com.google.appengine.api.xmpp.MessageBuilder This API has been deprecated.
com.google.appengine.api.xmpp.Presence This API has been deprecated.
com.google.appengine.api.xmpp.PresenceBuilder This API has been deprecated.
com.google.appengine.api.prospectivesearch.ProspectiveSearchServiceFactory This API has been deprecated.
com.google.appengine.api.xmpp.SendResponse This API has been deprecated.
com.google.appengine.api.prospectivesearch.Subscription This API has been deprecated.
com.google.appengine.api.xmpp.Subscription This API has been deprecated.
com.google.appengine.api.xmpp.SubscriptionBuilder This API has been deprecated.
com.google.appengine.api.xmpp.XMPPServiceFactory This API has been deprecated.

Deprecated Enums
Enum and Description
com.google.appengine.api.prospectivesearch.FieldType This API has been deprecated.
com.google.appengine.api.xmpp.MessageType This API has been deprecated.
com.google.appengine.api.xmpp.PresenceShow This API has been deprecated.
com.google.appengine.api.xmpp.PresenceType This API has been deprecated.
com.google.appengine.api.xmpp.SubscriptionType This API has been deprecated.

Deprecated Exceptions
Exceptions and Description
com.google.appengine.api.channel.ChannelFailureException This API has been deprecated.
com.google.appengine.api.files.FinalizationException
com.google.appengine.api.files.KeyOrderingException
com.google.appengine.api.files.LockException
com.google.appengine.api.prospectivesearch.QuerySyntaxException This API has been deprecated.
com.google.appengine.api.xmpp.XMPPFailureException This API has been deprecated.

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 `ModulesService.getCurrentInstanceId()`
com.google.appengine.api.datastore.Query.KIND_METADATA_KIND
com.google.appengine.api.datastore.Query.NAMESPACE_METADATA_KIND
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.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.users.UserService.createLoginURL(String, String, String, Set<String>) Use of federatedIdentity is no longer supported. Please change calls to a method that does not take the parameter.
com.google.appengine.api.datastore.FetchOptions.cursor(Cursor) use `FetchOptions.startCursor` instead.
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.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.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.memcache.ErrorHandlers.getLogAndContinue(Level) Use `ErrorHandlers.getConsistentLogAndContinue(Level)` instead
com.google.appengine.api.oauth.OAuthService.getOAuthConsumerKey() OAuth1 is no longer supported
com.google.apphosting.api.ApiProxy.Environment.getRequestNamespace() Use `NamespaceManager`.getGoogleAppsNamespace()
com.google.appengine.api.search.ISearchServiceFactory.getSearchService(String) Use `ISearchServiceFactory.getSearchService(SearchServiceConfig)`
com.google.appengine.api.search.SearchServiceFactory.getSearchService(String) Use `SearchServiceFactory.getSearchService(SearchServiceConfig)`
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.search.ScoredDocument.getSortScores() Use an explicit `FieldExpression` in your `QueryOptions` instead.
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.taskqueue.QueueConstants.maxTaskSizeBytes() Use `QueueConstants.maxPushTaskSizeBytes()`
com.google.appengine.api.datastore.TransactionOptions.multipleEntityGroups(boolean)
com.google.appengine.api.datastore.Cursor.reverse() It is no longer necessary to call `Cursor.reverse()` on cursors. A cursor returned by a query may also be used in the query returned by `Query.reverse()`.
com.google.appengine.api.memcache.MemcacheService.setNamespace(String) use `MemcacheServiceFactory.getMemcacheService(String)` instead.
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.apphosting.api.ApiProxy.LogRecord(ApiProxy.LogRecord.Level, long, String, Throwable) Prefer the constructor that takes a StackTraceElement to identify the source location.
com.google.appengine.api.taskqueue.TaskHandle(String, String, long) Use `TaskHandle.TaskHandle(TaskOptions, String)`

Deprecated List (Google App Engine API for Java)

Deprecated API

Contents