创建springboot项目资料：新手入门教程

本文详细介绍了如何创建Spring Boot项目资料，包括安装开发环境、配置IDE以及使用Spring Initializr工具快速生成项目。文章还讲解了项目的基本结构和如何添加依赖并启动项目，帮助读者快速上手Spring Boot开发。

1. 引入Spring Boot框架

1.1 Spring Boot简介

Spring Boot是一个开源框架，它简化了使用Spring框架开发新应用的过程。Spring Boot提供了快速整合各种Spring模块的方法，支持“约定优于配置”的设计哲学，从而使得开发人员可以更快地构建独立的、生产级别的应用程序。

1.2 Spring Boot的主要优点

• 约定优于配置：Spring Boot通过约定来减少代码量，你不需要编写大量的配置代码来配置Spring框架，它会帮助你自动配置。
• 自动配置：默认情况下，Spring Boot会根据项目中引入的依赖自动配置所需的内容。
• 嵌入式服务器支持：Spring Boot内置了Tomcat、Jetty或Undertow作为应用服务器，并省去了配置web.xml的麻烦。
• 开箱即用的特性：例如，日志、安全、数据访问和缓存等都是开箱即用的。
• 多模块支持：支持使用Maven或Gradle构建多模块项目。
• 无需大量配置：开发人员可以快速创建独立的、完整的、生产级别的应用。

2. 安装与配置开发环境

2.1 下载与安装JDK

首先，下载并安装Java Development Kit (JDK)。访问官方JDK下载页面，下载适合你操作系统的版本。

# 示例：安装JDK 11
wget --no-check-certificate --no-cookies --header "Cookie: oraclelicense=accept-securebackup-cookie" http://download.oracle.com/otn-pub/java/jdk/11.0.1+13/ojdk-11.0.1_linux-x64_bin.tar.gz
tar -xvf ojdk-11.0.1_linux-x64_bin.tar.gz
sudo mkdir /usr/local/java
sudo mv jdk-11.0.1 /usr/local/java/
sudo update-alternatives --install /usr/bin/java java /usr/local/java/jdk-11.0.1/bin/java 200
sudo update-alternatives --install /usr/bin/javac javac /usr/local/java/jdk-11.0.1/bin/javac 200

检查Java版本以确保安装成功：

java -version

2.2 安装并配置IDE（如IntelliJ IDEA或Eclipse）

选择一个合适的集成开发环境（IDE）来开发Spring Boot应用程序，如IntelliJ IDEA或Eclipse。

IntelliJ IDEA

1. 下载IntelliJ IDEA社区版或专业版。
2. 安装完成后，运行IntelliJ IDEA。
3. 创建一个新的Spring Boot项目。

Eclipse

1. 下载Eclipse IDE for Enterprise Java Developers。
2. 安装完成后，打开Eclipse。
3. 创建一个新的Spring Boot项目，可以使用Spring Tools Suite (STS)插件。

2.3 安装Spring Boot插件

在IntelliJ IDEA或Eclipse中安装Spring Boot插件。

IntelliJ IDEA

1. 打开IntelliJ IDEA。
2. 选择File -> Settings。
3. 在左侧导航栏选择Plugins。
4. 搜索Spring Boot，然后点击Install。

Eclipse

1. 打开Eclipse。
2. 选择Help -> Eclipse Marketplace。
3. 搜索Spring Boot，然后点击Install。

3. 创建Spring Boot项目

3.1 使用IDE创建Spring Boot项目

在IntelliJ IDEA或Eclipse中创建一个新的Spring Boot项目。

IntelliJ IDEA

1. 打开IntelliJ IDEA。
2. 选择File -> New -> Project。
3. 选择Spring Initializr，点击Next。
4. 填写Group（如com.example）、Artifact（如demo）、Name（如Demo）。
5. 选择Java、Spring Boot作为语言和技术栈。
6. 选择所需的技术（如Web和JPA）。
7. 点击Finish完成创建。

Eclipse

1. 打开Eclipse。
2. 选择File -> New -> Other。
3. 选择Spring -> Spring Starter Project。
4. 填写Group id（如com.example）、Artifact id（如demo）、Name（如Demo）。
5. 选择Java和Spring Boot。
6. 选择所需的技术（如Web和JPA）。
7. 点击Finish完成创建。

3.2 使用Spring Initializr创建项目

Spring Initializr是一个在线工具，可以快速创建Spring Boot项目。

1. 打开浏览器，访问Spring Initializr。
2. 填写Project -> Maven Project，选择Java语言。
3. 填写Group（如com.example）、Artifact（如demo）。
4. 选择Java、Spring Boot作为技术栈。
5. 选择所需的技术（如Web和JPA）。
6. 点击Generate下载项目。
7. 解压下载的压缩包，使用你的IDE打开项目。

4. 项目基本结构解析

4.1 了解Spring Boot项目的基本目录结构

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

src
├── main
│   ├── java
│   │   └── com
│   │       └── example
│   │           └── demo
│   │               ├── DemoApplication.java
│   │               └── controller
│   │                   └── HelloController.java
│   └── resources
│       ├── application.properties
│       └── application.yml
pom.xml

DemoApplication.java

主应用类，标记了@SpringBootApplication注解，该类是应用程序的入口。

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

一个简单的控制器，用于返回"Hello, World!"。

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!";
    }
}

application.properties

配置文件，用于配置应用程序的属性。

server.port=8080
spring.application.name=demo

application.yml

同样用于配置应用程序的属性，但使用YAML格式。

server:
  port: 8080
spring:
  application:
    name: demo

5. 添加依赖和启动项目

5.1 使用Maven/Gradle添加常见依赖

使用Maven或Gradle添加常见依赖。

Maven

在pom.xml文件中添加依赖。

<dependencies>
    <!-- Spring Boot Starter Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- Spring Boot Starter JPA -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>

    <!-- MySQL Connector -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
    </dependency>

    <!-- Spring Boot Starter Test -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

Gradle

在build.gradle文件中添加依赖。

dependencies {
    // Spring Boot Starter Web
    implementation 'org.springframework.boot:spring-boot-starter-web'

    // Spring Boot Starter JPA
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'

    // MySQL Connector
    implementation 'mysql:mysql-connector-java'

    // Spring Boot Starter Test
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

5.2 运行Spring Boot项目

运行Spring Boot项目，可以通过IDE或命令行启动。

使用IDE运行

在IntelliJ IDEA或Eclipse中，右键点击DemoApplication.java，选择Run 'DemoApplication.main()'。

使用命令行运行

在项目根目录下，执行以下命令：

mvn spring-boot:run

或者，如果你使用Gradle：

./gradlew bootRun

6. 第一个Spring Boot应用实例

6.1 创建一个简单的REST API

创建一个新的控制器来返回"Hello, World!"。

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 hello() {
        return "Hello, World!";
    }
}

6.2 测试REST API接口

启动Spring Boot应用程序，打开浏览器或使用curl命令来访问REST API。

# 使用curl测试REST API
curl http://localhost:8080/

预期输出：

Hello, World!

总结

通过本教程，你已经了解了Spring Boot的基本概念，安装和配置了开发环境，创建了第一个Spring Boot项目，并运行和测试了一个简单的REST API。Spring Boot为开发人员提供了强大的工具和快速开发的能力，使得构建独立的、生产级别的应用程序变得简单和高效。