HttpRequest

HttpMethod虽然它被设计为final class而非enum（出于历史兼容性考虑），但它的作用与枚举完全一致：为 HTTP 协议中定义的 8 种标准请求方法提供类型安全的常量，并允许扩展非标准方法。下面我将其拆解为三个层次，详细解释每一部分的设计意图和实际用途。1. 类定义与整体设计publicfinalclassHttpMethodimplementsComparableHttpMethod,Serializable{// ...}final class：表示该类不能被继承，确保所有实例的行为都是确定且统一的。ComparableHttpMethod：实现自然排序，基于方法名称的字符串顺序（如DELETEGET）。主要用于集合排序。Serializable：允许HttpMethod对象在网络传输或序列化到磁盘时保持状态（例如在分布式缓存或 RPC 调用中）。设计意图：在 Spring 3.0 之前，HttpMethod是一个普通的enum。后来为了允许用户自定义非标准 HTTP 方法（如 WebDAV 的PROPFIND），Spring 将其改为final class，同时保留预定义常量。这种设计既提供了类型安全，又保持了扩展性。2. 预定义常量（标准 HTTP 方法）类中定义了 8 个public static final常量，对应 HTTP/1.1 规范（RFC 2616）及 PATCH（RFC 5789）中的所有方法：常量名对应方法典型用途GETGET请求获取资源（安全、幂等）HEADHEAD仅获取响应头，不返回实体（安全、幂等）POSTPOST创建新资源或提交数据（非安全、非幂等）PUTPUT完整更新资源（幂等）PATCHPATCH部分更新资源（非幂等）DELETEDELETE删除资源（幂等）OPTIONSOPTIONS查询服务器支持的 HTTP 方法（安全、幂等）TRACETRACE回显服务器收到的请求（用于诊断，常被禁用）每个常量的注释都引用了相应的 RFC 文档，方便开发者查阅标准。实现细节：每个常量都是通过私有构造器new HttpMethod("GET")创建的，因此所有预定义常量都是该类的单例实例。3. 核心静态方法values()publicstaticHttpMethod[]values(){HttpMethod[]copy=newHttpMethod[values.length];System.arraycopy(values,0,copy,0,values.length);returncopy;}作用：返回所有预定义常量的副本数组，避免外部修改内部数组。用法：类似枚举的values()，通常用于遍历或转换为集合。valueOf(String method)publicstaticHttpMethodvalueOf(Stringmethod){Assert.notNull(method,"Method must not be null");returnswitch(method){case"GET"-GET;case"HEAD"-HEAD;// ...default-newHttpMethod(method);};}作用：将字符串转换为HttpMethod对象。关键行为：如果字符串匹配预定义常量（区分大小写，必须是大写），则返回对应的单例。如果字符串不匹配，则创建一个新的HttpMethod实例（例如"PROPFIND"）。注意：这意味着HttpMethod.valueOf("get")会返回一个新对象，且该对象与HttpMethod.GET不相等（equals比较字符串名称）。这种设计使得任何字符串都能被包装为HttpMethod，但只有标准方法才拥有单例。4. 实例方法name()返回 HTTP 方法名称的字符串（如"GET"）。matches(String method)判断当前对象的方法名是否与给定字符串相等（区分大小写）。等价于name().equals(method)，但更语义化。compareTo(HttpMethod other)基于name的字典序进行比较，符合Comparable契约。equals/hashCode/toString重写自Object，均基于name字段。因此两个不同实例但名称相同（如new HttpMethod("GET")和HttpMethod.GET）会被视为相等，但实际开发中不会这样使用。5. 设计亮点与实战关联类型安全与扩展性的平衡类型安全：方法参数使用HttpMethod而非String，防止拼写错误。扩展性：允许创建任意非标准方法对象，而无需修改类定义，适配了 WebDAV、自定义 REST 动词等场景。在 Spring 生态中的广泛应用RestTemplate、WebClient、@RequestMapping等均使用HttpMethod作为参数或属性。在WebSocket 握手场景中，握手请求本身就是一个 HTTP 升级请求，其方法通常是GET。因此HttpMethod.GET在HandshakeInterceptor中会被用来判断请求类型。与你的聊天软件的联系在你的HandshakeInterceptor实现中，可以通过ServerHttpRequest.getMethod()获取请求方法：if(request.getMethod()!=HttpMethod.GET)