ネームスペース

名前空間

名前空間は、SocketIOサーバー内での機能やイベント処理の論理的な分離を提供します。 アプリケーションの異なる部分が、を使用して独立して動作できるようにします 単一の物理接続.

名前空間は別個のソケット接続を作成しません。 クライアントは一度接続し、同じ基礎となるWebSocket/TCPセッション上で複数の名前空間に参加できます。

---

デフォルト名前空間

クライアントが名前空間を指定せずに接続すると、デフォルト名前空間（"").

Configuration config = new Configuration();
config.setPort(9092);

SocketIOServer server = new SocketIOServer(config);
// デフォルト名前空間は暗黙的に存在します
server.start();

カスタム名前空間

カスタム名前空間はアプリケーションの関心事やイベントの範囲を分離します。

SocketIOServer server = new SocketIOServer(config);

Namespace chat = server.addNamespace("/chat");
Namespace admin = server.addNamespace("/auth");

server.start();

「/」を追加するのを忘れないでください。常に「/namespace」であり、「namespace」だけではありません。

各名前空間は次を定義します：

• 独自のイベントリスナー

• 独自の接続ライフサイクル

• 独自の認可ロジック

• 独自のブロードキャスト操作

---

公開名前空間の例（/chat)

その /chat 名前空間は公開されており、認証なしで一般的なメッセージングを許可します。

サーバー

Configuration config = new Configuration();
config.setPort(9092);

SocketIOServer server = new SocketIOServer(config);
Namespace chat = server.addNamespace("/chat");

// 新しいクライアント接続
chat.addConnectListener(client -> {
    log.info("[/chat] connected -> {}", client.getSessionId());
});

// メッセージイベント
chat.addEventListener("message", String.class, (client, data, ack) -> {
    // /chat 内のすべてのクライアントにブロードキャスト
    chat.getBroadcastOperations().sendEvent("message", data);
});

server.start();

クライアント

const chat = io("http://localhost:9092/chat");

chat.on("connect", () => console.log("connected to /chat"));
chat.emit("message", "hello everyone");

---

認証付き名前空間の例（/auth)

その /auth 名前空間は接続時に実行される認可ロジックを使用してアクセスを制限します。

サーバー

Configuration config = new Configuration();
config.setPort(9092);

SocketIOServer server = new SocketIOServer(config);
Namespace admin = server.addNamespace("/auth");

// 名前空間接続時にトークンを検証
admin.setAuthorizationListener(data -> {
    String token = data.getSingleUrlParam("token");
    return "secret123".equals(token);
});

// 特権アラートイベント
admin.addEventListener("alert", String.class, (client, data, ack) -> {
    admin.getBroadcastOperations().sendEvent("alert", data);
});

server.start();

認可されたクライアント

const auth = io("http://localhost:9092/auth", {
    query: { token: "secret123" }
});

admin.emit("alert", "restart service");

認可されていないクライアント

io("http://localhost:9092/auth", {
    query: { token: "invalid" }
});

サーバーの予想出力：

[/auth] authorization failed -> connection rejected

---