Como desenvolvedor front-end, é difícil esperar a entrega das APIs. E se houver um banco de dados milagroso que tenha a API integrada. Bem, não é mais fantasia. Injee é um banco de dados que vem com APIs CRUD prontas para uso para desenvolvedores front-end. Ao ler esta página, você aprenderá como usar o Injee, criar um registro de livros no injee e aprenderá como manipular e pesquisar os dados.

Começando

Instale Java

Você precisa fazer isso apenas uma vez. Visite https://java.com para baixar o Java para sua máquina. Uma vez instalado em seu CMD ou Terminal, digite java --varsion e ele deve funcionar.

Baixar Injee

Você pode baixar o injee clicando aqui. Ou no seu terminal use:

$ wget https://codeberg.org/injee/injee/releases/download/0.2.0/injee-0.2.0.jar

Usar Injee

Navegue até o diretório onde o arquivo injee jar foi baixado e execute-o usando:

$ java -jar injee-0.2.0.jar

Saúde

Vamos verificar se o servidor está rodando. Usamos a API GET http://localhost:4125/ops/health.

Em seu terminal, tente:

$ curl -X GET http://localhost:4125/ops/health

A saída deve ser

{
  "health": "ok"
}

Crie livros

Então vamos criar um repositório de livros, magicamente injee tem a API POST http://localhost:4125/api/books para criar um livro. Se você deseja criar um repositório de carros, o injee possui a API POST http://localhost:4125/api/cars API. Então, vamos criar um livro e armazená-lo em injee:

$ curl -X POST http://localhost:4125/api/books \
       -H "Content-Type: application/json" \
       -d '{"title": "Treasure Island", "author": "Robert Louis Stevenson"}'

Saída

{
  "title": "Treasure Island",
  "author": "Robert Louis Stevenson",
  "id": "722e2b57-59cc-4254-85b5-562858264f75"
}

Então injee armazena o livro e fornece um JSON que contém todos os valores que você enviou para injee, bem como um UUID, que é atribuído a um ney chamado id.

Agora vamos criar outro livro:

$ curl -X POST http://localhost:4125/api/books \
       -H "Content-Type: application/json" \
       -d '{"title": "Adventures of Huckleberry Finn", "author": "Mark Twain"}'

Saída

{
  "title": "Adventures of Huckleberry Finn",
  "author": "Mark Twain",
  "id": "689976e3-082e-4943-9525-a21b47cba325"
}

E funciona!

Listar todos os livros

Agora, para listar todos os livros, usamos GET http://localhost:4125/api/books:

$ curl -X GET http://localhost:4125/api/books

Saída

[
  {
    "title": "Treasure Island",
    "author": "Robert Louis Stevenson",
    "id": "722e2b57-59cc-4254-85b5-562858264f75"
  },
  {
    "title": "Adventures of Huckleberry Finn",
    "author": "Mark Twain",
    "id": "689976e3-082e-4943-9525-a21b47cba325"
  }
]

Recebemos uma boa variedade de livros que armazenamos.

Pegue um livro

Agora vamos buscar apenas um livro, para isso utilizamos a API GET http://localhost:4125/api/books/:id:

$ curl -X GET http://localhost:4125/api/books/689976e3-082e-4943-9525-a21b47cba325

Saída

{
  "title": "Adventures of Huckleberry Finn",
  "author": "Mark Twain",
  "id": "689976e3-082e-4943-9525-a21b47cba325"
}

Então, se eu acrescentar id GET http://localhost:4125/api/books/ recebo os detalhes de um único livro.

Atualizar um livro

Para atualizar um livro, use PUT junto com http://localhost:4125/api/books/:id, seguido dos parâmetros para o livro:

$ curl -X PUT http://localhost:4125/api/books/689976e3-082e-4943-9525-a21b47cba325 \
       -H "Content-Type: application/json" \
       -d '{"title": "Adventures of Tom Sawyer"}'

Saída

{
  "title": "Adventures of Tom Sawyer",
  "author": "Mark Twain",
  "id": "689976e3-082e-4943-9525-a21b47cba325"
}

Como você pode ver acima, o título do livro foi alterado de Adventures of Huckleberry Finn para Adventures of Tom Sawyer.

Agora vamos listar todos os livros:

$ curl -X GET http://localhost:4125/api/books

Saída

[
  {
    "title": "Treasure Island",
    "author": "Robert Louis Stevenson",
    "id": "722e2b57-59cc-4254-85b5-562858264f75"
  },
  {
    "title": "Adventures of Tom Sawyer",
    "author": "Mark Twain",
    "id": "689976e3-082e-4943-9525-a21b47cba325"
  }
]

para confirmar nossa atualização.

Excluir um livro

Agora vamos excluir um livro. Para isso use DELETE junto com http://localhost:4125/api/books/:id:

$ curl -X DELETE http://localhost:4125/api/books/689976e3-082e-4943-9525-a21b47cba325

Saída

Não haverá saída, você deverá obter o status 204, se estiver tentando no código e receber o objeto de resposta.

Agora vamos listar todos os livros e confirmar se As Aventuras de Tom Sawyer foram excluídas:

$ curl -X GET http://localhost:4125/api/books

Saída

[
  {
    "title": "Treasure Island",
    "author": "Robert Louis Stevenson",
    "id": "722e2b57-59cc-4254-85b5-562858264f75"
  }
]

Listando tabelas

Agora vamos criar um usuário:

$ curl -X POST http://localhost:4125/api/users \
       -H "Content-Type: application/json" \
       -d '{"name": "Karthik"}'

Saída

{
  "name": "Karthik",
  "created_at": "2024-07-22T11:18:42Z",
  "updated_at": "2024-07-22T11:18:42Z",
  "id": "ad100ab0-7893-421d-9233-353cc8899aa9"
}

Então agora deve haver duas tabelas em nosso banco de dados, nomeadamente livros e usuários, vamos listá-las usando a seguinte API:

$ curl -X GET http://localhost:4125/ops/tables

Saída

[
  "books",
  "users"
]

Pesquisando Registros

Vamos adicionar outro registro de usuário na tabela de usuários:

$ curl -X POST http://localhost:4125/api/users \
       -H "Content-Type: application/json" \
       -d '{"name": "Pari"}'

Agora vamos buscar todos os usuários e confirmar nossa adição

$ curl -X GET http://localhost:4125/api/users

[
  {
    "name": "Karthik",
    "created_at": "2024-07-22T11:18:42Z",
    "updated_at": "2024-07-22T11:18:42Z",
    "id": "ad100ab0-7893-421d-9233-353cc8899aa9"
  },
  {
    "name": "Pari",
    "created_at": "2024-07-22T11:23:27Z",
    "updated_at": "2024-07-22T11:23:27Z",
    "id": "1f06bb65-1f2d-4980-9cfc-cf3d38c9db7e"
  }
]

Agora vamos procurar uma string em users:

$ curl -X GET http://localhost:4125/api/users?q=Pari

[
  {
    "name": "Pari",
    "created_at": "2024-07-22T11:23:27Z",
    "updated_at": "2024-07-22T11:23:27Z",
    "id": "1f06bb65-1f2d-4980-9cfc-cf3d38c9db7e"
  }
]

Fazendo backup do Injee

Agora vamos fazer backup do nosso banco de dados em um arquivo chamado backup.json:

$ curl -X GET http://localhost:4125/ops/save?file=backup.json

Saída

{
  "message": "saved to file backup.json"
}

Parando Injee

Finalmente, para parar o injee, no terminal onde o injee está sendo executado, pressione Ctrl c no terminal onde o injee está sendo executado para pará-lo.

Carregando backup

Vamos começar de novo:

$ java -jar injee-0.2.0.jar

$ curl -X GET http://localhost:4125/ops/load?file=backup.json

Saída

{
  "message": "loaded from file backup.json"
}

Então você tem seu banco de dados original de volta e funcionando. Parabéns.

Manter atualizado

Uma das melhores maneiras de se manter atualizado com o Injee é seguir sua página aqui https://injee.codeberg.page/ ou seguir seu RSS aqui https://codeberg.org/injee.rss