Premiers pas pour diffuser du contenu statique

Apprenez à diffuser du contenu statique en toute sécurité, tel que des fichiers HTML, des feuilles de style CSS et des images à partir de l'environnement standard Google App Engine.

Avant de commencer

  1. Configurez votre environnement de développement et créez un projet App Engine.

  2. Si vous utilisez un nom de domaine personnalisé pour votre site Web, suivez les instructions pour ajouter un domaine personnalisé à votre projet.

Diffuser une page Web

App Engine peut diffuser du contenu statique comme les pages HTML et du contenu multimédia tel que les images. Le contenu statique est tout ce qui n'est pas exécuté en tant que fichier JSP ou servlet.

L'exemple suivant est une page HTML de base qui affiche un message de bienvenue.

<!DOCTYPE html>
<html>
  <head>
    <title>The App Engine Blog</title>
  </head>
  <body>
    <h1>Welcome to the App Engine Blog</h1>
    <p>This is being served by App Engine!</p>
  </body>
</html>

Où placer les fichiers statiques

Vous devez placer vos fichiers statiques diffusés dans le répertoire webapp de votre application. Vous pouvez utiliser des dossiers, mais souvenez-vous que tous les chemins d'accès aux fichiers et tous les URI sont relatifs au répertoire webapp.

Après avoir choisi un emplacement pour les fichiers statiques, vous devez définir leur emplacement dans le fichier appengine-web.xml, à l'aide de l'élément <static-files>.

Dans l'exemple ci-dessous, une configuration appengine-web.xml de base traite tous les fichiers HTML du répertoire webapp comme des fichiers statiques.

<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
  <threadsafe>true</threadsafe>
  <runtime>java8</runtime>
  <static-files>
    <include path="/**.html" >
    </include>
  </static-files>
</appengine-web-app>

Vous pouvez avoir plusieurs éléments <include path> faisant référence à différents répertoires et différents types de fichiers. Développons l'exemple précédent :

<static-files>
  <include path="/**.html" >
  </include>
  <include path="/images/**.jpg" >
  </include>
</static-files>

Désormais, tous les fichiers portant l'extension .jpg dans le répertoire webapp/images/ seront traités comme des fichiers statiques.

Dans l'exemple ci-dessus, si nous avions voulu afficher le fichier logo.jpg à partir du répertoire webapp/images, la balise <img> aurait <img src="/images/logo.jpg"> comme URI source.

Forcer HTTPS pour tous les contenus statiques

Bien que la diffusion de contenu via HTTP ou HTTPS soit possible avec App Engine, vous devez utiliser HTTPS. Pour configurer des URL sécurisées, vous devez ajouter un élément <security-constraint> au fichier web.xml de votre projet. Un exemple d'élément <security-constraint> vous est présenté ci-dessous :

<security-constraint>
    <web-resource-collection>
        <web-resource-name>blog</web-resource-name>
        <url-pattern>/*</url-pattern>
    </web-resource-collection>
    <user-data-constraint>
        <transport-guarantee>CONFIDENTIAL</transport-guarantee>
    </user-data-constraint>
</security-constraint>

Si vous utilisez l'élément <transport-guarantee>CONFIDENTIAL</transport-guarantee>, toutes les requêtes se trouvent automatiquement redirigées vers l'URI HTTPS du contenu statique.

Déployer l'application sur App Engine

Vous pouvez déployer votre application sur App Engine à l'aide de Maven.

Accédez au répertoire racine de votre projet, puis saisissez la commande suivante :

mvn appengine:deploy

Lorsque Maven a déployé votre application, saisissez la commande ci-dessous pour ouvrir un onglet de navigateur Web automatiquement dans votre nouvelle application :

gcloud app browse

Étape suivante

Les fichiers statiques peuvent servir à diffuser des images, des feuilles de style CSS et du contenu HTML statique via App Engine. Pour approfondir vos connaissances, vous pouvez consulter la page sur la gestion des données utilisateur via des formulaires HTML.