本篇文章主要是针对于要入手Spring Boot的小白们,可以快速的上手使用Spring Boot!
1.Spring Boot介绍
Spring Boot它本身并不提供Spring框架的核心特性以及扩展功能,只是用于快速、敏捷地开发新一代基于Spring框架的应用程序。
同时它集成了大量常用的第三方库配置(例如Jackson, JDBC, Mongo, Redis, Mail等等)
Spring Boot应用中这些第三方库几乎可以零配置的开箱即用(out-of-the-box),大部分的Spring Boot应用都 只需要非常少量的配置代码,开发者能够更加专注于业务逻辑。
优点:
1)快速的创建应用
2)使用嵌入式servlet容器,生成可直接运行的jar包,简化部署
3)大量的自动配置简化开发
4)starters自动依赖于版本控制
2.创建一个Spring Boot项目(idea 2023版)
1)选择生成Spring Boot项目的生成器
2)选择aliyun的服务器地址(想要MVC架构的可以点进去生成代码)
3)选择JDK1.8和Java8版本
4)选择Spring Boot的版本,还可以勾选所需要的依赖项
注意:用的JDK1.8,Spring Boot的版本不能是以3开头
3.创建一个Spring Boot项目(idea 2019版)
idea2019想创建JDK1.8的Spring Boot项目只能进行图中步骤去下载代码,若要用Spring Boot官方地址,那就不能用JDK1.8了,因为版本太低了,不支持!
4.常用注解
@SpringBootApplication | 这是 Spring Boot 最最最核心的注解,用在 Spring Boot 主类上,标识这是一个 Spring Boot 应用,用来开启 Spring Boot 的各项能力。其实这个注解就是 @SpringBootConfiguration、@EnableAutoConfiguration、@ComponentScan 这三个注解的组合,也可以用这三个注解来代替 @SpringBootApplication 注解 |
@Configuration | 基于JavaConfig的配置形式,相当于xml配置文件中的bean配置,任何一个标注了@Bean的方法,其返回值将作为一个bean定义注册到Spring的IoC容器,方法名将默认成该bean定义的id |
@ComponentScan | 功能其实就是自动扫描并加载符合条件的组件(比如@Component和@Repository等)或者bean定义,最终将这些bean定义加载到IoC容器中。我们可以通过basePackages等属性来细粒度的定制@ComponentScan自动扫描的范围,如果不指定,则默认Spring框架实现会从声明@ComponentScan所在类的package进行扫描。(注:所以SpringBoot的启动类最好是放在root package下,因为默认不指定basePackages。) |
@EnableAutoConfiguration | 借助@Import的支持,收集和注册特定场景相关的bean定义。允许 Spring Boot 自动配置注解,开启这个注解之后,Spring Boot 就能根据当前类路径>下的包或者类来配置 Spring Bean |
@SpringBootConfiguration | 这个注解就是 @Configuration 注解的变体,只是用来修饰是 Spring Boot 配置而已,或者可利于 Spring Boot 后续的扩展 |
@Conditional | 这是 Spring 4.0 添加的新注解,用来标识一个 Spring Bean 或者 Configuration 配置文>件,当满足指定的条件才开启配置 |
@ConditionalOnBean | 组合 @Conditional 注解,当容器中有指定的 Bean 才开启配置 |
@ConditionalOnMissingBean | 组合 @Conditional 注解,和 @ConditionalOnBean 注解相反,当容器中没有指定的 Bean 才开启配置 |
@ConditionalOnClass | 组合 @Conditional 注解,当容器中有指定的 Class 才开启配置 |
@ConditionalOnMissingClass | 组合 @Conditional 注解,和 @ConditionalOnMissingClass 注解相反,当容器中没有指定的 Class 才开启配置 |
@ConditionalOnWebApplication | 组合 @Conditional 注解,当前项目类型是 WEB 项目才开启配置 |
@ConditionalOnNotWebApplication | 组合 @Conditional 注解,和 @ConditionalOnWebApplication 注解相反,当前项目类型不是 WEB 项目才开启配置 |
@ConditionalOnProperty | 组合 @Conditional 注解,当指定的属性有指定的值时才开启配置 |
@ConditionalOnExpression | 组合 @Conditional 注解,当 SpEL 表达式为 true 时才开启配置 |
@ConditionalOnJava | 组合 @Conditional 注解,当运行的 Java JVM 在指定的版本范围时才开启配置 |
@ConditionalOnResource | 组合 @Conditional 注解,当类路径下有指定的资源才开启配置 |
@ConditionalOnJndi | 组合 @Conditional 注解,当指定的 JNDI 存在时才开启配置 |
@ConditionalOnCloudPlatform | 组合 @Conditional 注解,当指定的云平台激活时才开启配置 |
@ConditionalOnSingleCandidate | 组合 @Conditional 注解,当指定的 class 在容器中只有一个 Bean,或者同时有多个但为首选时才开启配置 |
@ConfigurationProperties | 用来加载额外的配置(如 .properties 文件),可用在 @Configuration 注解类,或者 @Bean 注解方法上面 |
@EnableConfigurationProperties | 一般要配合 @ConfigurationProperties 注解使用,用来开启对 @ConfigurationProperties 注解配置 Bean 的支持 |
@AutoConfigureAfter | 用在自动配置类上面,表示该自动配置类需要在另外指定的自动配置类配置完之后。如 Mybatis 的自动配置类,需要在数据源自动配置类之后,@AutoConfigureAfter(DataSourceAutoConfiguration.class) public class MybatisAutoConfiguration |
@AutoConfigureBefore | 这个和 @AutoConfigureAfter 注解使用相反,表示该自动配置类需要在另外指定的自动配置类配置之前 |
@Import | 这是 Spring 3.0 添加的新注解,用来导入一个或者多个 @Configuration 注解修饰的类,这在 Spring Boot 里面应用很多 |
@ImportResource | 这是 Spring 3.0 添加的新注解,用来导入一个或者多个 Spring 配置文件,这对 Spring Boot 兼容老项目非常有用,因为有些配置无法通过 Java Config 的形式来配置就只能用这个注解来导入 |
5.启动类
Spring Boot应用都会有一个启动类,Spring Boot默认扫描启动类所在包下的所有子包,也可以使用@ComponentScan注解指定扫描的包。
6.创建Spring Boot的配置文件
自己可以在配置文件中可以进行想要的配置
7.开发一个controller
8.统一异常处理
1. 定义统一消息返回格式
public class ReturnData extends HashMap<String,Object> {
public ReturnData(int code, String msg) {
this.put("code",code);
this.put("msg", msg);
}
public ReturnData(int code,String msg, Object data) {
this.put("code",code);
this.put("msg",msg);
this.put("data",data);
}
public ReturnData() {
this.put("code", 1);
this.put("msg", "success");
}
public ReturnData(Object data) {
this.put("code", 1);
this.put("msg", "success");
this.put("data",data);
}
public ReturnData(ErrorType error) {
this.put("code", error.getErrorCode().intValue());
this.put("msg", error.getErrorMsg().toString());
}
}
```
2. 定义异常信息枚举类
```java
public enum ErrorType {
SUCCESS(200, "ok"),
NO_AUTH(401, "未登录"),
NO_PERMISSION(403, "没有权限"),
OTHER_ERROR(500, "后台异常"),
NOT_FOUND_MAPPING(404, "请求资源不存在");
private Integer errorCode;
private String errorMsg;
ErrorType(Integer code, String errorMsg) {
this.errorCode = code;
this.errorMsg = errorMsg;
}
public Integer getErrorCode() {
return this.errorCode;
}
public String getErrorMsg() {
return this.errorMsg;
}
}
```
3. 自定义异常
```java
public class MyExcepton extends RuntimeException {
private ErrorType error;
public MyExcepton() {
super();
}
public MyExcepton(String msg) {
super(msg);
}
public MyExcepton (ErrorType error) {
super(error.getErrorMsg().toString());
this.error = error;
}
public ErrorType getError() {
return error;
}
}
```
4. 统一异常处理配置类
```java
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(Exception.class)
public ReturnData exceptionHandler(Exception e) {
System.out.println(e.getCause());
return new ReturnData(500, "服务异常");
}
@ExceptionHandler(MyExcepton.class)
public ReturnData myExceptionHandler(MyExcepton e) {
return new ReturnData(e.getError());
}
@ExceptionHandler(NoHandlerFoundException.class)
@ResponseBody
public ResponseEntity noHanderFound(NoHandlerFoundException e) {
ReturnData error = new ReturnData(ErrorType.NOT_FOUND_MAPPING.getErrorCode().intValue(),
ErrorType.NOT_FOUND_MAPPING.getErrorMsg());
return new ResponseEntity<>(error, HttpStatus.NOT_FOUND);
}
}
```
5. 静态资源配置配置
```java
@Configuration
public class ResourceConfig implements WebMvcConfigurer {
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
//可以访问localhost:8095/static/images/image.jpg
registry.addResourceHandler("/static/**").addResourceLocations("classpath:/static/");
}
}
```
6. 配置文件application.properties(或yml)
```加入下面两行代码
spring.mvc.throw-exception-if-no-handler-found=true
spring.web.resources.add-mappings=false
```
测试配置是否生效
本篇Spring Boot入门到此结束,希望能帮助到一些不懂的小白。
若还想继续学习,静候博主更新(博主正在努力学习中!!!)