APIService_XML_JSON_JAVA_Servlet

Apirservice_xml_json_java_servlet

Implémentation d'un service API à interroger sur les données utilisateur qui est stockée dans un fichier XML et mappée sur la méthode APIServlet Get et renvoyant un tableau JSON

API

L'interface de programmation d'application ou l'API est un intermédiaire logiciel qui permet à deux applications de se parler. Lorsque vous utilisez une application sur votre téléphone mobile, c'est ce qui se passe:

• L'application se connecte à Internet et envoie des données à un serveur.
• Le serveur récupère ensuite ces données, l'interprète et effectue les actions nécessaires et la renvoie à votre téléphone.
• L'application interprète ensuite ces données et présente les informations que vous vouliez dans un format lisible. Tout cela se fait via une API.

Détails de la tâche

Votre tâche consiste à implémenter un service API à interroger sur les données utilisateur qui est stockée dans com.he.api.data.xml dans le format suivant.

    <dataset id_auto_increment="3"› 
      <user id="1" firstName="John" lastName="Dawson"/> 
      <user id="2" firstName="John" lastName="Doe"/> 
    </dataset>

• La balise <dataset> est l'élément racine du document XML. Il a un seul attribut id_auto_increment . La valeur de son ID augmente comme suit: Valeur de l'ID de l'utilisateur qui a été ajouté en dernier + 1

• La balise <user /> représente un enregistrement utilisateur dans l'ensemble de données. Il a des attributs suivants:

  • ID: clé principale des données utilisateur. C'est une valeur entière.
  • FirstName: prénom de l'utilisateur. Il s'agit d'une valeur de chaîne qui ne contient que des lettres minuscules et majuscules de l'alphabet anglais.
  • IATHAME: Nom de famille de l'utilisateur. Il s'agit d'une valeur de chaîne qui ne contient que des lettres minuscules et majuscules de l'alphabet anglais.

L'appel à serveur serait fait par scheme://domain:port/API?action=#&id=#&firstName=#&lastName=# , où 'String' après '?' indique la chaîne de requête.

Vous devez implémenter un service API qui est mappé sur la méthode GET ( com.he.api.apiservlet.java) (au schéma URL: // domaine: port / api). La chaîne de requête (en savoir plus sur les chaînes de requête ici) peut avoir des paramètres suivants:

• Action: définit les opérations à effectuer
• identifiant
• prénom
• Iastname

Types de requêtes

Les requêtes peuvent être des types suivants:

• Action = searchByld & id = # : Recherchez par ID dans l'ensemble de données dans le fichier data.xml. Renvoyez un tableau JSON qui contient l'utilisateur sélectionné comme réponse.

Exemple URL: scheme://domain:port/API?action=searchById&id=1

Réponse:

  [{ 
    "id": 1, 
    "firstName": "John", 
    "lastName": "Dawson" 
  }l 

• Action = searchByFirstName & FirstName = # : Recherchez par FirstName dans l'ensemble de données dans le fichier data.xml. Renvoyez un tableau JSON qui contient le ou les utilisateurs sélectionnés en réponse.

Exemple URL: scheme://domain:port/API?action=searchByFirstName&firstName=John

Réponse:

  [{ 
    "id": 1, 
    "firstName": "John", 
    "lastName": "Dawson" 
  }, { 
    "id": 2, 
    "firstName": "John", 
    "lastName": "Doe" 
  }] 

• Action = searchByFirstName & iAtName = # : Recherchez par LastName dans l'ensemble de données dans data.xml. Renvoyez un tableau JSON qui contient le ou les utilisateurs sélectionnés en réponse.

Exemple URL: scheme://domain:port/API?action=searchByLastName&lastName=Doe

Réponse:

  [{ 
    "id": 2, 
    "firstName": "John", 
    "lastName": "Doe" 
  }] 

• Action = searchByldRange & Low = # & high = # : Recherchez par ID dans l'ensemble de données dans le fichier data.xml. Renvoyez un tableau JSON qui contient les utilisateurs sélectionnés dont l'ID est dans la plage [bas, haut] en réponse.

Exemple URL: scheme://domain:port/API?action=searchByIdRange&low=1&high=2

Réponse:

  [{ 
    "id": 1, 
    "firstName": "John", 
    "lastName": "Dawson" 
  }, { 
    "id": 2, 
    "firstName": "John", 
    "lastName": "Doe" 
  }] 

• Action = UpdateSer & id = # & FirstName = # & LastName = # : Mettez à jour l'utilisateur dans le fichier data.xml, qui est donné par ID, et définissez le premier nom et iAtName sur des valeurs données. Si le paramètre FirstName ou IAtNAME n'est pas présent, sa valeur est inchangée. Il peut être possible que seul le nom soit présent et que LastName soit nul, puis seul FirstName doit être mis à jour.

Exemple URL: scheme://domain:port/API?action=updateUser&id=1&firstName=James&lastName=Jackson

  <dataset id auto increment="3"> 
    <user id="1" firstName="James" lastName="Jackson"/> 
    <user id="2" firstName="John" lastName="Doe"/> 
  </dataset> 

• Action = insertuser & firstName = # & iAtName = # : insérer un enregistrement utilisateur dans le fichier data.xml en utilisant les paramètres suivants:
  • prénom
  • Iastname

L'ID de l'utilisateur est donné par le paramètre id_auto_increment de la balise de jeu de données racine. Une fois la valeur insérée, le paramètre id_auto_increment est incrémenté de 1.

Exemple URL: scheme://domain:port/API?action=insertUser&firstName=James&lastName=Jackson

  <dataset id auto increment="4"> 
    <user id="1" firstName="John" lastName="Dawson"/> 
    <user id="2" firstName="John" lastName="Doe"/>
    <user id="3" firstName="James" lastName="Jackson"/>
  </dataset> 

Essai

Testez votre implémentation API en comparant le mappage de votre tableau JSON et de votre DOM XML.