Remoting avec Hessian

Date de publication : 10 Juin 2008

Par Jawher Moussa (Accueil)
 

I. Introduction

Mais dans le cadre de cet article, je vais présenter une autre solution moins connue qui est basée sur les protocoles  Hessian et Burlap de Caucho.

II. Architecture

• Une partie commune (remoting-commons) qui définit les objets de communication partagés entre le client et le serveur ainsi que les contrats des services (sous forme d'interfaces Java)
• Une partie pour l'implémentation des services (remoting-impl) qui dépend de la partie commune et implémente ses différentes interfaces.
• La partie serveur (remoting-server) qui est une application web et qui dépend de remoting-commons et de remoting-impl qui ne fait qu'exposer les services pour le remoting
• La partie client (remoting-client)qui dépend uniquement de remoting-commons.

• Le client n'a aucun accès physique à l'implémentation des services, seulement à leur contrats (interfaces) ce qui permet de garder le client léger et de changer facilement d'implémentations sans le casser.
• Seul le serveur de remoting et le client dépendent de Hessian. La partie commune (définitions des objets de communication et des contrats) ainsi que l'implémentation des services sont en vanilla-Java, et peuvent ainsi être facilement réutilisées dans d'autres projets n'impliquant pas Hessian.

III. Développement de la partie commune

Diagramme UML des objets de transfert

public interface IGenericDao<T extends Pao> {

    List<T> select();

    T findById(Long id);

    void insert(T t);

    void update(T t);

    void delete(T t);

}

IV. Implémentation des services

V. Remoting avec Hessian

V-A. Développement du serveur

<servlet>
    <servlet-name>PersonDao</servlet-name>
    <servlet-class>
    com.caucho.hessian.server.HessianServlet
    </servlet-class>
    <init-param>
        <param-name>home-class</param-name>
        <param-value>djo.remoting.hessian.service.impl.PersonDao</param-value>
    </init-param>
    <init-param>
        <param-name>home-api</param-name>
        <param-value>djo.remoting.hessian.service.IGenericDao</param-value>
    </init-param>
    <load-on-startup>0</load-on-startup>
</servlet>

<servlet-mapping>
    <servlet-name>PersonDao</servlet-name>
    <url-pattern>/PersonDao</url-pattern>
</servlet-mapping>

V-B. Développement du client

• Création d'une fabrique Hessian
• Récupération d'un proxy représentant l'implémentation du service depuis la fabrique en précisant l'url de la servlet qui l'expose.
• Utiliser le proxy comme étant une classe ordinaire en invoquant ses méthodes.

HessianProxyFactory factory = new HessianProxyFactory();

IGenericDao<Person> personDao = (IGenericDao<Person>) factory
        .create("http://localhost:8080/remoting-server/PersonDao");

La méthode create de HessianProxyFactory peut lancer deux exceptions de type checked ( MalformedURLException, ClassNotFoundException) que l'on doit traiter.

Person person = new Person();
person.setName("djo");
person.setAge(25);
Address address = new Address();
address.setStreet("Some Street");
address.setNumber(17);
address.setCountry("Wonderland");
person.setAddress(address);
personDao.insert(person);
System.out.println(personDao.select());

VI. Remoting avec Burlap

VI-A. Développement du serveur

package djo.remoting.server.burlap;

public class BurlapPersonDao extends BurlapServlet {
    private PersonDao personDao = new PersonDao();
    
    @Override
    public void delete(Person t) {
        personDao.delete(t);
    }

    @Override
    public Person findById(Long id) {
        return personDao.findById(id);
    }

    @Override
    public void insert(Person t) {
        personDao.insert(t);
    }

    @Override
    public List<Person> select() {
        return personDao.select();
    }

    @Override
    public void update(Person t) {
        personDao.update(t);
    }
}

<servlet>
    <servlet-name>BPersonDao</servlet-name>
    <servlet-class>djo.remoting.server.burlap.BurlapPersonDao</servlet-class>
    <load-on-startup>0</load-on-startup>
</servlet>

<servlet-mapping>
    <servlet-name>BPersonDao</servlet-name>
    <url-pattern>/BPersonDao</url-pattern>
</servlet-mapping>

VI-B. Développement du client

BurlapProxyFactory factory = new BurlapProxyFactory();

BurlapPersonDao personDao = (IGenericDao<Person>) factory
        .create("http://localhost:8080/remoting-server/BPersonDao");

La méthode create de BurlapProxyFactory peut lancer deux exceptions de type checked (MalformedURLException, ClassNotFoundException) que l'on doit traiter.

Person person = new Person();
person.setName("djo");
person.setAge(25);
Address address = new Address();
address.setStreet("Some Street");
address.setNumber(17);
address.setCountry("Wonderland");
person.setAddress(address);
personDao.insert(person);
System.out.println(personDao.select());

VII. Support Spring

VIII. Télécharger

Le code source de cette application ainsi que toutes ses dépendances sont disponibles en téléchargement dans l'archive suivante :
  remoting-hessian.zip

• ant : contient les jars d'Apache Ant 1.7.0. Ils ne sont pas utilisés par l'application mais servent uniquement au build.
• dossier lib : contient toutes les dépendances de l'application (hessian-3.1.5.jar).
• dossier remoting-client : contient les sources Java de l'application client.
• dossier remoting-commons : contient les sources Java des objets de transfert et des contrats des services.
• dossier remoting-impl : contient l'implémentation des contrats des services.
• dossier remoting-server : contient les sources de l'application serveur.
• fichier build.xml : fichier de build ant
• fichier build.bat : permet de lancer le build sous Windows.
• fichier build.sh : permet de lancer le build sous Linux.

Assurez vous avant qu'une version JDK 5 ou antérieure est installée et que la variable d'environnement JAVA_HOME soit bien définie et qu'elle pointe vers le JDK installé.

Il se peut que vous ayez à ajouter le droit x (exécution) à build.sh sous Linux pour pouvoir l'exécuter.

IX. Conclusion