EndpointConfig端点配置类使用

EndpointConfig 是Spring WebSocket框架中的一个接口,用于配置WebSocket端点(Endpoint)。它提供了访问WebSocket端点配置信息的方法,这些信息在处理WebSocket连接时非常有用。以下是对 EndpointConfig 的详细介绍:

接口定义

EndpointConfig 接口位于 javax.websocket.server 包中,它是Java WebSocket API(JSR 356)的一部分。Spring WebSocket框架也提供了对这个接口的支持。

主要方法

  1. 返回一组类,这些类是在配置过程中传递给 EndpointConfig 的:Set<Class<?>> getClasses()

  2. 获取指定名称的初始化参数值:String getInitParam(String name)

  3. 获取所有的初始化参数:Map<String, String> getInitParams()

  4. 获取与当前WebSocket连接关联的用户主体(Principal):Principal getUserPrincipal()

  5. 检查当前用户是否具有指定的角色:boolean isUserInRole(String role)

  6. 获取路径参数的映射:Map<String, String> getPathParameters()

  7. 获取解码器列表:List<Class<? extends Decoder>> getDecoders()

  8. 获取编码器列表:List<Class<? extends Encoder>> getEncoders()

使用场景

  1. 初始化参数配置

    在配置中设置一些初始化参数,并在 Endpoint 中通过 EndpointConfig 访问这些参数。

  2. 用户认证和授权

    通过 getUserPrincipal()isUserInRole() 方法,你可以在连接建立时检查用户的身份和角色。

  3. 路径参数

    如果你的WebSocket端点URL中有路径参数,可以通过 getPathParameters() 方法获取这些参数。

  4. 编解码器

    配置自定义的编解码器,并在 Endpoint 中通过 getDecoders()getEncoders() 方法访问它们。

示例代码

如何在 Endpoint 中使用 EndpointConfig

java 复制代码
// 自定义配置器
public class ChatEndpointConfigurator extends ServerEndpointConfig.Configurator {

    @Override
    public void modifyHandshake(ServerEndpointConfig sec, HandshakeRequest request, HandshakeResponse response) {
        // 设置初始化参数
        sec.getUserProperties().put("myInitParam", "Hello, World!");

        // 设置路径参数
        Map<String, List<String>> pathParams = request.getUri().getQueryParameters();
        sec.getUserProperties().put("userId", pathParams.getFirst("userId"));

        // 设置用户主体
        Principal userPrincipal = new Principal() {
            @Override
            public String getName() {
                return "user123";
            }
        };
        sec.getUserProperties().put("javax.websocket.endpoint.principal", userPrincipal);
    }
}


@ServerEndpoint(value = "/chat", configurator = ChatEndpointConfigurator.class)
public class ChatEndpoint {

    @OnOpen
    public void onOpen(Session session, EndpointConfig config) {
        // 获取初始化参数
        String initParam = config.getInitParam("myInitParam");
        System.out.println("Init Param: " + initParam);

        // 获取路径参数
        Map<String, String> pathParams = config.getPathParameters();
        String userId = pathParams.get("userId");
        System.out.println("User ID: " + userId);

        // 获取用户主体
        Principal userPrincipal = config.getUserPrincipal();
        if (userPrincipal != null) {
            System.out.println("User Principal: " + userPrincipal.getName());
        }

        // 检查用户角色
        boolean isAdmin = config.isUserInRole("admin");
        System.out.println("Is Admin: " + isAdmin);
    }
}

完整WebSocket使用demo

WebSocket简易聊天室实现(有详细解释)-CSDN博客

相关推荐
信奥卷王3 分钟前
[GESP202503 五级] 原根判断
java·数据结构·算法
小咕聊编程11 分钟前
【含文档+源码】基于SpringBoot的过滤协同算法之网上服装商城设计与实现
java·spring boot·后端
Zz_waiting.12 分钟前
Spring 原理
java·spring·spring自动管理
瓯雅爱分享4 小时前
Java+Vue构建的采购招投标一体化管理系统,集成招标计划、投标审核、在线竞价、中标公示及合同跟踪功能,附完整源码,助力企业实现采购全流程自动化与规范化
java·mysql·vue·软件工程·源代码管理
猫头虎6 小时前
如何查看局域网内IP冲突问题?如何查看局域网IP环绕问题?arp -a命令如何使用?
网络·python·网络协议·tcp/ip·开源·pandas·pip
mit6.8247 小时前
[C# starter-kit] 命令/查询职责分离CQRS | MediatR |
java·数据库·c#
诸神缄默不语7 小时前
Maven用户设置文件(settings.xml)配置指南
xml·java·maven
任子菲阳7 小时前
学Java第三十四天-----抽象类和抽象方法
java·开发语言
学Linux的语莫7 小时前
机器学习数据处理
java·算法·机器学习
找不到、了7 小时前
JVM的即时编译JIT的介绍
java·jvm