]> source.dussan.org Git - vaadin-framework.git/commitdiff
Remove Google App Engine from documentation (#8038)
authorPekka Hyvönen <pekka@vaadin.com>
Mon, 19 Dec 2016 12:38:34 +0000 (14:38 +0200)
committerGitHub <noreply@github.com>
Mon, 19 Dec 2016 12:38:34 +0000 (14:38 +0200)
* Remove Google App Engine from documentation

Mention removal in release notes.

Part of #8033

all/src/main/templates/release-notes.html
documentation/advanced/advanced-gae.asciidoc [deleted file]
documentation/advanced/chapter-advanced.asciidoc
documentation/application/application-lifecycle.asciidoc
documentation/getting-started/getting-started-first-project.asciidoc

index aa6b4f962abd8fa37bf661b7056fc08f8d8e99ef..d72fee79f5383f4d96df6012541d3126c685176d 100644 (file)
         <ul><h4>Compatibility and requirements</h4>
             <li>Vaadin Framework now requires Java 8 or later and Servlet 3.0 or later</li>
             <li>Support for older browsers (including Microsoft IE 8-10) and Windows Phone has been dropped</li>
+            <li>Support for Google App Engine has been dropped</li>
             <li><a href="#supportedservers">Supported servers</a></li>
         </ul>
         <ul><h4>New Data Binding API related changes</h4>
diff --git a/documentation/advanced/advanced-gae.asciidoc b/documentation/advanced/advanced-gae.asciidoc
deleted file mode 100644 (file)
index 0547f2f..0000000
+++ /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&lt;sessionid&gt;#.
-
-* The Vaadin [classname]#WebApplicationContext# class is serialized separately
-into memcache and datastore; the memcache key is [parameter]#_vac&lt;sessionid&gt;#
-and the datastore entity kind is [parameter]#_vac# with identifiers of the type
-[parameter]#_vac&lt;sessionid&gt;#.
-
-* __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.
-
-
-
-
-
index b14abfdda1844d20dddb2736e77e117545a6be52..c80ea410f15e3b797e5eaade64d2522c98db1b56 100644 (file)
@@ -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]
index 219002b414aa009fbeacb16794935974eb394cc2..8ce552c663a1b9a82d967cf5bcbf671e20a17b64 100644 (file)
@@ -55,15 +55,7 @@ Serialization requires that the applications are __serializable__, that is, all
 classes implement the [interfacename]#Serializable# interface. All Vaadin
 classes do. If you extend them or implement interfaces, you can provide an
 optional serialization key, which is automatically generated by Eclipse if you
-use it. Serialization is also used for clustering and cloud computing, such as
-with Google App Engine.
-
-ifdef::web[]
-For more about that topic, see
-<<dummy/../../../framework/advanced/advanced-gae#advanced.gae,"Google App Engine
-Integration">>.
-endif::web[]
-
+use it. Serialization is also used for clustering and cloud computing.
 
 
 [[application.lifecycle.servlet-service]]
index ede6f778417e574b5b777bfa50d39d48b17b6b66..3262b8a4b1a77a525318476388396dec71674b69 100644 (file)
@@ -82,9 +82,7 @@ The further steps in the New Project Wizard depend on the selected deployment
 configuration; the steps listed in this section are for the default servlet
 configuration.
 ifdef::web[]
-See <<dummy/../../../framework/advanced/advanced-gae#advanced.gae,"Google App
-Engine Integration">> and <<dummy/../../../framework/portal/portal-overview.asciidoc#portal.overview,"Portal Integration">> for instructions regarding the use of Vaadin in the alternative
-environments.
+See <<dummy/../../../framework/portal/portal-overview.asciidoc#portal.overview,"Portal Integration">> for instructions regarding the use of Vaadin with portals.
 endif::web[]
 
 [guilabel]#Vaadin version#:: Select the Vaadin version to use. The drop-down list shows, by default, the