Namespace

Namespaces

Namespaces bieten eine logische Trennung von Funktionen und Ereignisbehandlung innerhalb des SocketIO-Servers. Sie ermöglichen verschiedenen Teilen einer Anwendung, unabhängig zu arbeiten, indem sie ein einzelne physische Verbindung.

Namespaces erstellen keine separaten Socket-Verbindungen. Ein Client verbindet sich einmal und kann mehrere Namespaces über dieselbe zugrunde liegende WebSocket-/TCP-Sitzung betreten.

---

Standard-Namespace

Wenn sich ein Client verbindet, ohne einen Namespace anzugeben, wird er dem Standard-Namespace angehängt ("").

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

SocketIOServer server = new SocketIOServer(config);
// Standard-Namespace existiert implizit
server.start();

Benutzerdefinierter Namespace

Benutzerdefinierte Namespaces trennen Anwendungsbelange und Ereignisbereiche.

SocketIOServer server = new SocketIOServer(config);

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

server.start();

Bitte vergessen Sie nicht, "/" hinzuzufügen, es ist immer "/namespace" NICHT nur "namespace".

Jeder Namespace definiert:

• seine eigenen Ereignis-Listener

• seinen eigenen Verbindungslebenszyklus

• seine eigene Autorisierungslogik

• seine eigenen Broadcast-Operationen

---

Beispiel für einen öffentlichen Namespace (/chat)

Die /chat Namespace ist offen und ermöglicht allgemeine Nachrichtenübermittlung ohne Authentifizierung.

Server

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

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

// neue Client-Verbindung
chat.addConnectListener(client -> {
    log.info("[/chat] connected -> {}", client.getSessionId());
});

// Nachrichtereignis
chat.addEventListener("message", String.class, (client, data, ack) -> {
    // Broadcast an alle Clients in /chat
    chat.getBroadcastOperations().sendEvent("message", data);
});

server.start();

Client

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

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

---

Beispiel für einen authentifizierten Namespace (/auth)

Die /auth Namespace beschränkt den Zugriff mithilfe einer Autorisierungslogik, die während der Verbindung ausgeführt wird.

Server

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

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

// Token beim Namespace-Connect verifizieren
admin.setAuthorizationListener(data -> {
    String token = data.getSingleUrlParam("token");
    return "secret123".equals(token);
});

// privilegiertes Alert-Ereignis
admin.addEventListener("alert", String.class, (client, data, ack) -> {
    admin.getBroadcastOperations().sendEvent("alert", data);
});

server.start();

Autorisierter Client

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

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

Nicht autorisierter Client

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

Erwartete Serverausgabe:

[/auth] authorization failed -> connection rejected

---