首页手记 Springboot入门教程：快速搭建你的第一个项目

Springboot入门教程：快速搭建你的第一个项目

标签：

SpringBoot

概述

Spring Boot 是一个简化配置和开发流程的框架，它能够快速搭建独立的生产级应用。本文介绍了 Spring Boot 的核心优势、适用场景以及如何搭建开发环境和创建项目。通过示例展示了如何使用 Spring Boot 创建第一个 Web 应用，并介绍了应用的部署方法。

Spring Boot 简介

Spring Boot 是什么

Spring Boot 是由 Pivotal 团队提供的基于 Spring 框架的一个开源项目。它的目标是简化 Spring 应用的初始搭建以及开发过程。通过 Spring Boot，开发人员可以快速创建独立的、生产级别的基于 Spring 框架的应用程序。Spring Boot 可以自动配置 Spring 和其他技术，减少配置文件的编写工作，从而提高开发效率。它还支持嵌入式 Web 服务器（如 Tomcat、Jetty、Undertow）、内嵌式数据库（如 H2、HSQL）、集成测试和生产就绪的特性（如运行时性能指标和健康检查）。

Spring Boot 的核心优势

快速开发：Spring Boot 通过自动配置和减少样板代码的方式，使得开发变得更加简单。
独立运行：Spring Boot 应用可以打包为独立的可执行文件（jar 或 war），内含所有依赖和配置。
嵌入式服务器：支持内嵌式 Web 服务器，如 Tomcat、Jetty 或 Undertow，无需配置外部容器。
框架集成：Spring Boot 与各种库和框架集成，如 Spring Data、Spring Security、Spring Web 等。
健康检查与监控：内置健康检查和运行时性能监控功能。
外部配置：支持外部化配置，如使用 application.properties 或 application.yml 文件。
无代码依赖：Spring Boot 封装常用功能，开发者无需编写大量代码即可使用。

Spring Boot 适用的开发场景

Web 应用：创建企业级 Web 应用。
微服务：快速搭建微服务架构。
REST API：构建 RESTful 服务。
数据库集成：与关系型数据库或 NoSQL 数据库集成。
命令行工具：开发命令行工具或批处理任务。
测试工具：集成单元测试和集成测试。

环境搭建

安装 Java 开发环境

安装 JDK：
- 下载 JDK（Java Development Kit），推荐使用最新稳定版。
- 安装 JDK 后，确保 Java 环境变量已配置好。
- 验证安装：运行 java -version 和 javac -version，查看版本信息。
配置环境变量：
- 在 Windows 系统中，编辑系统环境变量 Path，添加 JDK 的 bin 目录。
- 在 Linux 或 macOS 系统中，编辑 .bashrc 或 .zshrc 文件，添加如下内容：
```
export JAVA_HOME=/path/to/java_home
export PATH=$JAVA_HOME/bin:$PATH
```
- 重启终端或重新加载配置文件：
```
source .bashrc  # 或 .zshrc
```

下载 Spring Boot Starter

下载 Spring Boot Starter：
- 访问 Spring Boot Starter 下载页面，下载最新版本的 Spring Boot Starter。
- 下载完成后，解压下载的 Spring Boot Starter 包，确保解压后的目录包含 spring-boot-starter-1.5.8.RELEASE.jar 文件。
解压下载文件：
- 解压下载的 Spring Boot Starter 包，确保解压后的目录包含 spring-boot-starter-1.5.8.RELEASE.jar 文件。

使用 IDE 集成 Spring Boot 开发环境

安装 IntelliJ IDEA：
- 下载并安装 IntelliJ IDEA 社区版或专业版。
- 启动 IntelliJ IDEA，创建新项目时选择 Spring Boot 项目模板。
配置 IDE：
- 在 IntelliJ IDEA 中，选择 File -> New -> Project，选择 Spring Initializr 模板。
- 输入项目名称、语言（Java）、框架版本等信息，点击 Next。
选择依赖：
- 在 Dependencies 页面，选择所需的依赖，如 Web、JPA、Thymeleaf 等。
- 点击 Next，然后点击 Finish 完成项目创建。

创建 Spring Boot 项目

使用 Spring Initializr 创建项目

访问 Spring Initializr：
- 打开浏览器，访问 Spring Initializr。
选择项目信息：
- 选择项目语言（Java）。
- 选择依赖管理（Spring Boot 2.7.0 版本）。
- 选择项目类型（Maven）。
- 输入项目基本信息：项目名（my-spring-boot-app）、组织名（org.example）、Java 版本（11）。
选择依赖：
- 在 Dependencies 标签页，选择 Web 和 JPA 依赖。
- 点击 Generate 按钮，生成项目压缩包。
解压项目压缩包：
- 将下载的压缩包解压到本地目录。
- 使用命令行或 IDE 打开项目。

项目结构解析

Spring Boot 项目的目录结构如下：

my-spring-boot-app
├── src
│   ├── main
│   │   ├── java
│   │   │   └── org
│   │   │       └── example
│   │   │           └── myapp
│   │   │               ├── Application.java  # 应用入口类
│   │   │               └── controller
│   │   │                   └── HelloController.java  # 控制器示例
│   │   └── resources
│   │       ├── application.properties  # 配置文件
│   │       └── static  # 静态资源目录
│   └── test
│       └── java
│           └── org
│               └── example
│                   └── myapp
│                       └── MyApplicationTests.java  # 单元测试示例
└── pom.xml  # Maven 配置文件

配置文件详解

Spring Boot 的配置文件通常使用 application.properties 或 application.yml。这里以 application.properties 为例：

# server configuration
server.port=8080
server.servlet.context-path=/api

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

# JPA configuration
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect

这些配置项包括服务器端口、数据库连接信息以及 JPA 选项。

编写第一个 Spring Boot 应用

创建简单的控制器

创建 HelloController：

在 src/main/java/org/example/myapp/controller 目录下创建 HelloController.java。
示例代码如下：

package org.example.myapp.controller;

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

@RestController
@RequestMapping("/hello")
public class HelloController {

   @GetMapping
   public String hello() {
       return "Hello, Spring Boot!";
   }
}

创建 Application 类：

在 src/main/java/org/example/myapp 目录下创建 Application.java。
示例代码如下：

package org.example.myapp;

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

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

配置路由和端口

在 application.properties 文件中已配置端口为 8080，路由为 /api。用户可以通过 http://localhost:8080/api/hello 访问到 HelloController。

运行和测试应用

运行应用：
- 使用 IntelliJ IDEA，右键点击 Application.java，选择 Run 'Application.main()'。
- 或者使用命令行，执行 mvn spring-boot:run。
测试应用：
- 打开浏览器，输入 http://localhost:8080/api/hello，应显示 Hello, Spring Boot!。
- 使用 Postman 或其他工具测试。

常用功能实现

数据库连接配置

配置 application.properties 文件中的数据库连接信息：

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

使用 Spring Boot 集成 JPA

创建实体类：

在 src/main/java/org/example/myapp/model 目录下创建 User.java。
示例代码如下：

package org.example.myapp.model;

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

@Entity
public class User {

   @Id
   @GeneratedValue(strategy = GenerationType.IDENTITY)
   private Long id;
   private String name;
   private String email;

   // getters and setters
}

创建 Repository 接口：

在 src/main/java/org/example/myapp/repository 目录下创建 UserRepository.java。
示例代码如下：

package org.example.myapp.repository;

import org.example.myapp.model.User;
import org.springframework.data.jpa.repository.JpaRepository;

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

创建服务类：

在 src/main/java/org/example/myapp/service 目录下创建 UserService.java。
示例代码如下：

package org.example.myapp.service;

import org.example.myapp.model.User;
import org.example.myapp.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserService {

   @Autowired
   private UserRepository userRepository;

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

静态资源和模板的使用

静态资源：
- 静态资源文件通常放置在 src/main/resources/static 目录下。
- 示例：在 src/main/resources/static 下创建一个 index.html 文件。

模板：

Spring Boot 支持多种模板引擎，如 Thymeleaf、FreeMarker 等。
以 Thymeleaf 为例，配置 application.properties：

spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html

创建 src/main/resources/templates 目录，并在其中创建 index.html 文件。
示例代码如下：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
   <title>Spring Boot Example</title>
</head>
<body>
   <h1>Welcome to Spring Boot!</h1>
</body>
</html>

日志配置和使用

配置日志：
- 可以通过 application.properties 文件配置日志选项，如日志级别：
```
logging.level.org.example.myapp=INFO
logging.level.root=INFO
```

使用日志：

在服务或控制器类中使用 @Slf4j 注解，自动引入日志功能。
示例代码如下：

package org.example.myapp.service;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserService {

   private static final Logger logger = LoggerFactory.getLogger(UserService.class);

   @Autowired
   private UserRepository userRepository;

   public List<User> findAll() {
       logger.info("Fetching all users");
       return userRepository.findAll();
   }
}

单元测试

创建单元测试类：

在 src/test/java/org/example/myapp/repository 目录下创建 UserRepositoryTests.java。
示例代码如下：

package org.example.myapp.repository;

import org.example.myapp.model.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
import org.springframework.test.context.junit4.SpringRunner;
import org.junit.runner.RunWith;

import java.util.List;

import static org.junit.Assert.assertEquals;

@RunWith(SpringRunner.class)
@DataJpaTest
public class UserRepositoryTests {

   @Autowired
   private UserRepository userRepository;

   @org.junit.Test
   public void testFindAll() {
       User user = new User();
       user.setName("Test User");
       user.setEmail("test@example.com");

       userRepository.save(user);

       List<User> allUsers = userRepository.findAll();
       assertEquals(1, allUsers.size());
       assertEquals("Test User", allUsers.get(0).getName());
   }
}

部署 Spring Boot 应用

打包 Spring Boot 应用

使用 Maven 打包：
- 在命令行中，导航到项目根目录，执行以下命令：
```
mvn clean package
```
- 打包完成后，会在 target 目录下生成 my-spring-boot-app-0.0.1-SNAPSHOT.jar 文件。

部署到本地服务器

运行打包后的应用：
- 使用命令行运行打包后的应用：
```
java -jar target/my-spring-boot-app-0.0.1-SNAPSHOT.jar
```
- 应用将启动并监听默认端口（通过配置可以更改端口号）。

部署到云服务器

上传 jar 文件：
- 将 my-spring-boot-app-0.0.1-SNAPSHOT.jar 文件上传到云服务器。
运行应用：
- 使用命令行在云服务器上运行应用：
```
java -jar my-spring-boot-app-0.0.1-SNAPSHOT.jar
```
- 如果需要后台运行，可以使用 nohup 或 screen 工具。
使用云平台服务：
- 使用云平台提供的服务（如 AWS Elastic Beanstalk、Google App Engine 等）部署应用。

通过以上步骤，你已经成功搭建并部署了一个 Spring Boot 应用。希望这个教程能够帮助你快速入门并掌握 Spring Boot 的开发与部署。如果你需要进一步学习 Spring Boot，可以参考慕课网的课程，那里有丰富的 Spring Boot 教程和实战项目。

点击查看更多内容

为 TA 点赞

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

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

守着一只汪

手记
篇

粉丝

11

获赞与收藏

37

关注作者，订阅最新文章

阅读免费教程

后端通用面试教程

41个小节 30787 345

网络编程入门教程

20个小节 12720 239

Pandas 入门教程

25个小节 18599 341

推荐

评论

收藏

共同学习，写下你的评论



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

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

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

支付方式

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

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

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

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

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

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

作者：

免费赠送

兑换码：1111222211 复制

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

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

热搜

最近搜索清空