为了账号安全,请及时绑定邮箱和手机立即绑定

创建Spring Boot项目资料:新手入门教程

标签:
SpringBoot
概述

本文详细介绍了如何创建和配置Spring Boot项目,涵盖了从环境搭建到项目部署的全过程。文章将提供丰富的示例和步骤,帮助开发者快速上手。内容包括从下载和安装Spring Boot,到配置开发环境、编写第一个Spring Boot应用,以及依赖管理和部署运行的全面指导。

引入Spring Boot框架

Spring Boot是什么

Spring Boot 是一个基于 Spring 框架的开源项目,旨在简化新 Spring 应用的初始搭建以及开发过程。它通过自动配置、约定优于配置等方式帮助开发者快速构建出独立运行的应用程序。

Spring Boot的优势

  • 简化配置:Spring Boot 提供了大量默认配置,如自动配置数据库连接、嵌入式服务器等,大大减少了 XML 配置文件的使用。
  • 自动化配置:通过约定优于配置的原则,Spring Boot 能够根据项目中的依赖自动配置应用程序。
  • 快速启动:Spring Boot 提供了嵌入式 HTTP 服务器,如 Tomcat、Jetty 或 Undertow,使得服务器的部署变得非常简单。
  • 依赖管理:Spring Boot 包含了大量的依赖库,可以通过 Maven 和 Gradle 简单地添加和管理这些依赖。
  • 测试支持:Spring Boot 提供了内置的测试支持,简化了单元测试和集成测试的编写。

如何下载和安装Spring Boot

  1. Spring Boot下载

    • 访问 Spring Boot 官方网站 获取最新的 Spring Boot 发行版。
    • 下载压缩包或使用版本管理工具如 Maven 或 Gradle 直接添加依赖。
  2. 安装Java环境

    • 访问官网 Java SEOpenJDK 下载 Java。
    • 安装完成后,需要设置环境变量。假设你安装了 JDK,可以按照以下步骤设置环境变量:
    export JAVA_HOME=/usr/local/jdk1.8
    export PATH=$JAVA_HOME/bin:$PATH
    export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
  3. 配置IDE
    • 下载并安装 IntelliJ IDEAEclipse
    • 配置 IDE 以支持 Java 开发,例如在 IntelliJ IDEA 中,选择 File -> Settings -> Build, Execution, Deployment -> Compiler 检查 JDK 设置是否正确。

下载并配置Spring Initializr

  1. 访问Spring Initializr网站

    • 访问 Spring Initializr 官网
    • 选择项目类型、语言(Java)、依赖、构建工具(Maven 或 Gradle),以及其他选项。
    • 点击 Generate 生成项目压缩包。
  2. 解压项目

    • 将生成的压缩包下载到本地,解压文件。
      . 打开解压后的文件夹,可以看到项目的基本结构。
  3. 导入项目
    • 在 IntelliJ IDEA 中,选择 File -> Import Project
      . 选择解压后的项目文件夹,点击 Next
    • 选择 IntelliJ IDEA 项目类型,点击 Next
    • 确认项目的 SDK 为已配置的 JDK,点击 Finish
  • 在 Eclipse 中导入项目
    • 选择 File -> Import
    • 选择 Existing Maven Projects,点击 Next
    • 选择解压后的项目文件夹,点击 Finish
准备开发环境

安装Java开发环境

  1. 下载Java

  2. 配置环境变量

    • 设置 JAVA_HOME 环境变量指向 JDK 安装目录。
    • 更新 PATH 环境变量添加 JDK 的 bin 目录。

    示例配置:

    export JAVA_HOME=/usr/local/jdk1.8
    export PATH=$JAVA_HOME/bin:$PATH
    export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

配置IDE

IntelliJ IDEA配置

  1. 下载并安装 IntelliJ IDEA

    • 访问官网下载 IntelliJ IDEA。
    • 安装完成后,启动 IDE。
  2. 配置 JDK

    • 打开 IntelliJ IDEA,选择 File -> Project Structure
    • Project 选项卡下,设置 JDK 版本。
    • Modules 选项卡下,确保项目使用的 JDK 是正确的。
  3. 创建新项目
    • 选择 File -> New -> Project
    • 选择 Java 并勾选 Spring Initializr
    • Project SDK 中选择已配置的 JDK。
    • 选择 Next,填写项目名和位置,点击 Finish

Eclipse配置

  1. 下载并安装 Eclipse

    • 访问官网下载 Eclipse。
    • 安装完成后,启动 IDE。
  2. 配置 JDK

    • 打开 Eclipse,选择 Window -> Preferences(或 Eclipse -> Preferences 在 macOS 上)。
    • 选择 Java -> Installed JREs,点击 Add 添加新的 JRE。
    • 选择 Directory,指向 JDK 的根目录,点击 Finish
    • 选择 Java -> Compiler,设置编译器版本为您安装的 JDK。
  3. 创建新项目
    • 选择 File -> New -> Project
    • 选择 Java Project
    • 填写项目名和位置,点击 Next
    • Project Facets 中勾选 JavaDynamic Web Module
    • 点击 Finish 完成项目创建。

下载并配置Spring Initializr

  1. 访问Spring Initializr网站

    • 访问 Spring Initializr 官网
    • 选择项目类型、语言(Java)、依赖、构建工具(Maven 或 Gradle),以及其他选项。
    • 点击 Generate 生成项目压缩包。
  2. 解压项目

    • 将生成的压缩包下载到本地,解压文件。
    • 打开解压后的文件夹,可以看到项目的基本结构。
  3. 导入项目
    • 在 IntelliJ IDEA 中,选择 File -> Import Project
    • 选择解压后的项目文件夹,点击 Next
    • 选择 IntelliJ IDEA 项目类型,点击 Next
    • 确认项目的 SDK 为已配置的 JDK,点击 Finish
  • 在 Eclipse 中导入项目
    • 选择 File -> Import
    • 选择 Existing Maven Projects,点击 Next
    • 选择解压后的项目文件夹,点击 Finish
创建Spring Boot项目

使用Spring Initializr创建项目

  1. 访问Spring Initializr网站

    • 访问 Spring Initializr 官网
    • 选择项目类型、语言(Java)、依赖、构建工具(Maven 或 Gradle),以及其他选项。
    • 点击 Generate 生成项目压缩包。
  2. 解压项目

    • 将生成的压缩包下载到本地,解压文件。
    • 打开解压后的文件夹,可以看到项目的基本结构。
  3. 导入项目
    • 在 IntelliJ IDEA 中,选择 File -> Import Project
    • 选择解压后的项目文件夹,点击 Next
    • 选择 IntelliJ IDEA 项目类型,点击 Next
    • 确认项目的 SDK 为已配置的 JDK,点击 Finish
  • 在 Eclipse 中导入项目
    • 选择 File -> Import
    • 选择 Existing Maven Projects,点击 Next
    • 选择解压后的项目文件夹,点击 Finish

导入项目到IDE

  1. 导入到IntelliJ IDEA

    • 选择 File -> Import Project
    • 选择解压后的项目文件夹,点击 Next
    • 选择 IntelliJ IDEA 项目类型,点击 Next
    • 确认项目的 SDK 为已配置的 JDK,点击 Finish
  2. 导入到Eclipse
    • 选择 File -> Import
    • 选择 Existing Maven Projects,点击 Next
    • 选择解压后的项目文件夹,点击 Finish

项目结构介绍

  1. 项目根目录

    • src/main/java:存放 Java 源代码。
    • src/main/resources:存放静态资源文件、配置文件等。
    • pom.xmlbuild.gradle:项目构建文件,用于管理依赖和构建配置。
    • application.propertiesapplication.yml:Spring Boot 配置文件。
  2. 主要文件

    • pom.xml(Maven 项目):

      <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.7.0</version>
           <relativePath/> <!-- lookup parent from repository -->
       </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-test</artifactId>
               <scope>test</scope>
           </dependency>
       </dependencies>
      </project>
    • build.gradle(Gradle 项目):

      plugins {
       id 'org.springframework.boot' version '2.7.0'
       id 'io.spring.dependency-management' version '1.0.11.RELEASE'
       id 'java'
      }
      
      repositories {
       mavenCentral()
      }
      
      dependencies {
       implementation 'org.springframework.boot:spring-boot-starter-web'
       testImplementation 'org.springframework.boot:spring-boot-starter-test'
      }
编写第一个Spring Boot应用

创建主类

  1. 创建 Spring Boot 启动类

    • src/main/java 目录下,创建一个新的 Java 类,例如 DemoApplication.java
    • 添加 @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);
       }
    }

配置启动类

  1. 配置启动类

    • Spring Boot 应用的启动类需要实现 main 方法,该方法会启动 Spring Boot 应用。
    • 你可以在启动类中添加其他配置,例如配置数据源、事务管理器等。

    示例代码:

    package com.example.demo;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    import org.springframework.context.annotation.Bean;
    
    @SpringBootApplication
    public class DemoApplication {
       public static void main(String[] args) {
           SpringApplication.run(DemoApplication.class, args);
       }
    
       @Bean
       public MyBean myBean() {
           return new MyBean();
       }
    }
    
    class MyBean {
       public void doSomething() {
           System.out.println("Doing something...");
       }
    }

运行并测试应用

  1. 运行应用

    • 右键点击 DemoApplication 类的 main 方法,选择 Run 'DemoApplication.main()'
    • 应用将在控制台输出启动信息,表示应用已成功启动。
  2. 测试应用

    • 访问默认的 Spring Boot 应用端点 http://localhost:8080,可以查看启动成功的页面。
    • 也可以通过 @RestController 注解创建一个简单的 REST 控制器,测试 REST API。

    示例代码:

    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 MyRestController {
       @GetMapping("/hello")
       public String hello() {
           return "Hello, World!";
       }
    }

    访问 http://localhost:8080/hello,查看是否返回 Hello, World!

添加依赖管理

使用Maven或Gradle添加依赖

  1. Maven依赖管理

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

    示例代码:

    <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>
    </dependencies>
  2. Gradle依赖管理

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

    示例代码:

    dependencies {
       implementation 'org.springframework.boot:spring-boot-starter-web'
       implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    }

常用依赖介绍

  • Spring Web

    • spring-boot-starter-web:包含基本的 Web 功能,例如处理 HTTP 请求和响应。
    • 示例代码:
      <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
      </dependency>
  • Spring Data JPA
    • spring-boot-starter-data-jpa:支持 JPA,简化了数据库操作。
    • 示例代码:
      <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
      </dependency>

依赖冲突解决

  • Maven依赖冲突解决

    • pom.xml 文件中使用 <dependencyManagement> 来管理版本冲突。

    示例代码:

    <dependencyManagement>
      <dependencies>
          <dependency>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-dependencies</artifactId>
              <version>2.7.0</version>
              <type>pom</type>
              <scope>import</scope>
          </dependency>
      </dependencies>
    </dependencyManagement>
  • Gradle依赖冲突解决

    • build.gradle 文件中使用 dependencyOverrides 来管理版本冲突。

    示例代码:

    dependencyOverrides {
      'org.springframework.boot:spring-boot-starter-logging': '2.7.0'
    }
部署和运行项目

打包Spring Boot应用

  1. 打包应用

    • 使用 Maven 或 Gradle 打包 Spring Boot 应用。
    • Maven 命令:

      mvn clean package
    • Gradle 命令:
      gradle build
  2. 生成的jar文件

    • 打包完成后,会在 target 目录下(Maven)或 build/libs 目录下(Gradle)生成 jar 文件。

    示例:

    mvn clean package
    # 后生成的jar文件位于 target 目录下

在本地和服务器上部署

  1. 在本地运行

    • 使用 java -jar 命令运行生成的 jar 文件。
    • 示例:
      java -jar target/demo-0.0.1-SNAPSHOT.jar
  2. 在服务器上部署
    • 将 jar 文件上传到服务器。
    • 在服务器上运行 jar 文件。
    • 示例:
      ssh user@yourserver "scp target/demo-0.0.1-SNAPSHOT.jar /path/to/deploy/"
      ssh user@yourserver "java -jar /path/to/deploy/demo-0.0.1-SNAPSHOT.jar"

环境配置和调试

  1. 环境配置

    • 编辑 application.propertiesapplication.yml 文件,根据不同的环境设置不同的配置。
    • 例如,设置数据库连接、端口号等。

    示例 application.properties

    spring.datasource.url=jdbc:mysql://localhost:3306/dbname
    spring.datasource.username=root
    spring.datasource.password=root
    server.port=8080
  2. 调试
    • 使用 IDE 的调试工具进行调试。
    • 在 IntelliJ IDEA 中,可以在 DemoApplication.main 方法中设置断点。
    • 在 Eclipse 中,也可以在 DemoApplication.main 方法中设置断点,右键点击 Run As -> Debug

示例代码:

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;

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

    @Bean
    public MyBean myBean() {
        return new MyBean();
    }
}

class MyBean {
    public void doSomething() {
        System.out.println("Doing something...");
    }
}
点击查看更多内容
TA 点赞

若觉得本文不错,就分享一下吧!

评论

作者其他优质文章

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

100积分直接送

付费专栏免费学

大额优惠券免费领

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

举报

0/150
提交
取消