首页手记 Springboot项目开发入门教程

Springboot项目开发入门教程

标签：

SpringBoot

概述

Spring Boot是一个用来简化Spring应用开发的框架，它能够自动配置大多数应用所需的依赖，使得开发快速而简单。本文将详细介绍Spring Boot项目开发入门的相关知识，包括环境搭建、项目结构、RESTful API开发等内容。

Spring Boot简介

Spring Boot是什么

Spring Boot 是一个用来简化Spring应用开发的框架。开发者只需要将一系列Spring模块添加到项目中，Spring Boot就可以自动配置相关依赖，使得开发者无需手动配置大量的XML或properties文件。它使得Spring应用的开发变得快速、简单，并且具有极高的可配置性和扩展性。

Spring Boot的优势和特点

开箱即用：Spring Boot可以自动配置大多数应用所需的依赖，如Web服务器、数据库连接、安全机制等。
无配置XML：Spring Boot通过注解驱动的方式，减少了XML配置的使用，使代码更加简洁。例如，以下代码展示了如何使用@SpringBootApplication注解启动一个简单的Spring Boot应用：

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

生产就绪特性：提供了一系列生产级别的特性，如健康检查、指标监控、外部配置、日志等。
独立运行：可以将Spring Boot应用打包成一个可执行的Jar或者War文件，支持内嵌的Tomcat、Jetty或Undertow等Web服务器。
自动配置：Spring Boot会根据类路径中的依赖自动配置Spring环境和常用Maven或Gradle依赖。
快速构建：通过Spring Initializr可以快速构建新的Spring Boot项目，大大提高了开发效率。

Spring Boot的核心概念

核心注解：@SpringBootApplication 是Spring Boot项目的启动注解，它包含三个注解：@Configuration、@EnableAutoConfiguration 和@ComponentScan。
启动类：项目中的主入口类，通常命名为Application，使用@SpringBootApplication注解标记。
自动配置：Spring Boot会根据类路径中的依赖自动配置Spring应用，如Spring MVC、Web服务、JPA等。
外部配置：支持通过外部配置文件（如application.properties或application.yml）来覆盖默认配置。
Actuator：Spring Boot Actuator提供了监控和管理应用的功能，如监控应用的健康状态、收集应用的指标数据等。

开发环境搭建

开发工具选择

开发工具的选择主要取决于个人喜好和项目需求。常见的开发工具包括：

IntelliJ IDEA：功能强大且支持各种插件，适合大型项目开发。
Eclipse：易于使用且有丰富的插件支持，适合中小型项目开发。
STS（Spring Tool Suite）：基于Eclipse的开发工具，集成了Spring相关插件，是开发Spring应用的首选工具。

JDK安装及版本要求

Spring Boot通常推荐使用Java 11及以上版本。以下是安装JDK的步骤：

访问Oracle官网或其他官方渠道下载JDK安装包。
按照安装向导完成JDK的安装。
配置环境变量，确保系统能够识别安装的JDK版本。

示例代码：

# 设置JDK环境变量
export JAVA_HOME=/path/to/jdk
export PATH=$JAVA_HOME/bin:$PATH

构建工具Maven的配置

Maven是一个流行的构建工具，可以用来管理依赖和构建项目。以下是Maven的配置步骤：

访问Maven官网下载Maven安装包。
解压下载的压缩包到指定目录。
配置环境变量M2_HOME和Path，确保系统能够识别Maven命令。

示例代码：

# 设置Maven环境变量
export M2_HOME=/path/to/maven
export PATH=$M2_HOME/bin:$PATH

Maven配置文件示例

以下是一个简单的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>demo</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.5.4</version>
  </parent>
  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
  </dependencies>
  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>
</project>

第一个Spring Boot项目

创建Spring Boot项目的方法

常见的创建Spring Boot项目的方法包括使用Spring Initializr、IDE插件等。

使用Spring Initializr：
- 访问Spring Initializr（https://start.spring.io/）网站。
- 选择项目类型（如Maven项目）、语言（Java）、Spring Boot版本等。
- 选择项目依赖（如Web、JPA、Thymeleaf等）。
- 生成项目并下载。
- 将生成的项目解压到IDE中打开。

示例代码：

<!-- 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>demo</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.5.4</version>
  </parent>
  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
  </dependencies>
  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>
</project>

使用IDE插件：
- 在IDE中安装Spring Boot插件，如IntelliJ IDEA的Spring Boot插件。
- 使用插件创建新的Spring Boot项目，选择相应的项目依赖。

理解项目结构

一个典型的Spring Boot项目结构如下：

src
└── main
    ├── java
    │   └── com.example.demo
    │       ├── DemoApplication.java  # 启动类
    │       └── controller          # 控制器
    │           └── HelloController.java
    ├── resources
    │   ├── application.properties  # 项目配置文件
    │   └── static                  # 静态资源文件夹
    │       └── index.html
    └── webapp                      # Web应用文件夹
        └── WEB-INF
            └── views               # 视图文件夹

运行第一个Spring Boot应用

创建一个简单的Hello World应用，只需将以下代码添加到DemoApplication.java文件中：

示例代码：

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
public class DemoApplication {

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

}

@RestController
class HelloController {
  @GetMapping("/")
  String home() {
    return "Hello World!";
  }
}

启动应用，访问http://localhost:8080即可看到"Hello World!"。

Spring Boot常用注解

@SpringBootApplication

@SpringBootApplication 是Spring Boot应用的启动注解，它包含@Configuration、@EnableAutoConfiguration 和@ComponentScan三个注解。

@Configuration：表示当前类是一个配置类，可以使用注解来定义bean。
@EnableAutoConfiguration：启用自动配置功能。
@ComponentScan：扫描指定包下的组件，创建Spring Bean。

示例代码：

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、@Service、@Repository、@Controller等

这些注解用于定义Spring Bean，并告诉Spring框架这些Bean的职责：

@RestController：适用于控制层，@Controller通常用于非REST风格的控制器。
@Service：适用于服务层，实现业务逻辑。
@Repository：适用于数据访问层，如DAO层。
@Component：通用注解，可以用于任何组件。

示例代码：

package com.example.demo.controller;

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

@RestController
public class HelloController {

  @GetMapping("/")
  public String home() {
    return "Hello World!";
  }
}

package com.example.demo.service;

import org.springframework.stereotype.Service;

@Service
public class HelloService {
  public String greet() {
    return "Hello from Service!";
  }
}

package com.example.demo.repository;

import org.springframework.stereotype.Repository;

@Repository
public class HelloRepository {
  public String fetch() {
    return "Hello from Repository!";
  }
}

常用配置注解如@Value、@PropertySource等

@Value 注解用于注入配置属性值，@PropertySource 注解用于指定配置文件的位置。

示例代码：

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.PropertySource;
import org.springframework.context.annotation.PropertySources;
import org.springframework.context.annotation.Value;

@SpringBootApplication
@PropertySources({
  @PropertySource("classpath:application.properties"),
  @PropertySource("classpath:custom.properties")
})
public class DemoApplication {
  @Value("${greeting.message}")
  private String greetingMessage;

  public static void main(String[] args) {
    SpringApplication.run(DemoApplication.class, args);
    System.out.println(new DemoApplication().greetingMessage);
  }
}

RESTful API开发

创建RESTful服务

RESTful服务是指使用HTTP协议进行数据交互的应用。Spring Boot提供了注解简化了RESTful API的开发。

使用Spring MVC注解开发Controller

使用@RestController注解创建控制器，并使用@GetMapping等注解定义HTTP请求处理方法。

示例代码：

package com.example.demo.controller;

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

@RestController
public class HelloController {
  @GetMapping("/")
  public String home() {
    return "Hello World!";
  }
}

使用Spring Data JPA进行数据库操作

Spring Data JPA简化了数据库操作，通过继承JpaRepository接口实现CRUD操作。下面是一个简单的实体类User及其对应的UserRepository接口示例：

示例代码：

package com.example.demo.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.AUTO)
  private Long id;
  private String name;
  private int age;

  // Getter和Setter方法
}

package com.example.demo.repository;

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

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

配置文件使用

application.properties和application.yml的使用

application.properties 和 application.yml是Spring Boot项目的配置文件，用于设置应用的各种属性。通常放在src/main/resources目录下。

示例代码（application.properties）：

# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=root

# JPA配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

# 日志配置
logging.level.root=INFO

示例代码（application.yml）：

spring:
  datasource:
  url: jdbc:mysql://localhost:3306/mydb
  username: root
  password: root
jpa:
  hibernate:
    ddl-auto: update
  show-sql: true

logging:
  level:
    root: INFO

环境变量配置和多环境支持

Spring Boot支持通过环境变量来覆盖配置文件中的属性。例如，可以在应用启动时设置环境变量来切换不同的配置环境（如开发、测试、生产等）。

示例代码：

# 设置环境变量
export SPRING_PROFILES_ACTIVE=dev

属性覆盖机制

Spring Boot的属性覆盖机制使得可以按层次覆盖属性值，例如通过application.properties覆盖application.yml中的属性。

示例代码：

# application.yml
logging:
  level:
    root: INFO

# application.properties
logging.level.root=DEBUG

在上述示例中，application.properties中的logging.level.root属性会覆盖application.yml中的同名属性。

通过以上步骤，你已经了解了Spring Boot的基本概念、开发环境搭建、项目创建、常用注解、RESTful API开发以及配置文件的使用。掌握了这些知识，你可以进一步探索Spring Boot的强大功能，并将其应用到实际项目中。

点击查看更多内容

为 TA 点赞

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

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

函数式编程

手记
篇

粉丝

14

获赞与收藏

30

关注作者，订阅最新文章

阅读免费教程

后端通用面试教程

41个小节 30583 343

网络编程入门教程

20个小节 12561 237

Pandas 入门教程

25个小节 18499 337

推荐

评论

收藏

共同学习，写下你的评论



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

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

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

支付方式

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

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

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

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

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

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

作者：

免费赠送

兑换码：1111222211 复制

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

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

热搜

最近搜索清空

Springboot项目开发入门教程

Spring Boot是什么

Spring Boot的优势和特点

Spring Boot的核心概念

开发工具选择

JDK安装及版本要求

构建工具Maven的配置

Maven配置文件示例

创建Spring Boot项目的方法

理解项目结构

运行第一个Spring Boot应用

@SpringBootApplication

@RestController、@Service、@Repository、@Controller等

常用配置注解如@Value、@PropertySource等

创建RESTful服务

使用Spring MVC注解开发Controller

使用Spring Data JPA进行数据库操作

application.properties和application.yml的使用

环境变量配置和多环境支持

属性覆盖机制

阅读免费教程