App Engine Java SDK version 1.7.0
[gae.git] / java / RELEASE_NOTES
blob389e2762462a31827a2dbfc0f441c7eb13efc581
1 Copyright 2008 Google Inc.
2 All rights reserved.
4 App Engine Java SDK - Release Notes
6 Version 1.7.0
7 =============
8 - You can now configure your custom domain to serve HTTPS requests with App
9   Engine. You can choose either an SNI, VIP, or SNI and VIP configuration. SNI
10   costs $9/month for 5 certificates. A VIP costs $99/month.
11     https://developers.google.com/appengine/docs/ssl
12 - Premier customers now have the option to create applications to be served from
13   datacenters located in the European Union.
14 - Developers can configure their HRD app to use Google's PageSpeed Service,
15   which automatically speeds up serving of content for your application. The
16   PageSpeed Service costs $0.39/gigabyte in addition to the normal App Engine
17   bandwidth charges.
18     https://developers.google.com/appengine/docs/adminconsole/performancesettings#pagespeed
19 - The Search API now contains support for storing and searching on GeoPoints.
20 - The total size of all application versions is now limited to 1 GB. In the
21   future, you'll be able to purchase additional storage for your application
22   code.
23 - Logs API calls are now $.12/gigabyte for all data read from the Logs API over
24   the first 100MB.
25 - You can now specify a time frame of up to 1 year for the retention of your
26   application logs. All storage above 1 GB is billed based on the prices for
27   logs storage.
28 - You can now specify HTTP headers on static content for your application.
29 - The HRD Blob Migration tool is now generally available.
30 - After using the datastore backup utility, you can now restore that backup
31   to a new app id.
32 - It will not be possible to create new authorizations for M/S applications to
33   access Cloud SQL instances.
34 - You can now delete a Google Cloud Storage object using delete() in the
35   Blobstore Service API.
36 - You can now fetch a Google Cloud Storage object using fetch() in the
37   Blobstore Service API.
38 - You can now store keys for a Google Cloud Storage object in the datastore.
39 - The BlobstoreService.createUploadUrl() call now works for Google Cloud Storage
40   buckets.
41 - You can now use ImageService.getServingUrl() and
42   ImageService.deleteServingUrl() for Google Cloud Storage objects.
43 - You can now specify your own Security Provider in Java.
44     http://code.google.com/p/googleappengine/issues/detail?id=1612
45 - The Java Datastore API now supports Or queries.
46 - We've increased various Search API limits. New limits are a maximum of 1000
47   documents returned from search() or listDocuments(), a maximum of 1000
48   indexes returned from listIndexes(), and a maximum offset of 1000 for search()
49   or listIndexes()
50 - Fixed a javascript syntax error in the Admin Console.
51     http://code.google.com/p/googleappengine/issues/detail?id=7566
52 - Fixed an issue in the Search API tab of the Admin Console where it threw an
53   error displaying non-ascii characters.
54     http://code.google.com/p/googleappengine/issues/detail?id=7601
56 Version 1.6.6
57 =============
58 - On May 8, 2012 we released an experimental Search API.
59     http://googleappengine.blogspot.com/2012/05/looking-for-search-find-it-on-google.html
60 - The Admin Console now displays the quotas for Search API Calls and Search
61   Stored Data.
62 - The Search API has deprecated the AddDocumentResponse and
63   ListDocumentsException classes. When using this class you will see a
64   compile-time warning.
65 - The Search API has deprecated the orderId attribute on Document class. It has
66   been replaced by the rank attribute.
67 - App creation for apps using the Master/Slave datastore is now restricted to
68   only those users who already own a Master/Slave app.
69 - Apps with billing enabled are now able to configure up to 100 cron jobs.
70 - Admin Console can no longer be included in an <iframe>.  To prevent
71   clickjacking attacks on the Admin Console, we are now setting
72   X-Frame-Options: SAMEORIGIN.  To read more about clickjacking, please read:
73   https://www.owasp.org/index.php/Clickjacking.
74 - The datastore now supports embedding entities as properties of other entities.
75 - The Admin Console will now periodically prompt administrators to take an
76   optional App Engine satisfaction survey.
77 - Appstats now contains information about the cost of the RPCs made during the
78   request.
79 - Fixed an issue where large datastore backups were unable to be deleted.
80 - Fixed an issue where datastore backups fail due to an ascii decoding issue.
81 - Fixed an issue where running a projection query on a multi-valued property
82   with an equality filter did not return any results.
83 - Fixed an issue where XG transactions did not work with the Remote API.
84     http://code.google.com/p/googleappengine/issues/detail?id=7238
86 Version 1.6.5
87 =============
88 - You can now perform datastore queries that return a subset of your entity
89   properties with the same performance and cost of a keys-only query. This
90   feature is experimental.
91 - In the High Replication Datastore, there is a new metadata kind,
92   __entity_group__, that has a numeric __version__ property. This property is
93   guaranteed to increase on every change to the entity group.
94 - The Images API now supports manipulating objects hosted on Google Cloud
95   Storage.
96 - In the Images API, the getServingUrl() call now optionally allows you to
97   specify if the URL you are generating should be served over https.
98 - In the Task Queue REST API, you can now specify a tag when you insert a task
99   on a Pull Queue.
100 - In the Task Queue API, you can specify a deadline for the leaseTasks() call.
101   The default deadline has been increased from 5 seconds to 10 seconds.
102 - You can now use cron to schedule Datastore backups.
103 - The Datastore Admin now has a page that displays information on the status of
104   your Datastore backups and restores.
105 - You can now abort your Datastore backup or restore from the Datastore Admin.
106 - You can now restore a single Datastore Kind from the Datastore Admin from a
107   Datastore backup.
108 - In the Admin Console, you can report production issues with your application
109   directly to Google from the application's pages. Simply click the "Report
110   Production Issues" link, fill out the requested information, and submit.
111 - All user requests have X-AppEngine-Region, X-AppEngine-City, and
112   X-AppEngine-CityLatLong headers which contain location information based on
113   the IP address of the client request. For a full description of these headers,
114   see:
115     https://developers.google.com/appengine/docs/java/runtime#Request_Headers
116 - As announced in 1.6.4, omitting the <threadsafe> directive from
117   appengine-web.xml results in an error.
119 Version 1.6.4
120 =============
121 - Billed applications that have specified additional logs retention over 1 GB
122   are now being charged for that storage at $0.24/GB/month (the first gigabyte
123   of logs storage is free). All logs beyond an application's specified storage
124   limit will be deleted. Please examine your Application Settings page to verify
125   you are retaining the desired amount of logs.
126 - Datastore statistics now show the amount of storage used by application
127   indexes.
128 - We have released an experimental utility for migrating your application's
129   blobs at the same time you migrate your datastore data. You can opt-in to
130   blob migration in the Admin Console when you start your migration.
131 - We have updated the experimental Backup/Restore functionality to include
132   the option to backup and restore to Google Storage for Developers.
133 - Version 2.0 of the App Engine DataNucleus plugin is now available as an
134   experimental release. This plugin contains support for JDO 3 and JPA 2 and
135   over 40 bug fixes. For a full list see:
136     http://code.google.com/p/datanucleus-appengine/source/browse/branches/2_0_0/dist/RELEASE_NOTES.ORM
137 - Threads are available as an experimental feature via
138   com.google.appengine.api.ThreadManager.
139 - The Admin Console now provides a Memcache viewer that lists Memcache stats and
140   can display Memcache content based on key.
141 - Using the blobstoreService.serve method, your application can serve objects
142   hosted on Google Cloud Storage.
143 - The method ApiProxy.getRemainingMillis() returns the amount of milliseconds
144   remaining before a request hits the request deadline.
145 - New datastore query related callbacks - PreGet(), PreQuery(), and PostLoad()
146   are now available.
147 - Omitting the <threadsafe> directive from appengine-web.xml now results in
148   a warning. Starting with the 1.6.5 release, omitting this directive will
149   result in an error.
150 - You can set an RPC deadline for the Task Queue API's leaseTasks() method.
151 - The Datastore Admin tab in the Admin Console now shows entities from every
152   namespace.
153     http://code.google.com/p/googleappengine/issues/detail?id=3962
154 - GQL queries in the Admin Console no longer throw an error when a trailing
155   semi-colon is included.
156 - Fixed an issue where setting ApiProxy delegate caused ClassCastException in
157   unit test teardown.
158     http://code.google.com/p/googleappengine/issues/detail?id=4442
159 - Fixed an issue where <async-session-persistence> did not work.
160     http://code.google.com/p/googleappengine/issues/detail?id=5774
161 - The Datastore Admin now shows entities from every namespace.
162     http://code.google.com/p/googleappengine/issues/detail?id=3962
163 - Fixed an issue in the Java Development Server where Task Queue retry
164   parameters were ignored.
165     http://code.google.com/p/googleappengine/issues/detail?id=5200
166 - Fixed an issue in the Java Pipeline API
167   (http://code.google.com/p/appengine-pipeline/) that would lead to "No object
168   found in pool with id=barrier(...)" errors when used in HRD applications.
171 Version 1.6.3
172 =============
173 - In the Admin Console, you can use the new Traffic Splitting feature to send a
174   certain percentage of traffic to a non-default application version. The
175   traffic is split by either cookie or IP address.
176 - Emails that are sent from Google Apps domains email addresses where the domain
177   has been set up to use DKIM will be signed: when an email was from a request
178   that originated on that app's domain or any time the email was sent from
179   an app adminstrator, including when that email is sent from a cron job or task
180   queue request.
181 - In the Admin Console, you can now choose how much and how long you'd like to
182   store logs.  All apps get 1G for free and eventually will be able to pay for
183   more, while the amount can be increased this release we won't start charging
184   for the additional capacity until the next release at the earliest.
185 - The instances screen in the Admin Console now has a button to shut down
186   a specific instance.
187 - Each application log has a link to the instance that served the request. If
188   the instance is no longer serving requests, a message will be displayed.
189 - The TaskQueue API now supports the ability to tag a Pull Queue task. You may
190   then lease tasks by tag. This feature is experimental.
191 - Using Google Apps wildcard domain mappings, you can access alternate
192   versions of your app via a custom domain.
193 - Push and Pull Queues are now listed separately in the SDK development console.
194 - The PermGen size for  backend and frontend instances classes has been
195   increased. The values are as follows: F1/B1 - 44MB, F2/B2 - 108MB,
196   F4/B4 - 236MB, B8 - 492.
197 - The DataNucleus Enhancer command line tool
198   (com.google.appengine.tools.enhancer.Enhance) now supports the
199   -enhancerVersion flag, which allow you to specify the version of DataNucleus
200   with which to enhance your JDO/JPA classes.
201 - The dev appserver command line now supports the --generated_dir flag, which
202   allows you to specify a directory in which to write files generated by the
203   SDK.
204 - Fixed a StackOverflowError when using the Remote API.
205     http://code.google.com/p/googleappengine/issues/detail?id=6349
207 Version 1.6.2
208 =============
209 - The Admin Console Datastore Admin has added experimental backup and restore
210   functionality. The job occurs within your application and counts against your
211   application quota, including Instance Hours, Datastore Ops and Datastore
212   Storage.
213 - Developers can now specify how long a channel token will last until it
214   expires, with the default remaining two hours. Channel API quota is now
215   measured both in calls to create a channel and the number of hours of channel
216   time requested. The maximum hours of quota is the maximum number of channel
217   creation calls * 2, so free apps get 200 hours of requested channel token
218   time.
219 - Task Queue API requests now include a X-Appengine-TaskETA header, that can be
220   used to measure task delivery latency.
221 - We have removed the deprecated labs version of the TaskQueue API.
222 - The default API deadlines for Blobstore API calls have been raised to 15s for
223   online and 30s for offline requests, up from 5s.
224 - The Images API now allows you to stretch an image without maintaining the
225   aspect ratio.
226     http://code.google.com/p/googleappengine/issues/detail?id=2220
227 - Mail Quota for App Engine apps that have signed up for billing will only be
228   increased after the first payment for the app is processed.
229 - Fixed an issue where the SDK did not resize images down to 512 pixels by
230   default, as it does in production.
231 - Fixed an issue with the Images API where valid images were returning a
232   NotImageError.
233     http://code.google.com/p/googleappengine/issues/detail?id=5545
235 Version 1.6.1
236 =============
237 - You can now configure Frontend Instance Classes from your Admin Console's
238   application settings page. Three classes are available, with increasing
239   memory, CPU limits, and associated cost. By default, all applications use the
240   basic frontend instance setting of 128MB memory and 600MHz CPU.
241 - We've added new functionality to the Log API that will allow you to read your
242   application's logs programmatically.
243 - We are releasing an experimental Conversion API that will allow you to convert
244   between document types including .doc, .html, .pdf, images using OCR, and
245   more.
246 - The High Replication Datastore migration utility is now available as a GA
247   feature, and is no longer experimental.
248 - The dev appserver now emits a warning when loading any classes that fall under
249   com.google.appengine.repackaged.*.
250 - Version 2.0.0 of the DataNucleus App Engine plugin is available as an
251   experimental download from http://goo.gl/kyQiO. This release
252   adds support for JPA2 and JDO3. Installation instructions are available at
253   http://goo.gl/ELBL4.
254 - The Blobstore API now supports the multiple="true" attribute to the HTML input
255   tag.
256 - TaskOptions.Param now implements Serializable.
257     http://code.google.com/p/googleappengine/issues/detail?id=3712
258 - Fixed an issue in the SDK where logging "null" caused a 500 error.
259 - Fixed an issue with backends where SessionManager might try to save a session
260   forever under certain circumstances.
261 - Fixed an issue where cached static files served to IPs on the DoS blacklist
262   consumed bandwidth quota.
263     http://code.google.com/p/googleappengine/issues/detail?id=4607
265 Version 1.6.0
266 =============
267 - On November 7th, App Engine will be out of Preview. The new Terms of Service
268   and previously announced pricing changes will be in effect. Additionally, all
269   paid apps are now covered by our SLA.
270     http://code.google.com/appengine/docs/billing.html
271 - Paid apps can now specify the maximum pending latency for instances and the
272   minimum number of idle instances for your application in the Admin Console.
273 - Task Queue storage has been separated in to its own line item. Previously,
274   this was included in Datastore storage.
275 - We have released an experimental utility, available in the Admin Console, to
276   assist in migrating your application to the High Replication datastore. This
277   utility allows you to copy the bulk of your data in the background, while the
278   source application is still serving. You then need a brief read-only period to
279   migrate your application data while you copy the data that has changed from
280   the time the original copy started.
281 - Blobstore, which was previously limited to apps with billing enabled, is now
282   available for all apps.
283 - We have published a new article on Datastore Index Selection and Advanced
284   Search which explains our recent improvements to the query planner that make
285   exploding indexes unnecessary.
286     http://code.google.com/appengine/articles/indexselection.html
287 - Applications can now receive xmpp error stanzas at /_ah/xmpp/error.
288 - In the Admin Console data viewer, you can now filter by namespace from a drop
289   down menu, if applicable.
290 - In the Admin Console's Datastore Statistics, we now offer namespace suggest
291   for filtering stats.
292 - Added API functionality for making calls to the Memcache API asynchronously.
293 - In the Memcache API, getIdentifiable() and putIfUntouched() now support
294   batch operations.
295 - We've added a page, /_ah/admin/capabilitiesstatus, to the dev console that
296   allows you to configure the capability state of the local API implementations
297   when running locally.
298 - We've added LocalCapabilitiesServiceTestConfig to the testing API, which
299   allows you to configure the capability state of the local API implementations
300   in your tests.
301 - The Datastore API now supports callbacks that can execute before or after
302   put() and delete() calls.
303 - The queue-name argument is now optional for async-session-persistence in
304   appengine-web.xml.
305 - Fixed a ClassNotFound error when using async-session-persistence.
306     http://code.google.com/p/googleappengine/issues/detail?id=5774
307 - Fixed an issue with memcache serialization when using a entity key with a name
308   that points to the same reference as the key's parent.
309     http://code.google.com/p/googleappengine/issues/detail?id=2088
310 - Fixed an issue where DoS stats in the Admin Console didn't work for High
311   Replication apps.
312     http://code.google.com/p/googleappengine/issues/detail?id=5237
313 - WARNING: Starting with 1.6.1 (our next release, NOT this release), URLFetch
314   requests will honor the Accept-Encoding header. If your code sets this header
315   then it must be prepared to receive content of the specified type. For more
316   information please see
317     http://code.google.com/p/googleappengine/issues/detail?id=4978
319 Version 1.5.5
320 =============
321 - We have increased the number of files you can upload with your application to
322   from 3,000 to 10,000.
323 - We have increased the size limit for a single file uploaded to App Engine from
324   10MB to 32MB.
325 - We have increased the Frontend request deadline from 30 seconds to 60 seconds.
326 - We have increased the online URLFetch maximum deadline from 10 seconds to 60
327   seconds. The default deadline remains at 10 seconds. The offline maximum deadline
328   for URLFetch remains at 10 minutes.
329 - We have increased the URLFetch Post payload from 1MB to 5MB.
330 - App Engine now supports Cross Group (XG) transactions with the High
331   Replication Datastore, which allow you to perform transactions across multiple
332   entity groups.
333     http://code.google.com/appengine/docs/java/datastore/transactions.html
334 - We have added a graph to the admin console that displays the number of
335   instances for which you will be billed.
336 - In the XMPP API, getPresence() is deprecated in favor of using the inbound
337   presence handlers documented in
338   http://code.google.com/appengine/docs/java/xmpp/overview.html#Handling_User_Presence.
339 - Fixed an issue in the Admin Console where the "Run Now" button did not work
340   for tasks with a '-' in the name.
341 - Fixed an issue to provide a better error message when a user tries to parse an
342   HttpRequest's input stream more than once in a request.
343 - Fixed an issue to provide a better error message when using the Mail API to
344   send email to an invalid user address.
345 - Fixed an issue in the SDK where HttpServletRequest.getInputStream().read()
346   always returned -1.
347     http://code.google.com/p/googleappengine/issues/detail?id=5396
348 - Fixed an issue where you could not schedule a cron job to run every 100
349   minutes.
350     http://code.google.com/p/googleappengine/issues/detail?id=5861
352 Version 1.5.4
353 =============
354 - You can now specify the maximum size for a blob in
355   BlobstoreService.createUploadUrl().
356 - Zigzag merge join queries will now continue scanning up to the 30 second
357   Datastore query deadline. For zigzag queries that used to generate
358   DatastoreNeedIndexException, many will now succeed. A small percentage will
359   now instead timeout.
360 - The SDK datastore viewer in the dev console now displays the number of "Write
361   Ops" for each entity. "Write Ops" are the total number of entity and index
362   writes that were required to create the entity.
363 - The Prospective Search API is available in Java for all applications. This API
364   is still experimental, so applications will be limited to a maximum of 1000
365   subscriptions.
366 - We made a classloading improvement that we expect to help loading request
367   latencies for projects with large numbers of jars.
368 - Added support for the set_default_version flag to Appcfg.
369 - The Java Remote API now recognizes the HTTP_X_APPENGINE_INBOUND_APPID. This
370   means that the Datastore Admin copy functionality will work when using
371   Java's Remote API with the destination app.
372 - Fixed an issue that incorrectly allowed creation of tasks with whitespace in
373   the url.
374 - Fixed the error message for "transaction not found" to be more descriptive.
375 - Fixed an issue with the dev appserver's local Blobstore implementation trying
376   to modify an immutable collection.
377     http://code.google.com/p/googleappengine/issues/detail?id=3081
378 - Fixed an SDK issue where CONFIG, FINE, FINER, FINEST logging messages were not
379   displayed.
380     http://code.google.com/p/googleappengine/issues/detail?id=4591
383 Version 1.5.3
384 =============
385 - We've removed the limit on the size of blob uploads using the Blobstore API.
386 - You can now send emails with any attachment extension that is not included on
387   the email attachment extension blacklist.
388 - Added a getIndexes() method to the DatastoreService to retrieve an
389   application's indexes and their corresponding states.
390 - The development server has been updated to understand the reduced index
391   requirements of the 1.5.2 datastore query planner changes.
392 - The Datastore Admin functionality can now be enabled directly in the Admin
393   Console.
394 - You can now use Remote API to access the services of one App Engine
395   application from a different App Engine application.
396 - The Java Testing APIs now default to UTC if no timezone is specified.
397 - AppCfg now supports download_app, which will download all files that were
398   uploaded from your war directory.
399 - AppCfg now supports the -V (version) and -A (application) flags.
400 - Added app_identity api with methods to work with service accounts for
401   asserting identity on outbound HTTP calls.
402     http://code.google.com/appengine/docs/java/appidentity/overview.html
403 - Added an improved HRD migration tool that requires a read-only period relative
404   to your datastore write rate (as opposed to your datastore size, which is how
405   the current version behaves). The tool is not yet generally available.  If you
406   are interested in being an early adopter please fill out this form:
407   http://goo.gl/3jrXu
408 - Fixed an issue in the Channel API where jsapi was not served with the correct
409   mime type.
410 - Fixed an issue where blobs could not be uploaded using HTTPS.
411 - Fixed an issue where GQL didn't allow querying for valid kind names
412   containing '.', '-', and ':' by supporting quoted identifiers.
413     http://code.google.com/p/googleappengine/issues/detail?id=2584
415 Version 1.5.2
416 =============
417 - You can now specify the minimum pending latency for instances and the maximum
418   number of idle instances for your application in the Admin Console.
419 - The datastore now never requires an exploding index.
420     http://code.google.com/appengine/docs/python/datastore/queries.html#Big_Entities_and_Exploding_Indexes
421 - The SDK will now never suggest indexes with the same property repeated, as
422   such indexes are likely to be exploding indexes.
423 - Datastore stats are now available on a per-namespace basis.
424 - The queue details page in the Admin Console now contains request header
425   details, previous run information, and a task payload viewer.
426 - You can modify the lease on a task leased from a pull queue using the
427   modifyTaskLease() method.
428 - Pull Task maximum size has been increased to 1MB.
429 - You can now update the number of available backend instances without needing
430   to first stop the backend using the "backend configure" appcfg directive.
431 - You can now set the "References" and "In-Reply-To" headers with the Mail API.
432     http://code.google.com/p/googleappengine/issues/detail?id=2802
433 - The whitelist has been updated to include support for JSR 105.
434 - When the SDK throws a DatastoreNeedIndexException for a missing index
435   definition, the exception can now be caught.
437 Version 1.5.1
438 =============
439 - The development server's datastore and testing service implementations now
440   contains logic that closely replicates the consistency guarantees of the High
441   Replication datastore. To use, run the dev_appserver with the flag
442   -Ddatastore.default_high_rep_job_policy_unapplied_job_pct=20.
443 - All user request have an X-AppEngine-Country header which contains the
444   ISO-3166-1 alpha-2 country code for the user, based on the IP address of the
445   client request.
446 - The Channel API can now provide user presence, this can be configured by
447   adding channel_presence to the list of inbound services for your application.
448 - The Images API now supports the WebP format.
449 - You can switch the timezone for App Engine logs in the Admin Console.
450   http://code.google.com/p/googleappengine/issues/detail?id=734
451 - Added javax.xml.ws.Service$Mode to the whitelist.
452   http://code.google.com/p/googleappengine/issues/detail?id=4770
453 - You can configure your application to asynchronously write https session data
454   by adding <async-session-persistence enabled="true"/> to your
455   appengine-web.xml.
456   http://code.google.com/p/googleappengine/issues/detail?id=1692
457 - The local task queue unit testing API now supports Deferred Tasks.
458 - Fixed an issue where using reserved URLs did not cause an error in the SDK.
459 - Fixed an issue where having a backends.xml configuration file caused logging
460   to stdout to fail in the SDK.
461 - Fixed an issue where the Channel API didn't work with non-default versions of
462   applications using the High Replication datastore.
463 - Fixed an issue where the Remote API rtok comparison was broken for some users,
464   causing appfcg download data to fail.
465 - Fixed an issue with the SDK where you could not apply a transform to PNG
466   images.
467   http://code.google.com/p/googleappengine/issues/detail?id=3458
468 - When displaying corrupt data in the Admin Console dataviewer, a useful error
469   will be displayed, instead of a 500.
470   http://code.google.com/p/googleappengine/issues/detail?id=4945
471 - Fixed an issue with the SDK where non-string index names caused an error upon
472   upload.
473   http://code.google.com/p/googleappengine/issues/detail?id=5004
474 - Datanucleus now supports polymorphic relationships.
475   http://code.google.com/p/datanucleus-appengine/issues/detail?id=153
476 - Datanucleus now supports PreparedQuery#countEntities(FetchOptions).
477   http://code.google.com/p/datanucleus-appengine/issues/detail?id=225
478 - Fixed an issue with datanucleus where recursive relation did not work.
479   http://code.google.com/p/datanucleus-appengine/issues/detail?id=80
481 Version 1.5.0.1
482 ===============
483 - Fixed a bug that caused appengine-jsr107cache-1.5.0.jar to be empty.
485 Version 1.5.0
486 =============
487 - Support for Backends which allow developers to create infrastructure
488   components that complement the existing dynamic apps that App Engine already
489   provides. Instances of a backend can maintain state, be addressed
490   individually, and are not subject to per-request time limits. They can also be
491   configured to consume more memory and CPU than ordinary dynamic instances.
492 - Task Queues support pull mode, allowing for more control over task queue work
493   rates. To use pull queues, include the 'mode' element in your queue.xml.
494 - Pull queues are supported by a REST API, allowing access from outside App
495   Engine. To use the REST API, you must also include a valid ACL section
496   specifying which users can lease tasks from the pull queue.
497 - Task Queue payload limits have been increased. Queues support 100KB per task.
498   Within App Engine, the new limit is 32 MB per batch of tasks. With the REST
499   API the limit is 1 MB per batch.
500 - HTTP request and response sizes have been increased to 32 MB.
501 - We have removed the rate quotas for requests, datastore operations,
502   memcache operations, and image API operations. Resource quotas still apply.
503 - When creating new applications, developers will now see the High Replication
504   Datastore as the default configuration option.  Developers that still wish to
505   use the Master/Slave configuration must explicitly choose this option at
506   application creation time.
507 - The Task Queue maximum configurable processing rate has been increased to
508   500/s.
509 - Modified Dashboard latency graphs to indicate they only include dynamic
510   requests.
511 - We have added two restrictions to the Mail API to improve the reliability
512   of the service for all applications.
513   - Emails must be sent from email accounts managed by Google (either Gmail or
514     a domain signed up for Google Apps).
515   - Reduced the number of free recipients per day from 2000 to 100 for new
516     applications.
517 - Fixed an issue where the Javadoc for the File API was not generated.
518 - Fixed an issue where the API Deadlines were not being enforced in the SDK.
519 - Fixed an issue with Federated Users causing the Admin Console dataviewer to
520   fail.
521     http://code.google.com/p/googleappengine/issues/detail?id=384
522 - Fixed an issue causing SDK URL Fetch not to work behind proxy.
523     http://code.google.com/p/googleappengine/issues/detail?id=544
524 - Fixed an issue deploying an app with version set to 0.
525     http://code.google.com/p/googleappengine/issues/detail?id=735
526 - Improved support for reserving an app id that is a canonicalized version of
527   a user's Gmail address.
528     http://code.google.com/p/googleappengine/issues/detail?id=1196
529 - Added a more useful error message for unavailable App Ids.
530     http://code.google.com/p/googleappengine/issues/detail?id=1303
531 - Added clearer error messaging for invalid transactions in the SDK.
532     http://code.google.com/p/googleappengine/issues/detail?id=1357
533 - Added better error messages for cron.xml parsing.
534     http://code.google.com/p/googleappengine/issues/detail?id=1490
535 - Entity constructors are now consistent with KeyFactory constructors.
536     http://code.google.com/p/googleappengine/issues/detail?id=1626
537 - Task Queue names can now include the "_" character.
538     http://code.google.com/p/googleappengine/issues/detail?id=1723
539 - The sender of an email is no longer BCC'd when they are already included in
540   the email.
541     http://code.google.com/p/googleappengine/issues/detail?id=1907
542 - Added a more helpful error message when trying to send email to a malformed
543   address.
544     http://code.google.com/p/googleappengine/issues/detail?id=2386
545 - The SDK now returns an error if the Content-length header is not included in a
546   post request, matching production.
547     http://code.google.com/p/googleappengine/issues/detail?id=2512
548 - Fixed an issue where the wrong type of error was being thrown on HTTP request
549   timeout.
550     http://code.google.com/p/googleappengine/issues/detail?id=2464
551 - Fixed an issue where the Admin Console didn't keep the app version viewed
552   consistent across actions.
553     http://code.google.com/p/googleappengine/issues/detail?id=4023
554 - Added Javadocs for TaskOptions.taskName().
555     http://code.google.com/p/googleappengine/issues/detail?id=4316
556 - Fixed a typo in the Admin Console on the New App page.
557     http://code.google.com/p/googleappengine/issues/detail?id=4620
558 - Fixed an issue where sending mail from an app registered on the HR datastore
559   required the app id be prefaced with s~.
560     http://code.google.com/p/googleappengine/issues/detail?id=4671
561 - Fixed an issue where HTTP POST was broken in the SDK if the Content-Length
562   header was specified.
563     http://code.google.com/p/googleappengine/issues/detail?id=4836
565 Version 1.4.3
566 =============
567 - Added FileService API that allows writing to and reading from files in
568   blobstore.
569 - You can now specify cron execution for a time interval between a start and end
570   time.
571 - You can now configure the specific application version to which a task queue
572   or cron job will send requests.
573 - The Admin Console Task Queues page now displays a more accurate estimate of
574   queue size for queues containing more than 2000 tasks.
575 - Java applications can enable concurrent request support by setting
576   <threadsafe> to True in their appengine-web.xml. This flag indicates that
577   request handlers for your app are thread safe and multiple request handlers
578   may safely run at the same time in the same memory space for your application.
579 - Deferred library support now available in Java.
580     http://code.google.com/p/googleappengine/issues/detail?id=2381
581 - Remote API library now available in Java. This can be used in conjunction with
582   apps using either the Java or the Python runtime.
583 - The Java SDK now supports kindless and ancestor only queries.
584 - Fixed an issue where JAX-WS clients in the SDK could not handle receiving a
585   SOAP fault.
586 - Fixed an issue where the SDK did not support fetching HTTPS URLs.
587 - Fixed an issue where no link was displayed in the Admin Console blobstore
588   viewer for an unnamed blob.
589 - Fixed an issue where the Admin Console data viewer couldn't edit entities
590   with ByteString properties.
591     http://code.google.com/p/googleappengine/issues/detail?id=2367
592 - Fixed an issue where the Admin Console crashed when using a non-ascii
593   key_name.
594     http://code.google.com/p/googleappengine/issues/detail?id=2451
595 - The Disable Application admin function has been button-ized.
596     http://code.google.com/p/googleappengine/issues/detail?id=4323
597 - Fixed a regex validation issue in the queue.xml file that caused some uploads
598   to break.
599     http://code.google.com/p/googleappengine/issues/detail?id=4365
600 - Fixed an issue where the Java SDK Task Queue did not support 10 minute
601   timeouts.
602     http://code.google.com/p/googleappengine/issues/detail?id=4564
603 - Fixed an issue where the Channel API in the SDK didn't properly send messages
604   with unicode characters.
605     http://code.google.com/p/googleappengine/issues/detail?id=4675
607 Version 1.4.2
608 =============
609 - You can now vacuum datastore indexes with the Java SDK.
610 - The XMPP API was updated to include presence and allow subscriptions.
611 - The Task Queue now supports programmatic deleting of tasks.
612     http://code.google.com/p/googleappengine/issues/detail?id=2588
613 - The maximum rate per queue at which tasks are processed has been increased to
614   100 task per second.
615 - The maximum number of concurrent requests for a single queue can be specified
616   in the application's queue.xml. This provides an additional easy-to-use form
617   of rate limiting. The current number of running tasks is also displayed in
618   the Admin Console.
619 - Metadata queries in the Datastore now support cursors.
620 - Admin Console logs viewer now displays time as YYYY-MM-DD HH:MM:SS.mmm.
621 - The Mail API added KML and KMZ files as allowed attachments.
622 - Added support for verifying the server SSL certificate when making a
623   URLFetch request to an HTTPS URL. This will become the default in a future
624   release.
625 - Added a warning when an admin tries to upload a queue.yaml where the number
626   of new queues and the number of disabled queues exceeds 100.
627 - Added a putIfUntouched() method to the Memcache API.
628     http://code.google.com/p/googleappengine/issues/detail?id=2139
629 - Added JAX-WS support for writing SOAP clients and SAAJ support for writing
630   SOAP servers. JAX-WS for SOAP servers is not yet supported.
631 - Fixed an issue where mail from @appid.appspotmail.com did not work when
632   sending mail to app admins.
633 - Fixed an issue where the SDK did not enforce the 100 task limit for the Task
634   Queue.
635     http://code.google.com/p/googleappengine/issues/detail?id=3296
636 - Fixed an issue where the Java SDK URLFetch did not support 32MB response
637   sizes.
638     http://code.google.com/p/googleappengine/issues/detail?id=4215
639 - Fixed an issues where <jsp-file> mappings in web.xml were broken.
640     http://code.google.com/p/googleappengine/issues/detail?id=4216
642 Version 1.4.1
643 =============
644 There were no updates to the Java SDK for the 1.4.1 App Engine release.
646 Version 1.4.0
647 =============
648 - The Always On feature allows applications to pay and keep 3 instances of their
649   application always running, which can significantly reduce application
650   latency.
651 - Developers can now enable Warmup Requests. By specifying  a handler in an
652   app's appengine-web.xml, App Engine will attempt to send a Warmup Request to
653   initialize new instances before a user interacts with it. This can reduce the
654   latency an end-user sees for initializing your application.
655 - The Channel API is now available for all users.
656 - Task Queue has been officially released, and is no longer an experimental
657   feature. The API import paths that use 'labs' have been deprecated. Task queue
658   storage will count towards an application's overall storage quota, and will
659   thus be charged for.
660 - The deadline for Task Queue and Cron requests has been raised to 10 minutes.
661   Datastore and API deadlines within those requests remain unchanged.
662 - For the Task Queue, developers can specify task retry-parameters in their
663   queue.xml.
664 - Apps that have enabled billing are allowed up to 100 queues with the Task
665   Queue API.
666 - Metadata Queries on the datastore for datastore kinds, namespaces, and entity
667   properties are available.
668 - URL Fetch allowed response size has been increased, up to 32 MB. Request size
669   is still limited to 1 MB.
670 - The request and response sizes for the Images API have been increased to
671   32 MB.
672 - The total size of Memcache batch operations is increased to 32 MB. The 1 MB
673   limit on individual Memcache objects still applies.
674 - The attachment size for outgoing emails has been increased from 1 MB to 10 MB.
675   The size limit for incoming emails is still 10 MB.
676 - Size and quantity limits on datastore batch get/put/delete operations have
677   been removed. Individual entities are still limited to 1 MB, but your app may
678   batch as many entities together for get/put/delete calls as the overall
679   datastore deadline will allow for.
680 - When iterating over query results, the datastore will now asynchronously
681   prefetch results, reducing latency in many cases by 10-15%.
682 - The Admin Console Blacklist page lists the top blacklist rejected visitors.
683 - The automatic image thumbnailing service supports arbitrary crop sizes up to
684   1600px.
685 - Overall average instance latency in the Admin Console is now a weighted
686   average over QPS per instance.
687 - Added a low-level AysncDatastoreService for making calls to the datastore
688   asynchronously.
689 - Added a getBodyAsBytes() method to QueueStateInfo.TaskStateInfo, this returns
690   the body of the task state as a pure byte-string.
691 - The whitelist has been updated to include all classes from javax.xml.soap.
692 - Fixed an issue sending email to multiple recipients.
693     http://code.google.com/p/googleappengine/issues/detail?id=1623
694 - Revert the default logging level during GWT hosted mode back to INFO.
695     http://code.google.com/p/googleappengine/issues/detail?id=4011
696 - Fixed an issue with OpenId over SSL.
697   http://code.google.com/p/googleappengine/issues/detail?id=3393
699 Version 1.3.8
700 =============
701 - You can run task queue tasks immediately from the admin console.
702 - Added an OutputSettings class to the Images API to specify the JPEG encoding
703   quality when running in production.
704 - Support for login of multiple Google accounts within an app, and longer login
705   sessions. For more information see:
706     http://www.google.com/support/accounts/bin/answer.py?answer=181599
707 - In queue.xml, the maximum allowed bucket size is now 100.
708 - Removed limits on zigzag merge-join queries. Therefore the error "The built-in
709   indices are not efficient enough for this query and your data. Please add a
710   composite index for this query." will no longer be thrown in most cases,
711   enabling more types of queries without indexes.
712 - The whitelist has been updated to include java.net.InetAddress and some
713   interfaces and abstract classes in javax.xml.soap, including
714   javax.xml.soap.SOAPMessage.
715 - Fixed an issue reserving App Ids by owners of emails containing periods,
716   multiple cases, and googlemail.com address.
717     http://code.google.com/p/googleappengine/issues/detail?id=1196
718 - Fixed an issue where TaskOptions had no public getters, making testing
719   impossible.
720     http://code.google.com/p/googleappengine/issues/detail?id=3243
721 - Fixed an issue on the development server where PNGs were being returned as
722   JPEGs.
723     http://code.google.com/p/googleappengine/issues/detail?id=3661
725 Version 1.3.7
726 =============
727 - Fixed an SDK issue where calling getServingUrl raised an exception.
728     http://code.google.com/p/googleappengine/issues/detail?id=3598
730 Version 1.3.6
731 =============
732 - Multitenancy is now supported in the datastore, allowing better
733   compartmentalization of user data.
734 - Automatic image thumbnailing is now available in the Images API using
735   getServingUrl.
736 - Users can now serve custom static error pages for over_quota, dos_api_denial
737   and default cases.
738 - Results of datastore count() queries and offsets for all datastore queries
739   are no longer capped at 1000.
740 - Added a pause queue button to the task queue details page in the Admin
741   Console.
742 - Historical graphs have been added to all of the dashboard graphs in the Admin
743   Console.
744 - Content-range headers are supported on Blobstore downloads.
745 - New method to allocate datastore ids in a given range: allocateIdRange()
746 - The app.yaml format is supported with Java applications.
747 - Increased several rate limited quotas for free applications.
748 - Fixed an issue that did not allow forms of over 200,000 bytes to be submitted.
749    http://code.google.com/p/googleappengine/issues/detail?id=1608
751 Version 1.3.5
752 =============
753 - Ability to configure the Task Queue storage limit with the
754   total-storage-limit field in the queue.xml file.
755 - Task Queues now support up to 50 qps per queue, up from 50 qps per app.
756 - Developers can programmatically access Blobs with BlobstoreInputStream, which
757   provides an InputStream view of a blob in Blobstore
758 - Bulkloader transform helpers for lists and hierarchical keys were added.
759 - remote_api_shell commands can be sent over HTTPS or HTTP.
760 - Admin Console logs now include information on request time latency.
761 - The datastore now supports end cursors.
762 - Fixed an issue where requesting /appstats would not properly direct to
763   /appstats/.
764 - Fixed an issue with inconsistent URL mappings between the SDK and production.
765     http://code.google.com/p/googleappengine/issues/detail?id=2598
767 Version 1.3.4
768 =============
769 - Client side bulkloader available with the Python SDK that has a new
770   configuration syntax and wizard for easier import/export with the datastore.
771   Can be used by enabling remote_api in your Java application
772 - Applications can now be configured to authenticate with OpenID by selecting
773   the OpenID option when creating your application in the admin console
774     http://code.google.com/p/googleappengine/issues/detail?id=248
775     http://code.google.com/p/googleappengine/issues/detail?id=56
776 - New API to allow App Engine apps to act as OAuth service providers
777     http://code.google.com/p/googleappengine/issues/detail?id=919
778 - The version update check in the Java SDK now uses https
779 - Allow full access to javax.el.*
780     http://code.google.com/p/googleappengine/issues/detail?id=3157
781 - Increased the timeout during deployment to 15 minutes
782 - Fixed an issue with JPA where an illegal cast exception was thrown during the
783   fetch of integer fields
784 - MemcacheService.setNamespace() is deprecated in favor of
785   MemcacheServiceFactory.getMemcacheManager(namespace)
786 - Support in the SDK for Java 1.5 is being deprecated. These warnings now appear
787   when starting the SDK
789 Version 1.3.3.1
790 ===============
791 - Fixed an issue where servlet filters could cause 404s
792     http://code.google.com/p/googleappengine/issues/detail?id=3138
794 Version 1.3.3
795 =============
796 - Added two new system properties com.google.appengine.application.id and
797   com.google.appengine.application.version
798 - DeadlineExceededException is now always thrown before
799   HardDeadlineExceededError
800 - Decreased likelihood of "Too many URLMap" deployment errors for complex
801   web apps
802 - Fixed an error where QuotaService.getCpuTimeInMegaCycles() was returning
803   cycles instead of megacycles
804 - Fixed an issue between differing behavior of jsp in the production and
805   development environments
806     http://code.google.com/p/googleappengine/issues/detail?id=3022
807 - Fixed an issue uploading webapps with .tag files
808     http://code.google.com/p/googleappengine/issues/detail?id=2902
810 Version 1.3.2
811 =============
812 - New API to read the contents of uploaded Blobs (fetch_data)
813     http://code.google.com/p/googleappengine/issues/detail?id=2536
814 - URLFetch now supports accessing ports 80-90, 440-450, and 1024-65535
815 - Mail API now allows common document formats as attachments
816     http://code.google.com/p/googleappengine/issues/detail?id=494
817 - The Task Queue API now supports adding multiple tasks in a single call to
818   Queue.add()
819 - Fixed charset handling for inbound emails
820     http://code.google.com/p/googleappengine/issues/detail?id=2326
821 - Fixed issue with compositing background colors in dev_appserver
822 - New feature in the datastore to specify whether to use strong or eventually
823   consistent reads (the default is strong)
824 - New datastore feature allows setting deadlines for operations
825 - Increased the maximum Task Queue refill rate from 20/s to 50/s
826 - Support for IP blacklisting to prevent denial of service (DoS) attacks
827 - App Stats is now available for the Java SDK in addition to Python
828 - Fix issue with expiration times not being reset on Put on the Memchache API
829     http://code.google.com/p/googleappengine/issues/detail?id=1284
830 - Fix issue preventing static files from being served when a servlet is mapped to root
831     http://code.google.com/p/googleappengine/issues/detail?id=1379
833 Version 1.3.1
834 =============
835   - Datastore Query Cursors
836       http://code.google.com/appengine/docs/java/datastore/queriesandindexes.html#Query_Cursors
837   - Transactional Tasks
838   - Support for Custom Admin Console pages
839   - Java Precompilation is now on by default
840       Developers can opt-out of precompilation by setting the flag in
841       appengine-web.xml:
842       <precompilation-enabled>false</precompilation-enabled>
843   - New built-in support for unit testing (see appengine-testing.jar)
844       http://code.google.com/appengine/docs/java/tools/localunittesting.html
845       http://code.google.com/p/googleappengine/issues/detail?id=326
846   - net.sf.jsr107 package included as an alternative to the low-level
847     Memcache API
848   - javax.annotation.Resource/Resources added to the package whitelist
849   - New "month" and "synchronized" syntax for Cron configuration
850       http://code.google.com/appengine/docs/java/config/cron.html
851   - URLFetch supports asynchronous requests
852       http://code.google.com/p/googleappengine/issues/detail?id=1899
853   - appcfg.sh uses HTTPS for application deployment
854   - appcfg.sh adds request_logs --append
855   - Changes to the order queries without a specified sort order are returned
856     Only queries that use IN will see different results.
857   - Added support for multiple != filters on the same property
858   - Improved support for keys-only queries when using IN and != filters
859   - Support for ETags, If-matches, If-not-matches HTTP Headers, as well as 304
860     status codes now available on static files (not yet available on the
861     dev_appserver or Blobstore blobs)
862       http://code.google.com/p/googleappengine/issues/detail?id=575
863   - Fixed issue where the maximum transform count was enforced for composite
864     operations
865       http://code.google.com/p/googleappengine/issues/detail?id=1656
866   - Fixed issue with whitespace on the end of strings in web.xml
867       http://code.google.com/p/googleappengine/issues/detail?id=2242
868   - Fixed web.xml <error-page> entries for 404 error codes
869       http://code.google.com/p/googleappengine/issues/detail?id=1477
870   - Added validation prevent welcome-files with absolute paths
871       http://code.google.com/p/googleappengine/issues/detail?id=1249
872   - Fixed issue where cancelling a deployment in progress could unintentionally
873     corrupt the SDK
874       http://code.google.com/p/googleappengine/issues/detail?id=2255
875   - Fixed issue with QuotaService.getCpuTimeInMegaCycles() returning 0
876       http://code.google.com/p/googleappengine/issues/detail?id=2639
877   - Fixed issue where JSP exceptions will be incorrectly cast causing a
878     ClassCastException
879       http://code.google.com/p/googleappengine/issues/detail?id=1438
881 Version 1.3.0
882 =============
883   - Support for the new Blobstore API
884   - New com.google.appengine.runtime.{version,environment} system properties
885     (and a SystemProperty accessor class)
886   - New sample applications for GWT 2.0
887   - Optimizations for many reflection operations
889 Version 1.2.8
890 =============
891   - Support for JAXB. JAXB is included in JDK 1.6 (and App Engine's production
892     servers). If you're using JDK 1.5 with your local dev_appserver, you will
893     need to include the JAXB libraries with your application to use it.
894       http://code.google.com/p/googleappengine/issues/detail?id=1267
895   - New support for application pre-compilation to reduce the length of
896     loading requests. To enable pre-compilation on your application, add this
897     flag to your appengine-web.xml:
898       <precompilation-enabled>true</precompilation-enabled>
899     If you have trouble deploying your application, you should remove this
900     flag or set it to false.
901   - Added Quota API (com.google.appengine.api.quota) to match Python API.
902   - Low-level Memcache API now supports batchIncrement().
903   - HTTPResponse object now has getFinalUrl() method for 302 redirects.
904     - http://code.google.com/p/googleappengine/issues/detail?id=1464
905   - Java Dev Appserver now automatically executes tasks.  If you prefer the
906     old behavior where tasks do not automatically execute you can use the
907     following flag when starting the server:
908       -Dtask_queue.disable_auto_task_execution
909   - Additional file extensions permitted when sending mail.
910     - http://code.google.com/p/googleappengine/issues/detail?id=494
911   - Fixed issue with Java mail handler not processing multipart messages
912     correctly.
913   - Fixed agent code included in appengine-local-runtime.jar results in
914     RuntimeException.
915     - http://code.google.com/p/googleappengine/issues/detail?id=2280
916   - Fixed issue with sort orders defined on properties that allow multiple
917     values.
918     - http://code.google.com/p/googleappengine/issues/detail?id=2349
919   - Fixed problem with dropped query strings after requiring log-in.
920     - http://code.google.com/p/googleappengine/issues/detail?id=2225
921   - Removed limitation preventing multiple parameters with the same name.
922     - http://code.google.com/p/googleappengine/issues/detail?id=2090
923   - Fixed issue with local datastore incorrectly sorting results of ancestor
924     queries.
925     - http://code.google.com/p/googleappengine/issues/detail?id=2177
926   - New Index building status page in the Admin Console
927   - Task Queue now supports purging queues, and deleting tasks and queues via
928     the Admin Console.
929     - http://code.google.com/p/googleappengine/issues/detail?id=2159
930     - http://code.google.com/p/googleappengine/issues/detail?id=1740
931   - Over Quota HTTP status code changed from 403 to 503, other to 500.
932     - http://code.google.com/p/googleappengine/issues/detail?id=961
933   - Task Queue now considers all HTTP 2xx status codes to represent success.
935 For past release notes, visit:
936 http://code.google.com/p/googleappengine/wiki/SdkForJavaReleaseNotes