Développement backend Java : gestion des services API SOAP à l'aide de Java Apache Axis

Développement backend Java : gestion des services API SOAP avec Java Apache Axis

Dans le développement logiciel d'aujourd'hui, les API sont inévitables. L'API fournit une interface pour l'interaction entre différentes applications. Une API est un moyen d'exprimer des interfaces qui permet aux développeurs d'intégrer et d'étendre plus facilement différentes applications et services. SOAP (Simple Object Access Protocol) est un protocole de communication basé sur XML qui permet aux applications d'échanger des informations via le protocole HTTP et prend en charge la communication multilingue et multiplateforme. Apache Axis est un framework Java SOAP développé par la Fondation Apache pour créer et déployer des serveurs et des clients SOAP.

Dans cet article, nous verrons comment effectuer la gestion des API à l'aide du framework Apache Axis. Nous l'expliquerons sous les aspects suivants :

1. Installer Apache Axis
2. Créer un service Web SOAP
3. Gérer le service Web SOAP
4. Appeler le service Web SOAP
5. Installer Apache Axis

Tout d'abord, nous devons installer Apache Axis. Apache Axis propose deux méthodes d'installation :

• Téléchargez et décompressez le binaire Apache Axis
• Dans votre application Java, ajoutez la dépendance Apache Axis à l'aide d'Apache Maven ou Gradle

Si vous choisissez de télécharger et de décompresser Apache Axis, vous pouvez terminer l'installation en suivant les étapes suivantes :

1. Visitez la page de téléchargement d'Apache Axis https://axis.apache.org/axis2/java/core/download.cgi et sélectionnez "Binary Distribution" pour télécharger.
2. Extrayez le fichier zip téléchargé sur votre ordinateur.
3. Paramètre de la variable d'environnement : définissez la variable AXIS2_HOME pour qu'elle pointe vers le dossier dans lequel Axis2 est installé.
4. Création d'un service Web SOAP

Une fois Axis2 installé et configuré, nous pouvons commencer à créer notre API. Les étapes spécifiques sont les suivantes :

• Ouvrez votre IDE Java (tel qu'Eclipse) et créez un nouveau projet Web Java.
• Créez un nouveau package dans le dossier src créé par le projet, en nommant la méthode : com.example.api, puis créez un nouveau fichier de classe Java dans le package et nommez-le CalculatorService.
• Construire une API : créez une API simple dans la classe CalculatorService comme indiqué ci-dessous :

package com.example.api;

public class CalculatorService {
   
    public int add(int x, int y) {
        return x + y;
    }
 
    public int substract(int x, int y) {
        return x - y;
    }
}

3. Gérer le service Web SOAP

Après avoir créé le service Web, nous pouvons effectuer certaines opérations de gestion. Par exemple, nous devons prêter attention au déploiement des API, à la configuration des ports de service, etc. Nous pouvons le configurer dans le fichier services.xml dans le répertoire WEB-INF sous le répertoire racine du projet. Les étapes spécifiques sont les suivantes :

• Créez le fichier central « services.xml » : Créez le fichier services.xml dans le répertoire WEB-INF sous le répertoire racine. Ce fichier indique le nom du fichier de ressources de service que contient l'application à publier.
• Fichier "services.xml" du centre d'édition : configurez les informations du service Web, y compris le nom du service et son interface, son port, etc. Voici un exemple de service :

<serviceGroup>
   <service>
      <parameter name="ServiceClass" locked="false">com.example.api.CalculatorService</parameter>
      <parameter name="ServiceName" locked="false">CalculatorService</parameter>
      <parameter name="XMLValidator" locked="false">org.apache.axis2.jaxws.description.impl.JAXWSAxisServiceBuilder</parameter>
      <operation>
         <parameter name="addOperation" locked="false">
            <messageReceiver class="org.apache.axis2.jaxws.server.JAXWSMessageReceiver" />
         </parameter>
         <parameter name="subOperation" locked="false">
            <messageReceiver class="org.apache.axis2.jaxws.server.JAXWSMessageReceiver" />
         </parameter>
      </operation>
      <module ref="soapmonitor" />
   </service>
</serviceGroup>

4. Call SOAP Web Service

Enfin, nous pouvons appeler notre API via le programme client. Ce qui suit est un simple programme client Java qui appelle la méthode Add dans l'interface CalculatorService.

import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;
import org.apache.axis2.transport.http.HTTPConstants;
import javax.xml.namespace.QName;
 
public class JavaWebServiceClient {
 
 public static void main(String[] args) {
     
     try {
         
         EndpointReference epr = new EndpointReference("http://localhost:8080/axis2/services/CalculatorService");
         
         RPCServiceClient serviceClient = new RPCServiceClient();
         Options options = serviceClient.getOptions();
         options.setProperty(HTTPConstants.CHUNKED, "false");
         
         QName name = new QName("http://api.example.com", "add"); 
         Object[] params = new Object[] {21, 45};
         Class[] paramTypes = new Class[] { Integer.class, Integer.class };
         
         Object[] response = serviceClient.invokeBlocking(name, params, paramTypes);
         
         if (response.length > 0 && response[0] != null) {
             System.out.println("Result: " + response[0]);
         }
         
     } catch (AxisFault axisFault) {
         axisFault.printStackTrace();
     }
 }
}

Cet article fournit des connaissances de base sur le développement de services Web SOAP à l'aide du framework Java Apache Axis et vous explique comment créer, déployer et appeler un service Web SOAP simple. Les services Web SOAP jouent un rôle important dans la création d'applications d'entreprise basées sur des API. En utilisant le framework Apache Axis, vous pouvez développer rapidement et facilement des applications de services Web SOAP efficaces.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!