フロントエンド開発者として、API が配信されるのを待つのは苦痛です。 API が組み込まれた奇跡のデータベースが存在したらどうなるでしょうか。それはもはや空想ではありません。 Injee は、フロントエンド開発者向けにすぐに使用できる CRUD API が付属するデータベースです。このページを読むことで、Injee の使い方、injee で書籍の記録を作成する方法、データの操作と検索の方法を学びます。

はじめる

Javaのインストール

これを行う必要があるのは 1 回だけです。 https://java.com にアクセスして、マシン用の Java をダウンロードします。 CMD またはターミナルにインストールしたら、java --varsion と入力すると機能するはずです。

ダウンロード

ここをクリックするとinjeeをダウンロードできます。または、端末で次を使用します:

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

インジーを使用する

injee jar ファイルがダウンロードされたディレクトリに移動し、次のコマンドを使用して実行します。

$ java -jar injee-0.2.0.jar

健康

サーバーが起動しているか確認してみましょう。 API GET http://localhost:4125/ops/health.

端末で次のことを試してください:

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

出力は次のようになります

{
  "health": "ok"
}

本を作成する

それでは、書籍のリポジトリを作成しましょう。魔法のように、injee には書籍を作成するための API POST http://localhost:4125/api/books があります。車のリポジトリを作成したい場合、injee には API POST http://localhost:4125/api/cars API があります。それでは、ブックを作成して injee に保存しましょう:

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

出力

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

したがって、injee は本を保存し、injee に送信したすべての値と、id という名前の ney に割り当てられた UUID を含む JSON を渡します。

次に、別の本を作成しましょう:

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

出力

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

そしてそれはうまくいきます!

すべての本をリストする

次に、使用するすべての書籍をリストします。GET http://localhost:4125/api/books:

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

出力

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

保管していた素晴らしい本がたくさん届きました。

本を持ってくる

次に、本を 1 冊だけ取得しましょう。そのために、API GET http://localhost:4125/api/books/:id:
を使用します。

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

出力

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

したがって、id GET http://localhost:4125/api/books/ を先頭に追加すると、1 冊の本の詳細が得られます。

本を更新する

書籍を更新するには、http://localhost:4125/api/books/:id とともに PUT を使用し、その後に書籍のパラメータを続けます:

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

出力

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

上に見られるように、本のタイトルは、ハックルベリー・フィンの冒険からトム・ソーヤーの冒険に変更されました。

それでは、すべての本をリストしてみましょう:

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

出力

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

更新を確認してください。

本を削除する

それでは、本を削除しましょう。その場合は、http://localhost:4125/api/books/:id:
とともに DELETE を使用します。

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

出力

出力はありません。コードで試して応答オブジェクトを受信する場合は、ステータス 204 を取得する必要があります。

次に、すべての書籍をリストして、トム ソーヤーの冒険が削除されたことを確認しましょう:

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

出力

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

リストテーブル

次にユーザーを作成しましょう:

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

出力

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

データベースには書籍とユーザーという 2 つのテーブルが必要です。次の API を使用してそれらをリストしてみましょう:

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

出力

[
  "books",
  "users"
]

記録の検索

別のユーザー レコードを users テーブルに追加しましょう:

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

すべてのユーザーを取得して追加を確認しましょう

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

次に、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"
  }
]

Injee のバックアップ

次に、DB を Backup.json という名前のファイルにバックアップしましょう:

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

出力

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

インジーを止める

最後に、injee を停止するには、injee が実行されているターミナルで Ctrl c を押して停止します。

バックアップをロード中

またインジェを始めましょう:

$ java -jar injee-0.2.0.jar

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

出力

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

これで、元の DB が戻って実行できるようになりました。おめでとうございます。

最新の状態を保つ

Injee の最新情報を入手する最良の方法の 1 つは、こちらのページ https://injee.codeberg.page/ をフォローするか、こちらの RSS をフォローすることです https://codeberg.org/injee.rss