LEQUERTIER Margaux DESSENNE Nicolas M2 MIAGE IPI-NT DÉMARRER AVEC APACHE TOMEE
Introduction
En java EE, on utilise des serveurs d’applications pour déployer les applications WAR et pour server de conteneurs à tous les traitements réalisés.
Problème ?
Ils sont volumineux et consomment beaucoup de ressources serveurs.
Objectif
1- Réaliser un serveur d’applications léger certifié Java EE
2- Pouvoir transférer les applications de TomEE ou vers TomEE sans difficultés.
Une technologie simpliciée avec plus des options de TomCAT
TomeEE
Tomcat + Java EE = TomEE
Apache Tomcat : Serveur HTTP et conteneur Servlet penant en charge Java Servlet et Java Server Pages (JSP).
Java EE 7 Web Profile : C’est un profile de Java Platform, Entreprise Edition spécifié aux web applications.
Composants
WebSocket JSR 356 JSON-P 353 Servlet 3.1 JSR 340 JSF 2.2 JSR 344 – Java ServerFaces JSP 2.3 JSP 245 – Java ServerPages JSTL 1.2 JSR 52 Jbatch (plus) JSR 352 CDI 1.2 – Java Contexts and Dependency Injection
1 LEQUERTIER Margaux DESSENNE Nicolas M2 MIAGE IPI-NT
Bean validation 1.1 JSR 349 EJB 3.2 JSR 345 – Apache OpenEJB Java EE Connector JSR 322 JPA 2.1 JSR 338 – Java Persistence API JTA 1.2 JSR 907 – Java Transaction API JavaMail 1.4 (mais EE 7 exige 1.5)
Catalina C’est le composant le plus important de TomEE. Lorsqu’on démarre TomEE, on lance Catalina. Le comportement par défaut de Catalina peut être directement configuré en éditant les 6 fichiers dans CATALINA_BASE / conf catalina.policy: contient la stratégie de sécurité catalina.properties: contient les propriétés Java standard pour la classe Catalina logging.properties: configuration des fonctions de journalisation ( logs) de Catalina server.xml: configuration principale de TomEE tomcat-users.xml: informations des utilisateurs web.xml: configuration des options pour des applications Web
Fonctionnement général
2 LEQUERTIER Margaux DESSENNE Nicolas M2 MIAGE IPI-NT
Structure du répertoire bin : fichiers liés à l'exécutable et au boot - démarrage conf : dossier contenant la configuration de TomEE lib : dossier contenant des binaires TomEE logs : emplacement par défaut des fichiers log temp : dossier où est dirigé le répertoire temporaire Java webapps : dossier contenant les applications Web work : dossier dans lequel Tomcat et TomEE peuvent fonctionner
Avantages
- JNDI (Java Naming Directory Interface): un module d’annuaire enregistre toutes les ressources du serveur - Gère des EJB (Entreprise Java Beans) - Gère des applications web, et répond aux requêtes HTTP - Capable de se connecter à des bases de données - Gère des files d’attentes de messages, et les redistribus à des abonnés (Java Messaging System) - Peut se connecter à un service de messagerie (mail), et d’exposer ce service dans son annuaire - Gère la journalisation de tous ces éléments, de même que le suivi des performances, et différentes fonctions de monitoring. - Capable de faire dialoguer ses composants les uns avec les autes sous forme d’injection de dépendances
3 LEQUERTIER Margaux DESSENNE Nicolas M2 MIAGE IPI-NT
Installation et configuration (Sous UNIX)
- Télécharger le tar.gz d’Apache Tomee Plume (ici 7.1.0) sur le site officiel http://tomee.apache.org/download-ng.html
- La version Plume contient toutes les composantes d’Apache Tomee
- Décomprésser le tar.gz
- Se placer dans le répertoire conf
- Modifier le fichier server.xml pour définir le connecteur
- Modifier le fichier tomcat-users.xml pour définir les utilisateurs TomEE permettant d’avoir accès aux différentes composantes de TomEE (les users ayant accès au GUI par exemple).
4 LEQUERTIER Margaux DESSENNE Nicolas M2 MIAGE IPI-NT
Installation et configuration (Sous Eclipse)
Sous Eclipse, vous pouvez ajouter un serveur via l’onglet ‘Servers’ Cliquer sur ‘Créer un nouveau serveur’.
5 LEQUERTIER Margaux DESSENNE Nicolas M2 MIAGE IPI-NT
- Sélectionner ‘Tomcat v8.5 Server’
- Laisser ‘localhost’ pour le nom du serveur.
- Suivant.
- Dans l’encart ‘Tomcat installation directory’ sélectionné le dossier de votre TomEE. - Suivant.
6 LEQUERTIER Margaux DESSENNE Nicolas M2 MIAGE IPI-NT
- Ajouter à votre serveur les projets web que vous souhaitez déployer dessus. - Suivant.
Votre serveur va maintenant apparaître dans l’onglet ‘Servers’ où vous pourrez le démarrer, le debugguer, l’arrêter, le modifier.
7 LEQUERTIER Margaux DESSENNE Nicolas M2 MIAGE IPI-NT
Démarrer / Arrêter
Se placer dans le répertoire bin se trouvant dans le dossier de votre TomEE
Exécuter le script de démarrage ./startup.sh
Arrêter le serveur avec ./shutdown.sh
8 LEQUERTIER Margaux DESSENNE Nicolas M2 MIAGE IPI-NT
Déployer / Supprimer une application
- Vous pouvez ajouter une application dans votre serveur juste en copiant le fichier .war de cette application vers ‘votreapache/webapps’. Pas necessaire que TomEE soit en cours d’execution. TomEE va détecter le nouveau fichier après quelques secondes, déploiera et lancera l’application qui sera disponible à http://localhost:8080/myapp. Aussi si on remplace un fichier existant, TomEE redéploiera l’application. Évidemment, si vous venez à supprimer ce fichier, il sera aussi supprimé du serveur.
- Sur Eclipse, clique droit sur votre serveur, et sélectionner ‘Add & Remove’.
- Aller sur l’URL localhost:8080
- Cliquer sur le bouton ‘Manager App’ et rentrer les identifiants que vous avez spécifié dans le fichier tomcat-users.xml.
- Vous allez directement voir la partie ‘Applications’ avec par exemple les applications que vous avez déployé manuellement.
9 LEQUERTIER Margaux DESSENNE Nicolas M2 MIAGE IPI-NT
- Dans la partie ‘Deploy’, vous pouvez déployer une application sois en spécifiant le dossier cible ou le fichier .war, sois en sélectionnant un fichier via l’explorateur de fichiers.
- Cliquer sur ‘Deploy’, l’application sera ajouté dans la partie ‘Applications’.
- Dans la partie ‘Applications’ vous pouvez lancer, stopper, rafraîchir, supprimer votre application web.
10 LEQUERTIER Margaux DESSENNE Nicolas M2 MIAGE IPI-NT
Changer l’URL d’une application
- Vous pouvez changer l’url d’une application sois en modifiant le nom du fichier .war déployé dans le dossier apache/webapps .
- Vous pouvez changer l’url au moment du déploiement dans la partie ‘Deploy’ en choisissant dans l’encart ‘Context Path (required)’ votre url. (exemple : /ceciestmonurl ).
Connexion à la base de données
Modifier le fichier tomee.xml dans le répertoire conf
Administration Le serveur Apache TomEE s’administre via le Manager GUI disponible via l’url de déploiement du serveur (exemple : localhost:8080). On peut administrer aussi certains aspect du serveur en manipulant les fichiers du serveurs, soit directement en console ou via l’explorateur de fichier.
11 LEQUERTIER Margaux DESSENNE Nicolas M2 MIAGE IPI-NT
Documentation
- Documentation : http://localhost:8080/docs/
- Configuration : http://localhost:8080/docs/config/
- Wiki : https://wiki.apache.org/tomcat/FrontPage
Licence
Licensed under the Apache License, Version 2.0. Apache TomEE, TomEE, Apache, the Apache feather logo, and the Apache TomEE project logo are trademarks of The Apache Software Foundation.
12