Métodos HTTP do UniRest: GET, POST, PUT e DELETE

A comunicação eficaz entre aplicações é essencial no desenvolvimento de software moderno. Essa comunicação muitas vezes depende de protocolos bem definidos, como o Protocolo de Transferência de Hipertexto (HTTP). Dentro do HTTP, métodos específicos ditam o tipo de interação pretendida entre um cliente e um servidor.

Para entender quais métodos HTTP do UniRest estão disponíveis, este artigo irá abordar as funcionalidades principais de quatro métodos HTTP essenciais—GET, POST, PUT e DELETE—como implementados pela biblioteca UniRest. Compreender esses métodos é crucial para construir aplicações web robustas e versáteis.

O que são Métodos HTTP?

Métodos HTTP são um conjunto definido de instruções que ditam a ação pretendida em um recurso específico. Métodos HTTP são verbos que estabelecem canais de comunicação claros entre aplicações cliente e recursos do lado do servidor.

Métodos HTTP do UniRest e Exemplo

Método HTTP GET do UniRest

Recupera dados de uma URL especificada. O UniRest fornece um método get(url) para esse propósito. Você pode opcionalmente incluir parâmetros de consulta usando o método queryString(String chave, Object valor) para refinar sua solicitação.

Método HTTP POST do UniRest

Criar um novo recurso no servidor. O UniRest oferece um método post(url) para iniciar uma solicitação POST. Você pode incluir dados a serem criados dentro do corpo da solicitação usando métodos como body(Object corpo) ou field(String chave, Object valor) para dados de formulário.

Método HTTP PUT do UniRest

Atualiza um recurso existente completamente. O método put(url) do UniRest facilita o envio de solicitações PUT. Semelhante ao POST, você pode fornecer os dados atualizados dentro do corpo da solicitação usando body(Object corpo).

Método HTTP DELETE do UniRest

Remove um recurso especificado do servidor. Essa ação irreversível é iniciada usando o método delete(url) no UniRest.

Método HTTP HEAD do UniRest

Recupera apenas as informações do cabeçalho associadas a um recurso, excluindo o conteúdo real. O UniRest oferece um método head(url) para esse propósito.

Método HTTP OPTIONS do UniRest

Consulta o servidor para determinar os métodos HTTP suportados para um recurso específico. O UniRest fornece um método options(url) para essa funcionalidade.

Método HTTP PATCH do UniRest

Aplica modificações parciais a um recurso existente. O método patch(url) do UniRest permite o envio de solicitações PATCH. As mudanças específicas são tipicamente definidas em um formato como JSON Patch.

Método HTTP CONNECT do UniRest

Estabelece uma conexão de túnel com o servidor. O UniRest oferece um método connect(url) para esse propósito, embora seja menos comumente usado em comparação com outros métodos.

Método HTTP TRACE do UniRest

Rastreia o caminho percorrido por uma solicitação através da rede de intermediários. Este método é utilizado principalmente para fins de depuração, e o UniRest fornece um método trace(url) para isso.

Além desses métodos principais, o UniRest fornece funcionalidades para:

• Autenticação Básica: Definindo nome de usuário e senha para autorização utilizando basicAuth(String username, String password).
• Carregamentos de Formulário: Enviando arquivos dentro de uma solicitação POST usando field(String chave, File arquivo).
• Solicitações Assíncronas: Solicitações não bloqueantes são feitas usando métodos assíncronos fornecidos pelo UniRest.

Aproveitando esses métodos e funcionalidades, o UniRest capacita os desenvolvedores a construir interações dinâmicas e eficientes com serviços web, agilizando o processo de recuperação, criação, manipulação e exclusão de dados.

Exemplos de Código para Métodos HTTP do UniRest

Aqui estão alguns exemplos de Métodos HTTP do UniRest em UniRest Java.

Solicitação GET para Recuperação de Dados

// Importar classes necessárias
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.JsonNode;
import com.mashape.unirest.http.Unirest;

public class GetExample {

  public static void main(String[] args) throws Exception {

    // Defina a URL e o parâmetro de consulta opcional
    String url = "https://api.example.com/users";
    int userId = 123;

    // Construir a solicitação GET com o parâmetro de consulta
    HttpResponse<JsonNode> response = Unirest.get(url)
        .queryString("id", userId)
        .asJson();

    // Verificar se a resposta foi bem-sucedida
    if (response.getStatus() == 200) {
      JsonNode user = response.getBody();
      System.out.println("Dados do usuário recuperados: " + user);
    } else {
      System.out.println("Erro ao recuperar usuário: " + response.getStatus());
    }
  }
}

Solicitação POST para Criar um Recurso

public class PostExample {

  public static void main(String[] args) throws Exception {

    // Defina a URL e os dados para o novo recurso
    String url = "https://api.example.com/posts";
    String title = "Meu Novo Post";
    String content = "Este é um conteúdo para o novo post.";

    // Construir a solicitação POST com dados do corpo
    HttpResponse<String> response = Unirest.post(url)
        .body("{\"title\": \"" + title + "\", \"content\": \"" + content + "\"}")
        .asString();

    // Verificar se a resposta foi bem-sucedida
    if (response.getStatus() == 201) {
      System.out.println("Post criado com sucesso!");
    } else {
      System.out.println("Erro ao criar post: " + response.getStatus());
    }
  }
}

Solicitação PUT para Atualizar um Recurso

public class PutExample {

  public static void main(String[] args) throws Exception {

    // Defina a URL e os dados atualizados para o recurso
    String url = "https://api.example.com/posts/10";
    String newTitle = "Título Atualizado";

    // Construir a solicitação PUT com dados do corpo
    HttpResponse<String> response = Unirest.put(url)
        .body("{\"title\": \"" + newTitle + "\"}")
        .asString();

    // Verificar se a resposta foi bem-sucedida
    if (response.getStatus() == 200) {
      System.out.println("Post atualizado com sucesso!");
    } else {
      System.out.println("Erro ao atualizar post: " + response.getStatus());
    }
  }
}

Solicitação DELETE para Remover um Recurso

public class DeleteExample {

  public static void main(String[] args) throws Exception {

    // Defina a URL do recurso a ser deletado
    String url = "https://api.example.com/comments/5";

    // Construir a solicitação DELETE
    HttpResponse<String> response = Unirest.delete(url)
        .asString();

    // Verificar se a resposta foi bem-sucedida
    if (response.getStatus() == 204) {
      System.out.println("Comentário deletado com sucesso!");
    } else {
      System.out.println("Erro ao deletar comentário: " + response.getStatus());
    }
  }
}

Apidog - Comece a Integrar Aplicativos com UniRest!

O UniRest é uma ferramenta poderosa que fornece aos desenvolvedores as funcionalidades necessárias para conectar códigos e servidores através do poder das APIs. Portanto, é crucial que os desenvolvedores entendam como implementar tanto APIs quanto suas ferramentas.

Se você é novo no desenvolvimento de APIs, recomendamos que você use Apidog.

O Apidog é uma ferramenta de desenvolvimento de API abrangente que capacita os desenvolvedores a construir, testar, simular e documentar APIs, equipando-os com todas as ferramentas necessárias.

Através de uma interface de usuário simples e intuitiva, os usuários do Apidog, sejam novos ou experientes com o aplicativo, podem navegar pela aplicação rapidamente. Com uma curva de aprendizado baixa, os novos usuários não se sentirão intimidados pela complexidade do desenvolvimento de APIs.

Importando APIs Existentes para o Apidog

Se você tem um projeto de API existente que gostaria de observar, você pode importá-lo para o Apidog com apenas alguns cliques do seu cursor.

Uma vez que você tenha baixado o Apidog, você pode proceder para a seção Configurações do seu projeto. Localize o botão Importar Dados para que você possa escolher que tipo de arquivo API você possui. Se você não vir um, pode arrastá-lo e soltá-lo na caixa abaixo.

Gere Código do Cliente em Poucos Segundos com Apidog

Uma grande vantagem que os usuários do Apidog podem desfrutar é a funcionalidade de geração de código.

Primeiro, instale e abra o Apidog e certifique-se de ter um projeto aberto. Prossiga localizando o botão </> na parte superior direita da janela do Apidog, conforme mostrado na imagem acima.

Uma janela pop-up contendo uma lista de linguagens de programação será fornecida. A imagem acima mostra a geração de código para UniRest Java.

Conclusão

A biblioteca UniRest equipou os desenvolvedores com um conjunto de ferramentas poderoso e fácil de usar para interagir com serviços web. Ao oferecer uma API clara e concisa para métodos HTTP essenciais como GET, POST, PUT e DELETE, o UniRest simplifica o processo de recuperação, criação, manipulação e exclusão de dados. Além disso, seu suporte a funcionalidades como autenticação, carregamentos de formulário e solicitações assíncronas capacita os desenvolvedores a construir aplicações web robustas e eficientes.

Para uma exploração aprofundada e domínio das funcionalidades do UniRest, consultar a documentação oficial é altamente recomendável. A documentação fornece explicações abrangentes, exemplos de código ilustrativos e melhores práticas para utilizar efetivamente o UniRest em seus esforços de desenvolvimento. Ao aproveitar tanto a biblioteca quanto sua documentação, os desenvolvedores podem agilizar interações com serviços web e acelerar a criação de aplicações dinâmicas e ricas em recursos.