Skip to content

Servlets

Introduction

Ewt est une application Web qui se présente sous la forme d'une archive WAR contenant les éléments de configuration et les dépendances de base. En particulier, l'archive intègre un fichier de description de la web application (web.xml) dans lequel sont prédéfinis un certain nombre d'éléments. Le fichier est structuré en 7 parties:

  1. les paramètres d'initialisation de contexte
  2. l'énumération des servlets
  3. le mapping des servlets vers des url
  4. les paramètres de configuration des durées de vies des sessions
  5. les contraintes de sécurité
  6. les configurations de login
  7. l'énumération des rôles techniques

Dans ce document, nous nous limitons aux parties 1 et 3.

Paramètres d'initialisation

Le fichier de base ne contient qu'un seul paramètre de contexte qui permet à Ewt de connaître le chemin dans lequel se trouvent les applications métier à gérer. Dans la configuration de base, la valeur du paramètre est une référence à la variable d'environnement EWT_APPLICATION_ROOT_PATH. Cela évite d'avoir "en dur" un chemin absolu dans la configuration, mais implique que le serveur sur lequel Ewt est démarré définisse la variable d'environnement EWT_APPLICATION_ROOT_PATH avec le chemin des applications. À noter que la référence à cette variable peut être remplacée par une valeur personnalisée, par exemple:

1
2
3
4
<context-param>
  <param-name>application-root-path</param-name>
  <param-value>/opt/ewt/</param-value>
</context-param>

Endpoints

La 2e partie du fichier web.xml déclare les servlets mis à disposition par le moteur et la 3e partie décrit les mapping de ces servlets vers des endpoints.

Le moteur intègre 5 endpoints:

  • web : prend en charge les formulaires HTTP
  • rest : prend en charge les requêtes REST
  • soap : prend en charge les requêtes SOAP
  • data : fournit des méthodes de lecture/écriture de données de dossier
  • websocket: prend en charge les WebSockets