Développement d'une interface SEI (Service Endpoint Interface) à partir de beans enterprise pour les applications JAX-RPC

Vous pouvez développer une interface SEI (Service Endpoint Interface) à partir d'une EJB (Enterprise JavaBeans) pour des services web JAX-RPC.

Avant de commencer

Configurez un environnement de développement pour les services Web. Pour plus d'informations, reportez-vous à la rubrique Définition d'un environnement de développement pour les services Web.

Configurez un environnement de développement pour les services Web.

Cette tâche constitue une étape obligatoire du processus de développement d'un service Web JAX-RPC (Java™ API for XML-based RPC) à partir d'un bean enterprise.

L'interface SEI définit les méthodes des services web. Le bean enterprise qui implémente le service web doit implémenter des méthodes possédant la même signature que les méthodes utilisées dans l'interface SEI. Il existe un certain nombre de restrictions quant aux types pouvant être utilisés comme paramètres et comme résultats des méthodes de l'interface SEI. Ces restrictions sont documentées dans la spécification JAX-RPC (Java API for XML-based remote procedure call). Consultez la documentation sur les spécifications et l'API de services web pour plus d'informations sur la spécification JAX-RPC et pour obtenir une liste complète des spécifications et des normes prises en charge.

Pour créer l'interface SEI d'une implémentation de service web EJB, la méthode la plus simple consiste à utiliser une interface éloignée EJB.

Vous pouvez aussi créer une interface SEI (Service Endpoint Interface) à l'aide des outils d'assemblage.

Pourquoi et quand exécuter cette tâche

Développez une interface SEI en effectuant les opérations décrites dans cette section.

Procédure

  1. Créez une interface Java contenant les méthodes que vous souhaitez inclure à l'interface SEI (Service Endpoint Interface). Si vous commencez par une interface Java existante, supprimez toutes les méthodes non conformes à la spécification JAX-RPC.
  2. Compilez l'interface.

    Lorsque vous exécutez la commande javac, utilisez le nom de la classe de l'interface SEI pour la classe à compiler.

    [Windows]Utilisez les commandes javac.

    [Linux][AIX][HP-UX][Solaris]Sur les systèmes d'exploitation tels que AIX ou Linux, consultez la documentation sur le développement d'applications client légères autonomes.

    [IBM i]Vérifiez que le fichier j2ee.jar se trouve dans le chemin de classe CLASSPATH avant de compiler l'interface. Le fichier JAR est situé dans le chemin du répertoire app_server_root/dev/JavaEE.

Résultats

Vous avez créé une interface SEI (Service Endpoint Interface) vous permettant de développer un service Web.

Exemple

Cet exemple utilise l'interface distante EJB, appelée AddressBook_RI, pour créer une interface SEI pour une implémentation utilisée en tant que service web. L'exemple de code suivant illustre l'interface distante AddressBook_RI.
package addr;
public interface AddressBook_RI extends javax.ejb.EJBObject {
    /**
     * Retrieve an entry from the AddressBook.
     * 
     *@param name the name of the entry to look up.
     *@return the AddressBook entry matching name or null if none.
     *@throws java.rmi.RemoteException if communications failure.
     */
    public addr.Address getAddressFromName(java.lang.String name) 
    	throws java.rmi.RemoteException;
}
Effectuez les opérations suivantes pour créer l'interface SEI avec l'interface distante AddressBook_RI :
  1. Recherchez une interface distante qui a déjà été créée, telle que l'interface distante AddressBook_RI.java.
  2. Effectuez une copie de l'interface éloignée AddressBook.java et utilisez-la comme modèle pour l'interface SEI.
  3. Compilez l'interface SEI AddressBook.java.

Que faire ensuite

Continuez à rassembler les artefacts que vous voulez utiliser pour développer un service Web, y compris le fichier WSDL (Web Services Description Language). Vous devez développer un fichier WSDL car il s'agit du moteur d'un service Web, indispensable à son fonctionnement.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_devejbsei
Nom du fichier : twbs_devejbsei.html