Help us understand the problem. What is going on with this article?

[Node.js] Socket.ioで双方向通信チャットアプリを構築 〜 JSおくのほそ道 #005

More than 5 years have passed since last update.

こんにちはほそ道です。
今回はここまで学んだ技術、コールバック・イベント処理/モジュールの利用/HTTP通信を活用しつつ、
WebSocketによる双方向リアルタイム通信アプリケーションを作ってみます。

目次はこちら

WebSocketについてはWikipediaにいい感じにまとまってますが
ほそ道が感じた良さを一言でいうと
「ユーザアクション無しにサーバーからクライアントへのpush通信が可能となる」という事ですね。
指定時間にサーバからお知らせ等のアクションも可能となります。

チャットアプリケーションの実装

というわけで作ってみました。
非常にベタなんですが。。
チャットアプリケーションです。
今回はサーバ側とクライアント側の両方に実装が必要となります。
また、新しくWebSocketを実現する為の socket.ioモジュール が登場します。
アプリケーションの骨格が見えるよう、なるべく基本機能のみを用い、jQueryなども使わずに組みました。

構成

構成は下記の様になってます。
socket.ioのインストールは
npm install socket.io
でおこないます。
app.jsがサーバ側実装、index.htmlがユーザにレスポンスするhtmlです。

.
├── app.js
├── index.html
└── node_modules

サーバサイドの実装

実装

app.js
// 1.モジュールオブジェクトの初期化
var fs = require("fs");
var server = require("http").createServer(function(req, res) {
     res.writeHead(200, {"Content-Type":"text/html"});
     var output = fs.readFileSync("./index.html", "utf-8");
     res.end(output);
}).listen(8080);
var io = require("socket.io").listen(server);

// ユーザ管理ハッシュ
var userHash = {};

// 2.イベントの定義
io.sockets.on("connection", function (socket) {

  // 接続開始カスタムイベント(接続元ユーザを保存し、他ユーザへ通知)
  socket.on("connected", function (name) {
    var msg = name + "が入室しました";
    userHash[socket.id] = name;
    io.sockets.emit("publish", {value: msg});
  });

  // メッセージ送信カスタムイベント
  socket.on("publish", function (data) {
    io.sockets.emit("publish", {value:data.value});
  });

  // 接続終了組み込みイベント(接続元ユーザを削除し、他ユーザへ通知)
  socket.on("disconnect", function () {
    if (userHash[socket.id]) {
      var msg = userHash[socket.id] + "が退出しました";
      delete userHash[socket.id];
      io.sockets.emit("publish", {value: msg});
    }
  });
});

解説

コメント付けした1.がオブジェクトの初期化で、2.がアプリの機能実装を行っています。

オブジェクトの初期化

前回やったrequire("http").createServerでhttpサーバを立てています。
レスポンスはfsモジュールで読み込んだindex.htmlです。
var io = require("socket.io").listen(server);の部分でWebSocketの機能を追加しています。

アプリの機能実装

大外のio.sockets.on("connection", 〜で通信開始イベントが発生し、
内側にコールバックとして接続開始、メッセージ送信、接続終了の3つのイベントを設定しています。
コールバックの引数socketに色々な接続情報が格納されています。

今回、ユーザの入室と退出を他のユーザにも伝える為にuserHashというユーザを管理する入れ物を作りました。
socket.io自体にもkey-valueで値を保存する仕組みがあるのですが、
コード量の削減と、骨格が見えやするなるようにする為に自分で仕組みを用意しました。
Keyがsocket.id, Valueがクライアント側で生成するチャットユーザ名です。

接続開始はAさん入室時に他ユーザにAさん入室を通知します。
メッセージ送信は全ユーザ向け、自分以外全員、特定ユーザなど出来ますが今回実装では全ユーザ向けに配信します。
接続終了に関しては組込イベントdisconnectで、Aさん退出時に他ユーザにAさん退出を通知します。

クライアントサイドの実装

実装

index.html
<html>
<head>
  <meta charset="UTF-8">
  <title>ホソミチチャット</title>
</head>
<body>
  <input type="text" id="msg_input" style="width:200px;" />
  <button onclick="publishMessage();">語る</button>
  <div id="msg"></div>
  <script src="/socket.io/socket.io.js"></script>
  <script type="text/javascript">
    // 1.イベントとコールバックの定義
    var socketio = io.connect('http://localhost:8080');

    socketio.on("connected", function(name) {});
    socketio.on("publish", function (data) { addMessage(data.value); });
    socketio.on("disconnect", function () {});

    // 2.イベントに絡ませる関数の定義
    function start(name) {
      socketio.emit("connected", name);
    }

    function publishMessage() {
      var textInput = document.getElementById('msg_input');
      var msg = "[" + myName + "] " + textInput.value;
      socketio.emit("publish", {value: msg});
      textInput.value = '';
    }

    function addMessage (msg) {
      var domMeg = document.createElement('div');
      domMeg.innerHTML = new Date().toLocaleTimeString() + ' ' + msg;
      msgArea.appendChild(domMeg);
    }

    // 3.開始処理
    var msgArea = document.getElementById("msg");
    var myName = Math.floor(Math.random()*100) + "さん";
    addMessage("貴方は" + myName + "として入室しました");
    start(myName);
  </script>
</body>
</html>

解説

主にscriptタグの中について見ていきます。
1.でイベントの準備、2.で機能実装、3.が入室された時の開始処理となります。

イベントの準備

connectedが開始イベントで、サーバにユーザ名を伝え、ユーザ入室情報が配信されます。
publishメッセージ配信イベントです。コールバックとして画面にメッセージを表示させます。
disconnectはブラウザを閉じたときなので何もせずサーバに処理を任せます。

開始処理

ユーザ名をランダムな数字でテキトーに生成してみました。

チャットアプリケーションを動かしてみる

入室イベントの確認

それでは使ってみましょう。3画面で連動性を確認します。

スクリーンショット 2014-05-18 14.00.18.png

入室したユーザにはランダムに生成された名前が振られます。
先に入室したユーザに後から入室したユーザの入室イベントが配信されています。

メッセージの送信確認

スクリーンショット 2014-05-18 14.02.19.png

メッセージを送信すると全ユーザに配信され、チャットが出来ています。

退出通知の配信

スクリーンショット 2014-05-18 14.03.12.png

一番上のブラウザを閉じてみました。
残されたユーザには退出イベントがメッセージで通知されます。

WebSocket通信の確認

という訳でもっとちゃんとしたアプリケーションにするには詰める部分は色々ありますが
簡易的なアプリケーションが実装できました!
ちなみにWebSocketとして動いている事も確認しておきます。

スクリーンショット 2014-05-18 14.15.17.png

4番目のリクエスト応答が101:SwitchingProtocolのステータスコードを返し、
各種ヘッダ情報もWebsocketの条件を満たした通信内容となっています。

Node.jsまとめ

というわけでここまでNode.jsをやってきましたが、次回より別のテーマに移ろうと思います。
ほそ道的Node.jsの雑感をまとめます。

  • Nodeの良いと思った点
    • 小規模で簡素なツール等を作るには相当強力かつ生産性が高い
    • 簡素なWebアプリケーションを作る分には記述量は少なく、色々なミドルウェアの準備も不要
    • アプリケーション構築の為に覚える言語が少なくて良い。サーバサイドもクライアントサイドもJsが出来れば良い。
  • Nodeの難しそうな点
    • 複雑な処理を組もうと思った場合に非同期の処理順番制御と高速性の担保等、設計時に考えるべき要素が多い。
    • コールバックが多くなり過ぎコードの可読性が下がる可能性がある。これも設計をしっかりやらないと破綻しそう。

まあちゃんとしたものを作るならそれなりの学習は必要ってことですね。
シンプルなものを作るときの爆速感は気に入りました。

今回は以上です。

次回はビルドツールなんぞを紹介しようと思います。

Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
Comments
Sign up for free and join this conversation.
If you already have a Qiita account
Why do not you register as a user and use Qiita more conveniently?
You need to log in to use this function. Qiita can be used more conveniently after logging in.
You seem to be reading articles frequently this month. Qiita can be used more conveniently after logging in.
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away