寻求javax.validation.constraints.@Email注解字段校验规则的官方文档获取途径

刚好对这个Bean Validation里的常用注解比较熟悉，来给你详细说明：

一、@Email的具体校验规则 #

首先要明确：@Email是Bean Validation规范（JSR-303/JSR-380）定义的标准注解，它的基础语义是校验字段值是否符合邮箱格式，但具体的校验逻辑会由不同的实现（比如最常用的Hibernate Validator）来落地，细节上会有差异：

• 默认校验逻辑（以Hibernate Validator为例）：
  • 采用实用主义的正则表达式 ^[a-zA-Z0-9_!#$%&'*+/=?{|}~^.-]+@[a-zA-Z0-9.-]+$` 进行匹配
  • 这个规则会覆盖绝大多数日常使用的邮箱格式，但没有严格遵循RFC 5322的所有细节（比如不支持带引号的本地部分、注释内容等），属于兼顾兼容性和实用性的方案
• 可自定义的校验规则：
  • 通过regexp参数指定自定义正则，完全替换默认校验逻辑，比如你可以定义更严格的企业邮箱格式
  • 用flags参数配合regexp设置正则的匹配标志（例如Pattern.CASE_INSENSITIVE忽略大小写）
  • 其他通用参数：message自定义校验失败提示语，groups用于分组校验，payload携带自定义元数据

二、官方文档的获取方式 #

1. 查看源码Javadoc
   这是最直接的方式——在IDE里直接打开javax.validation.constraints.Email类，它的注释里会明确说明注解的用途、参数含义，以及默认实现的行为约束。比如注释里会提到："Accepts all valid email addresses as defined by RFC 5322, with the exception of comments and whitespace folding."

2. Bean Validation规范文档
   @Email属于JSR-303（Bean Validation 1.0）和JSR-380（Bean Validation 2.0）的标准注解，规范文档里会定义注解的通用语义、可选参数的作用，不过不会涉及具体实现的细节（比如具体正则）。

3. 具体实现的官方文档
   如果你使用的是Hibernate Validator（绝大多数Java项目的默认实现），它的官方文档里会详细说明@Email的默认校验规则、正则细节，以及自定义规则的方法。

内容的提问来源于stack exchange，提问作者Possenti