企业版Java核心概要简介

Annotations

Spring

备注

标记为资源

jakarta.annotation.Resource

org.springframework.stereotype.Repository

Resource用于指定EJB、WebService、Persistence等资源

属性/方法注入

jakarta.annotation.Resource

org.springframework.beans.factory.annotation.Autowired

@Resource默认按名称注入，找不到则按类型，支持从JNDI获取

顺序

jakarta.annotation.Priority

org.springframework.core.annotation.Order

@Priority的负值作为特殊用途

构造函数钩子

jakarta.annotation.PostConstruct

org.springframework.beans.factory.InitializingBean

Spring还支持其他init-method方式

析构函数钩子

jakarta.annotation.PreDestroy

org.springframework.beans.factory.DisposableBean

Spring还支持AutoCloseable等destroy-method方式

数据源

jakarta.annotation.sql.DataSourceDefinition

-

Spring可以通过在java配置类定义javax.sql.DataSource类型的bean

权限：定义角色

jakarta.annotation.security.DeclareRoles

-

Annotations还定义了其他权限相关注解

权限：资源角色

jakarta.annotation.security.RolesAllowed

org.springframework.security.access.annotation.Secured

spring-security的PreAuthorize注解支持表达式可以达到相同效果

权限：角色

jakarta.annotation.security.RunAs

-

Annotations还定义了其他权限相关注解

约束

jakarta.annotation.Nonnull
jakarta.annotation.Nullable

-

用于属性上则构造完不能/可能为null，用于方法上则返回值不能/可能为null

DI & CDI

spring-context

guice

备注

配置方式

annotation, xml

xml, properties, jdbc, java

java

类标记为bean

jakarta.enterprise.context.NormalScope
jakarta.enterprise.inject.Stereotype
jakarta.enterprise.context.Dependent

org.springframework.stereotype.Component

-

JakartaEE中注解带有NormalScope、Stereotype都被当作bean

定义bean

jakarta.enterprise.inject.Produces

org.springframework.context.annotation.Bean

com.google.inject.Provides

scope

jakarta.inject.Singleton
jakarta.enterprise.context.ApplicationScoped
jakarta.enterprise.context.SessionScoped
jakarta.enterprise.context.RequestScoped

singleton, prototype; session, request, refresh; custom

com.google.inject.Singleton

可以通过JakartaEE元注解jakarta.inject.Scope自定义scope

限定注册到上下文类型

jakarta.enterprise.inject.Typed

-

-

构造器注入

jakarta.inject.Inject

org.springframework.beans.factory.annotation.Autowired

com.google.inject.Inject

spring支持Resource、Inject注解

属性注入

jakarta.inject.Inject

org.springframework.beans.factory.annotation.Autowired

com.google.inject.Inject

方法注入

jakarta.inject.Inject

org.springframework.beans.factory.annotation.Autowired

com.google.inject.Inject

默认bean

jakarta.enterprise.inject.Default

org.springframework.context.annotation.Primary

-

guice可以通过ImplementedBy来指定默认实现类型

限定名称

jakarta.inject.Named

org.springframework.beans.factory.annotation.Qualifier

com.google.inject.name.Named

jakarta.inject.Qualifier在JakartaEE为元注解

可选依赖

jakarta.inject.Provider

java.util.Optional
org.springframework.beans.factory.annotation.Autowired(required=false)

java.util.Optional

延迟加载

jakarta.inject.Provider

org.springframework.context.annotation.Lazy

-

避免循环依赖

jakarta.inject.Provider

-

多实例注入

jakarta.inject.Provider

java.util.Collection
java.util.Map

-

bean销毁清理

jakarta.enterprise.inject.Disposes

org.springframework.beans.factory.DisposableBean

-

spring支持对Closeable类型自动发现销毁方法进行调用

上下文初始化通知

jakarta.enterprise.context.Initialized

org.springframework.context.event.ContextStartedEvent

-

上下文销毁前通知

jakarta.enterprise.context.BeforeDestroyed

-

-

上下文销毁通知

jakarta.enterprise.context.Destroyed

org.springframework.context.event.ContextStoppedEvent

-

产生事件

jakarta.enterprise.event.Event

org.springframework.context.ApplicationEventPublisher

-

CDI中通过注入的Event来产生同步/异步事件

事件处理

jakarta.enterprise.event.Observes
jakarta.enterprise.event.ObservesAsync

org.springframework.context.event.EventListener

-

SPI

jakarta.enterprise.inject.build.compatible.spi.Discovery
jakarta.enterprise.inject.build.compatible.spi.Enhancement
jakarta.enterprise.inject.build.compatible.spi.Registration
jakarta.enterprise.inject.build.compatible.spi.Synthesis
jakarta.enterprise.inject.build.compatible.spi.Validation

org.springframework.beans.factory.config.BeanFactoryPostProcessor
org.springframework.beans.factory.config.BeanPostProcessor

-

Interceptors

spring-aop

Aspectj

织入时机

runtime

runtime or load time

compile

标记为切面

jakarta.interceptor.Interceptor

org.springframework.aop.Advisor

org.aspectj.lang.annotation.Aspect

标记为切点

jakarta.interceptor.Interceptors

org.springframework.aop.Pointcut

org.aspectj.lang.annotation.Pointcut

方法执行前

-

org.springframework.aop.BeforeAdvice

org.aspectj.lang.annotation.Before

方法执行后

-

org.springframework.aop.AfterAdvice

org.aspectj.lang.annotation.After

方法返回后

-

org.springframework.aop.AfterReturningAdvice

org.aspectj.lang.annotation.AfterReturning

方法异常时

-

org.springframework.aop.ThrowsAdvice

org.aspectj.lang.annotation.AfterThrowing

环绕方法

jakarta.interceptor.AroundInvoke

-

org.aspectj.lang.annotation.Around

JSONB

jackson-json

guava

fastjson

带参构造函数反序列化

jakarta.json.bind.annotation.JsonbCreator

com.fasterxml.jackson.annotation.JsonCreator
com.fasterxml.jackson.annotation.JsonProperty
com.fasterxml.jackson.annotation.JacksonInject

objenesis

com.alibaba.fastjson.annotation.JSONCreator
com.alibaba.fastjson.annotation.JSONField

builder模式

-

com.fasterxml.jackson.databind.annotation.JsonPOJOBuilder

-

com.alibaba.fastjson.annotation.JSONType(builder = )
com.alibaba.fastjson.annotation.JSONPOJOBuilder

指定属性序列化时顺序

jakarta.json.bind.annotation.JsonbPropertyOrder

com.fasterxml.jackson.annotation.JsonPropertyOrder

-

com.alibaba.fastjson.annotation.JSONType(orders = )
com.alibaba.fastjson.annotation.JSONField(ordinal = )

属性别名

jakarta.json.bind.annotation.JsonbProperty

com.fasterxml.jackson.annotation.JsonProperty
com.fasterxml.jackson.annotation.JsonAlias

com.google.gson.annotations.SerializedName

com.alibaba.fastjson.annotation.JSONField(alternateNames = )

忽略属性

jakarta.json.bind.annotation.JsonbTransient

com.fasterxml.jackson.annotation.JsonIgnore
com.fasterxml.jackson.annotation.JsonIgnoreProperties
com.fasterxml.jackson.annotation.JsonIgnoreType

com.google.gson.annotations.Expose(serialize = false, deserialize = false)

com.alibaba.fastjson.annotation.JSONType(ignores = )
com.alibaba.fastjson.annotation.JSONField(serialize = false, deserialize = false)

指定日期格式化方式

jakarta.json.bind.annotation.JsonbDateFormat

com.fasterxml.jackson.annotation.JsonFormat

com.google.gson.GsonBuilder#setDateFormat

com.alibaba.fastjson.annotation.JSONField(format = )

指定数字格式化方式

jakarta.json.bind.annotation.JsonbNumberFormat

com.fasterxml.jackson.annotation.JsonFormat

-

com.alibaba.fastjson.annotation.JSONField(format = )

泛型

-

com.fasterxml.jackson.core.type.TypeReference

com.google.gson.reflect.TypeToken

com.alibaba.fastjson.TypeReference

多态

jakarta.json.bind.annotation.JsonbTypeInfo
jakarta.json.bind.annotation.JsonbSubtype

com.fasterxml.jackson.annotation.JsonTypeInfo
com.fasterxml.jackson.annotation.JsonSubTypes
com.fasterxml.jackson.databind.annotation.JsonTypeResolver

-

com.alibaba.fastjson.annotation.JSONType(seeAlso = {}, typeKey = )

自定义反序列化

jakarta.json.bind.annotation.JsonbTypeDeserializer

com.fasterxml.jackson.databind.annotation.JsonDeserialize

com.google.gson.JsonDeserializer

com.alibaba.fastjson.annotation.JSONType(deserializer = )

自定义序列化

jakarta.json.bind.annotation.JsonbTypeSerializer

com.fasterxml.jackson.databind.annotation.JsonSerialize

com.google.gson.JsonSerializer

com.alibaba.fastjson.annotation.JSONType(serializer = )

包/类属性可见性

jakarta.json.bind.annotation.JsonbVisibility

-

-

-

中间对象转换

jakarta.json.bind.annotation.JsonbTypeAdapter

-

com.google.gson.annotations.JsonAdapter

-

属性名映射策略

jakarta.json.bind.config.PropertyNamingStrategy

com.fasterxml.jackson.databind.annotation.JsonNaming
com.fasterxml.jackson.databind.PropertyNamingStrategy

com.google.gson.FieldNamingStrategy

com.alibaba.fastjson.annotation.JSONType(naming = )
com.alibaba.fastjson.PropertyNamingStrategy

mixin

-

org.springframework.boot.jackson.JsonMixin
com.fasterxml.jackson.annotation.JsonAnyGetter
com.fasterxml.jackson.annotation.JsonAnySetter

-

com.alibaba.fastjson.JSON.addMixInAnnotations(,)

注入上下文对象

-

com.fasterxml.jackson.annotation.JacksonInject

-

-

引用

-

com.fasterxml.jackson.annotation.JsonIdentityInfo
com.fasterxml.jackson.annotation.JsonIdentityReference

-

jsonpath

JSONP

jackson-json

guava

fastjson

解析JSON

jakarta.json.stream.JsonParser

com.fasterxml.jackson.core.JsonParser

com.google.gson.stream.JsonReader

com.alibaba.fastjson.parser.DefaultJSONParser

生成JSON

jakarta.json.stream.JsonGenerator

com.fasterxml.jackson.core.JsonGenerator

com.google.gson.stream.JsonWriter

com.alibaba.fastjson.serializer.JSONSerializer

JAX-RS & MVC

spring-webmvc

备注

控制器

jakarta.mvc.Controller

org.springframework.stereotype.Controller

spring-webmvc的Controller注解支持命名bean

URL映射

jakarta.ws.rs.Path

org.springframework.web.bind.annotation.RequestMapping

spring-webmvc的RequestMapping可以同时指定method, params, headers, consumes, produces

限定为GET方法

jakarta.ws.rs.GET

org.springframework.web.bind.annotation.GetMapping

同上

限定为POST方法

jakarta.ws.rs.POST

org.springframework.web.bind.annotation.DeleteMapping

同上

限定为PUT方法

jakarta.ws.rs.PUT

org.springframework.web.bind.annotation.PutMapping

同上

限定为DELETE方法

jakarta.ws.rs.DELETE

org.springframework.web.bind.annotation.DeleteMapping

同上

限定为PATCH方法

jakarta.ws.rs.PATCH

org.springframework.web.bind.annotation.PatchMapping

同上。注意：非幂等，对资源进行部分修改

限定为OPTIONS方法

jakarta.ws.rs.OPTIONS

-

spring-webmvc在HandlerMapping中识别预检请求，根据跨域配置决定放行还是拒绝

限定为HEAD方法

jakarta.ws.rs.HEAD

-

获取文件大小用。spring-webmvc无对应方式，可通过GetMapping变通实现

限定为TRACE方法

-

-

限定消费的媒体类型

jakarta.ws.rs.Consumes

org.springframework.web.bind.annotation.RequestMapping(consumes = )

限定产生的媒体类型

jakarta.ws.rs.Produces

org.springframework.web.bind.annotation.RequestMapping(produces = )

绑定请求头

jakarta.ws.rs.HeaderParam

org.springframework.web.bind.annotation.RequestHeader

Jakarta MVC的绑定参数如果是复杂对象，需要实现ParamConverterProvider并注册到容器

绑定Cookie

jakarta.ws.rs.CookieParam

org.springframework.web.bind.annotation.CookieValue

同上

绑定session

-

org.springframework.web.bind.annotation.SessionAttribute

绑定简单查询参数

jakarta.ws.rs.QueryParam

org.springframework.web.bind.annotation.RequestParam

绑定矩阵查询参数

jakarta.ws.rs.MatrixParam

org.springframework.web.bind.annotation.MatrixVariable

绑定路径模板参数

jakarta.ws.rs.PathParam

org.springframework.web.bind.annotation.PathVariable

绑定表单参数

jakarta.ws.rs.FormParam

-

MIME类型需为"
application/x-www-form-urlencoded"。Spring MVC无需注解，使用java bean会自动绑定

绑定请求体

java.lang.Object

org.springframework.web.bind.annotation.RequestBody

Jakarta MVC支持将RequestScoped的bean作为属性注入Controller

绑定上传的文件

-

org.springframework.web.bind.annotation.RequestPart

Jakarta MVC无注解绑定文件

绑定请求属性

-

org.springframework.web.bind.annotation.RequestAttribute

设置默认值

jakarta.ws.rs.DefaultValue

org.springframework.web.bind.annotation.*(defaultValue = )

spring-webmvc的RequestHeader、CookieValue、RequestParam、MatrixVariable支持默认值

返回视图

java.lang.String
jakarta.mvc.View

java.lang.String
org.springframework.web.servlet.View

Jakarta MVC的@View注解用于返回固定的默认视图

返回模型和视图

jakarta.mvc.Models

org.springframework.web.servlet.ModelAndView

返回响应码

-

org.springframework.web.bind.annotation.ResponseStatus

Jakarta MVC无对应注解，可通过
jakarta.ws.rs.core.Response实现

返回响应体

java.lang.Object

org.springframework.web.bind.annotation.ResponseBody

Jakarta MVC通过在实现了MessageBodyWriter和MessageBodyReader的类上标记Provider来自动编解码

全局异常处理

jakarta.ws.rs.ext.ExceptionMapper

org.springframework.web.bind.annotation.ExceptionHandler

Jakarta MVC需要用@Provider注解标记实现类，将其注册到容器

编码

jakarta.ws.rs.ext.MessageBodyWriter

org.springframework.http.codec.HttpMessageWriter

解码

jakarta.ws.rs.ext.MessageBodyReader

org.springframework.http.codec.HttpMessageReader

@Encoded仅用于标记无需解码

参数转换

jakarta.ws.rs.ext.ParamConverter

org.springframework.http.converter.HttpMessageConverter

参数校验

jakarta.validation.Valid

org.springframework.validation.annotation.Validated

spring-webmvc也支持规范的注解，但自定义注解支持分组校验；Jakarta MVC支持用MvcBinding，将违规约束放到注入的BindingResult

跨域

jakarta.mvc.security.CsrfProtected

org.springframework.web.bind.annotation.CrossOrigin

本地化

jakarta.mvc.locale.LocaleResolver

org.springframework.web.servlet.LocaleResolver

Jakarta MVC支持注入MvcContext来过程控制

异步

jakarta.ws.rs.container.Suspended

org.springframework.scheduling.annotation.Async

SSE

jakarta.ws.rs.Produces(MediaType.SERVER_SENT_EVENTS)

org.springframework.web.servlet.mvc.method.annotation.ResponseBodyEmitter

JAXB

XStream

jackson-dataformat-xml

绑定attribute

jakarta.xml.bind.annotation.XmlAttribute

com.thoughtworks.xstream.annotations.XStreamAsAttribute

com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty(isAttribute=true)

绑定元素

jakarta.xml.bind.annotation.XmlElement

com.thoughtworks.xstream.annotations.XStreamAlias

com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty

绑定通配attribute

jakarta.xml.bind.annotation.XmlAnyAttribute

-

-

绑定通配元素

jakarta.xml.bind.annotation.XmlAnyElement

-

-

映射元素值

jakarta.xml.bind.annotation.XmlValue

com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlText

映射附件

jakarta.xml.bind.annotation.XmlAttachmentRef

-

-

映射工厂方法到元素

jakarta.xml.bind.annotation.XmlRegistry
jakarta.xml.bind.annotation.XmlElementDecl

-

-

解组对象生成方式

jakarta.xml.bind.annotation.XmlType(factoryClass= , factoryMethod=)

-

-

包映射XML命名空间

jakarta.xml.bind.annotation.XmlSchema

-

-

标记类可编组为XML

jakarta.xml.bind.annotation.XmlRootElement

default

com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlRootElement

映射类到XML Schema

jakarta.xml.bind.annotation.XmlType

com.thoughtworks.xstream.annotations.XStreamAliasType

-

指定编组范围

jakarta.xml.bind.annotation.XmlAccessorType

-

-

忽略类/属性/方法

jakarta.xml.bind.annotation.XmlTransient

com.thoughtworks.xstream.annotations.XStreamOmitField

-

属性编组顺序

jakarta.xml.bind.annotation.XmlAccessorOrder
jakarta.xml.bind.annotation.XmlType(propOrder={})

-

-

属性类型映射XML内建类型

jakarta.xml.bind.annotation.XmlSchemaType

-

属性编组为XML ID

jakarta.xml.bind.annotation.XmlID

-

-

属性编组为XML IDREF

jakarta.xml.bind.annotation.XmlIDREF

-

-

属性编组为base64数据

jakarta.xml.bind.annotation.XmlMimeType
jakarta.xml.bind.annotation.XmlInlineBinaryData

-

-

枚举值编组

jakarta.xml.bind.annotation.XmlEnum
jakarta.xml.bind.annotation.XmlEnumValue

-

-

list属性编组为简单类型

jakarta.xml.bind.annotation.XmlList

-

-

多态

jakarta.xml.bind.annotation.XmlSeeAlso
jakarta.xml.bind.annotation.XmlElementRef

com.thoughtworks.xstream.annotations.XStreamInclude

-

混杂内容

jakarta.xml.bind.annotation.XmlMixed

-

-

编解组带包装元素

jakarta.xml.bind.annotation.XmlElementWrapper

com.thoughtworks.xstream.annotations.XStreamImplicit

com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlElementWrapper

CDATA

-

-

com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlCData

自定义编解组

jakarta.xml.bind.annotation.adapters.XmlJavaTypeAdapter

com.thoughtworks.xstream.annotations.XStreamConverter

-