IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)
Développons en Java v 2.20   Copyright (C) 1999-2021 Jean-Michel DOUDOUX.   
[ Précédent ] [ Sommaire ] [ Suivant ] [ Télécharger ]      [ Accueil ] [ Commentez ]


 

63. J2EE / Java EE

 

chapitre 6 3

 

Niveau : niveau 4 Supérieur 

 

J2EE est l'acronyme de Java 2 Entreprise Edition. Cette édition est dédiée à la réalisation d'applications pour entreprises. J2EE est basé sur J2SE (Java 2 Standard Edition) qui contient les API de base de Java. Depuis sa version 5, J2EE est renommée Java EE (Enterprise Edition).

Ce chapitre contient plusieurs sections :

 

63.1. La présentation de J2EE

J2EE est une plate-forme fortement orientée serveur pour le développement et l'exécution d'applications distribuées. Elle est composée de deux parties essentielles :

  • un ensemble de spécifications pour une infrastructure dans laquelle s'exécutent les composants écrits en Java : un tel environnement se nomme serveur d'applications.
  • un ensemble d'API qui peuvent être obtenues et utilisées séparément. Pour être utilisées, certaines nécessitent une implémentation de la part d'un fournisseur tiers.

Sun propose une implémentation minimale des spécifications de J2EE : le J2EE SDK. Cette implémentation permet de développer des applications respectant les spécifications mais n'est pas prévue pour être utilisée dans un environnement de production. Ces spécifications doivent être respectées par les outils développés par des éditeurs tiers.

L'utilisation de J2EE pour développer et exécuter une application offre plusieurs avantages :

  • une architecture d'applications basée sur les composants qui permet un découpage de l'application et donc une séparation des rôles lors du développement
  • la possibilité de s'interfacer avec le système d'information existant grâce à de nombreuses API : JDBC, JNDI, JMS, JCA ...
  • la possibilité de choisir les outils de développement et le ou les serveurs d'applications utilisés qu'ils soient commerciaux ou libres

J2EE permet une grande flexibilité dans le choix de l'architecture de l'application en combinant les différents composants. Ce choix dépend des besoins auxquels doit répondre l'application mais aussi des compétences dans les différentes API de J2EE. L'architecture d'une application se découpe idéalement en au moins trois tiers :

  • la partie cliente : c'est la partie qui permet le dialogue avec l'utilisateur. Elle peut être composée d'une application standalone, d'une application web ou d'applets
  • la partie métier : c'est la partie qui encapsule les traitements (dans des EJB ou des JavaBeans)
  • la partie données : c'est la partie qui stocke les données

 

en construction
La suite de ce chapitre sera développée dans une version future de ce document

 

63.2. Les API de J2EE

J2EE regroupe un ensemble d'API pour le développement d'applications d'entreprise.

API Rôle
version de l'API dans J2EE/Java EE
1.2
1.3
1.4
5
6
7
Entreprise Java Bean (EJB) Composants serveurs contenant la logique métier
1.1
2.0
2.1
3.0
3.1
3.2
Remote Method Invocation (RMI) et RMI-IIOP RMI permet l'utilisation d'objets Java distribués. RMI-IIOP est une extension de RMI pour une utilisation avec CORBA.
1.0
 
 
Java Naming and Directory Interface (JNDI) Accès aux services de nommage et aux annuaires d'entreprises
1.2
1.2
1.2.1
Java Database Connectivity (JDBC) Accès aux bases de données. J2EE intègre une extension de cette API
2.0
2.0
3.0
Java Transaction API (JTA)
Java Transaction Service (JTS)
Support des transactions
1.0
1.0
1.0
1.1
1.1
1.2
Java Message service (JMS) Support de messages avec des MOM (Messages Oriented Middleware)
1.0
1.0
1.1
1.1
1.1
2.0
Servlets Composants basés sur le concept C/S pour ajouter des fonctionnalités à un serveur. Pour le moment, principalement utilisé pour étendre un serveur web
2.2
2.3
2.4
2.5
3.0
3.1
Java Server Pages (JSP)  
1.1
1.2
2.0
2.1
2.2
2.2
Java Server Faces (JSF)        
1.2
2.0
2.2
Expression Language (EL)          
2.2
3.0
Java Server Pages Standard Tag Libray (JSTL)        
1.2
1.2
1.2
JavaMail Envoi et réception d'e-mails
1.1
1.2
1.3
1.4
1.4
1.4
J2EE Connector Architecture (JCA) Connecteurs pour accéder à des ressources du système d'information de l'entreprise telles que CICS, TUXEDO, SAP ...
 
1.0
1.5
1.5
1.6
1.6
Java API for XML Parsing (JAXP) Analyse et exploitation de données au format XML
 
1.1
1.2
Java Authentication and Authorization Service (JAAS) Echange sécurisé de données
 
1.0
 
JavaBeans Activation Framework Utilisé par JavaMail : permet de déterminer le type MIME
 
1.0.2
1.0.2
Java API for XML-based RPC (JAXP-RPC)      
1.1
1.1
1.1
1.1
SOAP with Attachments API for Java (SAAJ)      
1.2
1.3
Java API for XML Registries (JAXR)      
1.0
1.0
1.0
1.0
Java Management Extensions (JMX)      
1.2
Java Authorization Service Provider Contract for Containers (JACC)      
1.0
1.1
1.4
1.4
Java API for XML-Based Web Services (JAX-WS)        
2.0
2.2
2.2
Java Architecture for XML Binding (JAXB)        
2.0
2.2
Streaming API for XML (StAX)        
1.0
Java Persistence API (JPA)        
1.0
2.0
2.1
Java API for RESTful Web Services (JAX-RS)        
1.1
2.0
Web Services        
1.2
1.3
1.3
Web Services Metadata for the Java Platform          
2.1
2.1
Java APIs for XML Messaging (JAXM)          
1.3
Context and Dependency Injection (CDI)          
1.0
1.1
Dependancy Injection (DI)          
1.0
Bean Validation          
1.0
1.1
Managed beans          
1.0
1.0
Interceptors          
1.1
1.1
Common Annotations          
1.1
1.1
Java API for WebSocket
           
1.0
Java API for JSON            
1.0
Concurrency Utilities for Java EE            
1.0
Batch Applications for the Java Platform            
1.0

Ces API peuvent être regroupées en trois grandes catégories :

  • les composants : Servlet, JSP, EJB
  • les services : JDBC, JTA/JTS, JNDI, JCA, JAAS
  • la communication : RMI-IIOP, JMS, Java Mail

 

63.3. L'environnement d'exécution des applications J2EE

J2EE propose des spécifications pour une infrastructure dans laquelle s'exécutent les composants. Ces spécifications décrivent les rôles de chaque élément et précisent un ensemble d'interfaces pour permettre à chacun de ces éléments de communiquer.

Ceci permet de séparer les applications et l'environnement dans lequel elles s'exécutent. Les spécifications précisent à l'aide des API un certain nombre de fonctionnalités que doit implémenter l'environnement d'exécution. Ces fonctionnalités permettent aux développeurs de se concentrer sur la logique métier.

Pour exécuter ces composants de natures différentes, J2EE définit des conteneurs pour chacun d'eux. Il définit pour chaque composant des interfaces qui leur permettront de dialoguer avec les composants lors de leur exécution. Les conteneurs permettent aux applications d'accéder aux ressources et aux services en utilisant les API.

Les appels aux composants se font par des clients en passant par les conteneurs. Les clients n'accèdent pas directement aux composants mais sollicitent le conteneur pour les utiliser.

 

63.3.1. Les conteneurs

Les conteneurs assurent la gestion du cycle de vie des composants qui s'exécutent en eux. Les conteneurs fournissent des services qui peuvent être utilisés par les applications lors de leur exécution.

Il existe plusieurs conteneurs définis par J2EE:

  • conteneur web : pour exécuter les servlets et les JSP
  • conteneur d'EJB : pour exécuter les EJB
  • conteneur client : pour exécuter des applications standalone sur les postes qui utilisent des composants J2EE

Les serveurs d'applications peuvent fournir un conteneur web uniquement (exemple : Tomcat) ou un conteneur d'EJB uniquement (exemple : JBoss, Jonas, ...) ou les deux (exemple : Websphere, Weblogic, ...).

Pour déployer une application dans un conteneur, il faut lui fournir deux éléments :

  • l'application avec tous les composants (classes compilées, ressources ...) regroupés dans une archive ou module. Chaque conteneur possède son propre format d'archive.
  • un fichier descripteur de déploiement contenu dans le module qui précise au conteneur des options pour exécuter l'application

Il existe trois types d'archives :

Archive / module Contenu
Extension
Descripteur de déploiement
bibliothèque Regroupe des classes
jar
 
application client Regroupe les ressources nécessaires à leur exécution (classes, bibliothèques, images, ...)
jar
application-client.jar
web Regroupe les servlets et les JSP ainsi que les ressources nécessaires à leur exécution (classes, bibliothèques de balises, images, ...)
war
web.xml
EJB Regroupe les EJB et leurs composants (classes)
jar
ejb-jar.xml

Une application est un regroupement d'un ou plusieurs modules dans un fichier EAR (Entreprise ARchive). L'application est décrite dans un fichier application.xml lui-même contenu dans le fichier EAR

 

63.3.2. Le conteneur web

Le conteneur web est une implémentation des spécifications servlets et par extension des spécifications des JSP. Ce type de conteneur est composé de deux éléments majeurs : un moteur de servlets (servlet engine) et un moteur de JSP (JSP engine).

Les conteneurs web peuvent généralement utiliser leur propre serveur web et être utilisés en tant que plug-in d'un serveur web dédié (Apache, IIS, ...).

L'implémentation de référence pour ce type de conteneur est le projet open source Tomcat du groupe Apache.

Les API spécifiquement mises en oeuvre dans un conteur web sont détaillées dans les chapitres «Les servlets»" et "JSP".

 

63.3.3. Le conteneur d'EJB

 

Les EJB sont détaillées dans le chapitre «Les EJB (Entreprise Java Bean)».

 

63.3.4. Les services proposés par la plate-forme J2EE

Une plate-forme d'exécution J2EE complète implémentée dans un serveur d'applications propose les services suivants :

  • service de nommage (naming service)
  • service de déploiement (deployment service)
  • service de gestion des transactions (transaction service)
  • service de sécurité (security service)

 

Ces services sont utilisés directement ou indirectement par les conteneurs mais aussi par les composants qui s'exécutent dans les conteneurs grâce à leurs API respectives.

 

63.4. L'assemblage et le déploiement d'applications J2EE

J2EE propose une spécification pour décrire le mode d'assemblage et de déploiement d'une application J2EE.

Une application J2EE peut regrouper différents modules : modules web, modules EJB ... Chacun de ces modules possède son propre mode de packaging. J2EE propose de regrouper ces différents modules dans un module unique sous la forme d'un fichier EAR (Entreprise ARchive).

Le format de cette archive est très semblable à celui des autres archives :

  • un contenu : les différents modules qui composent l'application (module web, EJB, fichier RAR, ...)
  • un fichier descripteur de déploiement

Les serveurs d'applications extraient chaque module du fichier EAR et les déploient séparément un par un.

 

63.4.1. Le contenu et l'organisation d'un fichier EAR

Le fichier EAR est composé au minimum :

  • d'un ou plusieurs modules
  • d'un répertoire META-INF contenant un fichier descripteur de déploiement nommé application.xml

Les modules ne doivent pas obligatoirement être insérés à la racine du fichier EAR : ils peuvent être mis dans un des sous-répertoires pour organiser le contenu de l'application. Il est par exemple pratique de créer un répertoire lib qui contient les fichiers .jar des bibliothèques communes aux différents modules.

 

63.4.2. La création d'un fichier EAR

Pour créer un fichier EAR, il est possible d'utiliser un outil graphique fourni par le vendeur du serveur d'applications ou de créer le fichier manuellement en suivant les étapes indiquées ci-dessous :

  1. créer l'arborescence des répertoires qui vont contenir les modules
  2. insérer dans cette arborescence les différents modules à inclure dans le fichier EAR
  3. créer le répertoire META-INF (en respectant la casse)
  4. créer le fichier application.xml dans ce répertoire
  5. utiliser l'outil jar pour créer le fichier EAR en précisant les options cvf, le nom du fichier ear avec son extension et les différents éléments qui composent le fichier (modules, répertoire dont le répertoire META-INF).

 

63.4.3. Les limitations des fichiers EAR

Actuellement les fichiers EAR ne servent qu'à regrouper différents modules pour former une seule entité. Rien n'est actuellement prévu pour prendre en compte la configuration des objets permettant l'accès aux ressources par l'application telle qu'une base de données (JDBC pour DataSource, pool de connexions ...), un système de messages (JMS), etc ...

Pour pallier une partie de ces limites, les serveurs d'applications commerciaux proposent souvent des mécanismes propriétaires supplémentaires en attendant une évolution des spécifications.

 

63.5. J2EE 1.4 SDK

La version 1.4 de J2EE a été diffusée en novembre 2003.

La grande nouveauté de la version 1.4 est le support des services web. Deux nouvelles API ont été ajoutées pour normaliser le déploiement (J2EE deployment API 1.1) et la gestion des applications (J2EE management API 1.0 qui utilise JMX). Une nouvelle API permet de standardiser l'authentification (Java ACC : Java Authorization Contract for Container). Plusieurs API déjà présentes dans les précédentes versions de J2EE ont été mises à jour (EJB, JSP, Servlet, ...) :

  • J2EE Connector Architecture 1.5
  • Enterprise JavaBeans (EJB) 2.1
  • JavaServer Pages (JSP) 2.0
  • Java Servlet 2.4
  • JavaMail 1.3
  • Java Message Service 1.1
  • Java API for XML parsing (JAXP) 1.2
  • Java API for XML-based RPC (JAX-RPC) 1.1
  • SOAP with Attachments API for Java (SAAJ) 1.2
  • Java API for XML Registries (JAXR) 1.0
  • Java Management Extensions (JMX) 1.2
  • Java Authorization Service Provider Contract for Containers (JACC) 1.0

Le J2EE SDK 1.4 qui est l'implémentation de référence inclus le J2SE SDK 1.4.2 et J2EE 1.4 application server.

 

63.5.1. L'installation de l'implémentation de référence sous Windows

Le J2EE SDK 1.4 peut être installé sur les systèmes Microsoft suivants : Windows 2000 pro avec un service pack SP2, Windows XP Pro avec un service pack SP1 et Windows Server 2003.

Il existe plusieurs packages d'installation : celui utilisé ci-dessous ne contient que le serveur d'applications puisque le J2SE 1.4.2 était déjà présent sur la machine.

Lancer le programme j2eesdk-1_4-dr-windows-eval-app.exe. L'application extrait les fichiers, lance le J2RE et exécute un assistant qui va guider l'installation :

  • la première page est la page d'accueil (welcome) : cliquez sur le bouton « Next »
  • La page suivante permet de lire et d'accepter la licence d'utilisation (software licence agreement) : lire la licence et si vous l'acceptez, cliquez sur le bouton « Yes » puis sur le bouton « Next »
  • la page suivante permet de sélectionner le répertoire d'installation du produit (Select Installation Directory) : sélectionnez le répertoire d'installation et cliquez sur « Next »

    Cliquez sur « Create directory »

  • la page suivante permet de préciser l'emplacement du J2SDK nécessaire au produit (Java 2 SDK Required) : sélectionnez l'emplacement du J2SE SDK (s'il est présent sur la machine, son chemin est proposé par défaut), puis cliquez sur le bouton « Next »
  • la page suivante permet de préciser les informations nécessaires à la configuration du serveur

    Il faut saisir des paramètres de configuration : saisir le mot de passe de l'administrateur et sélectionner l'option pour l'authentification ou non lors d'actions d'administration.

    Il est aussi possible de définir les ports pour le module d'administration et pour les serveurs web HTTP et HTTPS.

    Une fois les informations saisies, cliquez sur le bouton « Next ».

  • La page suivante permet de sélectionner le type d'installation à réaliser (Installation Options) : pour une première installation, il suffit de conserver l'option par défaut proposée puis cliquez sur le bouton « Next »
  • La page suivante synthétise les différentes informations avant l'installation (Ready to Install) : cliquez sur « Install Now »
  • La dernière page indique que l'installation s'est bien terminée et donne quelques informations sommaires sur les différents outils

Il est utile de rajouter le répertoire bin du répertoire d'installation de J2EE SDK 1.4 à la variable PATH du système d'exploitation.

 

63.5.2. Le démarrage et l'arrêt du serveur

Un domaine permet de regrouper des applications qui s'exécutent avec une configuration particulière sur une instance donnée du serveur. Lors de l'installation un domaine par défaut est créé : domain1

Le programme d'installation a créé plusieurs entrées dans le menu « Démarrer/Programmes/Sun Microsystems/J2EE 1.4 SDK/ »

L'option « Start default domain » permet de démarrer le domaine domain1.

Il suffit d'appuyer sur une touche pour fermer la fenêtre.

Pour vérifier la bonne exécution du serveur, il suffit d'appeler l'URL http://localhost:nnnn/ dans un navigateur où nnnn représente le port http précisé dans les paramètres lors de l'installation.

L'arrêt du domaine par défaut peut être obtenu en utilisant l'option « Stop default domain ».

 

63.5.3. L'outil asadmin

J2EE application server est livré avec une application nommée asadmin, utilisable sur une ligne de commandes, pour administrer le serveur.

Cette application utilise deux modes de fonctionnement :

  • la réception de commandes par la console après son lancement
  • le passage des commandes en argument de la commande

Les commandes possèdent des noms bien définis en fonction de leurs actions et nécessitent souvent un ou plusieurs paramètres.

Exemple : démarrage d'un domaine

C:\>asadmin start-domain domain1

Starting Domain domain1, please wait.

Log redirected to C:\Sun\AppServer\domains\domain1\logs\server.log.

Domain domain1 started.

Exemple : arrêt d'un domaine

C:\>asadmin stop-domain domain1

Domain domain1 stopped.

 

63.5.4. Le déploiement d'applications

Pour déployer une application sous la forme d'un fichier war ou ear il suffit de copier le fichier dans le sous-répertoire domains/nom_du_domaine/autodeploy.

Il est nécessaire de s'authentifier auprès du serveur d'applications pour certaines opérations.

 

63.5.5. La console d'administration

La console d'administration est une application web qui permet de configurer le serveur.

Pour l'utiliser, le serveur doit être lancé et il suffit de saisir dans un navigateur l'URL http://localhost:4848/asadmin

 

63.6. La présentation de Java EE 5.0

Le nom de la cinquième version de la plate-forme Java pour Entreprise a été simplifié : au lieu de se nommer J2EE (Java 2 Enterprise Edition) version 1.5, la plate-forme a été renommée Java EE 5 (Java Enterprise Edition).

L'accent est mis dans cette version sur la simplification des développements tout en conservant et en faisant évoluer les fonctionnalités proposées par la plate-forme J2EE.

J2EE est réputée pour sa complexité et pour certaines lourdeurs essentiellement liées aux nombreuses entités à développer (classes, interfaces, fichiers de configuration, ...). La version 5 de la plate-forme repose sur la version 5 de la plate-forme Java Standard Edition et profite donc de ses améliorations notamment les generics et les annotations. L'utilisation intensive de ces dernières dans la version 5 de la plate-forme Java EE permet de simplifier les développements et ainsi de réduire le temps nécessaire à leur réalisation.

L'un des principaux buts de Java EE 5 est de conserver les fonctionnalités et la puissance de la plate-forme tout en simplifiant grandement le code à produire. Cette simplification repose essentiellement sur :

  • L'utilisation intensive des annotations afin de réduire le volume de code et le nombre de fichiers à créer
  • L'utilisation de valeurs et de comportements par défaut
  • Les descripteurs de déploiement ne sont plus nécessaires que pour des besoins très particuliers

La simplification concerne aussi des sujets plus précis tels que l'utilisation des POJO ou l'injection de ressources.

Cette nouvelle version de la plate-forme, spécifiée dans la JSR 244, propose donc d'énormes simplifications dans le code à écrire par les développeurs.

Elle intègre aussi de nouvelles API :

  • Java Server Faces pour le développement d'applications web avec la JSTL et un support pour AJAX
  • Une nouvelle API pour la persistance des données reposant sur les POJO et les annotations : Java Persistence API
  • La version 3.0 des EJB simplifie grandement l'utilisation de cette technologie
  • Le support des dernières versions des API concernant les services web et permettant une mise en oeuvre d'une architecture de type SOA

Elle intègre aussi les dernières versions de la plupart des API qui formaient la version précédente de la plate-forme. Ainsi la version 5 de l'édition Entreprise de Java inclut de nombreuses spécifications :

Technologies pour les services web
Implementing Enterprise Web Services JSR 109
Java API for XML-Based Web Services (JAX-WS) 2.0 JSR 224
Java API for XML-Based RPC (JAX-RPC) 1.1 JSR 101
Java Architecture for XML Binding (JAXB) 2.0 JSR 222
SOAP with Attachments API for Java (SAAJ) JSR 67
Web Service Metadata for the Java Platform JSR 181
Technologies pour les composants
Enterprise JavaBeans 3.0 JSR 220
J2EE Connector Architecture 1.5 JSR 112
Java Servlet 2.5 JSR 154
JavaServer Faces 1.2 JSR 252
JavaServer Pages 2.1 JSR 245
JavaServer Pages Standard Tag Library JSR 52
Technologies de gestion et déploiement
J2EE Management JSR 77
J2EE Application Deployment JSR 88
Java Authorization Contract for Containers JSR 115
Autres technologies
Common Annotations for the Java Platform JSR 250
Java Transaction API (JTA) JSR 907
JavaBeans Activation Framework (JAF) 1.1 JSR 925
JavaMail JSR 919
Streaming API for XML (StAX) 1.0 JSR 173

 

63.6.1. La simplification des développements

La version 5 de la plate-forme Java EE fait un usage important des annotations introduites dans la plate-forme Java SE 5.0. Les annotations sont des métadonnées qui seront utilisées par le conteneur. Le code à écrire est ainsi réduit car certaines entités à définir ou règles à respecter sont simplement remplacées par l'utilisation d'une ou plusieurs annotations.

Historiquement, des tags étaient déjà utilisés notamment par Javadoc.

Une annotation commence par le caractère @ suivi par le nom de l'annotation éventuellement suivi d'une liste, entourée de parenthèses, de paramètres sous la forme de paires clé/valeur.

Les annotations précèdent par convention les modificateurs des entités qu'elles caractérisent. Elles correspondent à des classes particulières.

Les annotations n'ont aucune influence sur la logique des traitements du code mais elles influent sur la façon dont certains outils vont exécuter le code.

Java EE 5 propose des annotations pour de nombreux rôles :

  • définition et utilisation des services web
  • définition des EJB
  • mapping objets / XML
  • mapping objet / relationnel
  • précision sur les informations de déploiement
  • ...

L'utilisation des annotations n'est pas obligatoire : la configuration peut aussi être faite dans un descripteur de déploiement.

Le packaging a aussi été simplifié : il est maintenant possible d'écrire des EJB ou des services web sans devoir écrire de descripteur de déploiement sauf pour des besoins particuliers. La configuration est déduite par le conteneur à partir des annotations.

De nombreux attributs d'annotations possèdent des valeurs par défaut que le développeur pourra utiliser sans avoir à les préciser.

 

63.6.2. La version 3.0 des EJB

La version 3.0 des EJB propose une simplification de leur développement. Le travail des développeurs est réduit au profit d'une augmentation des traitements pris en charge par le conteneur :

  • Le nombre de classes et d'interfaces à écrire est réduit
  • Le descripteur de déploiement est optionnel car il n'est plus utile que pour des besoins spécifiques. Pour cela, la définition des composants utilise les annotations et l'injection de dépendance.
  • Les EJB entités sont plus faciles à développer en faisant usage de la nouvelle API Java Persistence API pour le mapping O/R
  • Les intercepteurs permettent de proposer des traitements avant ou après l'appel de méthodes à l'image de ce que peuvent proposer certaines fonctionnalités de l'AOP

Dans les versions antérieures des spécifications, les interactions entre le bean et le conteneur pour la gestion de son cycle de vie étaient réalisées par les méthodes ejbRemove(), setMessage(), setSessionContext(), ejbActivate() et ejbPassivate() des classes javax.ejb.SessionBean et javax.ejb.MessageDrivenBean. Même inutiles, ces méthodes devaient être écrites.

Dans la version 3.0, il suffit simplement d'utiliser les annotations définies dans les spécifications de Java EE dont voici les principales :

tag Rôle
@Stateless annote une classe qui est un composant de type EJB Session Stateless
@Stateful annote une classe qui est un composant de type EJB Session Stateful
@PostConstruct  
@PreDestroy  
@PostActivate  
@PrePassivate  
@EJB annote un EJB qui sera injecté par le conteneur
@WebServiceRef annote un service web qui sera injecté par le conteneur
@Resource annote une ressource différente d'un EJB ou d'un service web qui sera injectée par le conteneur
@MessageDriven annote une classe qui est un composant de type EJB Message Driven
@TransactionAttribute annote une classe (dans ce cas toutes ses méthodes) ou une méthode pour préciser les attributs d'appartenance à une transaction
@TransactionManagement  
@RolesAllowed, @PermitAll
@DenyAll
annote une méthode pour indiquer ses permissions d'utilisation
@RolesReferenced  
@RunAs  

 

63.6.3. Un accès facilité aux ressources grâce à l'injection de dépendance

Le motif de conception injection de dépendance permet à une entité extérieure à un objet de lui fournir toutes les références sur les objets dont il dépend.

Avec Java EE 5, l'injection de dépendance peut être mise en oeuvre sur plusieurs types de ressources utilisés par un composant :

  • EJB
  • Services web
  • DataSource
  • EntityManager
  • Queue et Topic
  • SessionContext
  • UserTransaction
  • TimerService

Trois annotations permettent de mettre en oeuvre l'injection de dépendance :

  • @EJB : pour les EJB
  • @WebServiceRef : pour les services web
  • @Ressource : pour tous les autres types de ressources supportés

Ces annotations peuvent être utilisées dans tout objet dont le cycle de vie est géré par un conteneur du serveur d'applications (EJB, service web, servlet, bean entité, ...).

L'injection de dépendance peut donc être mise en oeuvre dans les trois conteneurs de la plate-forme : EJB, web et client.

Ceci permet d'éviter l'utilisation directe de l'API JNDI pour obtenir une instance de la ressource stockée dans l'annuaire.

 

63.6.4. JPA : le nouvelle API de persistance

La nouvelle API Java Persistence API, développée sous la JSR 220, est ajoutée à la version 5.0 de la plate-forme Java EE. Cette API peut être utilisée dans les EJB mais aussi dans toutes les autres applications même celles utilisant Java SE. Son utilisation n'est ainsi pas réservée qu'à des développements avec la plate-forme Java EE.

Cette API propose les fonctionnalités suivantes :

  • standardisation du mapping O/R
  • utilisation de POJO
  • mise en oeuvre des opérations de type CRUD au travers de l'objet EntityManager
  • support de l'héritage et du polymorphisme
  • requêtes en EJB Query Langage

Les entités sont de simples POJO enrichis d'annotations dédiées. Ces annotations permettent de préciser comment est réalisé le mapping entre une ou plusieurs tables d'une base de données et l'entité.

Exemple :
package com.jmdoudoux.test.jpa;

import java.io.Serializable;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;

@Entity
public class Personne implements Serializable {
  @Id
  @GeneratedValue
  private int id;

  private String prenom;

  private String nom;

  private static final long serialVersionUID = 1L;

  public Personne() {
    super();
  }

  public int getId() {
    return this.id;
  }

  public void setId(int id) {
    this.id = id;
  }

  public String getPrenom() {
    return this.prenom;
  }

  public void setPrenom(String prenom) {
    this.prenom = prenom;
  }

  public String getNom() {
    return this.nom;
  }

  public void setNom(String nom) {
    this.nom = nom;
  }
}

JPA propose une API pour manipuler ces entités notamment en utilisant un objet de type EntityManager.

Exemple : rechercher et supprimer une occurrence
    private EntityManager em;
...
    Personne personne = em.find(Personne.class, 4);    
    if (personne == null) {
      System.out.println("Personne non trouvée");
    } else {
      em.remove(personne);      
    }

La mise en oeuvre de JPA est détaillée dans le chapitre «JPA (Java Persistence API)»

 

63.6.5. Des services web plus simples à écrire

La simplification de JAVA EE 5 concerne aussi les services web : les services web sont plus simples à développer et le nombre de standards supportés a augmenté. Cette simplification est largement assurée par l'utilisation des annotations et de comportements par défaut.

Exemple :
package com.jmdoudoux.test.jaxws;

import javax.jws.WebService;

@WebService
public class MonService {

  public String saluer(String param) {
    return "Bonjour " + param;
  }
}

Avec Java EE 5, l'utilisation d'annotations a grandement simplifié le développement de services web.

Java EE 5 propose aussi plusieurs API concernant les services web : Java API for XML-Based Web Services (JAX-WS) 2.0 (JSR 224), Java Architecture for XML Binding (JAXB) 2.0 (JSR 222) et Web Services Metadata for the Java Platform (JSR 181).

JAX-WS 2.0 est la nouvelle API pour le développement de services web. Elle succède à JAX-RPC 1.1. Cette nouvelle version propose :

  • l'utilisation des annotations
  • le binding des données grâce à JAXB 2.0
  • le support de SOAP 1.1 et 1.2
  • le support de MTOM/XOP pour l'encodage optimisé des attachments
  • le support des services web de type REST

La définition d'un service web consiste à utiliser l'annotation @WebService sur une classe.

Par défaut, toutes les méthodes publiques sont exposées en tant qu'opérations du service web. L'utilisation des annotations permet de ne pas avoir à définir de fichier de déploiement.

Pour modifier le mapping par défaut, certaines annotations peuvent être utilisées.

Exemple :
package com.jmdoudoux.test.jaxws;

import javax.jws.WebService;
import javax.jws.WebMethod;

@WebService(name="MonServiceWS")
public class MonService {

  @WebMethod(operationName="direBonjour")
  public String saluer(String param) {
    return "Bonjour " + param;
  }
}

Par défaut, le WSDL d'un service web sera généré dynamiquement par le conteneur selon les spécifications de JAX-WS 2.

JAX-WS 2.0 propose aussi une API pour permettre l'appel de services web par un client de façon asynchrone. Cet appel asynchrone peut être utilisé avec n'importe quel service web : l'invocation de services web de façon asynchrone n'implique aucun traitement particulier côté serveur. C'est simplement l'invocation côté client qui est différente.

 

63.6.6. Le développement d'applications Web

Le framework Java Server Faces version 1.2 est inclus dans la plate-forme Java EE 5.

La bibliothèque JavaServer Pages Standard Tag Library (JSTL) est incluse dans la plate-forme Java EE 5. JSTL propose un langage d'expression pour faciliter la manipulation d'entités et un ensemble de tags personnalisés.

Les incompatibilités entre les langages d'expressions de la JSTL et des JSF ont été corrigées, ce qui leur permet d'être utilisés simultanément grâce à UEL (Unified EL).

 

63.6.7. Les autres fonctionnalités

La version 2.0 de JAXB offre un support complet des schémas XML.

L'API Streaming API for XML (StAX) défini une méthode pour parser un document XML à partir d'événements. Son mode de fonctionnement est différent de SAX : avec SAX le développeur écrit du code pour répondre à des événements émis par le parser, avec StAX c'est le programme qui pilote le parser.

Remarque : ces deux API ont été ajoutées à la version 6 de Java SE.

 

63.6.8. L'installation du SDK Java EE 5 sous Windows

Téléchargez le fichier java_ee_sdk-5-windows.exe sur le site de Sun et exécutez le.

Les fichiers d'installation sont extraits puis le programme d'installation est lancé pour guider l'utilisateur avec un assistant :

  • Sur la page « Welcome », cliquez sur le bouton « Next »
  • Sur la page « Software Licence Agreement », lisez la licence et si vous l'acceptez, cliquez sur « Yes » puis sur le bouton « Next »
  • Sur la page « select Installation Directory, modifiez si nécessaire le répertoire d'installation puis cliquez sur le bouton « Next »
  • Sur la page « Admin Configuration », saisissez le mot de passe, sélectionnez la saisie ou non du mot de passe, et modifiez les ports au besoin puis cliquez sur le bouton « Next »

  • Sur la page « Installation options », cochez «Create desktop shortcut to autodeploy directory» et «create windows service» en plus des options déjà cochées, puis cliquez sur le bouton «Next». Le programme d'installation vérifie l'espace disque requis.
  • Sur la page « Ready to Install », cliquez sur le bouton «Install Now».
  • Le programme d'installation copie les fichiers.
  • Sur la page « Installation Complete », cliquez sur le bouton « Start server »

Cliquez sur le bouton «OK» puis sur le bouton  « Finish »

Ouvrez un navigateur sur l'url http://localhost:8082

 

 

63.7. La présentation de Java EE 6

La version 6 de la plate-forme Java EE est diffusée depuis décembre 2009. Elle s'appuie sur la plate-forme Java SE 6 dont elle utilise de nombreuses API (JDBC, JNDI, JAXB, JAXP, RMI, JMX, ...).

Cette nouvelle version de la plate-forme a plusieurs caractéristiques :

  • Plus riche : de nouvelles spécifications sont ajoutées et les spécifications majeures sont enrichies
  • Plus facile : généralisation de l'utilisation des POJO et des annotations notamment dans le tiers web
  • Plus légère : création de la notion de profiles et de pruning, EJB Lite
  • Toujours aussi robuste après 10 ans d'existence

L'implémentation de référence est le projet open source GlassFish version 3.

 

63.7.1. Les spécifications de Java EE 6

C'est la version de la plate-forme avec le plus grand nombre de spécifications. Elle contient 28 spécifications :

Technologies

JSR

Java Platform, Enterprise Edition 6 (Java EE 6) (avec Managed Beans 1.0)

 JSR 316

Technologies relatives aux services web

Java API for RESTful Web Services (JAX-RS) 1.1

 JSR 311

Implementing Enterprise Web Services 1.3

 JSR 109

Java API for XML-Based Web Services (JAX-WS) 2.2

 JSR 224

Java Architecture for XML Binding (JAXB) 2.2

 JSR 222

Web Services Metadata for the Java Platform

 JSR 181

Java API for XML-Based RPC (JAX-RPC) 1.1

 JSR 101

Java APIs for XML Messaging 1.3

 JSR 67

Java API for XML Registries (JAXR) 1.0

 JSR 93

Technologies relatives aux développements web

Java Servlet 3.0

 JSR 315

JavaServer Faces 2.0

 JSR 314

JavaServer Pages 2.2/Expression Language 2.2

 JSR 245

Standard Tag Library for JavaServer Pages (JSTL) 1.2

 JSR 52

Debugging Support for Other Languages 1.0

 JSR 45

Technologies relatives aux développements d'applications

Contexts and Dependency Injection for Java (Web Beans 1.0)

 JSR 299

Dependency Injection for Java 1.0

 JSR 330

Bean Validation 1.0

 JSR 303

EnterpriseJava Beans 3.1 (avec Interceptors 1.1)

 JSR 318

Java EE Connector Architecture 1.6

 JSR 322

Java Persistence 2.0

 JSR 317

Common Annotations for the Java Platform 1.1

 JSR 250

Java Message Service API 1.1

 JSR 914

Java Transaction API (JTA) 1.1

 JSR 907

JavaMail 1.4

 JSR 919

Gestion et sécurité

Java Authentication Service Provider Interface for Containers

 JSR 196

Java Authorization Contract for Containers 1.3

 JSR 115

Java EE Application Deployment 1.2

 JSR 88

J2EE Management 1.1

 JSR 77

 

63.7.2. Une plate-forme plus légère

Une critique récurrente de la plate-forme Java EE est qu'elle est très riche et donc complexe. La plupart des applications de petite taille ou de taille moyenne n'ont pas besoin de toutes les technologies proposées par la plate-forme.

Cette richesse est aussi liée au fait que certaines technologies sont obsolètes car remplacées par une nouvelle technologie : ces anciennes versions sont cependant conservées pour des raisons de compatibilité.

 

63.7.2.1. La notion de profile

Java EE 6 définit la notion de profile qui est un sous-ensemble et/ou un sur-ensemble de Java EE 6 pour des besoins particuliers.

Les profiles sont conçus pour proposer une solution technique particulière pour des besoins spécifiques. Cela permet à un fournisseur de n'avoir à proposer que le support des technologies incluses dans le profile plutôt que d'avoir à implémenter toutes celles de la plate-forme Java EE.

Java EE 6 définit un premier profile : le web profile qui se concentre sur le développement d'applications de type web. Il doit pouvoir être exécuté dans un simple conteneur web car le packaging se fait dans une archive de type war.

Le web profile est composé de plusieurs spécifications pour définir un sous-ensemble de Java EE :

Servlet 3.0

JSP 2.2

EL 1.2

JSTL 1.2

JSF 2.0

EJB Lite 3.1

JTA 1.1

JPA 2.0

Bean Validation 1.0

DI 1.0

CDI 1.0

Interceptors 1.1


D'autres profiles devraient être définis ultérieurement de façon indépendante des évolutions de la plate-forme Java EE.

Un fournisseur n'a plus l'obligation de fournir une implémentation complète de la spécification Java EE mais peut simplement fournir une implémentation d'un profile. Bien sûr dans ce cas, les fonctionnalités utilisables sont uniquement définies dans ce profile.

La notion de profile a fait l'objet de nombreux débats au sein des membres de la JSR notamment sur sa définition, la compatibilité et sur la confusion et les interrogations qu'elle peut susciter chez les développeurs.

 

63.7.2.2. La notion de pruning

La plate-forme Java EE est devenue au fil des versions imposante en terme de nombre de spécifications, de fonctionnalités et d'API. Aucunes des précédentes versions n'a supprimé de fonctionnalités même si certaines sont obsolètes car remplacées, rarement adoptées ou utilisées. Cela pose plusieurs problèmes :

  • Pour le développeur : la taille du SDK augmente avec le nombre d'API
  • Pour les fournisseurs de serveurs d'applications : l'obligation de support pour ces fonctionnalités avec un accroissement de la taille des serveurs, de leur consommation en ressources et de leur temps de démarrage

Certaines de ces fonctionnalités sont de plus obsolètes car remplacées par une plus récente ou ne sont que peu ou pas utilisées.

Java EE 6 entame donc une cure d'amaigrissement de la plate-forme en définissant un ensemble d'API déclarées comme pruned.

Les fonctionnalités déclarées pruned dans Java EE 6 sont :

  • Entity CMP 2.x : cette API est avantageusement remplacée par JPA
  • JAX-RPC : cette API est avantageusement remplacée par JAX-WS
  • JAX-R : cette API est très peu utilisée car l'utilisation de UDDI n'est pas trés répandue
  • JSR 88 (Java EE Application Deployment) : cette API est très peu mise en oeuvre par les fournisseurs de serveurs d'applications

Elles doivent toujours être disponibles dans une implémentation de Java EE 6 mais elles seront certainement amenées à disparaître dans la prochaine version de la plate-forme Java EE et leur support ne sera plus obligatoire dans les implémentations des serveurs d'applications. Le concept de pruned est plus fort que le concept de deprecated de la plate-forme Java SE.

Il est donc raisonnable de ne plus utiliser ces fonctionnalités dans de nouveaux développements et de migrer progressivement les applications existantes qui les utilisent.

Le but est de simplifier le développement des prochaines versions de conteneurs des serveurs d'applications qui n'auront plus l'obligation de fournir une implémentation des fonctionnalités déclarées pruned.

 

63.7.3. Les évolutions dans les spécifications existantes

Plusieurs spécifications existantes dans la version 5 de Java EE 5 ont été mises à jour dans la plate-forme Java EE 6.

 

63.7.3.1. Servlet 3.0

Cette nouvelle version de l'API servlet a pour but de simplifier son utilisation. Comme pour la plupart des API de Java EE, cette simplification repose en grande partie sur l'utilisation d'annotations telles que @WebServlet, @ServletFilter, @WebServletContextListener, @InitParam, @WebFilter, ... pour déclarer des entités ce qui permet de rendre le descripteur de déploiement web.xml plus léger voire optionnel.

Bien qu'une servlet puisse être annotée avec @WebServlet, elle doit toujours hériter de la classe HttpServlet notamment pour permettre d'identifier de façon unique les méthodes à invoquer selon le type de requête http à traiter.

Même si la plupart des développements n'utilise plus directement cette API au profit de frameworks, les développeurs de ces derniers vont pouvoir utiliser les nouvelles fonctionnalités de la spécification.

Le fichier web.xml est rendu modulaire et peut être rédigé sous la forme de fragments qui seront agrégés et fusionnés par le conteneur au moment du déploiement.

Un fragment est une portion du descripteur de déploiement dont le tag racine est <web-fragment> qui peut contenir la définition de tout ou partie des entités configurables dans le descripteur de déploiement.

Ceci pourra ainsi permettre d'éviter d'avoir à déclarer des servlets ou des filtres d'un framework utilisés dans une webapp. Le framework pourra simplement définir le fragment pour que ces déclarations soient prises en compte par le conteneur.

Le conteneur recherche des fragments du fichier web.xml dans le classpath de la webapp (WEB-INF/classes et dans les fichiers jar du répertoire WEB-INF/lib) pour les agréger et composer le fichier web.xml.

Servlet 3.0 propose un support des invocations asynchrones en utilisant l'attribut asyncSupported=True de l'annotation @WebServlet. Une api dédiée est proposée pour gérer l'état d'une requête.

L'interface ServletContext propose des méthodes pour permettre d'enregistrer dynamiquement des servlets, des filtres et des listeners.

L'implémentation de référence est GlassFish v3.

 

63.7.3.2. JSF 2.0

Cette nouvelle version de JSF a pour but de simplifier son utilisation. Comme pour la plupart des API de Java EE, cette simplification repose en grande partie sur l'utilisation d'annotations telles que @ManagedBean, @ManagedProperty, @ApplicationScoped, @SessionScoped, @FacesValidator, @FacesConverter ... qui permettent de rendre le fichier faces-config.xml beaucoup plus petit.

JSF 2.0 utilise le projet open source Facelets comme technologie pour la partie vue : l'organisation du contenu des pages et des composants est facilitée grâce à l'utilisation de Facelets. Le développement de composants a été grandement simplifié grâce à Facelets en utilisant la notion de composition qui met en oeuvre XHTML et un tag JSF.

JSF propose en standard un support de fonctionnalités mettant en oeuvre Ajax sur des fonctions JavaScript standardisées contenues dans le fichier jsf.js que chaque implémentation doit fournir. Le cycle de vie de traitement d'une requête JSF a dû être adapté pour les traitements Ajax en incorporant la notion de page partielle (partial page).

L'implémentation de référence est Mojorra.

 

63.7.3.3. Les EJB 3.1

La version 3.1 des EJB poursuit l'effort de simplification de la version 3.0 tout en apportant de nouvelles fonctionnalités et un enrichissement des fonctionnalités existantes :

  • Les interfaces Local sont optionnelles pour les EJB Session
  • EJB Singleton : le conteneur garantit qu'une seule instance de l'EJB sera accessible par défaut de façon thread-safe. Il est cependant possible d'avoir un contrôle sur la gestion de la concurrence des accès.
  • Les invocations asynchrones des session beans
  • EJB Timer
  • Packaging dans un war qui est utilisé notamment dans le web profile
  • Les noms JNDI portables pour faciliter le déploiement sur plusieurs serveurs d'applications.
  • Le conteneur embarqué pour exécuter des EJB sur la plate-forme Java SE
  • EJB Lite qui est utilisé, en autres, dans le web profile en ne proposant qu'une petite partie des fonctionnalités proposées par les EJB (Session Bean, transactions et sécurité) en occultant notamment les appels distants, les MDB et le scheduling.

L'implémentation de référence est GlassFish v3.

Le chapitre «Les EJB 3.1» contient une description détaillée de cette API.

 

63.7.3.4. JPA 2.0

JPA 2.0 a fait l'objet d'une spécification dédiée.

Les possibilités de mapping sont enrichies avec

  • le support des collections qui ne représentent pas de relations avec des entités grâce à l'annotation @ElementCollection (mappe une collection d'éléments ou une collection de type Map dans une table dédiée)
  • le support des relations unidirectionnelles one-to-many

La version 2.0 de JPA propose de nouvelles fonctionnalités manquantes dans la version précédente :

  • Une gestion plus fine des verrous (locks) notamment avec le support des verrous pessimistes
  • Une API pour coder les critères de recherche de façon dynamique sous la forme d'un graphe d'objets
  • Une API simple pour la gestion du cache

L'implémentation de référence est EclipseLink.

 

63.7.3.5. JAX-WS 2.2

Cette API permet la mise en oeuvre de services web de type Soap. La version 2.2 est incluse dans Java EE 6.

L'implémentation de référence est Metro.

 

63.7.3.6. Interceptors 1.1

Ils peuvent être utilisés sur les EJB et les Managed Beans.

 

63.7.4. Les nouvelles API

De nouvelles API ont été ajoutées à la version 6 de la plate-forme Java EE.

 

63.7.4.1. JAX-RS 1.1

L'API JAX-RS permet de mettre en oeuvre des services web de type RestFul.

L'inclusion de JAX-RS 1.1 dans la plate-forme Java EE suit la tendance à l'adoption grandissante des services web de type REST.

JAX-RS utilise des annotations sur des POJO pour masquer la complexité de traitement des requêtes et de génération des réponses ce qui permet de simplifier leurs mises en oeuvre.

Plusieurs annotations sont définies :

  • @Path permet de déterminer l'URL d'accès à la ressource
  • @GET, @POST, @PUT and @DELETE permet de déterminer la méthode http utilisée pour accéder à la ressource
  • @QueryParam, @PathParam, @CookieParam et @HeaderParam permettent d'extraire les valeurs de la requête http (paramètres, cookies, header)
  • @Produces, @Consumes permet de préciser le format de restitution ou de consommation de la ressource

Cette API repose sur l'utilisation de ces annotations sur un POJO.

La version utilisée dans Java EE 6 est la 1.1.

Exemple :
@Path("/helloworld")
public class HelloWorldRS {
  @GET
  @Produces("text/plain")
  public String saluer() {
    return "Hello World";
  }
}

Cette version permet une utilisation de l'API avec les EJB.

L'implémentation de référence est Jersey.

 

63.7.4.2. Contexte and Dependency Injection (WebBeans) 1.0

Le but de cette spécification est de faciliter les interactions entre la couche de présentation, la couche métier et la couche de persistance notamment à l'aide de beans qui pourront être utilisés par plusieurs couches.

Cette spécification a été influencée par plusieurs projets open source notamment JBoss Seam, Google Guice et Spring.

CDI a pour objectif de fournir une glue entre les couches mettant en oeuvre JSF, EJB et JPA. Elle permet notamment d'enregistrer et de gérer des EJB, des entités JPA et des ManagedBeans sous la forme de composants qui seront injectables et utilisables grâce à EL (Expression Language).

CDI peut remplacer les backing beans de JSF.

La gestion du cycle de vie des composants par CDI se fait par rapport à un contexte (requête, session et application mais aussi deux nouveaux contextes nommés dependent et conversation).

L'implémentation de référence est JBoss Seams.

 

63.7.4.3. Dependency Injection 1.0

Le but de cette JSR est de proposer la standardisation d'un ensemble d'annotations utilisables avec n'importe quel moteur d'injection : le but n'est pas de spécifier un tel moteur.

Elle définit plusieurs annotations :

  • @Inject : identifier un constructeur, une méthode ou un champ injectable
  • @Named : permet de qualifier une dépendance avec une chaîne de caractères
  • @Qualifier : permet de qualifier une dépendance
  • @Scope : permet de définir la portée de l'injection
  • @Singleton : injection d'une instance unique

Google Guice et Spring 3.0 implémentent cette spécification.

 

63.7.4.4. Bean Validation 1.0

Cette API standardise la validation de données.

Les contraintes sont définies dans les beans avec des annotations (@NotNull, @Size, @Past, ...)

Bean Validation propose une API pour valider des données, définir ses propres contraintes et rechercher des contraintes.

Cette API est utilisée notamment par JSF 2.0 et JPA 2.0

L'implémentation de référence est Hibernate Validator 4.0.

Le chapitre «La validation des données» contient une description détaillée de cette API.

 

63.7.4.5. Managed Beans 1.0

C'est un modèle de composants légers : ce sont des POJO gérés par le conteneur.

Les managed beans supportent plusieurs services :

  • Injection de dépendances : @Resource, @Inject
  • Gestion du cycle de vie : @PostConstruct, @PreDestroy
  • Intercepteurs : @Interceptor, @AroundInvoke

Un managed bean est un POJO annoté avec l'annotation @javax.annotation.ManagedBean. Cette annotation est issue de la JSR 250 (Commons annotations).

 

63.8. La présentation de Java EE 7

Les spécifications de Java EE 7 sont définies dans la JSR 342. Cette spécification ne définit pas directement d'API mais elle liste celles qui sont incluses dans la plate-forme et comment celles-ci interagissent entre-elles. Elle définit aussi des éléments précis de la plate-forme comme les transactions, la sécurité, l'assemblage, le déploiement, ...

Java EE 7 a plusieurs objectifs :

  • poursuivre l'amélioration de la productivité et la simplification de l'utilisation de la plate-forme
  • le support de HTML 5 (WebSocket, Json, HTML5 forms, ...)
  • l'ajout de nouvelles fonctionnalités : Batch API (modèle de programmation pour les applications batch) et Concurrency Utilities API (exécution de traitements asynchrones sans avoir à utiliser JMS)

Les spécifications de Java EE 7 furent officiellement diffusées en juin 2013. Java EE 7 s'appuie sur Java SE 7. Cette spécification contient 14 nouvelles JSR et 9 versions de maintenance (Maintenance Release) de JSR.

Java EE 7 inclut plusieurs nouvelles API :

  • Java API for JSON Processing 1.0 (JSR 353)
  • Java API for WebSocket 1.0 (JSR 356)
  • Batch Applications for the Java Platform 1.0 (JSR 352)
  • Concurrency utilities for Java EE 1.0 (JSR 236)

Java EE 7 inclut des API ayant une mise à jour majeure :

  • Java Message Service 2.0 (JSR 343)
  • Expression Language 3.0 (JSR 341)
  • JAX-RS : Java API for Restful Web Services 2.0 (JSR 339)

Java EE 7 inclut des API mises à jour :

  • JPA 2.1 (JSR 338)
  • EJB 3.2 (JSR 345)
  • Servlet 3.1 (JSR 340)
  • Java Server Faces 2.2 (JSR 344)
  • Contexts and Dependency Injection for Java EE 1.1 (JSR 346)
  • Bean Validation 1.1 (JSR 349)
  • Interceptors 1.2 (JSR 318)
  • Java EE Connector Architecture 1.7 (JSR 322)

Les JSR mises à jour (Maintenance Release) sont :

  • Web Services for Java EE 1.4 (JSR 109)
  • Java Authorization Service Provider Contract for Containers 1.5 (JACC 1.5) (JSR 115)
  • Java Authentication Service Provider Interface for Containers 1.1 (JASPIC 1.1) (JSR 196)
  • JavaServer Pages 2.3 (JSR 245)
  • Common Annotations for the Java Platform 1.2 (JSR 250)
  • Java Transaction API 1.2 (JSR 907)
  • JavaMail 1.5 (JSR 919)

Initialement Java EE 7 devait intégrer la spécification Java Temporary Caching API 1.0 (JSR 107) et des fonctionnalités relatives au Cloud (par exemple State Management (JSR 350)) mais elles sont repoussées dans la prochaine version de Java EE.

Java EE 7 poursuit la simplification de l'utilisation de la plate-forme entamée depuis Java EE 5 notamment :

  • la nouvelle version 2.0 de l'API JMS
  • des changements dans la configuration : ressources de type fabrique de connexions par défaut pour la base de données et le broker JMS, amélioration dans la déclaration des permissions de sécurité, ...
  • les technologies déclarées pruned dans Java EE 6 sont optionnelles dans Java EE 7 : EJB Entity Beans, JAX-RPC 1.1, JAXR 1.0 et la JSR-88

JAX-RS 2.0 est ajoutée dans le Web Profile.

L'implémentation de référence est la version 4.0 du serveur d'applications Glassfish.

 

63.8.1. Java API for JSON Processing 1.0 (JSR 353)

La JSR 353 définit les spécifications d'une nouvelle API qui permet de produire et consommer des documents JSON. La version 1.0 ne propose rien concernant le binding entre un document et des objets Java.

Elle propose deux API pour réaliser ces tâches :

  • streaming API qui est une API de bas niveau reposant sur le traitement d'événements émis lors du parcours du document JSON et une API de type fluent pour générer un document
  • model API qui permet d'obtenir ou de créer un graphe d'objets qui encapsule les éléments du document.

Les principales interfaces de l'API Streaming, contenues dans le package javax.json.stream sont :

  • JsonParser : pour le parcours séquentiel d'un document JSON avec l'émission d'événements
  • JsonGenerator : pour la création séquentielle des éléments d'un document JSON

Les principales interfaces de l'API Model, contenues dans le package javax.json sont :

  • JsonBuilder : pour créer des éléments d'un document JSON (objets et tableaux)
  • JsonReader : pour lire un élément d'un document JSON à partir d'un flux
  • JsonWriter : pour écrire un élément d'un document JSON

Pour permettre une utilisation de différentes implémentations, l'API propose des fabriques.

L'utilisation de cette API est détaillée dans le chapitre «JSON-P».

 

63.8.2. Java API for WebSocket 1.0 (JSR 356)

WebSocket est un protocole de communication bi-directionnel en mode full duplex

Les WebSockets sont standardisés par l'IETF sous la RFC 6455

Les WebSockets font parties des spécifications HTML 5 : l'API Javascript définie par le W3C est à l'état Candidat Recommendation

La JSR 356 définit les spécifications de l'API « Java API for WebSocket 1.0 » qui propose une utilisation côté client et serveur.

Elle propose deux modèles de développement :

  • utilisation d'annotations sur des POJO
  • l'utilisation de l'API notamment en implémentant l'interface Endpoint

L'API WebSocket 1.0 définit plusieurs annotations

Annotation

S'applique sur

Rôle

@ServerEndPoint

Classe

Déclarer la classe comme étant un endpoint client de la websocket

@OnOpen

Méthode

Intercepter l'ouverture de la websocket

@OnMessage

Méthode

Intercepter un message de la websocket

@PathParam

Paramètre d'une méthode

Définir un paramètre dont la valeur sera extraite de l'URI

@OnError

Méthode

Intercepter les erreurs durant les échanges

@OnClose

Méthode

Intercepter la fermeture du websocket

@ClientEndPoint

Classe

Déclarer la classe comme étant un client du websocket


Elle consiste essentiellement à réagir à certains événements liés au cycle de vie d'une WebSocket.

La mise en oeuvre repose sur plusieurs concepts :

  • Endpoint : encapsule un endpoint et contient les traitements des différents événements
  • Session : encapsule une conversation
  • MessageHandler : pour traiter un message reçu au format texte ou binaire
  • Encoder/Decoder : pour permettre l'encodage et le décodage d'un objet

L'utilisation de cette API est détaillée dans le chapitre «L'API Websocket».

 

63.8.3. Batch Applications for the Java Platform 1.0 (JSR 352)

La JSR 352 propose une standardisation d'une API pour le développement de traitements de type batch. Aussi appelé traitements par lots, ce type d'applications existe depuis toujours dans l'informatique : elle permet de traiter grâce à différentes étapes de grandes quantités de données avec des algorithmes plus ou moins complexes sans interaction si tout se passe bien.

Les traitements batch ou traitements par lot (batch processing) sont des traitements automatisés sur un ensemble de données. Généralement ces traitements effectuent des opérations complexes ou lourdes sur un volume conséquent de données : leurs temps d'exécution est généralement long, ce qui les empêchent d'être exécutés en temps réels.

Les traitements métier d'un batch sont généralement composés d'une ou plusieurs étapes.

La spécification ne précise rien concernant la planification de l'exécution des batches car différentes solutions existent déjà notamment les EJB Timer dans la plate-forme Java EE.

La JSR 352 est une spécification qui définit un modèle de programmation pour des traitements batch.

Ce modèle repose sur plusieurs concepts :

  • Batch Job : un traitement batch composé d'un ou plusieurs steps exécutés séquentiellement.
  • Step : une étape particulière d'un Job
  • Job Specification Langage : description d'un Job en utilisant XML
  • ItemReader : lecture d'un élément à traiter dans un Step
  • ItemProcessor : traitements à réaliser sur un élément
  • ItemWriter : écriture d'un élément traité dans un Step
  • JobOperator : permet un accès au JobRepository

Lors de l'exécution d'un batch, plusieurs concepts sont utilisés :

  • JobRepository : encapsule les jobs executés et ceux en cours d'exécution. Il contient notamment des instances de type Job, JobExecution et StepExecution
  • JobInstance : encapsule une exécution logique d'un job
  • JobExecution : encapsule le résultat d'une exécution d'un job (réussie ou échouée)
  • JobParameters : encapsule les paramètres fournis à l'exécution d'un job
  • StepExecution : encapsule une tentative d'exécution d'un step

Les classes et interfaces de l'API Batch processing sont contenues dans le package javax.batch.

Un job est un traitement qui peut être composé d'une ou plusieurs étapes (Step).

Un Step peut être de deux types :

  • Chunked qui est orienté traitement d'un élément
  • Batchlet qui est orienté traitement d'une tâche

Un step de type chunked met en oeuvre le modèle de conception lecture/traitement/écriture (read/process/write) d'un élément. Pour cela, trois types de classes sont définies : ItemReader, ItemProcessor et ItemWriter. Chaque élément est lu et traité.

Exemple :
package com.jmdoudoux.test.javaee7.batch;
	  
import java.io.Serializable;
import java.util.Iterator;
import java.util.List;
import javax.batch.api.chunk.AbstractItemReader;
import javax.ejb.EJB;
import javax.inject.Named;

@Named("MonItemReader")
public class MonItemReader extends AbstractItemReader
{
    @EJB
    private ElementBean elementBean;
    Iterator<Element> elementsIterator;
    
    @Override
    public void open(Serializable e) throws Exception {
        List<Element> elements = elementBean.getElements();
        elementsIterator = elements.iterator();
    }

    @Override
    public Object readItem() throws Exception {
        return elementsIterator.hasNext() ? elementsIterator.next() : null;
    } 
}

Exemple :
package com.jmdoudoux.test.javaee7.batch;

import javax.batch.api.chunk.ItemProcessor;
import javax.inject.Named;

@Named("MonItemProcessor")
public class MonItemProcessor implements ItemProcessor {

    @Override
    public Object processItem(Object obj) throws Exception {
        Element element = (Element) obj;
        int valeur = element.getValeur();
        element.setValeur(valeur + 10);
        return element;
    }
}

L'écriture des éléments se fait par paquets : la gestion des checkpoints dans les transactions est configurable dans ce modèle ce qui permet d'avoir des commit à intervalles réguliers.

Un step de type Bachlet ne repose sur aucun modèle prédéfini : les traitements sont invoqués une seule fois dans leur intégralité et se terminent.

Le contrôle des Jobs se fait grâce au JSL (Job Specification Language). Le JSL est un document XML qui permet de décrire les fonctionnalités d'un Job.

Exemple :
<?xml version="1.0" encoding="UTF-8"?>
<job id="monJob" xmlns="http://xmlns.jcp.org/xml/ns/javaee"
version="1.0">
    <step id="traitement">
        <chunk item-count="1">
            <reader ref="MonItemReader"></reader> 
            <processor ref="MonItemProcessor"></processor>
            <writer ref="MonItemWriter"></writer> 
        </chunk>
    </step>
</job>

L'API propose un support de fonctionnalités avancées notamment :

  • les checkpoints : pour permettre la définition de points de reprise qui peuvent permettre de reprendre l'exécution d'un step qui se serait arrêté prématurément. Les checkpoints s'utilisent sur des step de type chunked
  • la gestion des exceptions pour permettre une retentative du step ou de le passer
  • une définition de la séquence de traitements d'un job (décision, transition, fail, end, stop, ...)
  • l'exécution en parallèle d'un même step en partitionnant les données à traiter

 

63.8.4. Concurrency utilities for Java EE (JSR 236)

Il ne faut pas utiliser l'API Concurrency de Java SE dans une application Java EE. Le but de la spécification Concurrency Utilities définit par la JSR 236 est de permettre la mise en oeuvre des traitements concurrents dans un conteneur Java EE. Elle enrichit la JSR 166.

Les spécifications de cette API ont plusieurs objectifs :

  • permettre à des composants Java EE de réaliser des traitements concurrents tout en préservant l'intégrité des containers Java EE dans lequel le composant peut s'exécuter
  • assurer une cohérence entre le modèle de programmation concurrente de Java SE et Java EE (notamment en étant une extension de l'API Concurrent Utilities (JSR 166)

Les classes et interfaces de cette spécifications sont dans le package javax.enterprise.concurrent.

Chaque serveur d'applications Java EE propose une implémentation de l'interface ManagedExecutorService qui hérite de l'interface java.util.concurrent.ExecutorService. Pour obtenir une instance, il faut soit se la faire injecter sous la forme d'une ressource soit l'obtenir grâce à un lookup JNDI (dans ce dernier cas, il est nécessaire de déclarer la ressource dans un descripteur de déploiement).

Exemple ( code Java 7 ) :
@Resource(name="concurrent/monExecutor")
ManagedExecutorService managedExecutor;

Exemple dans le description de déploiement web.xml d'une webapp

Exemple :
<resource-env-ref>
  <resource-env-ref-name>concurrent/monExecutor</resource-env-ref-name>
  <resource-env-ref-type>javax.enterprise.concurrent.ManagedExecutorService
</resource-env-ref-type>
</resource-env-ref>

Il est possible de définir plusieurs ManagedExecutorService avec différentes configurations dans le serveur d'applications, chacun ayant un nom permettant de les identifier, en les associant au sous contexte JNDI java:comp/env/concurrent.

Les traitements qui seront exécutés par le ManagedExecutorService doivent être encapsulés dans une classe qui doit implémenter l'interface java.lang.Runnable ou java.util.concurrent.Callable

Exemple ( code Java 7 ) :
public class MaTache implements Runnable {
  public void run() {
    // Traitements a effectuer
  }
}

Le plus simple pour demander l'exécution d'une tâche est de passer son instance en paramètre de la méthode submit(). Elle renvoie une instance de type java.util.concurrent.Future qui permet de gérer et de déterminer le résultat de manière asynchrone.

La méthode invokeAll() permet de demander l'exécution de plusieurs tâches passées en paramètres sous la forme d'une collection de type List<Callable<T>>.

Exemple ( code Java 7 ) :
package com.jmdoudoux.test.concurrency;
	  
import java.io.IOException;
import java.io.PrintWriter;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;
import java.util.concurrent.Callable;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.Future;
import java.util.logging.Level;
import java.util.logging.Logger;
import javax.annotation.Resource;
import javax.enterprise.concurrent.ManagedExecutorService;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet(name = "MaServlet", urlPatterns = {"/MaServlet"})
public class MaServlet extends HttpServlet {

  @Resource(name = "concurrent/monExecutor")
  ManagedExecutorService mes;
  
  @Override
  protected void doGet(HttpServletRequest request, HttpServletResponse response)
      throws ServletException, IOException {
    
    response.setContentType("text/html;charset=UTF-8");
    try (PrintWriter out = response.getWriter()) {
      out.println("<!DOCTYPE html>");
      out.println("<html>");
      out.println("<head>");
      out.println("<title>Test JSR 236</title>");
      out.println("</head>");
      out.println("<body>");
      out.println("<p>Tache lancée à " + new Date() + "</p>");
      
      MaTache maTache = new MaTache();
      Future maTacheFuture = mes.submit(maTache);
      while (!(maTacheFuture.isDone() || maTacheFuture.isCancelled())) {
        try {
          Thread.sleep(500);
        } catch (InterruptedException ex) {
        }
      }
      
      out.println("<p>Tache terminée à " + new Date() + "</p>");
      out.println("<p>Taches lancées à " + new Date() + "</p>");
      ArrayList<Callable<Date>> taches = new ArrayList<>();
      taches.add(new MaSecondeTache(2000));
      taches.add(new MaSecondeTache(5000));
      
      List<Future<Date>> res = null;
      try {
        res = mes.invokeAll(taches);
        out.println("<p>Tache 1 terminée à " + res.get(0).get() + "</p>");
        out.println("<p>Tache 2 terminée à " + res.get(1).get() + "</p>");
      } catch (InterruptedException | ExecutionException ex) {
        Logger.getLogger(MaServlet.class.getName()).log(Level.SEVERE, null, ex);
      }
      out.println("</body>");
      out.println("</html>");
    }
  }
}

Chaque implémentation du serveur d'applications Java EE propose ses propres possibilités de configuration et les fonctionnalités qui leur sont associées.

L'interface ManagedScheduledExecutorService hérite des interfaces javax.enterprise.concurrent.ManagedExecutorService et java.util.concurrent.ScheduledExecutorService pour permettre de décaler l'exécution de tâches ou permettre leur exécution de manière répétitive selon un certain délai.

Pour soumettre l'exécution d'une tâche, il est possible d'utiliser une des méthodes submit(), invokeXXX() ou scheduleXXX(). Deux surcharges de la méthode schedule() attendent en paramètres un objet de type javax.enterprise.concurrent.Trigger qui permet de définir les conditions de déclenchement de l'exécution.

Exemple ( code Java 7 ) :
   
@Resource(name="concurrent/monScheduledExecutor")
    ManagedScheduledExecutorService executor;
    // ...
    Future future = executor.schedule(new MaTache(), 5, TimeUnit.SECONDS);

Une classe qui implémente une tâche peut optionnellement implémenter l'interface ManagedTask pour permettre de fournir des informations d'exécution et enregistrer un ManagedTaskListener qui recevra et traitera des événements sur le cycle de vie de la tâche.

L'interface ManagedThreadFactory qui hérite de l'interface java.util.concurrent.ThreadFactory définit les fonctionnalités d'une fabrique de threads gérés par le conteneur. Les threads obtenus en invoquant la méthode newThread() doivent implémenter l'interface ManageableThread.

Une instance de type ManagedThreadFactory doit être définie dans le contexte JNDI et une référence vers cette instance doit être déclarée dans le descripteur de déploiement pour permettre un lookup JNDI.

Exemple :
<resource-env-ref>
  <resource-env-ref-name>concurrent/maThreadFactory</resource-env-ref-name>
  <resource-env-ref-type>javax.enterprise.concurrent.ManagedThreadFactory
</resource-env-ref-type>
</resource-env-ref>

Il est aussi possible de demander l'injection de l'instance et de l'utiliser dans le code.

Exemple ( code Java 7 ) :
    @Resource(name = "concurrent/maThreadFactory")
    ManagedThreadFactory threadFactory;
    // ...
    MaTache maTache = new MaTache();
    Thread thread = threadFactory.newThread(maTache);

 

63.8.5. Java Message Service 2.0 (JSR 343)

La précédente version, la 1.1, a été publiée en 2003. Pourtant cette API est largement utilisée.

Les spécifications de la version 2.0 de JMS sont dans la JSR 343.

La version 2.0 de l'API JMS a pour but de simplifier l'utilisation de l'API en réduisant la quantité de code nécessaire à sa mise en oeuvre.

La version 2.0 de JMS définit une nouvelle API et simplifie l'API existante notamment :

  • en réduisant la quantité de code superflu
  • de faciliter l'injection des ressources et ainsi renforcer l'intégration avec CDI
  • en facilitant la gestion des erreurs
  • les principaux objets implémentent l'interface AutoClosable qui permet leur utilisation dans une instruction try avec ressources
  • une utilisation avec Java EE et Java SE
  • les méthodes pour créer une session existent toujours. Une nouvelle méthode pour Java SE attend le mode de session en paramètre. Une nouvelle méthode pour Java EE ne possède aucun paramètre.

Le but de ces évolutions est de maintenir la compatibilité ascendante tout en simplifiant le code à écrire pour utiliser JMS.

L'utilisation de l'API JMS 1.1, pour par exemple envoyer un message, présente plusieurs inconvénients :

  • il est nécessaire de créer plusieurs instances d'objets de types différents (connection, Session, Producer/Consumer, TextMessage)
  • la connexion doit être fermée explicitement, particulièrement si la méthode createSession() de l'interface Connection est utilisée
  • les paramètres de certaines méthodes peuvent être sources d'erreurs
  • les exceptions doivent être gérées puisqu'elles sont de type checked.
Exemple ( code Java 7 ) :
@Resource(lookup = "java:global/jms/mqConnectionFactory")
ConnectionFactory connectionFactory;
@Resource(lookup = "java:global/jms/maQueue")
Queue maQueue;

public void sendMessage(String contenu) {
  try {
    Connection connection = connectionFactory.createConnection();
    try {
      Session session = connection.createSession(false,Session.AUTO_ACKNOWLEDGE);
      MessageProducer messageProducer = session.createProducer(maQueue);
      TextMessage textMessage = session.createTextMessage(contenu);
      messageProducer.send(textMessage);
    } finally {
      connection.close();
    }
  } catch (JMSException ex) {
    // traitement de l'exception
  }
}

Pour conserver la compatibilité, les modifications dans l'API existante ont été limitées.

En plus des méthodes existantes qui sont conservées, la classe javax.jms.Connection possède de nouvelles méthodes :

  • creationSession() essentiellement pour Java EE
  • creationSession(sessionMode) essentiellement pour Java SE

Les principaux objet de JMS (Connection, Session, MessageProducer, MessageConsumer, QueueBrowser) implémentent AutoCloseable pour permettre leur utilisation avec l'instruction try with ressources.

Exemple ( code Java 7 ) :
@Resource(lookup = "jms/mqConnectionFactory")
ConnectionFactory cf; 
@Resource(lookup="jms/maQueue")
Destination dest;

public void sendMessage (String contenu) throws JMSException {
  try ( Connection conn = connectionFactory.createConnection();
    Session session = conn.createSession();
    MessageProducer producer = session.createProducer(dest);){ 
    Message mess = sess.createTextMessage(payload); 
    producer.send(mess); 
  } catch(JMSException e){ 
    // traitement de l'exception
  }
}

Pour faciliter l'utilisation de JMS, la version 2.0 introduit de nouveaux concepts dans une API simplifiée.

Envoi d'un message avec l'API simplifiée de JMS 2.0

Exemple ( code Java 7 ) :
@Resource(lookup = "jms/mqConnectionFactory")
ConnectionFactory connectionFactory; 
@Resource(lookup = "jms/maQueue")
Queue maQueue;

public void sendMessage (String contenu) {
  try (JMSContext context = connectionFactory.createContext();){
    context.createProducer().send(maQueue, contenu);
  } catch (JMSRuntimeException ex) {
    // traitement de l'exception
  }
}

L'interface JMSContext définit les fonctionnalités d'objets qui encapsulent une connexion et une session et ainsi facilite la création d'objets de l'API JMS.

Pour obtenir une instance, il suffit d'invoquer la méthode createContext() de la classe ConnectionFactory ou de demander au conteneur d'en injecter une instance.

L'interface JMSProducer facilite la définition des propriétés et l'envoi de messages en utilisant un JMSContext. Pour en obtenir une instance, il faut invoquer la méthode createProducer().

Les méthodes de ces classes ne lèvent plus d'exceptions de type checked mais des exceptions de type unchecked.

Exemple ( code Java 7 ) :
@Inject
JMSContext context;
@Resource(mappedName="maQueue")
Queue maQueue;

public void sendMessage(String contenu) {
  context.createProducer().send(maQueue, contenu);
}

 

63.8.6. BeanValidation 1.1 (JSR 349)

La JSR 349 spécifie la version 1.1 de l'API BeanValidation qui propose notamment :

  • une meilleure intégration avec les spécifications JAX-RS et JAXB
  • l'application de contraintes sur les paramètres et la valeur de retour d'une méthode
  • une API pour valider les contraintes sur les paramètres et la valeur de retour d'une méthode
Exemple ( code Java 7 ) :
public void MaMethode(@NotNull String contenu) {
  context.createProducer().send(maQueue, contenu);
}

@Future
public Date determinerProchaineEcheance() {
  // ...
}

 

63.8.7. Java API for RESTful Web Services 2.0 (JSR 339)

La JSR 339 définit les spécifications de la version 2.0 de l'API JAX-RS.

La version 2.0 propose notamment :

  • une API client standardisée
  • l'utilisation de l'API Bean Validation pour effectuer des vérifications sur les données obtenues d'une requête HTTP
  • le traitement de requêtes de manière asynchrone côtés serveur et client
  • l'utilisation de filtres grâce aux intercepteurs
  • le support d'Hypermedia qui permet de créer et traiter des liens associés à des ressources

 

63.8.8. Servlets 3.1 (JSR 340)

La JSR 340 définit les spécifications de la version 3.1 de l'API Servlets.

Cette version apporte plusieurs améliorations à l'API :

  • meilleur support des appels IO asynchrones avec NIO en utilisant les listeners ReadListener et WriteListener enregistrés sur les classes ServletInputStream et ServletOutputStream
  • simplification des invocations des servlets de manière asynchrone
  • utilisation de l'API Java EE concurrency
  • sécurité enrichie
  • prise en charge de l'option upgrade du protocole HTTP pour permettre la mise en oeuvre des WebSockets

La prise en charge de l'option upgrade du protocole HTTP se fait grâce à la méthode upgrade() de la classe HttpServletRequest qui attend en paramètre le type d'une classe implémentant l'interface HttpUpgradeHandler.

L'interface HttpUpgradeHandler définit deux méthodes :

Méthode

Rôle

void destroy()

Méthode invoquée lorsque la connexion est fermée

void init(WebConnection wc)

Méthode invoquée lors la connexion est prête à utiliser le nouveau protocole

 

63.8.9. JPA 2.1 (JSR 338)

La version 2.1 de JPA, spécifiée dans la JSR 338, ajoute quelques fonctionnalités manquantes dans les versions précédentes, notamment :

  • le support de l'invocation des procédures stockées en utilisant l'annotation @NamedStoredProcedureQuery et l'interface StoredProcedureQuery
  • la possibilité de faire des mises à jour et des suppressions par lots en utilisant l'API Criteria respectivement avec les interfaces CriteriaUpdate et CriteriaDelete
  • la possibilité de générer le schéma de la base de données en utilisant les métadonnées de mapping et de nouvelles annotations : @Index permet de préciser des index additionnels et @ForeignKey permet de préciser des clés étrangères
  • l'utilisation de fonctions définies par l'utilisateur avec le mot clé FUNCTION en JPQL
  • la définition de convertisseurs en utilisant l'annotation @Converter
  • le support des jointures ouvertes en utilisant le mot clé ON en JPQL
  • les PersistenceContext non synchronisés tant que la méthode joinTransaction() n'est pas invoquée

 

63.8.10. JTA 1.2

La JSR 907 définit les spécifications de la version 1.2 de JTA.

Cette version propose le support de la déclaration de transactions en dehors des EJB grâce à l'utilisation des intercepteurs de CDI.

Cette déclaration se fait en utilisant une nouvelle annotation : javax.transaction.Transactional.

Exemple ( code Java 7 ) :
public class MaClasse {
 
  // ...
  @Transactional
  public void maMethode() {
   
    // ...
  }
  // ...
}

Elle peut avoir en attribut une énumération de type TxType qui par défaut vaut TxType.REQUIRED.

L'énumération TxType définit plusieurs valeurs : REQUIRED, REQUIRED_NEW, MANDATORY, SUPPORTS, NOT_SUPPORTED, NEVER

 


Développons en Java v 2.20   Copyright (C) 1999-2021 Jean-Michel DOUDOUX.   
[ Précédent ] [ Sommaire ] [ Suivant ] [ Télécharger ]      [ Accueil ] [ Commentez ]