APIService_XML_JSON_JAVA_Servlet

APISERVICE_XML_JSON_JAVA_SERVlet

Implementação de um serviço de API para consultar os dados do usuário que são armazenados no arquivo XML e mapeado para o Método Get Apiservlet e retornando uma matriz JSON

API

A interface de programação de aplicativos ou API é um intermediário de software que permite que dois aplicativos 'conversem' entre si. Quando você usa um aplicativo no seu telefone celular, é isso que acontece:

• O aplicativo se conecta à Internet e envia dados para um servidor.
• O servidor recupera esses dados, o interpreta e executa as ações necessárias e o envia de volta ao seu telefone.
• O aplicativo interpreta esses dados e apresenta as informações que você desejava em um formato legível. Tudo isso é feito através de uma API.

Detalhes da tarefa

Sua tarefa é implementar um serviço de API para consultar os dados do usuário que são armazenados em com.he.api.data.xml no formato a seguir.

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

• A tag <dataset> é o elemento raiz no documento XML. Possui um único atributo ID_AUTO_INCRENT . O valor de seu ID aumenta a seguinte

• <user /> tag representa um registro de usuário no conjunto de dados. Tem atributos seguintes:

  • ID: chave primária dos dados do usuário. É um valor inteiro.
  • primeiro nome: primeiro nome do usuário. É um valor de string que contém apenas letras minúsculas e maiúsculas do alfabeto inglês.
  • IASTNAME: Sobrenome do usuário. É um valor de string que contém apenas letras minúsculas e maiúsculas do alfabeto inglês.

A chamada ao servidor seria feita pelo scheme://domain:port/API?action=#&id=#&firstName=#&lastName=# , onde 'string' depois '?' indica a sequência de consulta.

Você deve implementar um serviço de API que seja mapeado para o método GET ( com.he.api.apiserv A sequência de consultas (leia mais sobre seqüências de consultas aqui) pode ter os seguintes parâmetros:

• Ação: define quais operações precisam ser executadas
• eu ia
• primeiro nome
• IASTNAME

Tipos de consultas

As consultas podem ser dos seguintes tipos:

• Ação = SearchByld & Id =# : Pesquise por ID no conjunto de dados no arquivo data.xml. Retorne uma matriz JSON que contém o usuário selecionado como uma resposta.

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

Resposta:

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

• Ação = SearchByFirstName & FirstName =# : Pesquise por FirstName no conjunto de dados no arquivo data.xml. Retorne uma matriz JSON que contém o (s) usuário (s) selecionado (s) como uma resposta.

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

Resposta:

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

• Ação = SearchByFirstName & IASTNAME =# : Pesquise por LastName no conjunto de dados em data.xml. Retorne uma matriz JSON que contém o (s) usuário (s) selecionado (s) como uma resposta.

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

Resposta:

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

• Ação = SearchByldRange & Low =# & High =# : Pesquise por ID no conjunto de dados no arquivo data.xml. Retorne uma matriz JSON que contém o (s) usuário (s) selecionado (s) cujo ID está no intervalo [baixo, alto] como resposta.

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

Resposta:

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

• ação = updateUser & id =#& FirstName =#& lastName =# : Atualize o usuário no arquivo data.xml, que é fornecido por ID, e defina o primeiro nome e o IAtName como valores fornecidos. Se o parâmetro FirstName ou IASTName não estiver presente, o valor é deixado inalterado. Pode ser possível que apenas o primeiro nome esteja presente e o último nome seja nulo, então apenas o primeiro nome deve ser atualizado.

Exemplo de 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> 

• Ação = InsertUser & FirstName =# & iAstname =# : Insira um registro de usuário no arquivo data.xml usando os seguintes parâmetros:
  • primeiro nome
  • IASTNAME

O ID do usuário é fornecido pelo parâmetro ID_AUTO_INCREMENT da tag de dados raiz. Depois que o valor é inserido, o parâmetro ID_AUTO_INCRENT é incrementado por 1.

Exemplo de 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> 

Teste

Teste sua implementação da API comparando o mapeamento de sua matriz JSON e XML DOM.