My favorites ▼ | Sign in
Project Home Downloads Wiki Issues Source
Search
for
SdkForJavaReleaseNotes  
Google App Engine Java SDK Release Notes
Updated Apr 16 (2 days ago) by [email protected]

You can download the latest version of the SDK here

Version 1.9.19 - April 14, 2015

  • appcfg now outputs a warning if OAuth2 is not used for authentication when deploying or managing an application. OAuth2 will become the default in the 1.9.20 release.
  • Fixed an bug in the Java SDK where LogQuery throws an exception when more than 20 log entries are queried.
  • Added a Files API deprecation warning to the Java DevAppServer.
  • Allow applications to use the class javax.xml.crypto.dom.DOMURIReference.

Version 1.9.18 - February 19, 2015

  • Fixed a bug in the Task Queue Java API where TaskOptions.removeParam(String) was using the wrong operator to compare strings.
  • Fixed a bug wherein calling Recording.get() on a non-warmup request fails to find RECORDING_KEY in current environment.
  • Fixed a bug to ensure App Engine Remote API supports go remote_api responses
  • An useful error message is displayed when Endpoints deployment fails for a known reason
  • Fixed a bug wherein xsd schema did not agree with the SDKs interpretation of appengine-web.xml
  • Fixed a bug wherein local dev server was ignoring <vm>true</vm> for ear-based multi-module projects
  • Added a --noisy option to Java appcfg, to turn on all available logging.
  • Fixed the issue with the Dev App server failing to reproduce the production environment behaviour when serving Google Storage files.
  • Fixed the issue of Memcache API returning an unhelpful generic error message when put() value is >1MB

Version 1.9.17 - December 9, 2014

Version 1.9.15 - November 3, 2014

Version 1.9.14 - October 21, 2014

Version 1.9.13 - October 9, 2014

  • No changes for 1.9.13

Version 1.9.12 - September 25, 2014

  • No changes for 1.9.12

Version 1.9.11 - September 11, 2014

Version 1.9.10 - August 28, 2014

  • The deprecated methods in the LogQuery class will no longer work for deployed apps. For a full list of methods that have been deleted, please see the LogQuery deprecation announcement in the 1.8.7 version of the SDK.

Version 1.9.9 - August 12, 2014

Version 1.9.8 - July 31, 2014

Version 1.9.7 - July 16, 2014

Version 1.9.6 - June 03, 2014

Version 1.9.5 - May 20, 2014

Version 1.9.4 - April 30, 2014

  • Speed up memcache API deserialization by using Class.forName instead of ClassLoader.loadClass.
  • Added client side deployment logging to Java appcfg, which will improve deployment performance of Java Applications.
  • Fixed an issue with Datastore Queries containing nonexisting fields returning no results instead of an error.
  • Fixed an issue with Datastore String properties so they are now <=500 characters, not <500 characters.
  • Fixed an issue with the Search API where it does not correctly parse expressions that use the subtraction operator without surrounding whitespaces.
  • Fixed an issue with 4-byte UTF-8 character web requests not forming correctly in POST data.

Version 1.9.3 - April 15, 2014

  • Various internal bug fixes. No new features for Java SDK 1.9.3.

Version 1.9.2 - April 3, 2014

  • We are pleased to announce the availability of Dedicated Memcache service to our customers in the EU.

Version 1.9.1 - March 19, 2014

  • The Performance Settings section of the Application settings page in the Admin Console, Backends API and all backends related management tools are now deprecated and will be removed in a future release. Users of Backends are recommended to migrate to the App Engine Modules API, which provides a more flexible implementation of the same functionality. These settings are now all configurable via Modules configuration files. See the Modules documentation for more information:

Version 1.9.0 - February 26, 2014

  • Java 6 applications cannot be deployed to Google App Engine from any version of the SDK. Existing Java 6 applications will continue to run. If you are still relying on a Java 6 application in Google App Engine, we strongly encourage you to start testing and deploying your app using Java 7. Java 7 has been certified by Oracle to be fully backwards compatible with Java 6, as well as providing a number of benefits to developers. Java 7 applications will be fully supported in future releases of the App Engine SDK. If you absolutely need to continue to deploy Java 6 applications for compatibility reasons, you can request that your application be whitelisted for Java 6 deployment from http://goo.gl/ycffXq. As we review each whitelist application by hand, please allow 10 working days for review, and note that only billed applications that show a proven incompatibility will be considered for exemption.
  • Newly created App Engine applications now have a Google Cloud Storage bucket created automatically as part of the same Google Cloud Project. For more information please see: https://developers.google.com/appengine/docs/java/googlecloudstorageclient/activate#Using_the_default_Gcs_bucket
  • Modules Service API and application management features are now GA.
  • Removed deprecated ModulesService methods and exceptions:
    • getModulesAsync()
    • getVersionsAsync()
    • getDefaultVersionAsync()
    • getNumInstancesAsync()
    • getVersionHostnameAsync()
    • getInstanceHostnameAsync()
    • startModule() (replaced by startVersion)
    • startModuleAsync() (replaced by startVersionAsync)
    • stopModule() (replaced by stopVersion)
    • stopModuleAsync() (replaced by stopVersionAsync)
    • getModuleHostname() (replaced by getVersionHostname and getInstanceHostname)
    • getModuleHostnameAsync()
    • InvalidInstanceException
    • InvalidModuloeException
    • InvalidVersionException
  • Moved ModulesService from package com.google.appengine.api.labs.modules to package com.google.appengine.api.modules and from appengine-api-labs.jar to appengine-api.jar.
  • The following deprecated methods in com.google.appengine.api.log.LogQuery will be removed in an upcoming release.
    • Builder.withModuleVersions(List<Pair<String, String>> moduleVersionIds)
    • Builder.withServerVersions(List<Pair<String, String>> serverVersionIds)
    • moduleVersions(List<Pair<String, String>> moduleVersions)
    • serverVersions(List<Pair<String, String>> serverVersions)
    • getModuleVersions()
    • getServerVersions()
  • To avoid breakage when these are removed please update your code as per the javadocs and upload the updated version.
  • MapReduce is now a Preview feature. Documentation and getting started guides are now available on https://developers.google.com/appengine/docs/java/dataprocessing/
  • The size limit on the Search API is now computed and enforced on a per-index basis, rather than for the app as a whole. The per-index limit is now 10GB. There is no fixed limit on the number of indexes, or on the total amount of Search API storage an application may use.
  • Users now have the ability to embed images in emails via the Content-Id attachment header.
  • New App Engine Application Identifiers must now start with a letter, in addition to the existing requirements that the identifier be 6-30 characters which are letters, numbers, and hyphens, and not start or end with a hyphen.

Version 1.8.9 - January 14, 2014

  • Renamed appcfg start to appcfg start_module_version and stop to stop_module_version.
  • The following methods are deprecated in the Modules API and will be removed in an upcoming release:
    • getModulesAsync
    • getVersionsAsync
    • getDefaultVersionAsync
    • getNumInstancesAsync
    • getVersionHostnameAsync
    • getInstanceHostnameAsync
    • startModule (replaced by startVersion)
    • startModuleAsync (replaced by startVersionAsync)
    • stopModule (replaced by stopVersion)
    • stopModuleAsync (replaced by stopVersionAsync)
    • getModuleHostname (replaced by getVersionHostname and getInstanceHostname)
    • getModuleHostnameAsync
  • The following exceptions have been deprecated in the Modules API and will be removed in a following release:
    • InvalidInstanceException
    • InvalidModuloeException
    • InvalidVersionException
  • The following exceptions have been removed in the Modules API:
    • ModuleAlreadyStartedException
    • ModuleAlreadyStoppedException
  • Modules are now supported in the dev_appserver Development Console.
  • Fixed an issue with ID allocation collisions in the Datastore.

Version 1.8.8 - November 19, 2013

  • Dedicated Memcache is now a GA feature. Our deprecation policy applies and customers are encouraged to use this feature in production.
  • Memcache API calls are tracked by a new metric that estimates resource usage, Memcache Compute Units (MCU's). There is a new quota bucket and dashboard graph corresponding to the metric, as well as an option in the memcache viewer to display top keys by MCU's.
  • Fixed an issue with cloning apps not creating proper service account names.
  • Fixed an issue with users receiving errors when uploading large files to GCS.

Version 1.8.7 - November 5, 2013

  • Cloud Endpoints is now a GA feature.
  • Memcache configuration changes and mutations (flush, set, etc.) made from the Admin Console are now recorded in the admin console logs.
  • The max_concurrent_requests setting is now configurable per version/module.
  • LogService API functions related to the modules feature will be changing.
  • The following functions will be deprecated and new versions will be provided:
    • LogQuery.getModuleVersions(), LogQuery.moduleVersions() and LogQuery.Builder.withModuleVersions().
  • The following functions will be removed in a future release:
    • LogQuery.getModuleVersions(), LogQuery.moduleVersions(), LogQuery.Builder.withModuleVersions(), LogQuery.getServerVersions(), LogQuery.serverVersions() and LogQuery.Builder.withServerVersions(). Serialized LogQuery objects with values set using any of the above removed methods will not be supported in a future release.
  • Fixed an issue with Datastore not correctly validating namespaces with greater than 500 characters.
  • Fixed and issue with vacuum_indexes not working in the SDK.

Version 1.8.6 - October 15, 2013

  • GetAccessToken in the OAuth package is now a GA feature.
  • The LogsService API functions related to the Modules feature will be changing as follows:
    • The following functions will be deprecated and new versions will be provided: LogQuery.getModuleVersions(), LogQuery.moduleVersions() and LogQuery.Builder.withModuleVersions().
    • The following functions will be removed in an upcoming release: LogQuery.getModuleVersions(), LogQuery.moduleVersions() and LogQuery.Builder.withModuleVersions(), LogQuery.getServerVersions(), LogQuery.serverVersions() and LogQuery.Builder.withServerVersions(). Serialized LogQuery objects with values set using any of the above removed methods will not be supported in an upcoming release.
  • A memcache size chart has been added to admin console's dashboard. Access it via the drop-down above the graph. The chart graphs memcache size over time enabling customers to determine when cache flush events occurred. This is a preview feature.
  • The Cloud Endpoints API @ApiSerializer has been renamed to @ApiTransformer and the Serializer interface has been renamed to Transformer. @ApiSerializationProperty has also been renamed to @ApiResourceProperty.
  • If a customer passes invalid data to a memcache put() call, they now see a more useful error message.
  • Fixed an issue with the SDK that allows an invalid Datastore query combination of group by and filter properties.
  • Fixed an issue affecting validation of the size of Datastore property names.
  • Fixed an issue with Datastore query validation for strings with exactly 500 characters.

Version 1.8.5 - September 25, 2013

Version 1.8.4 - September 9, 2013

  • A Datastore Admin fix in this release improves security by ensuring that scheduled backups can now only be started by a cron or task queue task. Administrators can still start a backup by going to the Datastore Admin in the Admin Console.
  • The Java SDK local datastore now defaults to an HRD-like consistency policy, including eventually consistent global queries. For more information see developers.google.com/appengine/docs/java/tools/devserver#Using_the_Datastore
  • The Conversion API, a decommissioned feature, has been removed from the SDK. In the next release, the API will be removed from the runtime and any attempt to import the API will raise an exception. Applications in production that import the API should be fixed as soon as possible.
  • Fixed the implementation of the Cloud SQL JDBC driver for App Engine which restricted the connection lifetime to the lifetime of the HTTP request. This will unblock users who want to use long running connections (e.g. in connection pools).
  • Fixed bulkloader issue for Java caused by improper updates of the Java Remote API handlers in a previous version of the runtimes.
  • Fixed Eclipse plugin on the development server to eliminate complaints about missing indexes when using equality filters.
  • Fixed the issue with SASL provider registration that was impacting developers' ability to connect to GMail via IMAP.

Version 1.8.3 - August 6, 2013

  • Published a major rewrite of the Search API documentation. Please see: https://developers.google.com/appengine/docs/java/search
  • Interfacing into the Task Queue REST API no longer requires including "s~" at the beginning of the project name.
  • Fixed an issue with the Mail API, email addresses that contain encoded newlines as specified in rfc2047 are now parsed correctly.
  • Fixed an issue with ChannelService.sendMessage() failing when a client id has 3 or more dashes.
  • Fixed an issue with the Channel API send_message function not working in the SDK.
  • Fixed an issue with the Local Channel service failing to properly validate tokens.
  • Fixed an issue with enabling cloud integration for existing apps.
  • Fixed an issue with the Datastore Admin UI failing to load due to the app having too many kinds.

Version 1.8.2 - July 16, 2013

Version 1.8.1 - June 11, 2013

  • This SDK will be the last release that can deploy Java 6 apps. In 1.8.2, the SDK will only be compiled with the Java 7 compiler and the only target runtime will be Java 7.
  • The Task Queue async API is now a GA feature. The asynchronous methods improve utilization by allowing your app to add, lease and delete multiple tasks in parallel.
  • Cloud Console projects are now created by default whenever a new App Engine app is created. This is a Preview feature.
  • In an upcoming release the Experimental Google Cloud Storage API and Files API within the Blobstore service will be decommissioned. These APIs and their Experimental status are documented at the following links:
  • The Google Cloud Storage library will replace Google Cloud Storage API and is now available as a Preview feature. More information can be found at https://code.google.com/p/appengine-gcs-client/
  • Bandwidth between App Engine and Google Cloud Storage is currently free of charge (this may change in the future for certain levels of service).
  • The Search API has graduated from Experimental to Preview. Apps that have billing enabled can exceed the free quota levels and will be charged for usage above these levels.
  • Estimated number of search results will only be accurate if it is less than or equal to the number of results requested. By default this can be overridden by setting number_found_accuracy QueryOption in the Search API.
  • Dates, atoms, and number fields can now be found by searching without a field restriction in the Search API.
  • A quoted empty string now returns atom fields with empty values for the Search API.
  • Snippet and count functions are no longer allowed in sort expressions for the Search API.
  • The Search API now has improved error messages for user errors and internal errors.
  • The Datastore now assigns scattered auto ids by default. Legacy auto ids are still available via the auto_id_policy option in appengine-web.xml.
  • The Sockets API now allows client code to call get/set options against sockets. Previously, calls raised "Not Implemented" exceptions. When java.net.Socket.get<option>() is called, a mock value is returned, calls to set<option>() will be silently ignored.
  • Fixed an issue with the namespace not being displayed when a user attempts to select a namespace in the Admin Console.
  • Fixed an issue in the Admin Console Logs page to correctly display Until instead of Since for logs search criteria.

Version 1.8.0 - May 8, 2013

Version 1.7.7 - April 9, 2013

  • The Sockets API, which allows applications to make outgoing TCP connections and send/receive UDP packets to the Internet using both IPv4 and IPv6, is now available as an experimental feature.
  • The Java runtime now defaults to Java7. If you still need to use the Java6 runtime, please use the --use_java6 flag when deploying your app. We encourage you to move to Java7 as soon as possible.
  • Billing enabled apps will no longer be subject to a $2.10 minimum weekly spend. Instead, apps will only be charged for their actual usage.
  • Fixed an issue where Datastore auto ids assigned by the scattered id policy were too large to be represented as floating point numbers in the SDK.
  • Fixed an issue with sort by doc_id not translating correctly causing InvalidRequest errors in the Search API

Version 1.7.6 - March 19, 2013

  • Improvements to the App Engine billing system will be rolled out gradually to all apps.
  • The application summary no longer displays the default version of a running application, instead it lists the application as 'RUNNING'. In an upcoming release applications will have multiple logical sub components, each of which will have a default version. This UI update is meant to align with this functionality.
  • Projection queries are now a fully supported GA feature.
  • The XMPP API now has multi-JID getPresence(). This provides the ability to get the availability of multiple users.
  • The Java dev_appserver now allocates automatic ids using the 'scattered' id allocation policy by default. For more information, please see "Specifying the Automatic ID Allocation Policy": https://developers.google.com/appengine/docs/java/tools/devserver#Using_the_Datastore
  • Admin console dashboard charts and current load/errors reports will be moving to a new, more reliable backend. The change will be gradually rolling to users of admin console over the next few weeks.
  • New Search API quotas are now displayed in the Admin Console. These quotas are not currently enforced, but will be part of the pricing model for the Search API in a future release.
  • The experimental Search API's ability to explicitly sort search results by SortExpression.RANK_FIELD_NAME (i.e. order_id) field in ascending order has been removed.
  • Globally consistent indexes in the experimental Search API are now deprecated and will be removed in the next release.
  • Task Queue tasks may now be added and deleted asynchronously. This allows applications to perform common task queue operations without blocking. This is an experimental feature.
  • Fixed an issue which caused an incorrect server error message when setting the default version on the admin console, though the version was set correctly.
  • Fixed an issue that caused java.security.AccessControlException when creating a SOAP connection.
  • Fixed an issue that caused NullPointerException in ListIndexesResponse
  • Fixed an issue that caused an incorrect log message when launching the Java dev_appserver

Version 1.7.5 - February 13, 2013

  • New instance classes F4_1G and B4_1G are now available. These instances have compute capacity equal to F4/B4 but with a maximum of 1G RAM instead of 512MB.
  • The DataNucleus plugin has been upgraded to 2.1.2.
  • The deprecated classes AddException, AddResponse, ListException, ListIndexesException, ListIndexesRequest, ListIndexesResponse, ListRequest, ListResponse, and RemoveException were removed from the Search API in the SDK. If your app references any of these classes, you must deploy a new version without these references before the next release of App Engine. If you do not do this, your app may stop working in production.
  • The Conversion API, which was decommissioned last release, has been removed from the SDK. In a future release, the API will be removed from the runtime and applications that attempt to use it may stop working. Applications in production that import the library should be fixed as soon as possible.
  • We are making Java 7 available as an experimental feature. We strongly encourage local and production testing for all existing applications. For more information, please visit: http://developers.google.com/appengine/docs/java/java7
  • The Channel API now has the ability to send channel messages from any app version or backend regardless of where the channel was created.
  • The URL Fetch service now supports PATCH method requests.
  • The Mail API can now send mail bounce notifications to the app. The notification will be delivered to /_ah/bounce if mail_bounce inbound services are enabled.
  • The Blobstore service now returns the created filename instead of the blobKey when using Cloud Storage
  • Fixed an issue with Datastore callback annotations not working when running locally on Windows.

Version 1.7.4 - December 13, 2012

  • Traffic Splitting is now a GA feature.
  • Task Queue Statistics is now a GA feature.
  • Logs API now has the ability to fetch requests based on a list of request_ids. Currently, this only works in production and is not supported in dev_appserver.
  • The SDK now includes an IDE-friendly zip with the source for the App Engine APIs. The zip resides in <SDK_ROOT>/src/user
  • Additional support for Maven now exists through both Maven archetypes and a Maven plugin. Documentation for the new Maven support can be found at https://developers.google.com/appengine/docs/java/tools/maven
  • DISTINCT for Datastore queries is now available as an experimental feature.
  • The decommissioned Conversion API has been removed.
  • Various JSP improvements
    • JSPs are now compiled together as opposed to one by one. This improves the compilation process time.
    • JSP compiled classes are packaged in JAR files.
    • You can now avoid the upload of JSP source, which is typically not needed at runtime. This can be done via the new --delete_jsps option in the appcfg tool. By default, this option is not set.
    • You can now package all the WEB-INF/classes/* classes into jar files. This can be done via the new --enable_jar_classes option in the appcfg tools. By default, this option is not set.
  • Users can now set how many columns can be viewed in the Datastore Viewer via a drop-down menu which customizes the number of columns displayed.
  • Fixed an issue with BackendService.getCurrentInstance() returning thread ID instead of integer instance ID in production.
  • Fixed an issue with Datastore Backup failing when a schema has a very large number of properties.
  • Fixed an issue with users being unable to change Authentication Type after app creation in the Admin Console.

Version 1.7.3 - October 23, 2012

  • We encourage you to try and test your application using Java 7 and the App Engine SDK. Note that Java 7 is not a supported runtime.
  • Java 7 Features that we encourage you to try in dev appserver:
    • Strings in switch
    • Binary integral literals and underscores in number literals
    • Multi-catch and more precise rethrow
    • Improved type inference for generic instance creation (diamond)
    • try-with-resources statement
    • Simplified varargs method invocation
  • Java 7 features that are NOT supported:
    • All new Java 7 classes (the Google App Engine whitelist has not been updated yet)
    • Method Handles
    • Invoke Dynamic bytecode
  • InetAddress name resolution now displays UnknownHostException instead of a runtime exception error when the host is unknown.
  • Datastore Index stats now report type instead of representation-type.
  • Class Loading Priority can now be granted to specific JAR files by adding class-loader-config element in appengine-web.xml file. This is an experimental feature.
  • Queries with transactions are now fully checked for consistency in Remote API.
  • Global Consistent Indexes are now deprecated in the Search API.
  • ListResponse<Document> listDocuments(ListRequest) has been deprecated and replaced with GetResponse<Document> getRange(GetRequest) in the Search API.
  • ListIndexesReponse listIndexes(ListIndexesRequest) has been deprecated and replaced with GetResponse<Index> getIndexes(GetIndexesRequest) in the Search API.
  • getField(String) has been deprecated and aliased to getFields(String) in the Search API.
  • AddResponse Index.add() has been deprecated and renamed to PutResponse Index.put() in the Search API.
  • RemoveResponse Index.remove() has been deprecated and renamed to DeleteReponse Index.delete() in the Search API.
  • Users can now change authentication options after app creation
  • Fixed an issue with Channel API breaking when using urlfetch service. This issue was limited to the SDK.
  • Fixed an issue with ResponseRewriterFilter not being threadsafe when using Remote API.

Version 1.7.2 - September 18, 2012

Version 1.7.1 - August 21, 2012

Version 1.7.0 - June 26, 2012

  • You can now configure your custom domain to serve HTTPS requests with App Engine. You can choose either an SNI, VIP, or SNI and VIP configuration. SNI costs $9/month for 5 certificates. A VIP costs $99/month.
  • Premier customers now have the option to create applications to be served from datacenters located in the European Union.
  • Developers can configure their HRD app to use Google's PageSpeed Service, which automatically speeds up serving of content for your application. The PageSpeed Service costs $0.39/gigabyte in addition to the normal App Engine bandwidth charges.
  • The Search API now contains support for storing and searching on GeoPoints.
  • The total size of all application versions is now limited to 1 GB. In the future, you'll be able to purchase additional storage for your application code.
  • Logs API calls are now $.12/gigabyte for all data read from the Logs API over the first 100MB.
  • You can now specify a time frame of up to 1 year for the retention of your application logs. All storage above 1 GB is billed based on the prices for logs storage.
  • You can now specify HTTP headers on static content for your application.
  • The HRD Blob Migration tool is now generally available.
  • After using the datastore backup utility, you can now restore that backup to a new app id.
  • It will not be possible to create new authorizations for M/S applications to access Cloud SQL instances.
  • You can now delete a Google Cloud Storage object using delete() in the Blobstore Service API.
  • You can now fetch a Google Cloud Storage object using fetch() in the Blobstore Service API.
  • You can now store keys for a Google Cloud Storage object in the datastore.
  • The BlobstoreService.createUploadUrl() call now works for Google Cloud Storage buckets.
  • You can now use ImageService.getServingUrl() and ImageService.deleteServingUrl() for Google Cloud Storage objects.
  • You can now specify your own Security Provider in Java.
  • The Java Datastore API now supports Or queries.
  • We've increased various Search API limits. New limits are a maximum of 1000 documents returned from search() or listDocuments(), a maximum of 1000 indexes returned from listIndexes(), and a maximum offset of 1000 for search() or listIndexes()
  • Fixed a javascript syntax error in the Admin Console.
  • Fixed an issue in the Search API tab of the Admin Console where it threw an error displaying non-ascii characters.

Version 1.6.6 - May 22, 2012

  • On May 8, 2012 we released an experimental Search API.
  • The Admin Console now displays the quotas for Search API Calls and Search Stored Data.
  • The Search API has deprecated the ListDocumentsException class. When using this class you will see a compile-time warning.
  • The Search API has deprecated the orderId attribute on the Document class. It has been superseded by the rank attribute.
  • The Search API has replaced AddDocumentResponse with AddResponse. This will require fixing and redeploying applications that use Index.add().
  • App creation for apps using the Master/Slave datastore is now restricted to only those users who already own a Master/Slave app.
  • Apps with billing enabled are now able to configure up to 100 cron jobs.
  • Admin Console can no longer be included in an <IFRAME>. To prevent clickjacking attacks on the Admin Console, we are now setting X-Frame-Options: SAMEORIGIN. To read more about clickjacking, please read:
  • The datastore now supports embedding entities as properties of other entities.
  • The Admin Console will now periodically prompt administrators to take an optional App Engine satisfaction survey.
  • Appstats now contains information about the cost of the RPCs made during the request.
  • Fixed an issue where large datastore backups were unable to be deleted.
  • Fixed an issue where datastore backups fail due to an ascii decoding issue.
  • Fixed an issue where running a projection query on a multi-valued property with an equality filter did not return any results.
  • Fixed an issue where XG transactions did not work with the Remote API.

Version 1.6.5 - April 24, 2012

  • You can now perform datastore queries that return a subset of your entity properties with the same performance and cost of a keys-only query. This feature is experimental.
  • In the High Replication Datastore, there is a new metadata kind, __entity_group__, that has a numeric __version__ property. This property is guaranteed to increase on every change to the entity group.
  • The Images API now supports manipulating objects hosted on Google Cloud Storage.
  • In the Images API, the getServingUrl() call now optionally allows you to specify if the URL you are generating should be served over https.
  • In the Task Queue REST API, you can now specify a tag when you insert a task on a Pull Queue.
  • In the Task Queue API, you can specify a deadline for the leaseTasks() call. The default deadline has been increased from 5 seconds to 10 seconds.
  • You can now use cron to schedule Datastore backups.
  • The Datastore Admin now has a page that displays information on the status of your Datastore backups and restores.
  • You can now abort your Datastore backup or restore from the Datastore Admin.
  • You can now restore a single Datastore Kind from the Datastore Admin from a Datastore backup.
  • In the Admin Console, you can report production issues with your application directly to Google from the application's pages. Simply click the "Report Production Issues" link, fill out the requested information, and submit.
  • All user requests have X-AppEngine-Region, X-AppEngine-City, and X-AppEngine-CityLatLong headers which contain location information based on the IP address of the client request. For a full description of these headers, see:
  • As announced in 1.6.4, omitting the <threadsafe> directive from appengine-web.xml results in an error.

Version 1.6.4 - March 27, 2012

  • Billed applications that have specified additional logs retention over 1 GB are now being charged for that storage at $0.24/GB/month (the first gigabyte of logs storage is free). All logs beyond an application's specified storage limit will be deleted. Please examine your Application Settings page to verify you are retaining the desired amount of logs.
  • Datastore statistics now show the amount of storage used by application indexes.
  • We have released an experimental utility for migrating your application's blobs at the same time you migrate your datastore data. You can opt-in to blob migration in the Admin Console when you start your migration.
  • We have updated the experimental Backup/Restore functionality to include the option to backup and restore to Google Storage for Developers.
  • Version 2.0 of the App Engine DataNucleus plugin is now available as an experimental release. This plugin contains support for JDO 3 and JPA 2 and over 40 bug fixes. For a full list see:
  • Threads are available as an experimental feature via com.google.appengine.api.ThreadManager.
  • The Admin Console now provides a Memcache viewer that lists Memcache stats and can display Memcache content based on key.
  • Using the blobstoreService.serve method, your application can serve objects hosted on Google Cloud Storage.
  • The method ApiProxy.getRemainingMillis() returns the amount of milliseconds remaining before a request hits the request deadline.
  • New datastore query related callbacks - PreGet(), PreQuery(), and PostLoad() are now available.
  • Omitting the <threadsafe> directive from appengine-web.xml now results in a warning. Starting with the 1.6.5 release, omitting this directive will result in an error.
  • You can set an RPC deadline for the Task Queue API's leaseTasks() method.
  • The Datastore Admin tab in the Admin Console now shows entities from every namespace.
  • GQL queries in the Admin Console no longer throw an error when a trailing semi-colon is included.
  • Fixed an issue where setting ApiProxy delegate caused ClassCastException in unit test teardown.
  • Fixed an issue where <async-session-persistence> did not work.
  • The Datastore Admin now shows entities from every namespace.
  • Fixed an issue in the Java Development Server where Task Queue retry parameters were ignored.
  • Fixed an issue in the Java Pipeline API (http://code.google.com/p/appengine-pipeline/) that would lead to "No object found in pool with id=barrier(...)" errors when used in HRD applications.

Version 1.6.3 - February 28, 2012

  • In the Admin Console, you can use the new Traffic Splitting feature to send a certain percentage of traffic to a non-default application version. The traffic is split by either cookie or IP address.
  • Emails that are sent from Google Apps domains email addresses where the domain has been set up to use DKIM will be signed: when an email was from a request that originated on that app's domain or any time the email was sent from an app adminstrator, including when that email is sent from a cron job or task queue request.
  • In the Admin Console, you can now choose how much and how long you'd like to store logs. All apps get 1G for free and eventually will be able to pay for more, while the amount can be increased this release we won't start charging for the additional capacity until the next release at the earliest.
  • The instances screen in the Admin Console now has a button to shut down a specific instance.
  • Each application log has a link to the instance that served the request. If the instance is no longer serving requests, a message will be displayed.
  • The TaskQueue API now supports the ability to tag a Pull Queue task. You may then lease tasks by tag. This feature is experimental.
  • Using Google Apps wildcard domain mappings, you can access alternate versions of your app via a custom domain.
  • Push and Pull Queues are now listed separately in the SDK development console.
  • The PermGen size for backend and frontend instances classes has been increased. The values are as follows: F1/B1 - 44MB, F2/B2 - 108MB, F4/B4 - 236MB, B8 - 492MB.
  • The DataNucleus Enhancer command line tool (com.google.appengine.tools.enhancer.Enhance) now supports the -enhancerVersion flag, which allow you to specify the version of DataNucleus with which to enhance your JDO/JPA classes.
  • The dev appserver command line now supports the --generated_dir flag, which allows you to specify a directory in which to write files generated by the SDK.
  • Fixed a StackOverflowError when using the Remote API.

Version 1.6.2 - January 31, 2012

  • The Admin Console Datastore Admin has added experimental backup and restore functionality. The job occurs within your application and counts against your application quota, including Instance Hours, Datastore Ops and Datastore Storage.
  • Developers can now specify how long a channel token will last until it expires, with the default remaining two hours. Channel API quota is now measured both in calls to create a channel and the number of hours of channel time requested. The maximum hours of quota is the maximum number of channel creation calls * 2, so free apps get 200 hours of requested channel token time.
  • Task Queue API requests now include a X-Appengine-TaskETA header, that can be used to measure task delivery latency.
  • We have removed the deprecated labs version of the TaskQueue API.
  • The default API deadlines for Blobstore API calls have been raised to 15s for online and 30s for offline requests, up from 5s.
  • The Images API now allows you to stretch an image without maintaining the aspect ratio.
  • Mail Quota for App Engine apps that have signed up for billing will only be increased after the first payment for the app is processed.
  • Fixed an issue where the dev_appserver did not resize images down to 512 pixels by default, as it does in production.
  • Fixed an issue with the Images API where valid images were returning a NotImageError.

Version 1.6.1 - December 13, 2011

  • You can now configure Frontend Instance Classes from your Admin Console's application settings page. Three classes are available, with increasing memory, CPU limits, and associated cost. By default, all applications use the basic frontend instance setting of 128MB memory and 600MHz CPU.
  • We've added new functionality to the Log API that will allow you to read your application's logs programmatically.
  • We are releasing an experimental Conversion API that will allow you to convert between document types including .doc, .html, .pdf, images using OCR, and more.
  • The High Replication Datastore migration utility is now available as a GA feature, and is no longer experimental.
  • The dev appserver now emits a warning when loading any classes that fall under com.google.appengine.repackaged.*.
  • Version 2.0.0 of the DataNucleus App Engine plugin is available as an experimental download from http://goo.gl/kyQiO. This release adds support for JPA2 and JDO3. Installation instructions are available at http://goo.gl/ELBL4.
  • The Blobstore API now supports the multiple="true" attribute to the HTML input tag.
  • TaskOptions.Param now implements Serializable.
  • Fixed an issue in the SDK where logging null caused a 500 error.
  • Fixed an issue with backends where SessionManager might try to save a session forever under certain circumstances.
  • Fixed an issue where cached static files served to IPs on the DoS blacklist consumed bandwidth quota.

Version 1.6.0 - November 7, 2011

  • On November 7th, App Engine will be out of Preview. The new Terms of Service and previously announced pricing changes will be in effect. Additionally, all paid apps are now covered by our SLA.
  • Paid apps can now specify the maximum pending latency for instances and the minimum number of idle instances for your application in the Admin Console.
  • Task Queue storage has been separated in to its own line item. Previously, this was included in Datastore storage.
  • We have released an experimental utility, available in the Admin Console, to assist in migrating your application to the High Replication datastore. This utility allows you to copy the bulk of your data in the background, while the source application is still serving. You then need a brief read-only period to migrate your application data while you copy the data that has changed from the time the original copy started.
  • Blobstore, which was previously limited to apps with billing enabled, is now available for all apps.
  • We have published a new article on Datastore Index Selection and Advanced Search which explains our recent improvements to the query planner that make exploding indexes unnecessary.
  • Applications can now receive XMPP error stanzas at /_ah/xmpp/error.
  • In the Admin Console data viewer, you can now filter by namespace from a drop down menu, if applicable.
  • In the Admin Console's Datastore Statistics, we now offer namespace suggest for filtering stats.
  • Added API functionality for making calls to the Memcache API asynchronously.
  • In the Memcache API, getIdentifiable() and putIfUntouched() now support batch operations.
  • We've added a page, /_ah/admin/capabilitiesstatus, to the dev console that allows you to configure the capability state of the local API implementations when running locally.
  • We've added LocalCapabilitiesServiceTestConfig to the testing API, which allows you to configure the capability state of the local API implementations in your tests.
  • The Datastore API now supports callbacks that can execute before or after put() and delete() calls.
  • The queue-name argument is now optional for async-session-persistence in appengine-web.xml.
  • Fixed a ClassNotFound error when using async-session-persistence.
  • Fixed an issue with memcache serialization when using a entity key with a name that points to the same reference as the key's parent.
  • Fixed an issue where DoS stats in the Admin Console didn't work for High Replication apps.
  • WARNING: Starting with 1.6.1 (our next release, NOT this release), URLFetch requests will honor the Accept-Encoding header. If your code sets this header, then it must be prepared to receive content of the specified type. For more information please see

Version 1.5.5 - Oct 11, 2011

  • We have increased the number of files you can upload with your application to from 3,000 to 10,000.
  • We have increased the size limit for a single file uploaded to App Engine from 10MB to 32MB.
  • We have increased the Frontend request deadline from 30 seconds to 60 seconds.
  • We have increased the online URLFetch maximum deadline from 10 seconds to 60 seconds. The default deadline remains at 10 seconds. The offline maximum deadline for URLFetch remains at 10 minutes.
  • We have increased the URLFetch Post payload from 1MB to 5MB.
  • App Engine now supports Cross Group (XG) transactions with the High Replication Datastore, which allow you to perform transactions across multiple entity groups. http://code.google.com/appengine/docs/java/datastore/transactions.html
  • We have added a graph to the admin console that displays the number of instances for which you will be billed.
  • In the XMPP API, getPresence() is deprecated in favor of using the inbound presence handlers documented in http://code.google.com/appengine/docs/java/xmpp/overview.html#Handling_User_Presence.
  • Fixed an issue in the Admin Console where the "Run Now" button did not work for tasks with a '-' in the name.
  • Fixed an issue to provide a better error message when a user tries to parse an HttpRequest's input stream more than once in a request.
  • Fixed an issue to provide a better error message when using the Mail API to send email to an invalid user address.
  • Fixed an issue in the SDK where HttpServletRequest.getInputStream().read() always returned -1. http://code.google.com/p/googleappengine/issues/detail?id=5396
  • Fixed an issue where you could not schedule a cron job to run every 100 minutes. http://code.google.com/p/googleappengine/issues/detail?id=5861

Version 1.5.4 - Sep 12, 2011

  • You can now specify the maximum size for a blob in BlobstoreService.createUploadUrl().
  • Zigzag merge join queries will now continue scanning up to the 30 second Datastore query deadline. For zigzag queries that used to generate DatastoreNeedIndexException, many will now succeed. A small percentage will now instead timeout.
  • The SDK datastore viewer in the dev console now displays the number of "Write Ops" for each entity. "Write Ops" are the total number of entity and index writes that were required to create the entity.
  • The Prospective Search API is available in Java for all applications. This API is still experimental, so applications will be limited to a maximum of 1000 subscriptions.
  • We made a classloading improvement that we expect to help loading request latencies for projects with large numbers of jars.
  • Added support for the set_default_version flag to Appcfg.
  • The Java Remote API now recognizes the HTTP_X_APPENGINE_INBOUND_APPID. This means that the Datastore Admin copy functionality will work when using Java's Remote API with the destination app.
  • Fixed an issue that incorrectly allowed creation of tasks with whitespace in the url.
  • Fixed the error message for "transaction not found" to be more descriptive.
  • Fixed an issue with the dev appserver's local Blobstore implementation trying to modify an immutable collection.
  • Fixed an SDK issue affecting GWT applications where CONFIG, FINE, FINER, FINEST logging messages were not displayed.

Version 1.5.3 - Aug 17, 2011

  • We've removed the limit on the size of blob uploads using the Blobstore API.
  • You can now send emails with any attachment extension that is not included on the email attachment extension blacklist.
  • Added a getIndexes() method to the DatastoreService to retrieve an application's indexes and their corresponding states.
  • The development server has been updated to understand the reduced index requirements, thanks to the 1.5.2 datastore query planner changes.
  • The Datastore Admin functionality can now be enabled directly in the Admin Console.
  • You can now use Remote API to access the services of one App Engine application from a different App Engine application.
  • The Java Testing APIs now default to UTC if no timezone is specified.
  • AppCfg / appcfg.sh now supports download_app, which will download all files that were uploaded from your war directory.
  • AppCfg / appcfg.sh now supports the -V (version) and -A (application) flags.
  • Added app_identity api with methods to work with service accounts for asserting identity on outbound HTTP calls.
  • Added an improved HRD migration tool that requires a read-only period relative to your datastore write rate (as opposed to your datastore size, which is how the current version behaves). The tool is not yet generally available. If you are interested in being an early adopter please fill out this form:
  • Fixed an issue in the Channel API where jsapi was not served with the correct MIME type.
  • Fixed an issue where blobs could not be uploaded using HTTPS.
  • Fixed an issue where GQL didn't allow querying for valid kind names containing '.', '-', and ':' by supporting quoted identifiers.

Version 1.5.2 - July 21, 2011

  • You can now specify the minimum pending latency for instances and the maximum number of idle instances for your application in the Admin Console.
  • The datastore now never requires an exploding index.
  • The SDK will now never suggest indexes with the same property repeated, as such indexes are likely to be exploding indexes.
  • Datastore stats are now available on a per-namespace basis.
  • The queue details page in the Admin Console now contains request header details, previous run information, and a task payload viewer.
  • You can modify the lease on a task leased from a pull queue using the modifyTaskLease() method.
  • Pull Task maximum size has been increased to 1MB.
  • You can now update the number of available backend instances without needing to first stop the backend using the backend configure appcfg directive.
  • You can now set the References and In-Reply-To headers with the Mail API.
  • The whitelist has been updated to include support for JSR 105.
  • When the SDK throws a DatastoreNeedIndexException for a missing index definition, the exception can now be caught.

Version 1.5.1 - June 20, 2011

Version 1.5.0.1 - May 16, 2011

  • Fixed a bug that caused appengine-jsr107cache-1.5.0.jar to be empty.

Version 1.5.0 - May 10, 2011

Version 1.4.3 - March 30, 2011

Version 1.4.2 - February 11, 2011

  • You can now vacuum datastore indexes with the Java SDK.
  • The XMPP API was updated to include presence and allow subscriptions.
  • The Task Queue now supports programmatic deleting of tasks.
  • The maximum rate per queue at which tasks are processed has been increased to 100 tasks per second.
  • The maximum number of concurrent requests for a single queue can be specified in the application's queue.xml. This provides an additional easy-to-use form of rate limiting. The current number of running tasks is also displayed in the Admin Console.
  • Metadata queries in the Datastore now support cursors.
  • Admin Console logs viewer now displays time as YYYY-MM-DD HH:MM:SS.mmm.
  • Added a warning when an admin tries to upload a queue.yaml where the number of new queues and the number of disabled queues exceeds 100.
  • Added a putIfUntouched() method to the Memcache API.
  • Added JAX-WS support for writing SOAP clients and SAAJ support for writing SOAP servers. JAX-WS for SOAP servers is not yet supported.
  • The Mail API added KML and KMZ files as allowed attachments.
  • Fixed an issue where mail from @appid.appspotmail.com did not work when sending mail to app admins.
  • Fixed an issue where the SDK did not enforce the 100 task limit for the Task Queue.
  • Fixed an issue where the Java SDK URLFetch did not support 32MB response sizes.
  • Fixed an issues where <jsp-file> mappings in web.xml were broken.

Version 1.4.0 - December 02, 2010

  • The Always On feature allows applications to pay and keep 3 instances of their application always running, which can significantly reduce application latency.
  • Developers can now enable Warmup Requests. By specifying a handler in an app's appengine-web.xml, App Engine will attempt to send a Warmup Request to initialize new instances before a user interacts with it. This can reduce the latency an end-user sees for initializing your application.
  • The Channel API is now available for all users.
  • Task Queue has been officially released, and is no longer an experimental feature. The API import paths that use 'labs' have been deprecated. Task queue storage will count towards an application's overall storage quota, and will thus be charged for.
  • The deadline for Task Queue and Cron requests has been raised to 10 minutes. Datastore and API deadlines within those requests remain unchanged.
  • For the Task Queue, developers can specify task retry-parameters in their queue.xml.
  • Apps that have enabled billing are allowed up to 100 queues with the Task Queue API.
  • Metadata Queries on the datastore for datastore kinds, namespaces, and entity properties are available.
  • URL Fetch allowed response size has been increased, up to 32 MB. Request size is still limited to 1 MB.
  • The request and response sizes for the Images API have been increased to 32 MB.
  • The total size of Memcache batch operations is increased to 32 MB. The 1 MB limit on individual Memcache objects still applies.
  • The attachment size for outgoing emails has been increased from 1 MB to 10 MB. The size limit for incoming emails is still 10 MB.
  • Size and quantity limits on datastore batch get/put/delete operations have been removed. Individual entities are still limited to 1 MB, but your app may batch as many entities together for get/put/delete calls as the overall datastore deadline will allow for.
  • When iterating over query results, the datastore will now asynchronously prefetch results, reducing latency in many cases by 10-15%.
  • The Admin Console Blacklist page lists the top blacklist rejected visitors.
  • The automatic image thumbnailing service supports arbitrary crop sizes up to 1600px.
  • Overall average instance latency in the Admin Console is now a weighted average over QPS per instance.
  • Added a low-level AysncDatastoreService for making calls to the datastore asynchronously.
  • Added a getBodyAsBytes() method to QueueStateInfo.TaskStateInfo, this returns the body of the task state as a pure byte-string.
  • The whitelist has been updated to include all classes from javax.xml.soap.
  • Fixed an issue sending email to multiple recipients.
  • Revert the default logging level during GWT hosted mode back to INFO.
  • Fixed an issue with OpenId over SSL.

Version 1.3.8 - October 14, 2010

  • You can run task queue tasks immediately from the admin console.
  • Added an OutputSettings class to the Images API to specify the JPEG encoding quality when running in production.
  • Support for login of multiple Google accounts within an app, and longer login sessions. For more information see:
  • In queue.xml, the maximum allowed bucket size is now 100.
  • Removed limits on zigzag merge-join queries. Therefore the error "The built-in indices are not efficient enough for this query and your data. Please add a composite index for this query." will no longer be thrown in most cases, enabling more types of queries without indexes.
  • The whitelist has been updated to include java.net.InetAddress and some interfaces and abstract classes in javax.xml.soap, including javax.xml.soap.SOAPMessage.
  • Fixed an issue reserving App Ids by owners of emails containing periods, multiple cases, and googlemail.com address.
  • Fixed an issue where TaskOptions had no public getters, making testing impossible.
  • Fixed an issue on the development server where PNGs were being returned as JPEGs.

Version 1.3.7 - August 30, 2010

Version 1.3.6 - August 17, 2010

  • Multitenancy is now supported in the datastore, allowing better compartmentalization of user data.
  • Automatic image thumbnailing is now available in the Images API using getServingUrl.
  • Users can now serve custom static error pages for over_quota, dos_api_denial and default cases.
  • Results of datastore count() queries and offsets for all datastore queries are no longer capped at 1000.
  • Added a pause queue button to the task queue details page in the Admin Console.
  • Historical graphs have been added to all of the dashboard graphs in the Admin Console.
  • Content-range headers are supported on Blobstore downloads.
  • New method to allocate datastore ids in a given range: allocateIdRange()
  • The app.yaml format is supported with Java applications.
  • Increased several rate limited quotas for free applications.
  • Fixed an issue that did not allow forms of over 200,000 bytes to be submitted.

Version 1.3.5 - June 30, 2010

  • Ability to configure the Task Queue storage limit with the total-storage-limit field in the queue.xml file.
  • Task Queues now support up to 50 qps per queue, up from 50 qps per app.
  • Developers can programmatically access Blobs with BlobstoreInputStream, which provides an InputStream view of a blob in Blobstore.
  • Bulkloader transform helpers for lists and hierarchical keys were added.
  • remote_api_shell commands can be sent over HTTPS or HTTP.
  • Admin Console logs now include information on request time latency.
  • The datastore now supports end cursors.
  • Fixed an issue where requesting /appstats would not properly direct to /appstats/.
  • Fixed an issue with inconsistent URL mappings between the SDK and production.

Version 1.3.4 - May 19, 2010

Version 1.3.3 - April 21, 2010

  • Added two new system properties com.google.appengine.application.id and com.google.appengine.application.version
  • DeadlineExceededException is now always thrown before HardDeadlineExceededError
  • Decreased likelihood of "Too many URLMap" deployment errors for complex web apps
  • Fixed an error where QuotaService.getCpuTimeInMegaCycles() was returning cycles instead of megacycles
  • Fixed an issue between differing behavior of jsp in the production and development environments
  • Fixed an issue uploading webapps with .tag files

Version 1.3.2 - March 25, 2010

JDO/JPA Changes

  • Support default rpc deadlines and query-specific deadlines
  • Support default read consistency config and query-specific read consistency config

Version 1.3.1 - February 10, 2010

JDO/JPA Changes

Version 1.3.0 - December 14, 2009

Service Changes

  • Added new Blobstore Viewer to Admin Console

Version 1.2.8 - December 3, 2009

Version 1.2.6 - October 13, 2009

Version 1.2.5 - September 3, 2009

JDO/JPA Changes

Version 1.2.2 - July 13, 2009

  • Fix memcache stub to not allow decrementing below 0.
  • Allow cron tasks to be sent to admin-only servlets.
  • The images API no longer goes into an infinite loop parsing certain images.
  • Replicate static file handling in the DevAppServer more correctly.
  • Prefix all built-in servlets with _ah to ensure they don't interact with user-supplied servlets.
  • Add OverQuotaException and RequestTooLargeException for API calls.
  • Fix generation of indexes that query by the same property multiple times.
  • Fix generation of indexes kind queries that sort in descending order.
  • Provide a servlet for session cleanup.
  • Try to prompt for a password using Swing in AppCfg if running Java 1.5.
  • Better emulate datastore transaction support in the DevAppServer.
  • New -p option to AppCfg for connecting to App Engine via a HTTP proxy.
  • Increase file limit from 1000 files to 3000 files, and check the limit up-front.
  • Allow ancestor queries to be made inside of transactions.
  • AppCfg should re-prompt users for authentication after an unauthorized error.
  • Allow Entity objects to be cloned and their properties reset.
  • Implement a local data viewer for the DevAppServer.
  • Slight performance enhancement to datastore queries.
  • Improve performance of applications that do a large number of File stat operations.
  • Added com.google.apphosting.api.ApiProxy.CapabilityDisabledException which developers can catch in the event of a datastore outage or when the datastore goes into read-only mode.

JDO/JPA Changes

Version 1.2.1 - May 13, 2009

JDO/JPA Changes

Powered by Google Project Hosting