diff options
author | Pekka Hyvönen <pekka@vaadin.com> | 2016-12-19 14:38:34 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2016-12-19 14:38:34 +0200 |
commit | dd20a4d9d8f04661318735843486a446a5193fb4 (patch) | |
tree | d8ab2692ac0c2e6d1ac96c0eebccf0e3a230c8aa /documentation/advanced | |
parent | 389be32ec5c3d1439f08c4baeafaa221ce3cda2a (diff) | |
download | vaadin-framework-dd20a4d9d8f04661318735843486a446a5193fb4.tar.gz vaadin-framework-dd20a4d9d8f04661318735843486a446a5193fb4.zip |
Remove Google App Engine from documentation (#8038)
* Remove Google App Engine from documentation
Mention removal in release notes.
Part of #8033
Diffstat (limited to 'documentation/advanced')
-rw-r--r-- | documentation/advanced/advanced-gae.asciidoc | 71 | ||||
-rw-r--r-- | documentation/advanced/chapter-advanced.asciidoc | 2 |
2 files changed, 0 insertions, 73 deletions
diff --git a/documentation/advanced/advanced-gae.asciidoc b/documentation/advanced/advanced-gae.asciidoc deleted file mode 100644 index 0547f2f134..0000000000 --- a/documentation/advanced/advanced-gae.asciidoc +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Google App Engine Integration -order: 7 -layout: page ---- - -[[advanced.gae]] -= Google App Engine Integration - -__This section is not yet fully updated to Vaadin 7.__ - -Vaadin includes support to run Vaadin applications in the Google App Engine -(GAE). The most essential requirement for GAE is the ability to serialize the -application state. Vaadin applications are serializable through the -[classname]#java.io.Serializable# interface. - -To run as a GAE application, an application must use -[classname]#GAEVaadinServlet# instead of [classname]#VaadinServlet#, and of -course implement the [classname]#java.io.Serializable# interface for all -persistent classes. You also need to enable session support in -[filename]#appengine-web.xml# with: - - -[source, xml] ----- -<sessions-enabled>true</sessions-enabled> ----- - -The Vaadin Project wizard can create the configuration files needed for GAE -deployment. See -<<dummy/../../../framework/getting-started/getting-started-first-project#getting-started.first-project.creation,"Creating -the Project">>. When the Google App Engine deployment configuration is selected, -the wizard will create the project structure following the GAE Servlet -convention instead of the regular Servlet convention. The main differences are: - -* Source directory: [filename]#src/main/java# -* Output directory: [filename]#war/WEB-INF/classes# -* Content directory: [filename]#war# - -== Rules and Limitations - -Running Vaadin applications in Google App Engine has the following rules and -limitations: - -* Avoid using the session for storage, usual App Engine limitations apply (no -synchronization, that is, it is unreliable). - -* Vaadin uses memcache for mutex, the key is of the form -[parameter]#_vmutex<sessionid>#. - -* The Vaadin [classname]#WebApplicationContext# class is serialized separately -into memcache and datastore; the memcache key is [parameter]#_vac<sessionid># -and the datastore entity kind is [parameter]#_vac# with identifiers of the type -[parameter]#_vac<sessionid>#. - -* __Do not__ update the application state when serving an -[classname]#ConnectorResource# (such as [classname]#ClassResource#. -[methodname]#getStream()#). - -* __Avoid__ (or be very careful when) updating application state in a -[classname]#TransactionListener# - it is called even when the application is not -locked and won't be serialized (such as with [classname]#ConnectorResource#), -and changes can therefore be lost (it should be safe to update things that can -be safely discarded later, that is, valid only for the current request). - -* The application remains locked during uploads - a progress bar is not possible. - - - - - diff --git a/documentation/advanced/chapter-advanced.asciidoc b/documentation/advanced/chapter-advanced.asciidoc index b14abfdda1..c80ea410f1 100644 --- a/documentation/advanced/chapter-advanced.asciidoc +++ b/documentation/advanced/chapter-advanced.asciidoc @@ -16,8 +16,6 @@ include::advanced-shortcuts.asciidoc[leveloffset=+2] include::advanced-printing.asciidoc[leveloffset=+2] -include::advanced-gae.asciidoc[leveloffset=+2] - include::advanced-security.asciidoc[leveloffset=+2] include::advanced-navigator.asciidoc[leveloffset=+2] |