APIService_XML_JSON_JAVA_Servlet

Apiservice_xml_json_java_servlet

Реализация службы API для запроса пользовательских данных, которые хранятся в файле XML и сопоставлены с методом Apiservlet Get и возвращая массив JSON

API

Интерфейс прикладного программирования или API - это программный посредник, который позволяет двум приложениям «разговаривать» друг с другом. Когда вы используете приложение на своем мобильном телефоне, это то, что происходит:

• Приложение подключается к Интернету и отправляет данные на сервер.
• Затем сервер получает эти данные, интерпретирует их и выполняет необходимые действия и отправляет их обратно на ваш телефон.
• Затем приложение интерпретирует эти данные и представляет информацию, которую вы хотели в читаемом формате. Все это делается через API.

Детали задачи

Ваша задача состоит в том, чтобы реализовать службу API для запроса пользовательских данных, которые хранятся в com.he.api.data.xml в следующем формате.

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

• <dataset> Tag является корневым элементом в документе XML. Он имеет один атрибут id_auto_increment . Значение его идентификатора увеличивается следующим образом: значение идентификатора пользователя, который был добавлен в последний раз + 1

• <user /> тег представляет запись пользователя в наборе данных. У него есть следующие атрибуты:

  • Идентификатор: первичный ключ пользовательских данных. Это целочисленное значение.
  • FirstName: Имя пользователя. Это строковое значение, которое содержит только строчные и верхние буквы английского алфавита.
  • Iastname: фамилия пользователя. Это строковое значение, которое содержит только строчные и верхние буквы английского алфавита.

Вызов на сервер будет сделан с scheme://domain:port/API?action=#&id=#&firstName=#&lastName=# , где 'string' после '?' обозначает строку запроса.

Вы должны реализовать службу API, отображаемой с Apiservlet (com.he.api.apiservlet.java) Метод получения (AT URL -схема: // домен: порт/API). Строка запроса (подробнее о строках запроса здесь) может иметь следующие параметры:

• Действие: определяет, какие операции необходимо выполнить
• идентификатор
• имя
• Iastname

Типы запросов

Запросы могут быть следующих типов:

• action = searchbyld & id =# : поиск по идентификатору в наборе данных в файле data.xml. Верните массив JSON, который содержит выбранного пользователя в качестве ответа.

Пример URL: scheme://domain:port/API?action=searchById&id=1

Ответ:

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

• action = searchbyfirstname & firstname =# : search by firstname в наборе данных в файле data.xml. Верните массив JSON, который содержит выбранного пользователя в качестве ответа.

Пример URL: scheme://domain:port/API?action=searchByFirstName&firstName=John

Ответ:

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

• action = searchbyfirstname & iastname =# : search by lastname в наборе данных в data.xml. Верните массив JSON, который содержит выбранного пользователя в качестве ответа.

Пример URL: scheme://domain:port/API?action=searchByLastName&lastName=Doe

Ответ:

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

• action = searchbyldrange & low =# & high =# : search по ID в наборе данных в файле data.xml. Верните массив JSON, который содержит выбранный пользователь (ы), идентификатор которого находится в диапазоне [низкий, высокий] в качестве ответа.

Пример URL: scheme://domain:port/API?action=searchByIdRange&low=1&high=2

Ответ:

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

• action = updateUser & id =#& firstname =#& lastname =# : Обновление пользователя в файле data.xml, который определяется идентификатором, и установил первое именное и iastname для заданных значений. Если FirstName или IastName параметр отсутствует, то его значение остается неизменным. Возможно, что присутствует только первое имен, а Lastname - NULL, а затем обновлять только FirstName.

Пример 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 =# & iastname =# : вставьте запись пользователя в файл data.xml, используя следующие параметры:
  • имя
  • Iastname

Идентификатор пользователя определяется параметром ID_AUTO_INCREMENT тега набора данных ROOT. После того, как значение вставлено, параметр id_auto_increment увеличивается на 1.

Пример 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> 

Тестирование

Проверьте свою реализацию API, сравнив картирование вашего массива JSON и XML DOM.