Spring Boot项目搭建详解：从零开始到实践应用

最新推荐文章于 2025-03-30 11:29:56 发布
最新推荐文章于 2025-03-30 11:29:56 发布
阅读量2.3k 收藏 32
点赞数 25
分类专栏： java 文章标签： spring boot 后端 java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_19749625/article/details/139293181
版权

Spring Boot项目搭建详解：从零开始到实践应用

引言

Spring Boot作为Spring生态系统的一部分，极大地简化了Spring应用的开发和部署过程。通过自动配置和嵌入式服务器，开发者可以快速构建独立运行的Spring应用。本文将详细介绍如何从零开始搭建一个Spring Boot项目，涵盖项目创建、基本配置、常见功能实现及最佳实践。

1. 创建Spring Boot项目

使用Spring Initializr

Spring Initializr是Spring官方提供的项目生成工具，可以快速创建Spring Boot项目。

  1. 打开Spring Initializr网站：https://start.spring.io
  2. 选择项目属性：
    • Project: Maven Project
    • Language: Java
    • Spring Boot: 最新版本
    • Project Metadata:
      • Group: com.example
      • Artifact: demo
      • Name: demo
      • Package Name: com.example.demo
      • Packaging: Jar
      • Java: 11（或其他版本）
  3. 添加依赖：
    • Spring Web
    • Spring Data JPA
    • MySQL Driver
    • Spring Boot DevTools
    • Lombok
  4. 点击“Generate”按钮生成项目，下载并解压缩。

导入IDE

将生成的项目导入到IntelliJ IDEA或其他IDE中，确保项目可以成功构建和运行。

2. 配置项目

配置数据库连接

在src/main/resources/application.properties中配置数据库连接信息：

spring.datasource.url=jdbc:mysql://localhost:3306/demo
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5Dialect

创建数据库表

在数据库中创建一个名为demo的数据库，并创建一个User表：

CREATE TABLE `user` (
  `id` BIGINT NOT NULL AUTO_INCREMENT,
  `name` VARCHAR(255) NOT NULL,
  `email` VARCHAR(255) NOT NULL,
  PRIMARY KEY (`id`)
);

3. 实现基本功能

创建实体类

在src/main/java/com/example/demo/entity目录下创建User实体类：

package com.example.demo.entity;

import lombok.Data;

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

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

创建Repository接口

在src/main/java/com/example/demo/repository目录下创建UserRepository接口：

package com.example.demo.repository;

import com.example.demo.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

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

创建Service类

在src/main/java/com/example/demo/service目录下创建UserService类：

package com.example.demo.service;

import com.example.demo.entity.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;
import java.util.Optional;

@Service
public class UserService {
    
    @Autowired
    private UserRepository userRepository;

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

    public Optional<User> getUserById(Long id) {
        return userRepository.findById(id);
    }

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

    public void deleteUser(Long id) {
        userRepository.deleteById(id);
    }
}

创建Controller类

在src/main/java/com/example/demo/controller目录下创建UserController类：

package com.example.demo.controller;

import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/users")
public class UserController {

    @Autowired
    private UserService userService;

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

    @GetMapping("/{id}")
    public ResponseEntity<User> getUserById(@PathVariable Long id) {
        return userService.getUserById(id)
                .map(ResponseEntity::ok)
                .orElse(ResponseEntity.notFound().build());
    }

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

    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteUser(@PathVariable Long id) {
        userService.deleteUser(id);
        return ResponseEntity.noContent().build();
    }
}

测试应用

启动Spring Boot应用，在浏览器或Postman中访问以下API端点进行测试：

  • GET /users：获取所有用户
  • GET /users/{id}：根据ID获取用户
  • POST /users：创建新用户
  • DELETE /users/{id}：删除用户

4. 常见功能实现

全局异常处理

在src/main/java/com/example/demo/exception目录下创建全局异常处理类GlobalExceptionHandler：

package com.example.demo.exception;

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.context.request.WebRequest;

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ResponseEntity<?> handleGlobalException(Exception ex, WebRequest request) {
        return new ResponseEntity<>(ex.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR);
    }

    @ExceptionHandler(ResourceNotFoundException.class)
    public ResponseEntity<?> handleResourceNotFoundException(ResourceNotFoundException ex, WebRequest request) {
        return new ResponseEntity<>(ex.getMessage(), HttpStatus.NOT_FOUND);
    }
}

分页和排序

在UserService中添加分页和排序功能：

package com.example.demo.service;

import com.example.demo.entity.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;
import org.springframework.data.domain.Pageable;
import org.springframework.data.domain.Sort;
import org.springframework.stereotype.Service;

import java.util.List;
import java.util.Optional;

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

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

    public Page<User> getUsersWithPagination(int page, int size) {
        Pageable pageable = PageRequest.of(page, size);
        return userRepository.findAll(pageable);
    }

    public List<User> getUsersWithSorting(String field) {
        return userRepository.findAll(Sort.by(Sort.Direction.ASC, field));
    }

    public Optional<User> getUserById(Long id) {
        return userRepository.findById(id);
    }

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

    public void deleteUser(Long id) {
        userRepository.deleteById(id);
    }
}

在UserController中添加分页和排序端点：

@RestController
@RequestMapping("/users")
public class UserController {

    @Autowired
    private UserService userService;

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

    @GetMapping("/page")
    public Page<User> getUsersWithPagination(@RequestParam int page, @RequestParam int size) {
        return userService.getUsersWithPagination(page, size);
    }

    @GetMapping("/sort")
    public List<User> getUsersWithSorting(@RequestParam String field) {
        return userService.getUsersWithSorting(field);
    }

    @GetMapping("/{id}")
    public ResponseEntity<User> getUserById(@PathVariable Long id) {
        return userService.getUserById(id)
                .map(ResponseEntity::ok)
                .orElse(ResponseEntity.notFound().build());
    }

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

    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteUser(@PathVariable Long id) {
        userService.deleteUser(id);
        return ResponseEntity.noContent().build();
    }
}

使用Swagger生成API文档

  1. 添加Swagger依赖：

    <dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>

  2. 配置Swagger：

    package com.example.demo.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.spi.DocumentationType;


import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.demo"))
                .paths(PathSelectors.any())
                .build();
    }
}

  3. 启动应用，访问http://localhost:8080/swagger-ui/查看API文档。

5. 最佳实践

配置管理

使用application.properties或application.yml进行配置管理，区分不同环境的配置。

spring:
  profiles:
    active: dev

---

spring:
  profiles: dev
  datasource:
    url: jdbc:mysql://localhost:3306/demo_dev
    username: root
    password: root

---

spring:
  profiles: prod
  datasource:
    url: jdbc:mysql://localhost:3306/demo_prod
    username: prod_user
    password: prod_pass

日志管理

使用SLF4J和Logback进行日志管理，配置日志级别和输出格式。

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

在src/main/resources目录下创建logback-spring.xml：

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

    <root level="info">
        <appender-ref ref="STDOUT" />
    </root>

    <logger name="com.example.demo" level="debug" />
</configuration>

安全性

使用Spring Security保护应用，配置身份认证和授权。

  1. 添加Spring Security依赖：

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

  2. 配置Spring Security：

    package com.example.demo.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.security.crypto.password.PasswordEncoder;

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
            .antMatchers("/public/**").permitAll()
            .anyRequest().authenticated()
            .and()
            .formLogin().permitAll()
            .and()
            .logout().permitAll();
    }

    @Bean
    public PasswordEncoder passwordEncoder() {
        return new BCryptPasswordEncoder();
    }
}

结语

通过本文的讲解，你应该已经掌握了从零开始搭建Spring Boot项目的全过程，涵盖了项目创建、基本配置、常见功能实现及最佳实践。希望这篇文章能帮助你在实际开发中更高效地构建Spring Boot应用。如果你喜欢这篇文章，请分享给更多的Java开发者，并关注我们的Spring Boot专题，获取更多精彩内容和最新资讯！

你的支持是我们前进的最大动力！

qq群

私人微信

私人微信

Spring Boot入门(02)：【教程】轻松搭建Spring Boot开发环境，启动你的第一个Web项目！
**My Coding Family**
08-11 3万+
快速搭建开发环境和启动项目是每个开发人员必备的技能。本文将为您提供一些简单易懂的方法和技巧，以帮助您快速搭建开发环境和启动项目。我们将介绍如何选择适合您的开发工具、配置您的操作系统、安装必要的软件包和依赖项，并开始编写您的第一个应用程序。无论您是一位新手还是一位经验丰富的开发人员，本文都会给您提供有用的信息和实用的建议，让您在最短时间内快速搭建和启动开发项目。
Spring Boot入门(12)：从零开始！轻松掌握Spring Boot整合MyBatis-Plus的最佳实践！
**My Coding Family**
08-17 1万+
一文吃透SpringBoot整合mybatis-plus及实战演练，赶紧来学！
超详细从0开始搭建 Spring Boot 项目
algftxjgs的博客
07-22 1783
1.0.0 创建项目 我使用的ide 是 idea 创建项目 选择 Spring initializr ，如果点Next一直在转圈，可能是 start.spring.io/ 在国外，访问比较慢。可以科学上网或者，使用自定义的 start.spring.io/ 主要改以下组织名称、项目名称和项目描述就好了 我创建项目的时候， Spring Boot 最新稳定版是 2.1.9 。要用就用最新的！！！ 依赖先都不勾选，后期一项一项加 项目文件夹名称以及存放位置 添加maven镜像 添加
创建Spring Boot项目有哪几种方式
最新发布
极客鼠之家
03-30 1302
下面为你详细介绍如何使用Spring Boot官方模板创建Spring Boot项目，这里提供两种常见的创建方式：通过Spring Initializr网站创建和使用IntelliJ IDEA集成开发环境创建。解压下载的压缩包，打开你的集成开发环境（如IntelliJ IDEA、Eclipse等），选择“Import Project”或“Open”，导入解压后的项目目录。点击“Next”，在“Dependencies”页面添加项目所需的依赖，例如Spring Web、Spring Data JPA等。
从零开始搭建一个SpringBoot项目
Wannaer的博客
05-20 1760
在springboot2.0之后 , 采用的默认连接池就是Hikari, 号称"史上最快的连接池", 所以我们没有添加依赖也能直接用, springboot的自动配置中含有DataSourceAutoConfiguration配置类, 会先检查容器中是否已经有连接池对象, 没有则会使用默认的连接池, 并根据特定的属性来自动配置连接池对象, 用到的属性值来源于DataSourceProperties对象。例如常用的getter、setter、toString、构造器和equals等方法。
从0开始搭建一个SpringBoot项目（从环境配置到运行项目）
高朗的博客
08-21 2821
从环境配置到创建SpringBoot项目
从零开始搭建springboot项目（一）、创建springboot项目
老头的博客
03-29 3364
本次创建项目分成下面几个步骤介绍 （1）创建springboot项目； （2）整合mybatis，搭建数据访问层框架 （3）整合shiro搭建权限验证框架； （4）自动生成代码； （5）整合logger搭建日志框架 创建springboot项目 准备环境 1、jdk1.8及以上； 2、maven 3.6.1; 3、开发工具：本人使用的是idea，也可以使用eclipse； 开始搭建 （一）、打开f...
从零开始创建一个SpringBoot项目
这里是辛苦牛的博客
04-05 2335
从零开始创建一个SpringBoot项目
Spring Boot入门(03)： 从零开始学习配置文件：掌握YAML和Properties，轻松应对多环境配置管理
热门推荐
**My Coding Family**
08-12 4万+
在Spring Boot开发中，配置文件是非常重要的。本文将带领你从零开始学习配置文件，掌握YAML和Properties的语法，轻松应对多环境配置管理。无论是开发、测试还是生产环境，你都可以轻松切换不同的配置文件，并且能够灵活修改配置信息。
Spring Boot与Mybatis深度整合教程：从零开始到实战
本文将详细介绍如何在Spring Boot框架中整合Mybatis，以...通过这篇文章，读者不仅能学习到Spring Boot与Mybatis的整合技术，还能了解到相关的最佳实践和插件的使用方法，对于快速上手Spring Boot项目开发非常有帮助。
Spring Boot 2.0深度解析：从入门到精通指南
这一系列内容旨在帮助开发者从零开始，逐步深入地掌握Spring Boot 2.0的各项技术要点。文章在编写的过程中，特别关注了版本的稳定性和对构建系统的支持，同时对2.0正式版的发布进行了及时的跟进和内容更新。 从...
从零开始搭建SpringBoot项目
Lizhj的博客
10-17 455
从零开始搭建SpringBoot项目项目地址 创建
创建一个Spring Boot项目
wuweixiaoyue的博客
05-10 8249
没有用的文件因为我们是按照Spring Boot的模版来创建项目，所以会给我们添加一些实际上没什么用的配置文件，直接删掉即可。.idea：代表了IDEA相关的配置src：代码mainjavacom：放置Java源代码resources：资源目录，主要是配置相关的代码static：主要放置静态文件templates：主要放置模版：Spring Boot 项目的配置文件test：放置了开发人员的测试代码，用来测试某一个文件是否有bug。
从零搭建的一个springboot项目
please93的博客
11-18 1009
从零搭建的sprinboot项目 首先是最近基础的四个文件夹（不做过多解释了） 在resources中创建跟mapper接口一样的mapper.xml路径，如果路径一样就不用不配置了，如果不一样则需要配置了，这里是.yaml文件用的mybatis-plus配置的 表示为mapper下的mapper.xml文件 mybatis-plus: mapper-locations: classpath*:/mapper/**Mapper.xml 最基础的数据库配置，然后如果前端使用thymeleaf则也需要
【从零开始】搭建 Spring-Boot项目
菜鸟的进阶之路
03-12 3378
本文以用户管理为例 ，使用mysql数据库搭建了Spring-boot项目。
手把手教你从0搭建SpringBoot项目
CZ101的博客
04-10 1万+
用到的工具：idea 2021、Maven 3.6.3、postman 框架：SpringBoot、Mybatis 数据库：Mysql8.0.30。
搭建Spring Boot 项目
CQRNB的博客
02-16 1万+
详细介绍搭建完整的Spring Boot项目 使用mybatis-plus链接数据库 通过swagger生成接口文档 测试接口
从0搭建第一个Spring Boot项目
guiweishi2241的博客
06-11 403
小测试的第一个Java 项目
SpringBoot从零搭建一个项目（一）准备工作
乌龟赛跑
07-13 347
1、Eclipse安装插件 Eclipse->help->Eclipse Marketplace->search 搜索“STS”，选择Spring Tools 3(或者更高版本)，点击install，等待下载安装。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

阿里渣渣java研发组-群主

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值