Google App Engine JSON :: AboutMyRequest

Viele Wege führen nach JSON, hier ein kleines Beispiel in Java …

Das folgende Beispiel wurde unter Mac OS X 10.6.8 mit der Java Version 1.6.0_26, Eclipse EE 3.7.1 Indigo und Google Plugin für Eclipse 2.4.1 durchgeführt. Siehe auch Hello World Google App Engine …

AboutMyRequest …

… oder einfach über mein Request soll als kleines Beispiel die Informationen über eine Anfrage zur Anwendung in der Google App Engine in JSON zurück beantworten.

JSON Referenzimplementierung

Im SDK von der Google App Engine sind die Klassen der Referenzimplementierung zur Verarbeitung von JSON im Paket com.google.appengine.repackaged.org.json (appengine-api-labs-1.5.4.jar) vorhanden.

Damit die Dokumenation der Referenzimplementierung von Douglas Crockford in Eclipse verwendet werden kann, können die Quellen unter JSON-java als ZIP-Archiv heruntergeladen werden und dem Projekt hinzugefügt werden.

AboutMyRequestServlet

Ein neues Servlet wird im Google App Engine Projekt bei selektiertem Package über “File / New / Class” mit folgenden Einstellungen erstellt.

Google App Engine JSON :: Eclipse New Java Class

• Name: AboutMyRequestServlet
• Superclass: javax.servlet.http.HttpServlet

In dem folgenden Servlet wird ein JSONObject erzeugt (Zeile 20) und die jeweiligen Header-Informationen hinzugefügt (Zeile 25). Das JSONObject wird mit dem richtigen Media Type (Zeile 27) über Response einfach zum Client gesendet (Zeile 28).

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

package tld.sld.my.example;
 
import java.io.IOException;
import java.util.Enumeration;
 
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
 
import com.google.appengine.repackaged.org.json.JSONException;
import com.google.appengine.repackaged.org.json.JSONObject;
 
@SuppressWarnings("serial")
public class AboutMyRequestServlet extends HttpServlet {
 
	@Override
	protected void doGet(HttpServletRequest req, HttpServletResponse resp)
			throws ServletException, IOException {
		JSONObject jsonObject = new JSONObject();
		try {
			Enumeration<String> names = req.getHeaderNames();
			while(names.hasMoreElements()) {
				String name = names.nextElement();
				jsonObject.put(name, req.getHeader(name));
			}
			resp.setContentType("application/json");
			resp.getWriter().print(jsonObject);
		} catch (JSONException e) {
			e.printStackTrace();
		}
	}
 
}

AboutMyRequestServlet.java

Konfiguration

Damit das Servlet im Container bekannt ist (<servlet>) und über eine URL auflösbar ist (<servlet-mapping>), muss folgende Konfiguration in der Datei “war/WEB-INF/web.xml” hinzugefügt werden.

<servlet>
	<servlet-name>AboutMyRequest</servlet-name>
	<servlet-class>tld.sld.my.example.AboutMyRequestServlet</servlet-class>
</servlet>
<servlet-mapping>
	<servlet-name>AboutMyRequest</servlet-name>
	<url-pattern>/aboutmyrequest</url-pattern>
</servlet-mapping>

web.xml

Anschließend kann die Webanwendung über “Run / Run As / Web Application” gestartet werden und lokal über http://localhost:8888/aboutmyrequest getestet werden.

Antworten

Nach erfolgreicher Publizierung in der Google App Engine kann auf das Servlet über http://myappid.appspot.com/aboutmyrequest wie z.B. http://mgsimon.appspot.com/aboutmyrequest zugegriffen werden.

{
    "Accept-Language":"de-de,de;q=0.8,en-us;q=0.5,en;q=0.3",
    "Host":"mgsimon.appspot.com",
    "Accept-Charset":"ISO-8859-1,utf-8;q=0.7,*;q=0.7",
    "X-AppEngine-Country":"DE",
    "User-Agent":"Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; de; rv:1.9.2.23) Gecko/20110920 Firefox/3.6.23",
    "Accept":"text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
}

Antwort einer Anfrage durch Mozilla Firefox unter Mac OS X auf einem MacBook Pro

{
    "Host":"mgsimon.appspot.com",
    "Referer":"http://mgsimon.de/",
    "X-AppEngine-Country":"DE",
    "User-Agent":"Mozilla/5.0 (Linux; U; Android 2.3.3; de-de; HTC_DesireZ_A7272 Build/GRI40) AppleWebKit/533.1 (KHTML, like Gecko) Version/4.0 Mobile Safari/533.1"
}

Antwort einer Anfrage durch Browser unter Android auf einem HTC Desire Z

Die Anfrage wird durch die Google App Engine um zusätzliche Informationen wie z.B. die i18n Info “X-AppEngine-Country”:”DE” erweitert.

Weiter …

• rfc4627

Hello World Google App Engine :: Mozilla Firefox

“Hello World” in der Google App Engine, ein erstes kleines Beispiel in Java. Ab in die Cloud, schnell, schneller, am schnellsten …

Das folgende Beispiel wurde unter Mac OS X 10.6.8 mit der Java Version 1.6.0_26, Eclipse EE 3.7.1 Indigo und Google Plugin für Eclipse 2.4.1 durchgeführt.

Für die Verwendung der Google App Engine ist ein Google-Konto und die Anmeldung unter appengine.google.com notwendig.

Einfach mit der E-Mail und dem Passwort anmelden und auf der folgenden Seite über “Create Application” das eigene Konto durch eine Handynummer bestätigen. Eine SMS mit einem Code zur Bestätigung wird unmittelbar an die angegebene Nummer gesendet. Nach der Bestätigung kann die erste Anwendung erstellt werden.

“Application Identifier”, “Application Title, “I accept these terms.” und die Anwendung kann über “Create Application” erstellt werden.

Auf der Suche nach einem noch verfügbarem “Application Identifier” kann der Name des eigenen Google-Kontos verwendet werden, dieser sollten in der Regel für das eigene Konto reserviert sein.

Hello World Google App Engine :: Dashboard

Anwendungen für die Google App Engine können mit dem SDK für Java manuell oder mit etwas mehr Benutzerfreundlichkeit dem Google Plugin in der IDE Eclipse erstellt werden.

Eclipse herunterladen, Archiv extrahieren, Eclipse starten und das Google Repository über “Help / Install New Software… / Add…” mit folgenden Angaben hinzufügen.

• Name: Google
• Location: http://dl.google.com/eclipse/plugin/3.7

Google stellt das Plugin für mehrere Eclipse Versionen (Galileo, Helios, Indigo …) in verschiedene Repositories bereit. Die Adressen für die jeweilige Version sind unter Google Plugin für Eclipse aufgelistet.

Hello World Google App Engine :: Install Available Software

Hello World Google App Engine :: Eclipse Plugin

Hello World

Einfach über “File / New / Project …” ein “Google / Web Application Project” auswählen und durch “Next >” mit folgenden Einstellungen über “Finish” ein neues Projekt erstellen.

• Project name: HelloWorldGoogleAppEngine
• Package: tld.sld.my.example
• Use Google Web Toolkit abwählen

Hello World Google App Engine :: Create Web Application Project

package tld.sld.my.example;
 
import java.io.IOException;
import javax.servlet.http.*;
 
@SuppressWarnings("serial")
public class HelloWorldGoogleAppEngineServlet extends HttpServlet {
	public void doGet(HttpServletRequest req, HttpServletResponse resp)
			throws IOException {
		resp.setContentType("text/plain");
		resp.getWriter().println("Hello, world");
	}
}

Das erste Servlet “Hello World Google App Engine” ohne eine Zeile selbst geschrieben zu haben … ;)

Test

Die Entwicklungsumgebung bietet durch das Google Plugin für Eclipse eine lokale Simulationsumgebung an.

Die Google App Engine Web Anwendung wird bei selektiertem Projekt über “Run / Run As / Web Application” lokal gestartet und im Browser kann über die URL http://localhost:8888/ die folgende Startseite geladen werden.

Hello World Google App Engine :: Hello App Engine

Hello World Google App Engine :: Mozilla Firefox

Damit das erste Beispiel im weltweiten Netz erreichbar ist, muss die Anwendung in die Cloud von Google publiziert werden.

In der Konfigurationsdatei appengine-web.xml unter “war/WEB-INF” die eigene zuvor erstellte Anwendungs-ID (myappid) eintragen.

<?xml version="1.0" encoding="utf-8"?>
<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
  <application>myappid</application>
  <version>1</version>
 
  <!--
    By default, App Engine sends requests serially to a given web server.
    To allow App Engine to send multiple requests in parallel specify:
 
      <threadsafe>true</threadsafe>
  -->
 
  <!-- Configure java.util.logging -->
  <system-properties>
    <property name="java.util.logging.config.file" value="WEB-INF/logging.properties"/>
  </system-properties>
 
</appengine-web-app>

Das Projekt kann über das Kontextmenü “Google / Deploy to App Engine” zur App Engine von Google übertragen werden.

Anschließend kann auf die Anwendung über http://myappid.appspot.com (myappid = zuvor erstellter Application Identifier) wie z.B. http://mgsimon.appspot.com zugegriffen werden.

Fertig … erst einmal. ;)

Weiter …

• Google App Engine Projekt
• Google App Engine Dokumentation
• Google App Engine Javadoc
• Google App Engine Administration
• Programming Google App Engine (Animal Guide)

Wer will noch mal, wer hat noch nicht?

A la “First In – First Out” werde ich die Einladungen versenden.

Hätte da noch 5. :-)