Espacio de nombres

Espacios de nombres

Los espacios de nombres proporcionan separación lógica de características y manejo de eventos dentro del servidor SocketIO. Permiten que diferentes partes de una aplicación funcionen de forma independiente usando una conexión física única.

Los espacios de nombres no crean conexiones de socket separadas. Un cliente se conecta una vez y puede unirse a múltiples espacios de nombres sobre la misma sesión subyacente WebSocket/TCP.

---

Espacio de nombres predeterminado

Si un cliente se conecta sin especificar un espacio de nombres, se adjunta al espacio de nombres predeterminado ("").

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

SocketIOServer server = new SocketIOServer(config);
// el espacio de nombres predeterminado existe de forma implícita
server.start();

Espacio de nombres personalizado

Los espacios de nombres personalizados separan las preocupaciones de la aplicación y los ámbitos de eventos.

SocketIOServer server = new SocketIOServer(config);

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

server.start();

Por favor no olvides añadir "/", siempre es "/namespace" NO solo "namespace".

Cada espacio de nombres define:

• sus propios escuchadores de eventos

• su propio ciclo de vida de conexión

• su propia lógica de autorización

• sus propias operaciones de difusión

---

Ejemplo de espacio de nombres público (/chat)

El /chat espacio de nombres está abierto y permite mensajería general sin autenticación.

Servidor

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

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

// nueva conexión de cliente
chat.addConnectListener(client -> {
    log.info("[/chat] connected -> {}", client.getSessionId());
});

// evento de mensaje
chat.addEventListener("message", String.class, (client, data, ack) -> {
    // difundir a todos los clientes en /chat
    chat.getBroadcastOperations().sendEvent("message", data);
});

server.start();

Cliente

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

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

---

Ejemplo de espacio de nombres autenticado (/auth)

El /auth el espacio de nombres restringe el acceso usando lógica de autorización ejecutada durante la conexión.

Servidor

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

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

// verificar token al conectar al espacio de nombres
admin.setAuthorizationListener(data -> {
    String token = data.getSingleUrlParam("token");
    return "secret123".equals(token);
});

// evento privilegiado de alerta
admin.addEventListener("alert", String.class, (client, data, ack) -> {
    admin.getBroadcastOperations().sendEvent("alert", data);
});

server.start();

Cliente autorizado

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

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

Cliente no autorizado

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

Salida esperada del servidor:

[/auth] authorization failed -> connection rejected

---