Web開発のサンプルコードを探しております

Question

Node.jsとExpressとPostgreSQLをつかって、WEBアプリを開発したいと思っています。そこで、開発にあたって、参考になりそうなサンプルソースをさがしております。

Rails＋PostgreSQLの組み合わせだと情報はたくさんあるのですが、Node.jsとなると極端に情報量が少ないような印象を受けています。参考になる情報を教えていただけませんでしょうか。

WBアプリはある程度、本格的なものを作る予定をしております。学習教材でよくありがちな、ちょっとしたToDoアプリを作りましょう的なサンプルコードでは参考にならないと思っております。学習教材よりも少し本格的なサンプルコードを探しております。そのような情報をご存じの方、教えていただけませんでしょうか。よろしくお願いします。

Answer 1

Rails＋PostgreSQLの組み合わせだと情報はたくさんある

Railsは非常に多くのブラックボックスを抱えたプロジェクトだからです。
それにより必要最小限のコードで(それなりにまともに動くデフォルト値が補われて)動作します。

高速にWebサービスをリリースできるのはRailsの強みですが、
知っているべき前提が多く、その知識なしではお話にならないって所に起因していると私は分析しています。

学習教材よりも少し本格的なサンプルコードを探しております。

ぶっちゃけ無いと言うのが実情です。

Node,jsの文化がUnix哲学の「一つのことをうまくやるプログラムを書け」みたいなもんで、
必要最低限のモジュールだけを必要に応じてこしらえて動かす事が前提となっています。

なのでNode.jsの基礎の部分の学習と、
各種モジュールの公式サイトを読んで情報を引き出せる能力が極めて重要となります。
そしてそれらをすぐに試せるREPLもついています。

Expressは機能が多くないので、コード読めばやってることは全て書いてありますしドキュメントも神です。
日本語ドキュメントの上メニューにある「解説」「ガイド」「高度なトピック」「リソース」全てが神です。
Webに必要な要素はほぼ網羅されており、困ったら日本語ドキュメントに泣きつけば大抵書いてあります。
逆にそこいらの雑魚が書いたメンテされてない記事やサンプルコードなど不要です。

postgresqlはpgというモジュールの手厚いドキュメントを見つけました。
コネクションプールの張り方、Node.js世界での値の残し方を覚えれば後は消化試合みたいなもんですね。
これは調べてもすぐには出てこないので後述します。

後はNode.js力だけですね。
ここに関しては良い書籍を買うなり時間かけるしかないです。

---

さて、Node.js上でRDBMSを使う上で必要になる
シングルトンに関して解説して締めます。

Node.jsでrequireした場合、
require先のJavaScriptファイルを一度上から下まで全て実行してしまい、
最終的にmodule.exports変数に代入された値をキャッシュとしてもたせる動きになります。

なのでconnectingを読みつつ
コネクション張った瞬間をキャッシュにしてもたせましょう。
(本番環境の事を考えると記事内にある環境変数を使った手法にした方が良いでしょう)

// src/modules/connection.js
const {Pool} = require("pg");

module.exports = process.env.PGHOST
  ? new Pool({
    user: 'dbuser',
    host: 'database.server.com',
    database: 'mydb',
    password: 'secretpassword',
    port: 3211,
  })
  : new Pool();

使う側はこんな感じ
2箇所以上でrequireしてもnew Pool()で生成された後の値をキャッシュとして返すだけなので
様々なファイルが呼び出しても不必要なコネクションを張りに行くことはありません。
こちらもQueriesというサンプルがあるのでそこから採用します。

// src/models/user.js

// .で始まるとこのファイルのパスを起点としたJavaScriptファイルの指定になる
const conn = require("../modules/connection.js");

module.exports = {
  findById: async (id) => {
    const res = await conn.query("SELECT * FROM users WHERE id = $1", [id]);
    return res.rows[0];
  },
};

Express使う側はこんな感じ
ガイド -> ルーティングを読みつつ書きました。

// app.js
const express = require("express");

// 欲しいと思ったファイルの先頭で呼び出す
const User = require("./src/models/user.js");

const app = express();

app.get("users/:id", (req, res) => {
  const user = await User.findById(req.params.id);
  res.json(user);
});

app.port(3000);

ExpressJSでのテンプレートを何をどうやって使うか、ファイル分割テクニック等は
個別に調べれば出てくるので規模に合わせて調査してみてください。

Comments

[pyon_kiti_jp]

ご丁寧にありがとうございました。

Answer 2

何をしたいかによって、お勧めするサンプルは変わってくると思います。

単純にnodeでPostgreSQLを利用したサンプルが欲しいというのであれば、下記サイトを見つけました。
PostgreSQLのセットアップから、nodeからの接続までを行っています。
https://www.dailyupblog.com/backend_development/962/

また、Expressはシンプルなフレームワークなので、Expressのマニュアルに記載されているサンプルもわかりやすいかと思います。
https://expressjs.com/ja/guide/routing.html

「本格的」という文言がありますが、基本的にはどのアプリも学習教材の「ToDo」アプリのようなものの考え方を応用したりといったものがほとんどなので、学習教材的なサンプルに手を付けるのが一番いいかと思います。

Comments

[pyon_kiti_jp]

ありがとうございます。参考にさせていただきます。
自分が求めているレベルとしては、昔、「現場で使える Ruby on Rails 5速習実践ガイド」という本を参考にして、Railsを作った事がありますが、この程度のレベルのNode.js版をイメージしておりました。

[Matsumon0104]

私は「現場で使える Ruby on Rails 5速習実践ガイド」の内容がわからないので、適切な回答ができないかもしれませんが、オライリー（いわゆる動物本)が間違いないかもしれません。
元が英語を日本語翻訳した書籍になりますが、内容が結構詳しいですしサンプルコードものってますので、nodeエンジニアを目指すというのであれば、必携かもしれません。
全国の書店にもあると思いますので、ぜひ一度見てみてください。

■nodeデザインパターン
https://www.oreilly.co.jp/books/9784873118734/

■Express(こちらは、日本語訳があるかはわからないです。)
https://www.oreilly.com/library/view/web-development-with/9781492053507/

[pyon_kiti_jp]

ご丁寧にありがとうございます。