TP4 EJB : Utilisation de JMS et de Message Driven Beans

Faisons marcher l'exemple du cours

Repartez du TP2. Dans la liste des EJBs, ajoutez un Message Driven Bean.
Dans la méthode onMessage(), mettez le code de l'exemple du cours. Ce Bean doit ressembler à celui-ci une fois terminé: 

import javax.ejb.MessageDriven;
import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.MessageListener;
import javax.jms.ObjectMessage;
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;

/**
 *
 * @author lm
 */
@MessageDriven(mappedName = "jms/NewMessage", activationConfig =  {
        @ActivationConfigProperty(propertyName = "acknowledgeMode", propertyValue = "Auto-acknowledge"),
        @ActivationConfigProperty(propertyName = "destinationType", propertyValue = "javax.jms.Topic"),
        @ActivationConfigProperty(propertyName = "subscriptionDurability", propertyValue = "Durable"),
        @ActivationConfigProperty(propertyName = "clientId", propertyValue = "NewMessageBean"),
        @ActivationConfigProperty(propertyName = "subscriptionName", propertyValue = "NewMessageBean")
    })
public class NewMessageBean implements MessageListener {
    @PersistenceContext
    private EntityManager em;
    
    public NewMessageBean() {
    }

    
    public void onMessage(Message msg) {
        if(msg instanceof TextMessage) {            TextMessage tm = (TextMessage) msg;
           try {  
              String text = tm.getText();
              System.out.println("Received new message :"  + text);
            } catch (JMSException e) {
              e.printStackTrace();
            }       
        }
    }

    public void persist(Object object) {
        em.persist(object);
    }
    
}

Notez que le nom de la destination est "jms/NewMessage", si vous allez voir dans la console d'administration du serveur d'application, vous trouverez sous jms/resources sa définition. C'est la même chose que pour les sources de données.

Créez une servlet de test pour ce bean

Vous allez ajouter au projet une servlet de test, appelez-la par exemple ServletTestMDB. Cette servlet enverra lors de son invocation un message texte à l'EJB précédente. 

Avec netbeans, faites dans le source de la servlet bouton de droite :

Puis dans le dialogue suivant, indiquez le nom du Message Driven Bean à qui vous voulez envoyer un message :

Etudiez le code généré. Essayez de comprendre ce qu'il fait. En particulier, notez que les lignes :

Correspondent aux 4 premières étapes indiquées en cours, que l'on pourrait écrire (en utilisant explicitement JMS) comme ceci :

// 1 Récupération de la factory JMS InitialContext ctx = new InitialContext(); TopicConnectionFactory factory = (TopicConnectionFactory) ctx.lookup("jms/NewMessageFactory");         // 2 Use connection factory to create a JMS connection TopicConnection connection = factory.createTopicConnection();         //3 Use connection to create a session TopicSession session = connection.createTopicSession(false, Session.AUTO_ACKNOWLEDGE);         //  4 Lookup destination         Topic topic = (Topic) ctx.lookup("jms/NewMessage");

Evidemment, avec les annotations de code c'est plus simple !

Des méthodes utilitaires sont également générées, en particulier la méthode sendJMSMessageToNewMessage qui prend un objet en paramètre (messageData). Regardez ce qu'elle fait... Elle nous mache le travail. Sauf que par défaut elle suppose que le message est un textMessage. Pour la question suivante du TP, vous utilisez un ObjectMessage, il faudra donc légèrement modifier la ligne de création du message.

Regardez également la méthode processRequest. Elle est finalement très concise, pour envoyer un message texte on se contente d'une ligne de code :

Compilez, déployez, testez la servlet de test et vérifiez dans la console du serveur que le message est bien arrivé !

Allez, au boulot ! Faisons une vraie application !

Vous allez maintenant modifier le TP2. Aux fonctionnalités de virement, de création, de modification de solde, vous allez ajouter la notion de "opération bancaire".

Une opération bancaire est une "trace" d'une opération qui a été effectuée sur un compte particulier. Lorsque vous consultez votre compte bancaire sur l'application web de votre banque et que vous examinez les opérations sur un compte, chaque ligne affichée est "opération bancaire".

 En effet, lorsque vous émettez un chèque ou lorsque vous achetez des produits avec votre carte bleue, la banque est contactée et une ligne est ajoutée dans la table des opérations bancaires.

Pour le moment nous n'allons pas utiliser de "relations" au sens des "relations entre tables". On laissera la table des opérations déconnectée de la table des comptes.

 Vous allez juste créer un entity bean OperationBancaire qui permettra d'enregistrer dans une BD des opérations. La table sera créée à partir de la classe du Bean, comme pour le TP 2. Une opération a un numéro (auto-généré), une date, un descriptif (magasin où on a acheté), un type (chèque ou CB ou virement par exemple) et un montant. Le client de ce bean sera un Message Driven Bean.

Sa méthode onMessage() récupère un message de type ObjectMessage qui est en fait une instance d'un objet OperationBancaire et utilise un entity manager pour ajouter les données dans la base. Vous complèterez le bean du TP2 pour qu'il puisse fournir des fonctionalités comme afficher le détail des transactions d'un compte, avec pour paramètre le numéro de compte par exemple. Bien entendu, pour complèter le tableau, vous écrirez les jsps et servlets qu'il manque, clients du Message Driven Bean et du bean gestionnaire de comptes.

Chaque fois qu'une création de compte, qu'un virement, qu'une modification sur un compte est effectuée, on emet un message que le Message Driven Bean traitera (il écrira une ligne de plus dans la table des opérations bancaires).