En tant que développeur front-end, il est difficile d'attendre que les API soient livrées. Et s'il existait une base de données miracle intégrant l'API. Eh bien, ce n'est plus un fantasme. Injee est une base de données fournie avec des API CRUD prêtes à l'emploi pour les développeurs front-end. En lisant cette page, vous apprendrez à utiliser Injee, à créer un enregistrement de livres dans injee et à manipuler et rechercher les données.

Commencer

Installer Java

Vous ne devez le faire qu'une seule fois. Visitez https://java.com pour télécharger Java pour votre machine. Une fois installé sur votre CMD, ou Terminal tapez java --varsion et cela doit fonctionner.

Télécharger

Vous pouvez télécharger injee en cliquant ici. Ou dans votre terminal utilisez :

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

Utiliser Injee

Accédez au répertoire dans lequel le fichier injee jar est téléchargé et exécutez-le en utilisant :

$ java -jar injee-0.2.0.jar

Santé

Vérifions si le serveur est en cours d'exécution. Nous utilisons l'API GET http://localhost:4125/ops/health.

Dans votre terminal, essayez :

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

La sortie doit être

{
  "health": "ok"
}

Créer des livres

Alors créons un dépôt de livres, comme par magie, injee a l'API POST http://localhost:4125/api/books pour créer un livre. Si vous souhaitez créer un dépôt de voitures, injee dispose de l'API API POST http://localhost:4125/api/cars. Créons donc un livre et stockons-le dans injee :

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

Sortir

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

Ainsi, injee stocke le livre et distribue un JSON contenant toutes les valeurs que vous avez envoyées à injee, ainsi qu'un UUID, qui est attribué à un ney nommé id.

Créons maintenant un autre livre :

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

Sortir

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

Et il fonctionne!

Lister tous les livres

Maintenant, pour répertorier tous les livres que nous utilisons, GET http://localhost:4125/api/books :

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

Sortir

[
  {
    "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"
  }
]

Nous recevons une belle gamme de livres que nous avons stockés.

Aller chercher un livre

Maintenant, récupérons un seul livre, pour cela nous utilisons l'API GET http://localhost:4125/api/books/:id:

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

Sortir

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

Donc, si j'ajoute l'identifiant GET http://localhost:4125/api/books/, j'obtiens les détails d'un seul livre.

Mettre à jour un livre

Pour mettre à jour un livre, utilisez PUT avec http://localhost:4125/api/books/:id, suivi des paramètres du livre :

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

Sortir

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

Comme vous pouvez le voir ci-dessus, le titre du livre a été modifié de Adventures of Huckleberry Finn à Adventures of Tom Sawyer.

Listons maintenant tous les livres :

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

Sortir

[
  {
    "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"
  }
]

pour confirmer notre mise à jour.

Supprimer un livre

Supprimons maintenant un livre. Pour cela, utilisez DELETE avec http://localhost:4125/api/books/:id:

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

Sortir

Il n'y aura aucune sortie, vous devriez obtenir le statut 204, si vous l'essayez dans le code et recevez l'objet de réponse.

Listons maintenant tous les livres et confirmons que les Aventures de Tom Sawyer ont été supprimés :

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

Sortir

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

Liste des tableaux

Créons maintenant un utilisateur :

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

Sortir

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

Alors maintenant, il doit y avoir deux tables dans notre base de données, à savoir les livres et les utilisateurs, listons-les en utilisant l'API suivante :

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

Sortir

[
  "books",
  "users"
]

Recherche d'enregistrements

Ajoutons un autre enregistrement d'utilisateur dans la table des utilisateurs :

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

Récupérons maintenant tous les utilisateurs et confirmons notre ajout

$ 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"
  }
]

Recherchons maintenant une chaîne dans les utilisateurs :

$ 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"
  }
]

Sauvegarde d'Injee

Sauvegardons maintenant notre base de données dans un fichier nommé backup.json :

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

Sortir

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

Arrêter Injee

Enfin, pour arrêter injee, dans le terminal où injee s'exécute, appuyez sur Ctrl c dans le terminal où injee s'exécute pour l'arrêter.

Chargement de la sauvegarde

Recommençons injee :

$ java -jar injee-0.2.0.jar

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

Sortir

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

Vous avez donc récupéré votre base de données d'origine. Bravo.

Garder à jour

L'une des meilleures façons de se tenir au courant d'Injee est de suivre sa page ici https://injee.codeberg.page/ , ou de suivre son RSS ici https://codeberg.org/injee.rss