samedi 1 janvier 2011

01 - Google AppEngine - first steps

Première étape dans la réalisation du projet "clojadventure".

Objectif : mettre en ligne une application très simple en utilisant GAE (Google App Engine).

Spécifications :
- afficher "HelloWorld" sur la page d'accès

Prérequis :
- avoir un compte google actif.

Actions :


1- Téléchargement du SDK (appengine-java-sdk-1.4.0.zip) pour Java à l'adresse suivante :



2- Installation du SDK sous windows 7.

- cf http://code.google.com/intl/fr-FR/appengine/docs/java/gettingstarted/installing.html
- s'assurer que le java sdk est correctement installer par la commande "java -version" qui doit retourner "1.6.xx"
- dezip du fichier sous d:\outils



3- Test de l'appli demo de guestbook en local

lancement du serveur de développement

test du serveur en local

4- Téléchargement/installation de Ant : http://ant.apache.org/bindownload.cgi


5- création des fichiers. MyServlet.java, web.xml, appengine-web.xml et build.xml sont situés dans l'arborescence suivante :

test-helloworld-java\
  build.xml
  src\
    test\
      java\
        helloworld\
          MyServlet.java
  war\
  WEB-INF\
    appengine-web.xml
    web.xml

MyServlet.java, web.xml, appengine-web.xml

build.xml

Nous pouvons maintenant lancer le serveur à l'aide de la commande : 'ant runserver' en ligne de commande :




Notez l'utilisation de la macro "dev_appserver2" à la place de la macro google "dev_appserver". En effet, lors de l'arrêt du server par Ctrl-C, le serveur ne s'arrête pas ! il y a toujours un process java qui tourne. Je vous envoie donc au bug 2093 pour récupérer le code de la macro à insérer dans le fichier "config/user/ant-macros.xml"

6- Mettre en ligne cette appli démo.

  1. inscrire l'application à partir de https://appengine.google.com/
  2. mise à jour du fichier appengine-web.xml avec l'ID de l'application
  3. upload de l'application à l'aide la commande "?\appengine-java-sdk\bin\appcfg.cmd update war"
  4. vérifier que la version en ligne est correcte (ne pas oublier /test1) : 


7- Tuning. Il manque une page d'accueil pour naviguer sur le site et un fichier "favicon.ico" recherché par GAE comme indiqué sur les accès log :



On va donc créer la page d'accueil par défaut (index.html). Cette page listera les liens vers les différents tests. Nous allons créer/récupérer un fichier "favicon.ico". Nous positionnerons ces fichiers dans le nouveau répertoire "html" :

test-helloworld-java\
  html\
    index.html
    favicon.ico


Il ne reste plus qu'à intégrer ces nouveaux fichiers sources dans le war en créant une nouvelle target "copyhtml" dans le build.xml :


Nous n'avons plus qu'à vérifier que le fichier icône et la nouvelle page d'accueil soient accessibles :



 Voilà !




Aucun commentaire:

Enregistrer un commentaire