为了账号安全，请及时绑定邮箱和手机立即绑定
首页 手记 Springboot框架入门教程：从零开始搭建你的第一...

Springboot框架入门教程：从零开始搭建你的第一个Spring Boot应用

标签：
SpringBoot
概述

Spring Boot框架通过自动配置和约定优于配置的原则，简化了Java应用程序的开发和部署过程。它提供了一系列的起步依赖和内嵌的Tomcat服务器，使得开发者可以更快地构建独立的、生产级别的应用。Spring Boot还支持外部化配置和健康检查，进一步提升了应用的可维护性和可靠性。

Spring Boot简介

什么是Spring Boot

Spring Boot是由Pivotal团队提供的一个基于Spring平台的框架，旨在简化Java应用程序的开发、部署和运行过程。Spring Boot通过自动配置和约定优于配置（Convention over Configuration）的原则，减少了开发者在配置文件上的工作量，使得开发者可以更快地构建独立的、生产级别的应用。

Spring Boot的主要特性

  1. 自动配置（Auto-Configuration）：Spring Boot可以根据所引入的依赖自动配置Spring框架。例如，如果你引入了spring-boot-starter-web依赖，Spring Boot将自动配置Tomcat服务器和Spring MVC。

  2. 起步依赖（Starters）：Spring Boot提供了一系列的起步依赖，将项目的依赖管理简化为一个或多个起步依赖的引入。例如，spring-boot-starter-web包含了Spring MVC所需的所有依赖，spring-boot-starter-data-jpa包含了Spring Data JPA所需的依赖。

  3. 独立运行的应用（独立的可执行的jar包）：Spring Boot支持将应用打包为独立运行的jar包，通过java -jar可以直接运行，无需额外配置Tomcat或Jetty服务器。

  4. 外部化配置（Externalized Configuration）：支持从命令行参数、环境变量、系统属性、应用属性文件等多个来源读取配置。默认配置文件名为application.properties或application.yml。

  5. 内嵌的Tomcat、Jetty或Undertow：Spring Boot可以内嵌配置和运行Tomcat、Jetty或Undertow，使得应用可以作为一个独立的可执行文件运行。

  6. 健康检查和指标：Spring Boot提供了内置的健康检查和性能指标监控，如Actuator模块。

  7. 嵌入式脚本支持：支持Groovy等脚本语言的嵌入式执行。

为什么选择Spring Boot

  • 简化配置：Spring Boot通过约定优于配置的原则，大大减少了配置文件的编写工作量。
  • 快速启动：使用Spring Boot，开发者可以快速启动一个独立的应用，不需要复杂的配置。
  • 自动配置：Spring Boot可以自动配置大部分组件，减少了代码的编写量。
  • 依赖管理：使用起步依赖，可以简化项目的依赖管理，减少了版本兼容性问题。
  • 生产就绪：提供了生产环境所需的特性，如健康检查、性能监控、日志管理等。
  • 社区支持：Spring Boot拥有庞大的社区支持，提供了大量的文档、教程和插件。

开发环境搭建

安装Java开发环境

为了开发Spring Boot应用，首先需要安装Java开发环境。推荐使用JDK 11及以上版本。以下是安装步骤：

  1. 访问Oracle官网或AdoptOpenJDK官网下载JDK。
  2. 安装下载的JDK，确保安装路径正确。
  3. 配置环境变量。编辑系统环境变量，添加JDK的bin目录到PATH环境变量中。
export JAVA_HOME=/path/to/jdk
export PATH=$JAVA_HOME/bin:$PATH
  1. 验证安装是否成功，打开命令行输入java -version，应该能输出Java版本信息。

安装IDE（如IntelliJ IDEA或Spring Tool Suite）

推荐使用IntelliJ IDEA作为开发IDE，因为它提供了强大的Spring Boot支持和插件。

  1. 访问JetBrains官网下载IntelliJ IDEA。
  2. 安装IntelliJ IDEA，选择适合的版本（社区版或专业版）。
  3. 打开IntelliJ IDEA，通过File -> New -> Project创建一个新的项目。

配置Maven或Gradle构建工具

为了管理和构建项目，需要配置Maven或Gradle构建工具。

  1. Maven：

    • 下载并安装Maven，配置环境变量MAVEN_HOME。
    • 编辑系统环境变量，将MAVEN_HOME/bin添加到PATH中。
  2. Gradle：
    • 下载并安装Gradle，配置环境变量GRADLE_HOME。
    • 编辑系统环境变量，将GRADLE_HOME/bin添加到PATH中。

验证安装是否成功，输入mvn -version或gradle -v，应该能输出Maven或Gradle版本信息。

创建第一个Spring Boot项目

使用Spring Initializr生成项目

Spring Initializr是一个在线工具，可以帮助你快速创建Spring Boot项目。以下是使用Spring Initializr创建项目的步骤：

  1. 访问Spring Initializr网站（https://start.spring.io/）。
  2. 选择项目类型（Maven、Gradle、Spring Boot版本等）。
  3. 填写项目基本信息（如项目名spring-boot-hello、项目包名com.example等）。
  4. 选择所需的技术栈（例如，Spring Web、Spring Data JPA等）。
  5. 点击Generate按钮下载生成的项目压缩包。
  6. 解压缩下载的项目压缩包，将其导入到IDE中。

项目结构解析

生成的项目结构通常如下：

spring-boot-hello
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com
│   │   │       └── example
│   │   │           └── demo
│   │   │               ├── DemoApplication.java
│   │   │               ├── controller
│   │   │               │   └── HelloController.java
│   │   │               └── repository
│   │   │                   └── UserRepository.java
│   │   └── resources
│   │       ├── application.properties
│   │       └── static
│   │           └── index.html
│   └── test
│       └── java
│           └── com
│               └── example
│                   └── demo
│                       └── DemoApplicationTests.java
└── pom.xml
  • src/main/java：项目源代码目录。
  • src/main/resources：资源文件目录，如application.properties配置文件。
  • pom.xml：Maven项目描述文件。

生成的项目中，包含以下文件：

// DemoApplication.java
package com.example.demo;

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);
    }
}

// HelloController.java
package com.example.demo.controller;

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

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

配置application.properties文件

application.properties文件用于配置应用的各种属性，例如数据库连接信息、端口号等。

server.port=8080
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

核心概念与常用注解

@SpringBootApplication注解详解

@SpringBootApplication是一个组合注解，包含了几个重要注解的功能：

  • @Configuration：声明当前类是一个配置类。
  • @EnableAutoConfiguration：启用自动配置。
  • @ComponentScan：扫描并加载当前类路径下的所有组件。
package com.example.demo;

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);
    }
}

@RestController和@RequestMapping注解的使用

@RestController注解用于声明一个RESTful Controller，而@RequestMapping则用于映射HTTP请求到控制器的处理方法。

package com.example.demo.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/v1")
public class HelloController {

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

@Service, @Repository, @Component注解介绍

@Service、@Repository、@Component都是Spring框架提供的注解，用于标识类的类型和角色。

  • @Service：用于标注业务逻辑层。
  • @Repository：用于标注数据访问层。
  • @Component：通用注解，表示一个组件。
package com.example.demo.repository;

import org.springframework.stereotype.Repository;

@Repository
public class UserRepository {
    public User getUserById(Long id) {
        // 实现从数据库中获取用户
        return new User();
    }
}

package com.example.demo.service;

import org.springframework.stereotype.Service;

@Service
public class UserService {
    UserRepository userRepository;

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

实战：构建一个简单的REST API

创建RESTful服务端点

创建RESTful服务端点，提供获取用户信息的功能。

package com.example.demo.controller;

import org.springframework.beans.factory.annotation.Autowired;
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/v1")
public class UserController {

    @Autowired
    private UserService userService;

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

操作数据库（使用Spring Data JPA）

使用Spring Data JPA简化数据库操作。

package com.example.demo.repository;

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

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

package com.example.demo.entity;

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

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

    // Getters and Setters
}

添加单元测试

编写单元测试来验证REST API的正确性。

package com.example.demo;

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.test.web.servlet.MockMvc;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

@WebMvcTest(UserController.class)
public class UserControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @Test
    public void shouldReturnDefaultMessage() throws Exception {
        mockMvc.perform(get("/api/v1/user/1"))
                .andExpect(status().isOk())
                .andExpect(content().string("User with id 1"));
    }
}

部署与运行

打包Spring Boot应用

使用Maven或Gradle打包Spring Boot应用。

  • Maven：

    mvn clean package
  • Gradle： 
    ./gradlew bootJar

生成的可执行jar包位于target目录下（Maven）或build/libs目录下（Gradle）。

使用Tomcat或Jetty运行应用

直接运行打包的jar包即可。

java -jar target/*.jar

部署到云平台（如Heroku, AWS Elastic Beanstalk）

部署到Heroku：

  1. 安装Heroku CLI。
  2. 登录Heroku，创建应用。
  3. 使用heroku apps:create your-app-name创建应用。
  4. 设置环境变量。
  5. 部署应用，上传jar包。

具体步骤如下：

# 部署到Heroku
heroku create your-app-name
heroku config:set SPRING_PROFILES_ACTIVE=prod
heroku config:set JAVA_OPTS="-Xmx300m"
mvn clean package -DskipTests
heroku buildpacks:set heroku/java
heroku apps:info
heroku logs --tail

部署到AWS Elastic Beanstalk：

  1. 登录AWS控制台，创建Elastic Beanstalk应用。
  2. 创建应用版本，上传jar包。
  3. 部署应用。

总结

通过本教程，你已经学习了如何使用Spring Boot快速搭建一个简单的REST API应用，并将其部署到不同的环境中。Spring Boot框架简化了开发流程，使得开发者可以更专注于业务逻辑的实现。希望这篇教程能够帮助你掌握Spring Boot的基础知识和实际应用。

点击查看更多内容
发表于 2024.10.21 19:10， 共 66 人浏览

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

举报
为 TA 点赞

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

评论

作者其他优质文章

正在加载中

慕村9548890

手记
篇
粉丝
227
获赞与收藏
991

关注作者，订阅最新文章

阅读免费教程

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

100积分直接送

付费专栏免费学

大额优惠券免费领

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

举报

0/150
提交
取消