原文： http://zetcode.com/springboot/mysql/

Spring Boot MySQL 教程展示了如何在 Spring Boot 应用中使用 MySQL 数据库。

Spring 是用于创建企业应用的流行 Java 应用框架。 Spring Boot 是 Spring 框架的演进，可帮助您轻松创建独立的，生产级的基于 Spring 的应用。

MySQL

MySQL 是领先的开源数据库管理系统。 它是一个多用户，多线程的数据库管理系统。 MySQL 在网络上特别流行。 它是非常流行的 LAMP 平台的一部分，该平台包括 Linux，Apache，MySQL 和 PHP。 MySQL 数据库在最重要的 OS 平台上可用。 它可以在 BSD Unix，Linux，Windows 和 Mac 上运行。

MySQL 设置

我们将展示如何在 Debian Linux 系统上安装 MySQL 数据库。

  1. $ sudo apt-get install mysql-server

此命令将安装 MySQL 服务器和相关包。

  1. $ sudo service mysql start
  2. $ sudo service mysql stop

这两个命令用于启动和停止 MySQL。

  1. $ sudo service mysql status

我们使用service mysql status命令检查数据库的状态。

  1. $ mysql -u root -p

现在我们需要重置根密码。 我们启动 mysql 命令行工具。 （服务器必须正在运行。）我们以root用户身份连接。

  1. mysql> SET PASSWORD = PASSWORD('newpassowrd');

我们为root设置了新密码。

  1. $ mysql_secure_installation

我们可以使用mysql_secure_installation来提高 MySQL 服务器的安全性。 我们可以选择改进 MySQL 的root密码，删除匿名用户帐户，禁用 localhost 外部的root登录以及删除测试数据库。

  1. mysql> CREATE DATABASE testdb;

我们创建一个新的testdb数据库。

  1. mysql> CREATE USER user12@localhost IDENTIFIED BY 's$cret';
  2. mysql> GRANT ALL ON testdb.* TO user12@localhost;

我们创建一个新的 MySQL 用户并将其特权授予testdb数据库。

创建 MySQL 表

现在，我们将创建一个名为cities的新 MySQL 表。

cities_mysql.sql

  1. DROP TABLE IF EXISTS cities;
  2. CREATE TABLE cities(id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(255),
  3.     population INT);
  5. INSERT INTO cities(name, population) VALUES('Bratislava', 432000);
  6. INSERT INTO cities(name, population) VALUES('Budapest', 1759000);
  7. INSERT INTO cities(name, population) VALUES('Prague', 1280000);
  8. INSERT INTO cities(name, population) VALUES('Warsaw', 1748000);
  9. INSERT INTO cities(name, population) VALUES('Los Angeles', 3971000);
  10. INSERT INTO cities(name, population) VALUES('New York', 8550000);
  11. INSERT INTO cities(name, population) VALUES('Edinburgh', 464000);
  12. INSERT INTO cities(name, population) VALUES('Berlin', 3671000);

这是用于创建cities表的 SQL。

  1. mysql> use testdb;
  2. mysql> source cities_mysql.sql

使用source命令，执行 SQL 语句。

Spring Boot MySQL 示例

以下应用是一个简单的 Spring Boot Web 应用，它使用 MySQL 数据库。 我们有一个主页，带有一个链接，用于显示数据库表中的数据。 我们使用 Freemarker 模板系统将数据与 HTML 连接。

  1. pom.xml
  2. src
  3. └── main
  4.     ├── java
  5.     │   └── com
  6.     │       └── zetcode
  7.     │           ├── Application.java
  8.     │           ├── model
  9.     │           │   └── City.java
  10.     │           ├── controller
  11.     │           │   └── MyController.java
  12.     │           ├── repository
  13.     │           │   └── CityRepository.java
  14.     │           └── service
  15.     │               ├── CityService.java
  16.     │               └── ICityService.java
  17.     └── resources
  18.         ├── application.properties
  19.         ├── static
  20.         │   └── index.html
  21.         └── templates
  22.             └── showCities.ftl

这是项目结构。

pom.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0"
  3.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
  5. http://maven.apache.org/xsd/maven-4.0.0.xsd">
  7.     <modelVersion>4.0.0</modelVersion>
  8.     <groupId>com.zetcode</groupId>
  9.     <artifactId>springbootmysqlex</artifactId>
  10.     <version>1.0-SNAPSHOT</version>
  11.     <packaging>jar</packaging>
  13.     <properties>
  14.         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  15.         <maven.compiler.source>11</maven.compiler.source>
  16.         <maven.compiler.target>11</maven.compiler.target>
  17.     </properties>
  19.     <parent>
  20.         <groupId>org.springframework.boot</groupId>
  21.         <artifactId>spring-boot-starter-parent</artifactId>
  22.         <version>2.1.1.RELEASE</version>
  23.     </parent>
  25.     <dependencies>
  26.         <dependency>
  27.             <groupId>org.springframework.boot</groupId>
  28.             <artifactId>spring-boot-starter-web</artifactId>
  29.         </dependency>
  31.         <dependency>
  32.             <groupId>mysql</groupId>
  33.             <artifactId>mysql-connector-java</artifactId>
  34.             <scope>runtime</scope>
  35.         </dependency>
  37.         <dependency>
  38.             <groupId>org.springframework.boot</groupId>
  39.             <artifactId>spring-boot-starter-freemarker</artifactId>
  40.         </dependency>
  42.         <dependency>
  43.             <groupId>org.springframework.boot</groupId>
  44.             <artifactId>spring-boot-starter-data-jpa</artifactId>
  45.         </dependency>
  46.     </dependencies>
  48.     <build>
  49.         <plugins>
  50.             <plugin>
  51.                 <groupId>org.springframework.boot</groupId>
  52.                 <artifactId>spring-boot-maven-plugin</artifactId>
  53.             </plugin>
  54.         </plugins>
  55.     </build>
  56. </project>

Spring Boot 启动器是一组方便的依赖项描述符，可以极大地简化 Maven 配置。 spring-boot-starter-parent具有 Spring Boot 应用的一些常用配置。 spring-boot-starter-web是使用 Spring MVC 构建 Web（包括 RESTful）应用的入门工具。 spring-boot-starter-freemarker是使用 Freemarker 视图构建 MVC Web 应用的入门工具。 spring-boot-starter-data-jpa是将 Spring Data JPA 与 Hibernate 结合使用的入门工具。

mysql-connector-java依赖项是针对 MySQL 数据库驱动程序的。

spring-boot-maven-plugin在 Maven 中提供了 Spring Boot 支持，使我们可以打包可执行的 JAR 或 WAR 档案。 它的spring-boot:run目标运行 Spring Boot 应用。

resources/application.properties

  1. spring.main.banner-mode=off
  2. logging.level.org.springframework=ERROR
  4. spring.datasource.url=jdbc:mysql://localhost:3306/testdb?useSSL=false
  5. spring.datasource.username=user12
  6. spring.datasource.password=s$cret

在application.properties文件中，我们编写了 Spring Boot 应用的各种配置设置。 使用spring.main.banner-mode属性，我们可以关闭 Spring 横幅。 使用logging.level.org.springframework，我们将 spring 框架的日志记录级别设置为ERROR。 在 spring 数据源属性中，我们设置了 MySQL 数据源。

com/zetcode/model/City.java

  1. package com.zetcode.model;
  3. import java.util.Objects;
  4. import javax.persistence.Entity;
  5. import javax.persistence.GeneratedValue;
  6. import javax.persistence.GenerationType;
  7. import javax.persistence.Id;
  8. import javax.persistence.Table;
  10. @Entity
  11. @Table(name = "cities")
  12. public class City {
  14.     @Id
  15.     @GeneratedValue(strategy = GenerationType.AUTO)
  16.     private Long id;
  18.     private String name;
  19.     private int population;
  21.     public City() {
  22.     }
  24.     public City(Long id, String name, int population) {
  25.         this.id = id;
  26.         this.name = name;
  27.         this.population = population;
  28.     }
  30.     public Long getId() {
  31.         return id;
  32.     }
  34.     public void setId(Long id) {
  35.         this.id = id;
  36.     }
  38.     public String getName() {
  39.         return name;
  40.     }
  42.     public void setName(String name) {
  43.         this.name = name;
  44.     }
  46.     public int getPopulation() {
  47.         return population;
  48.     }
  50.     public void setPopulation(int population) {
  51.         this.population = population;
  52.     }
  54.     @Override
  55.     public int hashCode() {
  56.         int hash = 7;
  57.         hash = 79 * hash + Objects.hashCode(this.id);
  58.         hash = 79 * hash + Objects.hashCode(this.name);
  59.         hash = 79 * hash + this.population;
  60.         return hash;
  61.     }
  63.     @Override
  64.     public boolean equals(Object obj) {
  65.         if (this == obj) {
  66.             return true;
  67.         }
  68.         if (obj == null) {
  69.             return false;
  70.         }
  71.         if (getClass() != obj.getClass()) {
  72.             return false;
  73.         }
  74.         final City other = (City) obj;
  75.         if (this.population != other.population) {
  76.             return false;
  77.         }
  78.         if (!Objects.equals(this.name, other.name)) {
  79.             return false;
  80.         }
  81.         return Objects.equals(this.id, other.id);
  82.     }
  84.     @Override
  85.     public String toString() {
  86.         final StringBuilder sb = new StringBuilder("City{");
  87.         sb.append("id=").append(id);
  88.         sb.append(", name='").append(name).append('\'');
  89.         sb.append(", population=").append(population);
  90.         sb.append('}');
  91.         return sb.toString();
  92.     }
  93. }

这是City实体。 每个实体必须至少定义两个注解：@Entity和@Id。

  1. @Entity
  2. @Table(name = "cities")
  3. public class City {

@Entity注解指定该类是一个实体，并映射到数据库表，而@Table注解指定要用于映射的数据库表的名称。

  1. @Id
  2. @GeneratedValue(strategy = GenerationType.AUTO)
  3. private Long id;

实体的主键由@Id注解指定。 @GeneratedValue提供了一种用于生成主键值的策略。

com/zetcode/CityRepository.java

  1. package com.zetcode.repository;
  3. import com.zetcode.model.City;
  4. import org.springframework.data.repository.CrudRepository;
  5. import org.springframework.stereotype.Repository;
  7. @Repository
  8. public interface CityRepository extends CrudRepository<City, Long> {
  10. }

通过从 Spring CrudRepository扩展，我们将为我们的数据存储库实现一些方法，包括findAll()。 这样，我们节省了大量样板代码。

com/zetcode/service/ICityService.java

  1. package com.zetcode.service;
  3. import com.zetcode.model.City;
  4. import java.util.List;
  6. public interface ICityService {
  8.     List<City> findAll();
  9. }

ICityService提供findAll()契约方法声明，以从数据源获取所有城市。

com/zetcode/service/CityService.java

  1. package com.zetcode.service;
  3. import com.zetcode.model.City;
  4. import com.zetcode.repository.CityRepository;
  5. import java.util.List;
  6. import org.springframework.beans.factory.annotation.Autowired;
  7. import org.springframework.stereotype.Service;
  9. @Service
  10. public class CityService implements ICityService {
  12.     @Autowired
  13.     private CityRepository repository;
  15.     @Override
  16.     public List<City> findAll() {
  18.         return (List<City>) repository.findAll();
  19.     }
  20. }

CityService包含findAll()方法的实现。 我们使用存储库从数据库检索数据。

  1. @Autowired
  2. private CityRepository repository;

注入CityRepository。

  1. return (List<City>) repository.findAll();

存储库的findAll()方法返回城市列表。

com/zetcode/MyController.java

  1. package com.zetcode.controller;
  3. import com.zetcode.model.City;
  4. import com.zetcode.service.ICityService;
  5. import java.util.List;
  6. import org.springframework.beans.factory.annotation.Autowired;
  7. import org.springframework.stereotype.Controller;
  8. import org.springframework.ui.Model;
  9. import org.springframework.web.bind.annotation.GetMapping;
  11. @Controller
  12. public class MyController {
  14.     @Autowired
  15.     private ICityService cityService;
  17.     @GetMapping("/showCities")
  18.     public String findCities(Model model) {
  20.         var cities = (List<City>) cityService.findAll();
  22.         model.addAttribute("cities", cities);
  24.         return "showCities";
  25.     }
  26. }

MyController类用@Controller注解。

  1. @Autowired
  2. private ICityService cityService;

我们将ICityService注入countryService字段。

  1. @GetMapping("/showCities")
  2. public String findCities(Model model) {
  4.     var cities = (List<City>) cityService.findAll();
  6.     model.addAttribute("cities", cities);
  8.     return "showCities";
  9. }

我们将带有/showCities路径的请求映射到控制器的findCities()方法。 @GetMapping注解将 GET 请求映射到该方法。 该模型将获取城市列表，并将处理过程发送到showCities.ftl Freemarker 模板文件。

resources/templates/showCities.ftl

  1. <!DOCTYPE html>
  2. <html>
  3.     <head>
  4.         <title>Cities</title>
  5.         <meta charset="UTF-8">
  6.         <meta name="viewport" content="width=device-width, initial-scale=1.0">
  7.         </head>
  8.     <body>
  9.         <h2>List of cities</h2>
  11.         <table>
  12.             <tr>
  13.                 <th>Id</th>
  14.                 <th>Name</th>
  15.                 <th>Population</th>
  16.             </tr>
  18.             <#list cities as city>
  19.                 <tr>
  20.                     <td>${city.id}</td>
  21.                     <td>${city.name}</td>
  22.                     <td>${city.population}</td>
  23.                 </tr>
  24.             </#list>
  25.         </table>
  26.     </body>
  27. </html>

在showCities.ftl模板文件中，我们在 HTML 表中显示数据。

resources/static/index.html

  1. <!DOCTYPE html>
  2. <html>
  3.     <head>
  4.         <title>Home page</title>
  5.         <meta charset="UTF-8"/>
  6.         <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
  7.     </head>
  8.     <body>
  9.         <a href="showCities">Show cities</a>
  10.     </body>
  11. </html>

index.html中有一个链接，显示所有城市。

com/zetcode/Application.java

  1. package com.zetcode;
  3. import org.springframework.boot.SpringApplication;
  4. import org.springframework.boot.autoconfigure.SpringBootApplication;
  6. @SpringBootApplication
  7. public class Application {
  9.     public static void main(String[] args) {
  10.         SpringApplication.run(Application.class, args);
  11.     }
  12. }

Application设置 Spring Boot 应用。 @SpringBootApplication启用自动配置和组件扫描。

  1. $ mvn spring-boot:run

应用运行后，我们可以导航到localhost:8080。

在本教程中，我们展示了如何在 Spring Boot 应用中使用 MySQL 数据库。 您可能也对相关教程感兴趣：

查找所有 Spring Boot 教程。