DBDリザルトログアプリ

<p>前回作った<a href="https://qiita.com/gorira/items/7381e98b37b528bf5ae5">dbdのマップログアプリ</a>を拡張したくなったので、いっそのことリザルトをまとめて記録するアプリを作りました。</p>
![dbdresultlog.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/148969/c05ff280-8f21-99d3-a62e-326459762df0.png)

<p><a href="https://github.com/kumagogogo/dbdResultLog">Github</a>にあげてみました。</p>

<p>扱う情報
<ul>
<li>勝敗</li>
<li>キラー</li>
<li>残り発電機</li>
<li>マップ</li>
<li>キラー使用パーク</li>
<li>サバイバーそれぞれの使用パーク</li>
</ul>
</p>

<p>開発環境
<ul>
<li>node.js</li>
<li>Express</li>
<li>pug</li>
<li>PostgreSQL</li>
</ul>
</p>
<p>詰まった点をまとめていきたいと思いますが、前回との重複点もあるため、そこは省かせていただきました。</p>
<p>特に使ったことがなかったPostgreSQLについての内容が多めです。</p>

#もくじ

[1.PostgreSQL connectionの作成](#1-PostgreSQL connectionの作成)
[2.queryの実行](#2-queryの実行)
[3.行の挿入時にidを返す](#3-行の挿入時にidを返す)
[4.取得した行のソート](#4-取得した行のソート)
[5.pug formの作成](#5-pug formの作成)
[6.selectの作成](#6-selectの作成)
[7.checkboxの作成](#7-checkboxの作成)
[8.tabで整理](#8-tabで整理)
[9.おわりに](#9-おわりに)

#1.PostgreSQL connectionの作成
<p>まずはデスクトップにPostgreSQLをインストールする必要があるため、以下のチュートリアルを実行します。</p>
<a href="https://www.postgresqltutorial.com/install-postgresql/">Install PostgreSQL on Windows</a>
<p>チュートリアルにあるshellのログイン情報をメモします。</p>
<p>次に以下のDocumentを参考に、メモの情報を入力してconnectionを作成します。</p>
<a href="https://node-postgres.com/features/connecting">connection作成方法</a>
<p>connectionはこのようになります。</p>

```index.js
//get db connection
const { Pool, Client } = require('pg')
const pool = new Pool({
  user: 'postgres',
  host: 'localhost',
  database: 'databasename',
  password: 'password',
  port: 5432,
})

```
#2.queryの実行
<p>PostgreSQLにはqueryの実行方法がいくつかあり、それぞれcallback, promise, async/awaitになります。</p>
<p>基本的にはcallbackが簡単です。</p>
```index.js
let killer_names = [];
let sql = "SELECT * FROM killer_name;
pool.query(sql, (err, res) => {
  killer_names = res["rows"];
})
```
<p>帰ってくるデータ構造は（テーブルや列によって変化しますが）、以下のようになります。</p>
```index.js
[
 {"id": 1, "name": "trapper"},
 {"id": 2, "name": "wraith"},,, 
]
```
<p>通常のdictと同じようにアクセスできます。</p>

```index.js
console.log(killer_name[0]["name"]);
//trapperが出力される。
```
<p>※注意
レスポンスにはタイムラグがあるため、直後にsqlを操作することはできません。</p>

```index.js
//悪い例
let killer_names = [];
let sql = "SELECT * FROM killer_name;
pool.query(sql, (err, res) => {
  killer_names = res["rows"];
})
//取得にはタイムラグがあるため参照できない。
console.log(killer_name);
```

<p>そこで出てくるのがproses, async/awaitです。</p>
<p>詳細は私よりも他のdocumentを参考にした方が良いと思います。</p>
<ul>
<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function">async/awaitのチュートリアル</a></li>
<li><a href="https://node-postgres.com/features/queries">PostgreSQLのasync/awaitチュートリアル。</a></li>
</ul>
<p>一応プログラム内のコードを貼っておきます。</p>

```index.js
async function ins_result(killer, kpc, spc_lst, values) {
  const insertText = "INSERT INTO result(\
    result, rem_gen, map, killer, party) \
  VALUES ($1, $2, $3, $4, $5);"

  const killer_id = await ins_killer(killer, kpc);
  values.push(killer_id.rows[0]["id"]);

  var surviver_id_lst = []
  var len = spc_lst.length;
  for (let i = 0; i < len; i++) {
    const surviver_id = await ins_surviver(spc_lst[i]);
    surviver_id_lst.push(surviver_id.rows[0]["id"]);
  }

  var party_id = await ins_party(surviver_id_lst);

  values.push(party_id.rows[0]["id"]);

  pool.query(insertText, values);
}
```

<p>ざっくりと解説いたしますと、async function内でawaitで呼び出された関数はその関数の処理が完全に終了するまで次の行を読み込まないという仕組みになっているようです。</p>
<p>awaitで呼び出される関数はprocessで宣言されたものや、今回のquery関数を含むものになります。
<p>上記のコード内でawaitで呼び出された関数は以下のようにqueryを実行したものになっておりました。</p>


```javascript
function ins_killer(killer_id, kpc) {
  const insertText_killer = "INSERT INTO killer VALUES(DEFAULT, $1, $2, $3, $4, $5) RETURNING id;";
  while (kpc.length != 4) {
    kpc.push(-1);
  }
  var val = [killer_id, kpc[0], kpc[1], kpc[2], kpc[3]];
  const res = pool.query(insertText_killer, val);
  return res;
}
```

#3.行の挿入時にidを返す
<p>上記の項目で部分的に見せましたが、行の挿入を行う際に、queryの最後に"RETURNING 〇〇;"を追加することで、挿入後に挿入した行の列を返します。</P>
<P>主にテーブルのidを自動登録に設定している際に使うことになると思います。</p>


```index.js
//ここではidを返しております。
const insertText_killer = "INSERT INTO killer VALUES(DEFAULT, $1, $2, $3, $4, $5) RETURNING id;";
```

<p>ちなみにidを自動登録する際のデータ型は'int'ではなく'SERIAL'にすると良いです。</p>
<p>そうすることで上記のINSERT文のように、idをわざわざ指定せずともDEFAULTを指定することで挿入が可能になります。</p>
#4.取得した行のソート
<P>このアプリでは多数のデータから選択を強いられます。一つ一つ確認するのは大変のため、使用頻度の高いデータ順にソートする必要がありました。</p>
<p>マップや使用キャラ（キラー）はリザルトログと一意の関係のため、比較的簡単んでした。</p>

```javascript
let sel_text_map = "SELECT map.id, map_name, count(map) FROM map LEFT JOIN result ON map.id=result.map GROUP BY map.id ORDER BY count(result.map) desc;";

let sel_text_kil_perk = "SELECT killer_perk.id, killer_perk.perk, count(*) FROM killer_perk LEFT JOIN killer ON killer_perk.id=killer.perk_1 OR killer_perk.id=killer.perk_2 OR killer_perk.id=killer.perk_3 OR killer_perk.id=killer.perk_4 WHERE killer_perk.id NOT IN (-1) GROUP BY killer_perk.id ORDER BY count(*) desc;";

```

<p>解説</p>
<ul>
<li>"COUNT(map)": マップを多い順にソート</li>
<li>"FROM map LEFT JOIN result": これによりmapテーブルを基準にresultテーブルを組み込む</li>
<li>"ON map.id=result.map": それぞれの列を組み合わせる。事前にforeign keyを設定しておく必要がある。</li>
<li>"killer_perk.id=killer.perk_1 OR killer_perk.id=killer.perk_2": ここはORで繋げることで複数行を扱うことができる。
<li>"GROUP BY map.id": COUNT等の関数を使った際に行をまとめる。</li>
<li>"ORDER BY count(result.map)": SELECTで指定した列を基準にソートする。</li>
<li>"desc": 降順を指定。</li>
</ul>

#5.pug formの作成
```js
//formの宣言
form(action="/submit-form", method="post")

//submitボタンを押してフォームを送信
input(type="submit")
```
#6.selectの作成
<p>labelで表記する。for属性は対象のidに依存する。</p>
```js
label(for="map") map: 
  select(id="map", name="map") 
    each val in map 
      option(value=val["id"]) #{val["map_name"]} 
```
<p>受けて側はselectタグのname属性にアクセスすることで、optionタグで選択された値を得ることができる。

```index.js
const map = req.body.map;
```
#7.checkboxの作成
<p>checkboxもselectと同様の仕組み。</p>
```js
input(type="checkbox", name="killer_perk_check", value=val["id"])
```
<p>ただしcheckboxの値は複数選択できるため</P>

<ul>
<li>空→null</li>
<li>単一→単一の変数</li>
<li>複数→配列</li>
<p>という特徴を持っている。</p>
</ul>
#8.tabで整理
<p>dbdは1vs4のゲームでそれぞれがパークというものを複数持ってゲームをスタートします。</p>
<p>そのため個々の人物のパークを選択しやすいようにtabを使いました。</p>
<p>ソースコードは<a href="https://www.w3schools.com/howto/howto_js_tabs.asp">こちら</a>を参考にしました。</p>
<p>基本的な仕組みは</p>
<ol>
<li>ボタンとチェックボックス郡を用意する</li>
<li>クラスで紐づける</li>
<li>ボタンのイベントで「クリックされると紐づけられたチェックボックスを表示、またその他を非表示にする」というものを組み立てる。</li>
</ol>
<p>というものになっています。
<p>余談ですが、formタグ内のボタンはtype属性に"submit"を持ってしまい、期待通りに動いてくれません。そこで</p>
```index.js
button(class="tablinks", onclick="openCity(event, 'Killer')", type="button") Killer 
```
<p>という風にtype="button"としてあげるときちんと機能します。</p>

#9.おわりに
<p>私にとって難しかった点の解説をメインに記事を執筆致しましたので、この記事に興味を持って下さった方にとっては既知の情報も多く含まれているかもしれません。</p>
<p>ここに記載した何かしらの解説が誰かの役に立たせて頂ければ幸いです。</p>