首页手记 Springboot3+JDK17搭建后端学习：新手入门指南

Springboot3+JDK17搭建后端学习：新手入门指南

标签：

Java SpringBoot

概述

本文详细介绍了如何使用Springboot3+JDK17搭建后端学习环境，包括JDK17和Spring Boot 3的安装、配置以及开发环境的搭建。文章还涵盖了创建第一个Spring Boot项目、编写RESTful API、数据库集成、项目打包与部署等内容。通过本文，读者可以全面掌握Spring Boot 3和JDK17的开发技巧。

环境搭建

安装JDK17

安装JDK17是开发Spring Boot项目的前提。以下是详细的安装步骤：

访问JDK官网：
- 访问JDK官方网站，选择下载JDK17的版本。
- 确保选择与你操作系统匹配的安装包。
安装JDK：
- 下载完成后，运行安装程序。
- 根据安装向导的提示完成安装。
- 安装完成后，配置环境变量。
配置环境变量：
- 打开系统环境变量设置，添加JDK的安装路径到Path环境变量中。
- 添加JAVA_HOME环境变量，指向JDK的安装目录。

示例配置环境变量：

# Windows系统配置
set JAVA_HOME=C:\Program Files\Java\jdk-17
set Path=%JAVA_HOME%\bin;%Path%

# Linux或Mac系统配置
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
export PATH=$JAVA_HOME/bin:$PATH

安装Spring Boot 3

安装Spring Boot 3通常不需要单独安装，而是通过Spring Initializr、Maven或Gradle来创建和管理项目。以下是具体步骤：

使用Spring Initializr：
- 访问Spring Initializr官网。
- 选择Spring Boot版本3.x。
- 选择所需的依赖和配置，如Web、JPA等。
- 点击“生成”按钮，下载项目压缩包。
使用Maven或Gradle创建项目：
- 使用Maven或Gradle的命令行工具，根据Spring Boot的配置文件创建项目。
- 示例使用Maven创建项目：

mvn archetype:generate -DgroupId=com.example -DartifactId=my-springboot-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

示例使用Gradle创建项目：

gradle init --type basic --dsl groovy

配置IDE开发环境（推荐使用IntelliJ IDEA或STS）

安装IDE：
- 下载并安装IntelliJ IDEA或Spring Tool Suite (STS)。
导入Spring Boot项目：
- 打开IDE，选择导入现有项目。
- 导入下载的Spring Boot项目压缩包。
配置IDE：
- 配置项目依赖。
- 使用Maven或Gradle进行项目同步。
- 开启IDE的自动构建和自动保存功能。

创建第一个Spring Boot项目

使用Spring Initializr创建项目

使用Spring Initializr创建Spring Boot项目是一种快速启动的方式。以下是步骤：

访问Spring Initializr官网：
- 打开浏览器，访问Spring Initializr官网。
- 选择Spring Boot版本3.x。
- 选择项目所需的依赖，例如Web、JPA等。
生成项目：
- 设置项目的基本信息，如Group、Artifact等。
- 点击“Generate”按钮，生成项目压缩包。
- 下载并解压压缩包，导入IDE中。

项目结构介绍

Spring Boot项目的结构通常包括以下部分：

src/main/java：Java源代码目录。
src/main/resources：资源文件目录，如配置文件、模板文件等。
pom.xml：Maven项目配置文件。
README.md：项目说明文件。

项目结构示例

my-springboot-app
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com
│   │   │       └── example
│   │   │           └── myapp
│   │   │               ├── Application.java
│   │   │               └── controller
│   │   │                   └── HelloController.java
│   │   └── resources
│   │       ├── application.yml
│   │       └── static
│   │           └── index.html
├── pom.xml
└── README.md

添加基本依赖

在pom.xml文件中添加基本的依赖，如Spring Boot Starter Web、Spring Boot Starter Data JPA等。

示例pom.xml文件

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>my-springboot-app</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.0.0</version>
    </parent>
    <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>com.h2database</groupId>
            <artifactId>h2</artifactId>
            <scope>runtime</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

编写第一个RESTful API

创建Controller类

在src/main/java目录下创建一个新的Java类，用于创建RESTful API。

示例Controller类

package com.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("/api/hello")
public class HelloController {

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

编写GET和POST请求方法

示例GET请求方法

package com.example.myapp.controller;

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

@RestController
@RequestMapping("/api/user")
public class UserController {

    @GetMapping("/get/{id}")
    public String getUserById(@PathVariable int id) {
        return "User with id " + id;
    }
}

示例POST请求方法

package com.example.myapp.controller;

import com.example.myapp.domain.User;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api/user")
public class UserController {

    @PostMapping("/add")
    public String addUser(@RequestBody User user) {
        // 处理添加用户逻辑
        return "User created: " + user.getName();
    }
}

测试API

可以使用Postman或者IDE自带的工具来测试API。以下是使用Postman测试GET请求的步骤：

打开Postman。
输入请求URL，如http://localhost:8080/api/hello/hello。
选择GET方法。
点击Send按钮，查看响应结果。

数据库集成

添加数据库依赖

在pom.xml中添加数据库相关的依赖。示例如下：

示例pom.xml文件

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

配置数据库连接

在src/main/resources目录下的application.yml文件中配置数据库连接信息。

示例application.yml文件

spring:
  application:
   name: my-springboot-app
   datasource:
      url: jdbc:h2:mem:testdb
      driverClassName: org.h2.Driver
      username: sa
      password:
   jpa:
      hibernate:
         ddl-auto: create-drop
      show-sql: true

对于MySQL数据库，配置如下：

spring:
  application:
   name: my-springboot-app
   datasource:
      url: jdbc:mysql://localhost:3306/mydb
      username: root
      password: password
      driverClassName: com.mysql.jdbc.Driver
      hikaricp:
         maximum-pool-size: 30
         minimum-idle: 10
   jpa:
      hibernate:
         ddl-auto: update
      show-sql: true

使用JPA操作数据库

定义实体类和对应的Repository接口。

示例实体类

package com.example.myapp.domain;

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接口

package com.example.myapp.repository;

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

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

实践示例

创建服务类

package com.example.myapp.service;

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

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

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

项目打包与部署

使用Maven打包项目

使用Maven打包项目，生成一个可执行的JAR文件。

使用Maven打包项目

mvn clean package

部署到本地Tomcat服务器

将打包好的JAR文件部署到本地的Tomcat服务器。

示例启动脚本

java -jar target/my-springboot-app-1.0.0.jar

其他部署方式介绍（如Docker、云服务）

使用Docker部署

创建Dockerfile文件。
编写Dockerfile内容。
构建并运行Docker容器。

示例Dockerfile

FROM maven:3.8.4-openjdk-17 AS build
COPY src /usr/src/my-springboot-app/src
COPY pom.xml /usr/src/my-springboot-app
RUN mvn -f /usr/src/my-springboot-app/pom.xml clean package -DskipTests

FROM openjdk:17-jdk-alpine
COPY --from=build /usr/src/my-springboot-app/target/my-springboot-app-1.0.0.jar app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

使用云服务部署

注册云服务提供商账号（如阿里云、腾讯云等）。
创建新的实例。
上传并部署项目包。

常见问题与解决方法

常见错误及解决办法

依赖冲突：
- 查看pom.xml文件，确保依赖版本一致。
- 使用Maven或Gradle的dependency:tree命令查看依赖树。
- 适当调整依赖版本或排除冲突的依赖。

示例解决依赖冲突：

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

配置文件错误：
- 检查application.yml或application.properties配置文件。
- 确保配置项正确无误。
- 使用IDE的格式化功能，确保文件格式正确。

示例配置文件错误解决

server:
   port: 8080

性能优化技巧

使用Spring Profiles：
- 根据不同的环境（如开发、测试、生产）启用不同的配置文件。
- 示例使用spring.profiles.active属性。
配置缓存：
- 使用Spring Cache注解缓存频繁调用的方法。
- 配置缓存管理器和缓存提供者。

示例启用缓存

import org.springframework.cache.annotation.Cacheable;
import org.springframework.stereotype.Service;

@Service
public class UserService {

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

日志管理和监控

配置日志框架：
- 使用Logback或Log4j配置日志输出级别和格式。
- 在application.yml中配置日志级别。
使用监控工具：
- 使用Prometheus、Grafana或Spring Boot Actuator监控应用指标。
- 配置Actuator端点。

示例配置日志

logging:
 root:
   level: info
   loggers:
      com.example.myapp:
         level: debug

示例监控配置

management:
 endpoints:
   web:
      exposure:
         include: "*"
   endpoint:
      health:
         show-details: always

以上是Spring Boot 3和JDK17搭建后端项目的完整指南，涵盖了环境搭建、项目创建、RESTful API编写、数据库集成、项目打包与部署，以及常见问题解决和性能优化等内容。希望这篇指南能帮助你快速上手开发Spring Boot应用。

点击查看更多内容

为 TA 点赞

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

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

慕标琳琳

手记
篇

粉丝

18

获赞与收藏

140

关注作者，订阅最新文章

阅读免费教程

Java并发工具

23个小节 19278 315

Java 并发原理入门教程

26个小节 39003 568

Java 入门教程

50个小节 342046 3165

推荐

评论

收藏

共同学习，写下你的评论



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

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

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

支付方式

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

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

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

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

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

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

作者：

免费赠送

兑换码：1111222211 复制

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

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

热搜

最近搜索清空

Springboot3+JDK17搭建后端学习：新手入门指南

安装JDK17

安装Spring Boot 3

配置IDE开发环境（推荐使用IntelliJ IDEA或STS）

使用Spring Initializr创建项目

项目结构介绍

项目结构示例

添加基本依赖

示例pom.xml文件

创建Controller类

示例Controller类

编写GET和POST请求方法

示例GET请求方法

示例POST请求方法

测试API

添加数据库依赖

示例pom.xml文件

配置数据库连接

示例application.yml文件

使用JPA操作数据库

示例实体类

示例Repository接口

实践示例

创建服务类

使用Maven打包项目

使用Maven打包项目

部署到本地Tomcat服务器

示例启动脚本

其他部署方式介绍（如Docker、云服务）

使用Docker部署

示例Dockerfile

使用云服务部署

常见错误及解决办法

示例配置文件错误解决

性能优化技巧

示例启用缓存

日志管理和监控

示例配置日志

示例监控配置

阅读免费教程