Page Comparison

Running GAE-Studio on AppEngine

1. Download the latest war of GAE Studio from our Drive folder
2. Extract the content of the war to your preferred location.
3. Download the latest version of Google Appengine SDK for Java.
4. Extract the content of the zip to your preferred location.
5. Using the command line, execute:
   /appengine-java-sdk-x.y.z/bin/appcfg.sh -A __application_id__ -M gaestudio update /path/to/unpacked/gae_studio
6. Replace __application_id__ by your application ID. You may be asked to enter your email and password.
7. GAE Studio will be available at http://gaestudio.__application_id__.appspot.com

Requirements

The project in which you want to plug GAE Studio must respect the following condition:

1. It must use the Java runtime on Google App Engine

Versions 0.5 and earlier

1. Download GAE-Studio

2. Install gae-studio to your local .m2 by moving within a terminal where you stored GAE-Studio jar file then:

   Code Block
   theme Confluence language bash
   mvn install:install-file -Dfile=gae-studio-webapp-<VERSION>.jar -DgroupId=com.arcbees.gaestudio -DartifactId=gae-studio-webapp -Dversion=<VERSION> -Dpackaging=jar

Versions 0.6+

Starting from version 0.6, GAE Studio is now on maven cental. All you need to do is add the GAE Studio dependency. If you are not using Maven, the jar can still be downloaded from maven central directly.

<dependency>
    <groupId>com.arcbees.gaestudio</groupId>
    <artifactId>gae-studio-webapp</artifactId>
    <version>0.8.3</version>
</dependency>

Plugging GAE Studio in your project

If you're using Google Guice and RESTeasy:

1. Add gae-studio-webapp jar file to your lib folder (if not using Maven)

2. Modify the appengine-web.xml file and turn on sessions and Channel API

   Code Block
   theme Confluence language xml
   <sessions-enabled>true</sessions-enabled>   <inbound-services> <service>channel_presence</service> </inbound-services>

3. Add into your Guice servlet config:

   Code Block
   theme Confluence language java
   import com.arcbees.gaestudio.server.GaeStudioModule; public class GuiceServletConfig extends GuiceServletContextListener { @Override protected Injector getInjector() { // Important: GaeStudioModule needs to be the last one. return Guice.createInjector(new ServerModule(), new GaeStudioModule()); } }

1. Add to your web.xml:

   Code Block
   theme Confluence language xml
   <filter-mapping> <filter-name>guiceFilter</filter-name> <url-pattern>/*</url-pattern> <dispatcher>REQUEST</dispatcher> <dispatcher>FORWARD</dispatcher> </filter-mapping>

If you're using Google Guice, but not RESTeasy:

...

Add to your web.xml:

<context-param>
    <param-name>resteasy.servlet.mapping.prefix</param-name>
    <param-value>/rest</param-value>
</context-param>
 
<filter-mapping>
    <filter-name>guiceFilter</filter-name>
    <url-pattern>/*</url-pattern>
	<dispatcher>REQUEST</dispatcher>
    <dispatcher>FORWARD</dispatcher>
</filter-mapping>

If you're not using Google Guice:

1. Same as above
2. Same as above

3. Add to your web xml:

   Code Block
   theme Confluence language xml
   <listener> <listener-class>com.arcbees.gaestudio.server.guice.GaeStudioServletConfig</listener-class> </listener> <context-param> <param-name>resteasy.servlet.mapping.prefix</param-name> <param-value>/rest</param-value> </context-param> <filter> <filter-name>guiceFilter</filter-name> <filter-class>com.google.inject.servlet.GuiceFilter</filter-class> </filter> <filter-mapping> <filter-name>guiceFilter</filter-name> <url-pattern>/*</url-pattern> <dispatcher>REQUEST</dispatcher> <dispatcher>FORWARD</dispatcher> </filter-mapping>

Running GAE Studio

...

Running GAE-Studio from command line

Running GAE-Studio with the Maven Plugin for Java