hapi.jsと出会って10分でAPI起動

どうも、oskn259です。

みなさんは、APIを構築するときどの言語を使っていますでしょうか？
例えばPHPでLaravel、JavaでSpringFrameworkというのは一般的かと思います。
PHPはわかる人が多くて人的リソースを活用しやすいですし、Javaは動作の高速さや充実のドキュメントがいいですよね。

ただ、webサイトを作るときにはどうしてもjavascriptというものを避けて通れず、二種類の言語を使わざるを得ない状況となっています。
最近ではフロントとバックエンドを完全に分担する形が多いですが、コミュニケーションコストが増大しますし、個人的にはできれば避けたい形と思っています。

そこで今回紹介するのはこちらです。
https://hapi.dev/

javascriptで書けるwebフレームワークで、元々はExpressの開発者の一人がシンプルさを求めて新たに始めたプロジェクトのようです（確かそう、違ったらすいません）。
これが本当にシンプルで、最低限のコア部分に、自分が必要だと思う機能のみを付け足していく感覚がは触っていて楽しいですね。

僕が現在担当している案件では、hapi.jsをapiのコードベースに使用しています。
つまり、フロントもバックエンドもTypescriptで記述しています。
これによって、参加エンジニアがフロントとバック両方を変更できる状態に近づけようとしています。

今回はhapi.jsセットアップのさわりの部分を解説していきます。

今回の内容はこちらで書いた記事の修正版でもあります。
https://blog.oskn259.com/article/lets_hapi_js

sh
$ mkdir hapi_hapi_nyowa
$ cd hapi_hapi_nyowa
$ yarn init
$ yarn add @hapi/hapi
$ yarn add -D typescript @types/node
以上のようにnodeプロジェクトをセットアップしたら、以下のファイルをその場に配置します。

json
// package.jsonへ追記
{
 "scripts": {
  "build": "tsc",
  "start": "node index.js"
 },
}

json
// tsconfig.json
{
 "compilerOptions": {
  "esModuleInterop": true,
  "rootDir": "."
 }
}

ts
// index.ts
import { Server } from '@hapi/hapi';

const server = new Server({
 port: 5000,
 host: '127.0.0.1'
});

server.start();

実行します。
sh
$ yarn build
$ yarn start

sh
$ curl http://localhost:5000
{"statusCode":404,"error":"Not Found","message":"Not Found"}

APIサーバーが完成しました！！！
お仕事終わり！！帰宅！！

hapi.jsでいかにシンプルにapiサーバーを構築できるかがお分かりいただけたかと思います。
404を返すサイトでお金を取るのは難しそうなので、何かしらのコンテンツを返すように拡張してみましょう。

ts
// index.ts
import { Server, Request, Response } from '@hapi/hapi';
// ...

server.route({
 method: 'GET',
 path: '/',
 handler: function (req: Request, res: Response) {
  return { msg: '開けろ！デトロイト市警だ！' };
 }
});

server.start();

sh
$ yarn build
$ yarn start

sh
$ curl http://localhost:5000/ 
{"msg":"開けろ！デトロイト市警だ！"}

いかがでしょうか？
ここまで、APIサーバーを起動するという目的以外の余計な記述をほぼしていません。
hapi.jsに限らず、このように目的に集中できるフレームワークは僕は好きですね。

ページの追加もとても簡単に完了しました。
これだけで終わるのも寂しいので、個人的に便利だと思っている機能を一つ紹介しましょう。

sh
$ yarn add joi

ts
// index.ts
import Joi from 'joi';

// ...

server.route({
 method: 'GET',
 path: '/',
 handler: function (req: Request, res: Response) {
  // @ts-ignore
  const speaker = req.query.speaker;
  return { msg: `${speaker}: 開けろ！デトロイト市警だ！` };
 },
 options: {
  validate: {
   query: Joi.object({
    speaker: Joi.string().required(),
   }),
  },
  response: {
   schema: Joi.object({
    msg: Joi.string().required(),
   }),
   sample: 100,
  }
 }
});

server.start();

sh
$ yarn build
$ yarn start

sh
$ curl http://localhost:5000/ 
{"statusCode":400,"error":"Bad Request","message":"Invalid request query input"}

はい、弾かれましたね。
上記のoptions部分の追記だけでクエリのバリデーションが行われるようになり、クエリが空のリクエストを弾いています。

クエリを正しく付与して再度アクセスしてみましょう。

sh
$ curl http://localhost:5000/?speaker=Cona
{"msg":"Cona: 開けろ！デトロイト市警だ！"}

ちなみにお察しの方も居るかもしれませんが、
リクエストだけでなく、レスポンスにもバリデーションをかけることができます。
意図的にレスポンスをおかしな値にして試してみましょう。

ts
// index.ts
// ...
  // @ts-ignore
  const speaker = req.query.speaker;
  return { msg: { 'open_up': 'Detroit_Police' } };
// ...

sh
$ yarn build
$ yarn start

sh
$ curl http://localhost:5000/?speaker=Cona
{"statusCode":500,"error":"Internal Server Error","message":"An internal server error occurred"}

このように、期待するスキーマと実際のレスポンスが異なる場合は500を返す、という動作をとります。
バリデーション機能は、以下のような面で僕の開発にとても役立っています。

• ロジックの設計ミスで思わぬ情報を返してしまうおそれがない
• 外部からの攻撃によって意図しない情報を返却してしまうリスクを減らせる
• バグの早期発見に役立つ

 - 特にこれは頻繁に体感します
 - DevOpsの一環とも言えますね

サラッと通過しましたが、リクエストやレスポンスのスキーマをチェックするために`Joi`というライブラリを使用しています。
これがとても表現力の高いバリデーターで、表現できなくて困るという事態に僕はまだなっていません。

例えばこんな感じで値やオブジェクトの型をチェックすることができます。
非常に便利で、DBやネットワーク経由で取得した値のバリデーションにも使用しています。

ts
cosnt validator = Joi.object({
 greeting: Joi.string().valid('やぁダニエル', '君を助けにきたんだ').require(),
 isHaveGun: Joi.boolean().require(),
 stressLevel: Joi.number().min(0).max(100).require(),
});

const result = validator.validate(android);

if (result.error === underined) {
 console.log('コナーです');
}

今回はhapi.jsの簡単な導入と、Joiを使ったバリデーションを紹介しました。
hapi.jsのこうした点を感じてもらえれば嬉しいです。

• とにかくシンプル
• Joiと連携した強力なバリデーション機能

こうしたシンプルなコアをベースに、オプショナルに記述できる機能や多数のプラグインが存在しており、実際のサービス構築にも十分耐えうる機能を有しています。
モノリシックなフレームワークの、体系化された集合知をそのまま活かせる雰囲気も良いですが、自分になじむようカスタマイズされたコードベースでの開発もなかなか良いものですね。