Spring注解开发

目录

1、简介

2、原始注解

2.1、注解种类

2.2、组件扫描

2.3、具体使用

2.3.1、xml配置

2.3.2、注解配置

3、⭐新注解

3.1、新注解种类

3.2、实践

3.3、运行结果

3.4、警告信息

---

1、简介

Spring框架提供了许多注解，用于在Java类中进行配置和标记，以实现依赖注入、AOP、Web MVC和其他功能。这些注解可以使配置更加简洁，代码更易读，减少了传统XML配置的繁琐性。

以下是一些常用的Spring注解及其功能：

①组件注解：@Component、@Controller、@Service、@Repository

②依赖注入注解：@Autowired、@Qualifier、@Value

③Web MVC注解：@RequestMapping、@RequestParam、@PathVariable、@ResponseBody

④AOP注解：@Aspect

⑤事务注解：@Transactional

⑥配置类注解：@Configuration、@Bean

⑦作用域注解：@Scope

⑧生命周期注解：@PostConstruct、@PreDestroy

2、原始注解

Spring是轻代码而重配置的框架，配置比较繁重，影响开发效率，所以注解开发是一种趋势。

注解代替xml配置文件可以简化配置，提高开发效率。

Spring原始注解主要是替代<Bean>的配置。

2.1、注解种类

注解名	描述
@Component	将一个类标记为Spring组件，表示它会被自动扫描并注册为一个Bean。
@Controller	将一个类标记为Spring MVC的控制器，用于处理请求和响应。
@Service	将一个类标记为业务逻辑的服务层组件，通常用于Service层的类。
@Repository	将一个类标记为数据访问层组件，通常用于DAO层的类。
@Autowired	自动注入依赖对象。Spring会自动查找匹配类型的Bean，并注入到对应的字段、构造函数或方法中。
@Qualifier	与@Autowired一起使用，用于指定具体的Bean名称，解决多个匹配类型的Bean自动注入的问题。
@Value	注入一个常量值或表达式(普通属性)，可以用于字段、方法或构造函数参数。
@Scope	标注Bean的作用范围
@PostConstruct	使用在方法上标注该方法是Bean的初始化方法
@PreDestroy	使用在方法上标注该方法是Bean的销毁方法
@RequestMapping	将请求URL映射到控制器的处理方法上，指定处理请求的URL路径。
@Aspect	定义一个切面，结合其他注解，可以实现切面的功能，如AOP。
@Transactional	标记一个方法或类需要事务支持，Spring将在方法执行时开启事务，支持回滚等操作。
@Configuration	定义配置类，通常与@Bean一起使用，用于替代XML配置文件。

@Resource：相当于@Autowired+@Qualifier，按照名称进行注入。

这是Java EE规范提供的一个注解，功能与spring的@Autowired+@Qualifier相同。

2.2、组件扫描

使用注解进行开发时，需要在applicationContext.xml中配置组件扫描，作用是指定哪个包及其子包下的Bean

需要进行扫描以便识别使用注解配置的类、字段和方法：

2.3、具体使用

2.3.1、xml配置

先回顾一下三重架构：

首先在dao包下定义一个接口类UserDao，定义实现类UserDaoImpl_xmlConfig；

然后在Service包下定义一个接口类UserService，定义实现类UserServiceImpl_xmlConfig；

最后在spring的配置文件配置bean。

java代码如下：

2.3.2、注解配置

注解开发注入对象的时候，不需要提供set方法。

首先在dao包下定义一个接口类UserDao，定义实现类UserDaoImpl_annotation；

然后在Service包下定义一个接口类UserService，定义实现类UserServiceImpl_annotation；

最后在配置文件applicationContext-annotation.xml中开启包扫描，然后导入applicationContext.xml：

dao层：

使用@Repository标记类UserDaoImpl_annotation：

value的默认值是""，在注解这里配置的value就是相当于xml配置文件中的id。

service层：

①使用@Service标记类UserServiceImpl_annotation：

这里的value依旧相当于xml配置中的id。

②使用(@Autowired和@Qualifier)或@Resource注解标记需要注入的对象，这里是UserDao对象(实际上是它的实现类)：

③使用@Value注入普通对象，这里注入spring容器中加载的jdbc配置文件的内容：

④使用@PostConstruct标记初始化方法(程序开始运行后执行)：

⑤使用@PreDestroy标记销毁方法(程序结束之前执行)：

3、⭐新注解

可以看到，spring的原始注解还无法完全替代applicationContext.xml，现在的applicationContext.xml中还存在的内容有：

所以，新注解需要解决的问题有：

1. 加载properties文件的配置：<context:property-placeholder>
2. 引入其他文件：<import>
3. 组件扫描的配置：<context:component-scan>
4. 非自定义的Bean的配置：<bean>

3.1、新注解种类

注解	用途
@Configuration	用于指定当前类是一个 Spring 配置类，当创建容器时会从该类上加载注解
@PropertySource	用于加载 properties 文件中的配置
@Import	用于导入其他配置类
@ComponentScan	用于指定 Spring 在初始化容器时要扫描的包
@Bean	使用在方法上，标注将该方法的返回值存储到 Spring 容器中

3.2、实践

代码：

package com.xzl.config;

import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Import;

/**
 * @author 逐梦苍穹
 * @date 2023/7/21 16:21
 */
@Configuration
@Import(value = {jdbcConfiguration.class,SpringConfiguration_ComponentScan.class})
//@Import({jdbcConfiguration.class})
//@ComponentScan("com.xzl")
public class SpringConfiguration {
}

package com.xzl.config;

import com.alibaba.druid.pool.DruidDataSource;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.PropertySource;

import javax.sql.DataSource;

/**
 * @author 逐梦苍穹
 * @date 2023/7/21 16:22
 */
@PropertySource("classpath:jdbc.properties")
public class jdbcConfiguration {
    @Value("${jdbc.driver}")
    private String driver;

    @Value("${jdbc.url}")
    private String url;

    @Value("${jdbc.username}")
    private String username;

    @Value("${jdbc.password}")
    private String password;

    //容器获取非自定义Bean对象
    @Bean("dataSource_druid")
    public DataSource getDataSourceJDBC(){
        DruidDataSource dataSource = new DruidDataSource();
        dataSource.setDriverClassName(driver);
        dataSource.setUrl(url);
        dataSource.setUsername(username);
        dataSource.setPassword(password);
        return dataSource;
    }
}

package com.xzl.config;

/**
 * @author 逐梦苍穹
 * @date 2023/7/21 16:38
 */

import org.springframework.context.annotation.ComponentScan;

@ComponentScan("com.xzl")
public class SpringConfiguration_ComponentScan {
}

3.3、运行结果

web测试代码：

3.4、警告信息

这里运行的时候会出现警告信息：

这些警告信息与使用的 JDK 版本相关。从 JDK 9 开始，Java 引入了新的访问控制机制，限制了对 Java 核心类的反射访问。这个限制主要是为了增强 Java 的安全性和稳定性。在 JDK 9 及更高版本中，默认情况下，对于某些敏感的、不稳定的 API，JVM 会输出警告信息，提醒开发者尽量避免使用这些 API。

在警告信息中，是因为 Spring 框架中的 CGLIB 库使用了一些在 JDK 9 中被认为是不稳定的 API，所以会触发这些警告。这些警告并不是错误，不会影响 Spring 框架的正常运行，但是可能在未来的 JDK 版本中导致一些不兼容性问题。

要解决这些警告，可以尝试以下方法之一：

1. 使用 JDK 8 或更低版本：如果你的项目没有特别需要使用 JDK 9 及更高版本的功能，可以考虑切换回 JDK 8 或更低版本，这样就不会触发这些警告。
2. 使用 --illegal-access=warn 参数：在启动应用程序时，可以添加 --illegal-access=warn JVM 参数，将这些警告设置为警告级别，从而让你在启动时看到警告信息。这样的设置可以帮助你识别潜在的问题。
3. 使用 JDK 9+ 的 --add-opens 参数：如果你的项目必须使用 JDK 9 及更高版本，你可以尝试使用 --add-opens JVM 参数，来显式地为某些包或模块打开访问权限。例如，你可以尝试使用 --add-opens java.base/java.lang=ALL-UNNAMED 来为 java.lang 包打开权限。

无论选择哪种方法，都应该考虑将项目升级到更新版本的 Spring 和 JDK，以便与最新的 Java 特性和安全性保持一致。