首页手记 Spring Boot项目实战：新手入门教程

Spring Boot项目实战：新手入门教程

标签：

SpringBoot

概述

本文将详细介绍如何从零开始搭建Spring Boot项目实战，包括环境搭建、项目配置、核心组件使用以及实战案例。通过本教程，你可以快速掌握Spring Boot项目开发的基本流程和关键技巧。

Spring Boot项目实战：新手入门教程

1. Spring Boot简介与环境搭建

Spring Boot是什么

Spring Boot 是一个用于简化 Spring 应用程序开发的框架。它使开发者能够快速搭建独立的、生产级别的基于 Spring 框架的应用程序。Spring Boot 可以自动配置 Spring 应用，并提供一系列开箱即用的功能，例如嵌入式的Web服务器、生产就绪的特性、自动配置等。它使得Java应用程序的开发、打包与部署变得更加简单。

Spring Boot 的主要目标是：

减少配置：默认配置可以减少许多配置的工作量。
快速启动：能够快速集成各种资源，简化开发流程。
独立运行：可以打包成独立的可执行 JAR 文件，并且可以部署到任何支持 Java 的环境中。

开发环境搭建

为了开发 Spring Boot 应用，你需要先搭建好开发环境。以下是搭建开发环境的步骤：

安装 JDK：确保已安装并配置好 JDK。
安装 IDE：推荐使用 IntelliJ IDEA 或 Eclipse。
安装 Maven：Maven 是一个强大的项目管理工具，用于构建和管理项目依赖。
安装 Spring Boot CLI（可选）：Spring Boot CLI 可以让你通过命令行快速创建 Spring Boot 应用。

创建第一个Spring Boot项目

创建一个简单的 Spring Boot 应用程序，可以通过以下步骤进行：

使用 Spring Initializr 创建项目：
- 访问 https://start.spring.io/，选择项目信息，如项目名、语言、依赖等。
- 下载项目压缩包，并解压到指定目录。
- 使用 IDE 打开项目。

使用 IDE 创建项目：

在 IntelliJ IDEA 或 Eclipse 中创建一个新的 Maven 项目。

修改 pom.xml 文件，添加 Spring Boot 依赖。

<dependencies>
<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-web</artifactId>
   <version>2.5.2</version>
</dependency>
</dependencies>

编写主应用类：

创建主应用类，该类需要包含 @SpringBootApplication 注解。

@SpringBootApplication
public class Application {
public static void main(String[] args) {
   SpringApplication.run(Application.class, args);
}
}

运行应用：
- 使用 IDE 运行主应用类，可以通过内置的 Tomcat 服务器启动应用。
- 访问 http://localhost:8080 查看默认的欢迎页面。

2. Spring Boot项目的基本配置

应用配置详解

Spring Boot 通过外部化配置使配置项的修改变得简单。配置文件通常存储在 src/main/resources 目录下的 application.properties 或 application.yml 文件中。以下是配置文件的一些基本配置项：

服务器配置：
- 服务器端口配置：
```
server.port=8080
```
- 服务器上下文路径配置：
```
server.servlet.context-path=/app
```

数据库配置：

数据库连接配置：

spring.datasource.url=jdbc:mysql://localhost:3306/db_name
spring.datasource.username=root
spring.datasource.password=root

数据库驱动配置：

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

日志配置：

控制台日志级别配置：

logging.level.root=INFO
logging.level.org.springframework=DEBUG

配置文件的使用

配置文件可以被分成多个文件，Spring Boot 会根据文件名进行自动加载。例如，可以创建多个配置文件来针对不同的环境（开发、测试、生产）进行配置。这些文件的命名格式为：

application-{profile}.properties
application-{profile}.yml

例如，为了在开发环境中使用特定的配置，可以创建 application-dev.properties 或 application-dev.yml 文件。

自动配置原理简介

Spring Boot 的自动配置是通过 @SpringBootApplication 注解实现的。它包含了三个注解：

@Configuration：表示一个配置类。
@EnableAutoConfiguration：启动自动配置支持。
@ComponentScan：扫描并注册组件，包括 @Component、@Service、@Repository 等。

Spring Boot 使用 SpringFactoriesLoader 加载特定于 EnableAutoConfiguration 的 AutoConfiguration 类。这些配置类会在类路径中查找特定的条件，如果满足条件，就会进行自动配置。

例如，Spring Boot 自动配置了 Web 服务，如果你的应用中有 spring-boot-starter-web 依赖，它会自动配置一个嵌入式的 Tomcat 服务器。自动配置的代码示例如下：

@Configuration
@EnableAutoConfiguration
@ComponentScan
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

3. Spring Boot中的核心组件

Spring Boot Starter的使用

Spring Boot Starter 是一系列开箱即用的依赖库，它们提供了自动配置和依赖管理功能。这些 Starter 可以大大简化项目的配置和依赖管理。常见的 Starter 包括：

spring-boot-starter-web：提供了 Web 服务的自动配置。
spring-boot-starter-data-jpa：提供了 JPA 的自动配置。
spring-boot-starter-security：提供了安全管理的配置。

例如，要使用 spring-boot-starter-web，只需要在 pom.xml 文件中添加以下依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

Spring Boot MVC框架

Spring Boot 框架集成了 Spring MVC，提供了处理 HTTP 请求的方法。通过声明式 REST 控制器可以快速开发 RESTful API。

创建控制器：
```
@RestController
public class HelloController {
   @GetMapping("/hello")
   public String hello() {
       return "Hello, World!";
   }
}
```
- @RestController 注解标记该类为控制器，并自动将该类的所有方法返回值转换成 JSON 响应。
- @GetMapping 注解标记了处理 GET 请求的方法。
配置Spring MVC：
- Spring Boot 默认配置了 DispatcherServlet，无需手动配置。

数据访问与集成

Spring Boot 支持多种数据访问技术，如 JPA、MyBatis 等。其中，JPA 是最常用的持久层框架。

添加JPA依赖：

<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>

配置数据库连接：

spring.datasource.url=jdbc:mysql://localhost:3306/db_name
spring.datasource.username=root
spring.datasource.password=root
spring.jpa.hibernate.ddl-auto=update

定义实体类：

@Entity
public class User {
   @Id
   @GeneratedValue(strategy = GenerationType.IDENTITY)
   private Long id;
   private String name;
   private String email;

   // 构造器、getter 和 setter 方法
}

定义 JPA Repository：

public interface UserRepository extends JpaRepository<User, Long> {
}

MyBatis 示例

Spring Boot 也支持 MyBatis。为了使用 MyBatis，你需要在 pom.xml 中添加如下依赖：

<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>2.1.4</version>
</dependency>

接下来定义 MyBatis 配置类和接口：

@Configuration
public class MyBatisConfig {
    @Bean
    public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {
        SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
        factoryBean.setDataSource(dataSource);
        return factoryBean.getObject();
    }
}

public interface UserMapper {
    @Select("SELECT * FROM users WHERE id = #{id}")
    User findById(Long id);
}

4. 实战案例：创建一个简单的Web应用

创建RESTful API

创建用户实体：

@Entity
public class User {
   @Id
   @GeneratedValue(strategy = GenerationType.IDENTITY)
   private Long id;
   private String name;
   private String email;

   // 构造器、getter 和 setter 方法
}

定义用户Repository：

public interface UserRepository extends JpaRepository<User, Long> {
}

创建用户控制器：

@RestController
public class UserController {
   @Autowired
   private UserRepository userRepository;

   @GetMapping("/users")
   public List<User> listAllUsers() {
       return userRepository.findAll();
   }

   @PostMapping("/users")
   public User createUser(@RequestBody User user) {
       return userRepository.save(user);
   }

   @GetMapping("/users/{id}")
   public User getUserById(@PathVariable Long id) {
       return userRepository.findById(id).orElse(null);
   }

   @PutMapping("/users/{id}")
   public User updateUser(@PathVariable Long id, @RequestBody User user) {
       return userRepository.save(user);
   }

   @DeleteMapping("/users/{id}")
   public void deleteUser(@PathVariable Long id) {
       userRepository.deleteById(id);
   }
}

实现前端页面展示

创建 HTML 页面：

<!DOCTYPE html>
<html lang="en">
<head>
   <meta charset="UTF-8">
   <title>User List</title>
</head>
<body>
   <h1>User List</h1>
   <ul id="userList"></ul>
   <script>
       fetch('/users')
           .then(response => response.json())
           .then(users => {
               const ul = document.getElementById('userList');
               users.forEach(user => {
                   const li = document.createElement('li');
                   li.textContent = `${user.name} (${user.email})`;
                   ul.appendChild(li);
               });
           });
   </script>
</body>
</html>

数据库集成与操作

配置数据库连接：

spring.datasource.url=jdbc:mysql://localhost:3306/db_name
spring.datasource.username=root
spring.datasource.password=root
spring.jpa.hibernate.ddl-auto=update

初始化数据：

@SpringBootApplication
public class Application {
   public static void main(String[] args) {
       SpringApplication.run(Application.class, args);
   }

   @Bean
   CommandLineRunner init(UserRepository userRepository) {
       return (args) -> {
           User user1 = new User();
           user1.setName("John");
           user1.setEmail("john@example.com");
           userRepository.save(user1);

           User user2 = new User();
           user2.setName("Jane");
           user2.setEmail("jane@example.com");
           userRepository.save(user2);
       };
   }
}

5. 项目打包与部署

打包与发布应用

打包应用：
- 使用 Maven 打包项目：
```
mvn clean package
```
- 打包后生成的文件在 target 目录下，通常是一个 .jar 文件。
运行打包的应用：
- 使用 Java 命令运行打包后的 JAR 文件：
```
java -jar target/myapp.jar
```

在本地服务器上部署应用

配置Tomcat服务器：
- 在 application.properties 中配置服务器端口：
```
server.port=8080
```
- 部署到外部 Tomcat 服务器：
  - 将打包的 JAR 文件复制到 Tomcat 的 webapps 目录下。
  - 启动 Tomcat 服务器。
运行WAR文件：
- 打包成 WAR 文件格式：
```
mvn clean package -Dpackaging=war
```
- 将 WAR 文件部署到 Tomcat 服务器。

使用Docker部署应用

创建Dockerfile：

FROM openjdk:8-jre-alpine
COPY target/myapp.jar myapp.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/myapp.jar"]

构建Docker镜像：
```
docker build -t myapp:latest .
```
运行Docker容器：
```
docker run -p 8080:8080 myapp:latest
```

6. Spring Boot项目调试与测试

常用调试技巧

IDE调试：
- 在 IntelliJ IDEA 或 Eclipse 中，可以使用断点、单步执行、查看变量等调试功能。
配置调试日志：
- 在 application.properties 文件中添加日志配置：
```
logging.level.org.springframework=DEBUG
```

单元测试与集成测试

编写单元测试：

使用 @SpringBootTest 注解的测试类：

@SpringBootTest
public class UserControllerTest {
 @Autowired
 private MockMvc mockMvc;

 @Autowired
 private UserRepository userRepository;

 @Test
 public void shouldReturnDefaultMessage() throws Exception {
     mockMvc.perform(get("/users"))
             .andExpect(status().isOk())
             .andExpect(content().string("[]"));
 }
}

编写集成测试：

使用 @SpringBootTest 注解的测试类：

@SpringBootTest
public class UserServiceTest {
 @Autowired
 private UserService userService;

 @Test
 public void shouldCreateUser() {
     User user = new User();
     user.setName("John");
     user.setEmail("john@example.com");
     User savedUser = userService.createUser(user);
     assertNotNull(savedUser.getId());
 }
}

日志管理与监控

配置日志文件：

使用 logback-spring.xml 配置文件：

<configuration>
 <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
     <encoder>
         <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level %logger{36} - %msg%n</pattern>
     </encoder>
 </appender>

 <root level="INFO">
     <appender-ref ref="STDOUT" />
 </root>
</configuration>

使用Spring Boot Actuator：
- 添加 Actuator 依赖：
```
<dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
```
- 访问 /actuator 接口查看应用的运行时信息。例如，访问 /actuator/health 可查看应用的健康状态。

以上是 Spring Boot 项目的基本开发、配置和部署流程，希望对你有所帮助。如果需要进一步深入学习，建议参考 Spring Boot 的官方文档，或参加在线课程，如慕课网（https://www.imooc.com/）提供的课程。

点击查看更多内容

为 TA 点赞

若觉得本文不错，就分享一下吧！

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

收到一只叮咚

手记
篇

粉丝

22

获赞与收藏

112

关注作者，订阅最新文章

阅读免费教程

后端通用面试教程

41个小节 30809 345

网络编程入门教程

20个小节 12721 239

Pandas 入门教程

25个小节 18600 342

推荐

评论

收藏

共同学习，写下你的评论



感谢您的支持，我会继续努力的～

扫码打赏，你说多少就多少

赞赏金额会直接到老师账户

支付方式

打开微信扫一扫，即可进行扫码打赏哦

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

恭喜你，你的运气太好了，居然抽中了 100个积分！

恭喜你，抽中了价值元的专栏！

太棒了，直接落到你账户里！

积分商城里的罗技鼠标、机械键盘、
Kindle 阅读器、小米平衡车
Apple iPad （10.2英寸）、大额优惠券
在等着你去兑换了噢

作者：

免费赠送

兑换码：1111222211 复制

优惠券可用于购买实战课、体系课
无门槛使用

先去看看，有什么好东西马上兑换我爱学习，选课去


热搜

最近搜索清空