Spring Boot 是一个开源框架，用于快速、轻松地创建基于 Java 的应用程序。它简化了 Spring 框架的配置和设置，使开发人员能够专注于编写业务逻辑。同时它提供了开箱即用的功能，例如自动配置、嵌入式服务器和简化的依赖管理，使应用程序开发更加高效。它还集成了广泛的第三方库和技术，使开发人员能够轻松地构建健壮且可扩展的应用程序。
在这里我会介绍一下如何设置本地环境并且用Spring bott的CLI和Spring Initializr来快速创建一个后台应用框架
本地环境设置
无论是Mac还是Windows, 要 运行一个Java应用都必须要先设置好环境,那环境设置具体包括什么呢? 我这里总结就2点: 1) 安装Java的SDK和构建工具(e.g. Maven/Gradle) 2)设置运行这些库和工具的系统参数. 这样你就可以在本地启动JVM来运行你的JAVA程序了
我用的是Mac, 本来想偷懒用homebrew来安装以上的工具和环境,但发现在国内运行homebrew极其不稳定,时长会被中断,所以我最后使用的比较原始的方法,就是自行去官网下载这些工具的安装包,然后手动设置他们在本地环境运行的路径和参数. 这里我介绍一下以下几个工具的安装
通过上面的安装包下载链接,下载后请直接安装到本地机器即可
P.S 如果是自动安装包,请记录一下安装的路径,如果只是个压缩文件,请把文件解压并且记录放置的路径,以便后续设置环境运行路径
JAVA SDK安装
Java SDK安装完成之后,路径是在/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home, 所以在你的启动Profile文件 (i.e. .zshrc)里面, 加上以下的命令
JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home
export PATH=$PATH:/$JAVA_HOME/bin
加载.zshrc文件之后,运行”java –version”就可以看到Java已经在系统路径里面可以随时调用了
Maven安装
我的Maven是直接下载解压包的,所以解压之后,在.zshrc文件里面加上以下命令
MAVEN_HOME=/Users/xxx/Dev/apache-maven-3.9.6
export PATH=$PATH:$MAVEN_HOME/bin
加载.zshrc文件之后,运行”mvn -version”就可以看到Maven已经在系统路径里面可以随时调用了
Gradle 安装
Gradle安装好之后,请也在.zshrc文件里面插入下面的命令
GRADLE_HOME=/opt/gradle/gradle-8.7
export PATH=$PATH:$GRADLE_HOME/bin
加载.zshrc文件之后,运行”gradle -version”就可以看到Gradle已经在系统路径里面可以随时调用了
到这里你的本地运行环境基本上就差不多了
Spring boot 项目创建
这里我会介绍两种方法:
- Spring CLI: Spring CLI（命令行界面）是一个基于文本的工具，用于与 Spring 生态系统交互。它允许开发人员从命令行执行各种任务，包括：创建新的 Spring Boot 项目, 运行 Spring Boot 应用程序, 管理 Spring Boot 应用程序的依赖项, 调试 Spring Boot 应用程序, 与 Spring Cloud 服务交互. 简单来说Spring CLI 提供了一个方便且高效的方式来管理和开发 Spring 应用程序，无需使用图形用户界面 (GUI)。
- Spring Initializr: Spring Initializr 是一个在线工具，允许开发人员快速创建一个新的 Spring Boot 项目。它提供了一个简单的界面，开发人员可以在其中选择所需的依赖项和模块，并生成一个包含所有必要配置和依赖项的项目脚手架。
Spring CLI
官方是有教程指导怎么安装Spring CLI的, 可以参考:https://docs.spring.io/spring-cli/reference/installation.html
但我想说的是,brew在我的机器上运行起来比较费劲,所以我建议大家可以直接参考教程里面自行git pull拉取Spring CLI在Github上的源代码,本地用Gradle直接构建就好了
用git clone把代码拉取到本地之后,去到该代码的根目录运行"./gradlew clean build -x test", 看到BUILD SUCCESSFUL的字样就代表Spring CLI的jar文件已经被创建好,并且可以使用了.Spring CLI的Jar包准备好之后, 需要执行下面的命令,把Spring CLI的功能封装成一个”spring”的快捷命令
alias spring='java -jar $HOME/temp/spring-cli/build/libs/spring-cli-0.8.1.jar'如果我们想构建一个Spring AI的项目,可以参考这个教程: https://spring.io/projects/spring-ai#overview
里面说到只需要运行以下的命令,项目就直接创建出来了
alias spring=java\ -jar\ ~/Dev/spring/build/libs/spring-cli-0.9.0-SNAPSHOT.jar
spring boot new --from ai --name myai
以上是我本地运行的效果
到这里你的Spring boot项目框架就创建好了
如果你已经有一个Spring项目, 想把Spring AI的模块加到你现有的项目里面,可以参考这里的教程https://docs.spring.io/spring-ai/reference/getting-started.html. 在现有的项目里面直接运行一下指令来增加这个模块
spring boot add aiSpring Initializr
Spring Initializr 是一个用于快速创建新的 Spring Boot 项目的在线工具。它允许开发人员选择所需的依赖项和配置，并自动生成一个基本的项目结构。它的网址是https://start.spring.io/
进入到Spring Initializr, 你可以看到以上的界面
- 区域1: 选择你想构建这个项目的构建工具(e.g. Gradle, Maven), 语言(e.g.Java, Kotlin)和Spring Boot的版本
- 区域2: 设置你这个项目的信息(e.g. 名称,描述,包名 等等)以及项目运行的JAVA版本(e.g. 22, 21, 17)
- 区域3: 选择你希望这个项目包含什么Spring的模块(e.g. Open AI, Spring Web, JDBC etc)
设置好之后,就可以点击下方的Generate按钮, 这样Spring Initializr就会把你刚刚的设置构建一个Spring boot的框架并打包成一个zip包下载到你本地, 你只需要把压缩包解压到你指定的项目目录即可
到这里,你的Spring boot项目框架就已经准备好, 可以使用IDE进行项目的开发了
