为了账号安全，请及时绑定邮箱和手机立即绑定
首页 手记 Springboot项目开发实战：新手入门到初级应用

Springboot项目开发实战：新手入门到初级应用

标签：
SpringBoot
概述

Spring Boot项目开发实战涵盖了从Spring Boot简介到快速搭建项目、核心特性和实战演练等多个方面，帮助开发者快速入门并掌握Spring Boot项目开发技能。文章详细介绍了Spring Boot的优势、项目搭建步骤、依赖配置和RESTful API开发等内容，适合新手入门到初级应用。

Spring Boot项目开发实战：新手入门到初级应用
Spring Boot简介

Spring Boot是什么

Spring Boot 是 Spring 框架的一个子项目，旨在简化 Spring 应用程序的开发过程。它提供了一种快速构建独立的、生产级别的基于 Spring 的应用的方式。Spring Boot 通过约定优于配置的方式减少了大量的配置工作，使得开发者可以专注于应用的业务逻辑，而不需要过多地关注底层框架的配置。

Spring Boot的优势

  1. 自动配置：许多配置可以通过 Spring Boot 的自动化配置功能自动完成，例如数据库连接、安全配置、静态资源处理等。
  2. 独立运行：Spring Boot 应用程序可以独立运行，不需要外部容器，如 Tomcat 或 Jetty，可以直接通过 java -jar 命令运行。
  3. 嵌入式容器：默认提供一个嵌入式的 Tomcat、Jetty 或者 Undertow 实现，大大简化了部署过程。
  4. 无需配置 XML：Spring Boot 遵循约定优于配置的原则，尽量减少 XML 配置。
  5. starter 依赖：通过引入 spring-boot-starter 依赖，可以快速添加所需的功能。
  6. 外部配置：支持从命令行参数、环境变量、JNDI、命令行属性、外部配置文件等不同来源读取配置。
  7. 内置健康检查：提供了大量的健康检查端点，可以方便地监控应用的健康状况。
  8. 监控和指标：集成了 Actuator 组件，提供了丰富的监控和管理功能，如应用状态、环境信息、审计日志等。

快速搭建Spring Boot项目

创建一个 Spring Boot 项目，首先需要安装 Java 开发环境和 Maven 或 Gradle 构建工具。接下来，可以使用 Spring Initializr 创建项目。Spring Initializr 是一个在线工具，可以根据选择的依赖快速生成 Spring Boot 项目的初始代码结构。

使用Spring Initializr创建项目

  1. 访问 Spring Initializr 网站：https://start.spring.io/
  2. 选择项目类型（Group、Artifact、Name、Description）。
  3. 选择版本（默认为最新版本）。
  4. 选择构建工具（Maven 或 Gradle）。
  5. 选择语言（Java）。
  6. 选择依赖（例如，Web、JPA、Thymeleaf 等）。
  7. 点击 "Generate" 生成项目代码。

生成的项目代码会被下载为一个压缩文件，解压后可以使用 IDE 打开并开发。

项目结构分析

生成的 Spring Boot 项目结构如下：

src
├── main
│   ├── java
│   │   └── com.example.demo  # 指定包名
│   │       └── DemoApplication.java  # 主启动类
│   ├── resources
│   │   ├── application.properties  # 配置文件
│   │   └── static  # 静态资源文件
│   │   └── templates  # Thymeleaf 模板文件
│   └── pom.xml  # Maven 文件
└── test
    └── java
        └── com.example.demo
            └── DemoApplicationTests.java  # 单元测试类

添加依赖和配置文件

在 pom.xml 文件中，可以看到添加了各种依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-thymeleaf</artifactId>
    </dependency>
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

在 application.properties 文件中，可以进行各种配置，如数据库连接、端口号等：

spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=root
spring.datasource.password=root
spring.h2.console.enabled=true
spring.h2.console.path=/h2-console
server.port=8080
创建第一个Spring Boot应用

使用Spring Initializr创建项目

在 Spring Initializr 网站上创建一个 Spring Boot 项目，选择所需的依赖，如 Web、JPA、Thymeleaf 等。下载并解压项目后，使用 IDE 打开项目。

项目结构分析

如前所述，项目结构包括主启动类、配置文件、静态资源文件等。主启动类通常位于 src/main/java 目录下，配置文件位于 src/main/resources 目录下。

添加依赖和配置文件

在 pom.xml 文件中添加依赖，并在 application.properties 文件中进行配置。例如：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
       .
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

配置文件 application.properties：

spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=root
spring.datasource.password=root
spring.h2.console.enabled=true
spring.h2.console.path=/h2-console
server.port=8080
Spring Boot核心特性和常用注解

@SpringBootApplication注解详解

@SpringBootApplication 是一个组合注解，集成了 @Configuration、@EnableAutoConfiguration 和 @ComponentScan 三个注解的功能。

  1. @Configuration：标记一个类为配置类，允许声明和配置 Bean。
  2. @EnableAutoConfiguration：激活自动配置，根据类路径中的类和库来智能地配置 Spring。
  3. @ComponentScan：指定扫描的包，Spring 会自动扫描标记了 @Component、@Controller、@Service、@Repository 等注解的类，并注册为 Bean。

示例代码：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

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

@Controller, @Service, @Repository, @Component注解

这些注解用于定义不同类型的组件。@Controller 常用于处理 HTTP 请求，@Service 用于业务逻辑处理，@Repository 用于数据访问，@Component 是通用组件标签，可以用于任何组件。

  1. @Controller：用于标记控制器类，处理 HTTP 请求并返回视图。
  2. @Service：用于标记业务逻辑类，封装业务逻辑。
  3. @Repository：用于标记数据访问类，封装数据访问逻辑。
  4. @Component：通用组件标签，可以用于任何组件。

示例代码：

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping("/hello")
public class HelloController {
    @GetMapping
    public String hello() {
        return "hello";  // 返回视图名称
    }
}
import org.springframework.stereotype.Service;

@Service
public class UserService {
    public void addUser(User user) {
        // 添加用户逻辑
    }
}
import org.springframework.stereotype.Repository;

@Repository
public class UserRepository {
    public User getUserById(Long id) {
        // 查询用户逻辑
        return new User();
    }
}
import org.springframework.stereotype.Component;

@Component
public class CommonService {
    public void commonMethod() {
        // 公共逻辑
    }
}

@RestController注解和RESTful API开发

@RestController 是 @Controller 和 @ResponseBody 的组合注解，用于标记 RESTful API 控制器，返回的数据直接写入 HTTP 响应，而不是返回视图。

示例代码：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api/users")
public class UserController {
    @GetMapping
    public List<User> getUsers() {
        // 返回用户列表
        return List.of(new User());
    }
}
实战演练：构建用户管理模块

创建用户实体类

用户实体类 User 用于表示用户信息，通常包含用户名、密码、电子邮件等字段。

示例代码：

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import lombok.Data;

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

创建用户服务和控制器

创建 UserService 和 UserController 类，分别用于处理业务逻辑和处理 HTTP 请求。

示例代码：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserService {
    private UserRepository userRepository;  // 假设 UserRepositroy 已定义

    @Autowired
    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public User addUser(User user) {
        return userRepository.save(user);
    }

    public User getUserById(Long id) {
        return userRepository.findById(id).orElse(null);
    }

    public List<User> getUsers() {
        return userRepository.findAll();
    }

    public User updateUser(Long id, User user) {
        User existingUser = userRepository.findById(id).orElse(null);
        if (existingUser != null) {
            existingUser.setUsername(user.getUsername());
            existingUser.setEmail(user.getEmail());
            return userRepository.save(existingUser);
        }
        return null;
    }

    public void deleteUser(Long id) {
        userRepository.deleteById(id);
    }
}
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/api/users")
public class UserController {
    private UserService userService;  // 假设 UserService 已定义

    @Autowired
    public UserController(UserService userService) {
        this.userService = userService;
    }

    @GetMapping
    public List<User> getUsers() {
        return userService.getUsers();
    }

    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        return userService.getUserById(id);
    }

    @PostMapping
    public User addUser(@RequestBody User user) {
        return userService.addUser(user);
    }

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

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

实现增删改查操作

在 UserService 和 UserController 中实现用户管理的基本操作：添加用户、查询用户、更新用户和删除用户。

示例代码：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/api/users")
public class UserController {
    private UserService userService;

    @Autowired
    public UserController(UserService userService) {
        this.userService = userService;
    }

    @GetMapping
    public List<User> getUsers() {
        return userService.getUsers();
    }

    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        return userService.getUserById(id);
    }

    @PostMapping
    public User addUser(@RequestBody User user) {
        return userService.addUser(user);
    }

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

    @DeleteMapping("/{id}")
    public void deleteUser(@PathVariable Long id) {
        userService.deleteUser(id);
    }
}
配置Spring Boot的启动参数和环境变量

设置应用程序参数

可以通过 application.properties 或 application.yml 文件设置应用程序参数。例如，设置应用程序端口、数据库连接等。

示例代码：

server.port=8080
spring.datasource.url=jdbc:mysql://localhost:3306/testdb
spring.datasource.username=root
spring.datasource.password=root

使用外部配置文件

Spring Boot 支持从外部配置文件读取配置，如 application-{profile}.properties。可以通过命令行参数或环境变量指定配置文件。

示例代码：

java -jar app.jar --spring.profiles.active=dev

配置文件的优先级和属性覆盖

配置文件优先级从低到高依次是：默认配置、@PropertySource 注解、外部配置文件、命令行参数。命令行参数具有最高优先级。

示例代码：

# application.properties
server.port=8080

# application-dev.properties
server.port=8081

# 命令行参数优先级更高
java -jar app.jar --spring.profiles.active=dev --server.port=9090
总结和后续学习方向

总结Spring Boot项目开发要点

  1. 使用 @SpringBootApplication 注解快速创建启动类。
  2. 根据需要添加依赖和配置文件。
  3. 使用 @Controller、@Service、@Repository 和 @Component 注解定义组件。
  4. 使用 @RestController 和 @RequestMapping 注解开发 RESTful API。
  5. 创建实体类、服务类和控制器类，实现增删改查操作。
  6. 设置应用程序配置参数，支持外部配置文件和命令行参数。

常见问题及解决方案

  1. 启动失败：检查配置文件是否正确，依赖是否完整。例如，确保 pom.xml 文件中的依赖项正确无误。
  2. 数据库连接失败：检查数据库连接信息是否正确，数据库是否运行。例如，确保 application.properties 中的数据库连接信息正确。
  3. 无法访问 RESTful API：检查控制器路径是否正确，方法是否被正确注解。例如，确保 @RestController 和 @GetMapping 注解使用正确。

推荐学习资源和进阶方向

  • 慕课网：提供丰富的 Spring Boot 学习资源。
  • 官方文档：深入阅读 Spring Boot 官方文档，了解更多高级功能。例如，访问 https://docs.spring.io/spring-boot/docs/current/reference/html/。
  • 社区和论坛：加入 Spring Boot 相关社区和论坛，与其他开发者交流经验。
  • 实战项目：通过实际项目加深对 Spring Boot 的理解和应用。

通过以上内容的学习和实践，可以快速掌握 Spring Boot 开发的基本技能，为后续的进阶学习打下坚实的基础。

点击查看更多内容
发表于 2024.11.08 17:13， 共 54 人浏览

本文原创发布于慕课网 ，转载请注明出处，谢谢合作

举报
为 TA 点赞

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

评论

作者其他优质文章

正在加载中

DIEA

手记
篇
粉丝
63
获赞与收藏
387

关注作者，订阅最新文章

阅读免费教程

  • 推荐
  • 评论
  • 收藏
  • 共同学习，写下你的评论
感谢您的支持，我会继续努力的～
扫码打赏，你说多少就多少
赞赏金额会直接到老师账户
支付方式
打开微信扫一扫，即可进行扫码打赏哦
今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与 放弃机会
意见反馈 帮助中心 APP下载
官方微信

举报

0/150
提交
取消