Als Front-End-Entwickler ist es mühsam, auf die Bereitstellung von APIs zu warten. Was wäre, wenn es eine Wunderdatenbank gäbe, in die die API integriert ist? Nun, das ist keine Fantasie mehr. Injee ist eine Datenbank, die mit gebrauchsfertigen CRUD-APIs für Front-End-Entwickler ausgestattet ist. Wenn Sie diese Seite lesen, erfahren Sie, wie Sie Injee verwenden, eine Buchaufzeichnung in Injee erstellen und wie Sie die Daten manipulieren und durchsuchen.

Erste Schritte

Installieren Sie Java

Sie müssen dies nur einmal tun. Besuchen Sie https://java.com, um Java für Ihren Computer herunterzuladen. Sobald Sie es auf Ihrem CMD oder Terminal installiert haben, geben Sie java --varsion ein und es muss funktionieren.

Laden Sie Injee herunter

Sie können Injee herunterladen, indem Sie hier klicken. Oder verwenden Sie in Ihrem Terminal:

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

Benutze Injee

Navigieren Sie zu dem Verzeichnis, in das die Injee-JAR-Datei heruntergeladen wird, und führen Sie sie aus mit:

$ java -jar injee-0.2.0.jar

Gesundheit

Überprüfen wir, ob der Server läuft. Wir verwenden die API GET http://localhost:4125/ops/health.

Versuchen Sie in Ihrem Terminal:

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

Ausgabe sollte sein

{
  "health": "ok"
}

Bücher erstellen

Lasst uns also ein Repo mit Büchern erstellen. Auf magische Weise verfügt Injee über die API POST http://localhost:4125/api/books, um ein Buch zu erstellen. Wenn Sie ein Repo von Autos erstellen möchten, verfügt Injee über die API POST http://localhost:4125/api/cars API. Erstellen wir also ein Buch und speichern es in injee:

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

Ausgabe

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

Also speichert injee das Buch und gibt ein JSON aus, das alle Werte enthält, die Sie an injee gesendet haben, sowie eine UUID, die einer Ney namens id zugewiesen ist.

Jetzt erstellen wir ein weiteres Buch:

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

Ausgabe

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

Und es funktioniert!

Listen Sie alle Bücher auf

Um nun alle Bücher aufzulisten, die wir verwenden, GET http://localhost:4125/api/books:

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

Ausgabe

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

Wir erhalten eine schöne Auswahl an Büchern, die wir gespeichert haben.

Holen Sie sich ein Buch

Jetzt holen wir uns nur ein Buch, dafür verwenden wir die API GET http://localhost:4125/api/books/:id:

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

Ausgabe

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

Wenn ich also id GET http://localhost:4125/api/books/ voranstelle, erhalte ich die Details eines einzelnen Buches.

Aktualisieren Sie ein Buch

Um ein Buch zu aktualisieren, verwenden Sie PUT zusammen mit http://localhost:4125/api/books/:id, gefolgt von Parametern für das Buch:

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

Ausgabe

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

Wie Sie oben sehen können, wurde der Titel des Buches von „Adventures of Huckleberry Finn“ in „Adventures of Tom Sawyer“ geändert.

Jetzt listen wir alle Bücher auf:

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

Ausgabe

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

um unser Update zu bestätigen.

Ein Buch löschen

Jetzt löschen wir ein Buch. Verwenden Sie dazu DELETE zusammen mit http://localhost:4125/api/books/:id:

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

Ausgabe

Es erfolgt keine Ausgabe, Sie sollten den Status 204 erhalten, wenn Sie es im Code versuchen und das Antwortobjekt erhalten.

Lassen Sie uns nun alle Bücher auflisten und bestätigen, dass „Adventures of Tom Sawyer“ gelöscht wurde:

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

Ausgabe

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

Tabellen auflisten

Jetzt erstellen wir einen Benutzer:

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

Ausgabe

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

Jetzt müssen in unserer Datenbank also zwei Tabellen vorhanden sein, nämlich Bücher und Benutzer. Listen wir sie mithilfe der folgenden API auf:

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

Ausgabe

[
  "books",
  "users"
]

Durchsuchen von Datensätzen

Fügen wir einen weiteren Benutzerdatensatz zur Benutzertabelle hinzu:

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

Lassen Sie uns nun alle Benutzer abrufen und unser Hinzufügen bestätigen

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

Jetzt suchen wir nach einer Zeichenfolge in Benutzern:

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

Unterstützung für Injee

Jetzt können wir unsere Datenbank in einer Datei namens „backup.json“ sichern:

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

Ausgabe

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

Injee stoppen

Um Injee schließlich zu stoppen, drücken Sie im Terminal, in dem Injee ausgeführt wird, die Strg-Taste c im Terminal, in dem Injee ausgeführt wird, um es zu stoppen.

Backup wird geladen

Lass uns noch einmal mit Injee beginnen:

$ java -jar injee-0.2.0.jar

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

Ausgabe

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

Sie haben also Ihre ursprüngliche Datenbank wieder zum Laufen gebracht. Glückwunsch.

auf dem Laufenden halten

Eine der besten Möglichkeiten, über Injee auf dem Laufenden zu bleiben, besteht darin, seiner Seite hier zu folgen https://injee.codeberg.page/ oder seinem RSS hier zu folgen https://codeberg.org/injee.rss