學(xué)習(xí)開發(fā)SpringBoot之初遇到的第一個攔路虎竟然是創(chuàng)建SpringBoot應(yīng)用斧抱,網(wǎng)上選她千百度娇豫,驀然回首發(fā)現(xiàn)網(wǎng)上的教程多多少少都存在問題耀找。什么問題呢此洲?首先都是都是創(chuàng)建DEMO厂汗,其次創(chuàng)建過程中遇到的選項含義不僅沒有解釋,而且很多選項選錯了呜师。為避免大家走同樣的彎路娶桦,在這里重新編寫了一篇基礎(chǔ)教程。
廢話少說汁汗,下面正式開始教程:
1. 第一步干什么呢衷畦?當然是打開IDEA啦
首先打開IDEA,點擊 +Create New Project. 開始創(chuàng)建一個新項目:
打開IDEA新建項目
下面出現(xiàn)了創(chuàng)建新項目的第一步知牌,請按照下圖上的步驟選擇即可:
選擇初始化工具及模板選擇
簡單介紹一下上面的選項:
- 選擇左側(cè)的
Spring Initializr
選項:Spring Initializr
是官方提供的一個用來初始化的工具祈争,通過在Spring Initializr
的界面窗口上簡單的配置,就能輕松完成Spring Boot的項目的初始化送爸。
- 選擇左側(cè)的
- 選擇頂部的
Project SDK
選項:通過這個項目可以選擇項目運行JDK版本環(huán)境铛嘱,這里默認讀取的是當前用戶的JAVA_HOME
環(huán)境變量,如果這里沒有任何的默認選項袭厂,請參考前面JDK環(huán)境搭建的章節(jié)墨吓。
- 選擇頂部的
- 選擇頂部的
Initializr Service URL
:選擇生在項目模板的服務(wù)器地址,這里選擇的是默認選項Default : https://start.spring.io
纹磺,(如果默認的模板無法滿足需求還可以選擇Custom
從指定的鏈接加載模板帖烘,動手能力強的同學(xué)還可以選擇本地搭建spring Initializr服務(wù)器,這部分知識不是本節(jié)重點橄杨,這里不做拓展了秘症,大家可以自行百度)還有一點需要注意,idea默認使用https://start.spring.io
提供的在線模板式矫,所以建議執(zhí)行后續(xù)步驟的過程中保證網(wǎng)絡(luò)暢通乡摹。
- 選擇頂部的
- 以上選擇完成后应媚,點擊
Next
按鈕進入下一步十偶。
- 以上選擇完成后应媚,點擊
2. 第二步 填寫項目的元數(shù)據(jù)(Project Metadata)
所謂元數(shù)據(jù)也就是基本信息的意思厕怜,包含Group开呐、Artifact兔跌、Name枝嘶、Package等信息蛋济,如下圖所示旨袒,下面將詳細講解如何填寫這些信息:
填寫項目元數(shù)據(jù)頁面
從上圖可以看到察绷,需要填寫及選擇的內(nèi)容一共10項:
-
Group
:創(chuàng)建項目的組織或團隊的唯一標識干签,通常是com + 公司名稱
,按照國際慣例拆撼,這里建議所有的字母都使用小寫 -
Artifact
:是項目的唯一的標識符容劳,實際對應(yīng)項目或系統(tǒng)的名稱。按照國際慣例闸度,這里建議所有的字母都使用小寫 -
Type
:這里一共有4個選項鸭蛙,分別是Maven Project
、Maven POM
筋岛、Gradle Project
和Gradle Config
娶视,其中Maven Project
和Maven POM
兩個選項用于創(chuàng)建Maven方式管理的Java項目,區(qū)別是Maven Project
幫我們生成整個完整的工程結(jié)構(gòu)睁宰,而Maven POM
選項只會在工程目錄下生成pom.xml肪获,沒有src等等結(jié)構(gòu),所以對于新手建議選擇Maven Project
柒傻。下面的兩個選項Gradle Project
和Gradle Config
用于創(chuàng)建Gradle方式管理的Java項目孝赫,和前兩個一樣,Gradle Project
幫我們生成整個完整的工程红符,Gradle Config
初始化的項目只有build.gradle配置文件青柄。據(jù)了解國內(nèi)很多大公司的項目都是使用Maven管理的伐债,所以對于初學(xué)者建議選擇Maven Project
-
Language
:語言也提供了3個選項,分別是Java
致开、Kotlin
和Groovy
峰锁,Java應(yīng)該不用多做介紹了,Kotlin
和Groovy
都是基于Java平臺的面向?qū)ο蟮木幊陶Z言双戳,業(yè)界有人認為Kotlin
將會渠道Java的霸主地位虹蒋,Kotlin
提供了互操作性,代碼安全性和準確性比較受程序員們的歡迎飒货,大家不用也沒關(guān)系魄衅,可以查資料了解一下這兩種語言,豐富知識的寬度 -
Packaging
:提供了兩種打包方式Jar
和War
塘辅,其中Jar
的打包方式用于在服務(wù)器直接運行或提供給其他系統(tǒng)集成調(diào)用晃虫。War
一般用于在Tomcat
平臺部署。這里大家根據(jù)自己的部署環(huán)境和用途進行選擇 -
Java Version
:提供了8
扣墩,11
和15
三個選項傲茄,大家根據(jù)自己的Java環(huán)境自行選擇就好 -
Version
:項目或系統(tǒng)的版本號,后續(xù)可以修改沮榜,這里建議使用默認值
-
Name
:項目或系統(tǒng)的名稱盘榨,可以是Artifact
。(填寫Artifact
項完成后蟆融,初始化工具會自動使用Artifact
的內(nèi)功填充) -
Description
:項目功能及用途的介紹草巡,作為Jar包對外提供時,使用者可以通過Description
快速了解項目的能力型酥。這個信息可以后期修改山憨,可以直接跳過。 -
Package
:項目或系統(tǒng)的唯一標識弥喉,可以自定義郁竟,默認是Group
+Artifact
。(當填寫Group
和Artifact
兩項完成后由境,初始化工具會自動使用這兩項的內(nèi)容填充)
以上信息填寫完成后棚亩,請點擊右下角的Next
按鈕進入下一步。
3. 第三步 選擇項目的依賴(Dependencies)
項目的依賴選項多到讓人眼花繚亂措手不及虏杰,該從哪里下手呢讥蟆?選哪個合適呢?
1)選擇Spring Boot版本
Spring Boot版本選擇界面
如果上圖所示纺阔,Spring Boot的版本也有很多瘸彤,如果大家沒有必須要選擇的版本,建議選擇使用最新的版本笛钝,截止到2020年10月8日质况,最新的Spring Boot穩(wěn)定版本是
2.3.4
愕宋,注意請盡量不要選擇使用 (SNAPSHOT)
結(jié)尾版本,這些版本相當于開發(fā)版本结榄,會存在一些未知的Bug中贝,建議大家選擇穩(wěn)定版本,避免踩坑潭陪。
2)選擇初始依賴庫
選擇初始依賴庫的頁面
界面共分為三列:
左列
是分類雄妥, 中間列
是待選擇的依賴庫最蕾,右列
是已選擇的依賴庫依溯。在這里需要說明一下,依賴庫在項目創(chuàng)建完成后也可以添加瘟则,這里可以直接點擊
Next
按鈕跳過黎炉。下面我說一下我常用的一些依賴庫:
類別 | 依賴庫 |
---|---|
Developer Tools | Spring Boot DevTools |
Web | Spring Web |
SQL | Spring Data JPA |
下面詳細說一下這些依賴庫的作用:
-
Spring Boot DevTools
:提供了熱部署的能力,能節(jié)省很多程序員開發(fā)過程中調(diào)試部署的時間醋拧,強烈推薦使用慷嗜。網(wǎng)上也有很多關(guān)于熱部署原理的文章,建議大家拓展閱讀一下 -
Spring Web
:Spring MVC核心組件之一丹壕,常用于用開發(fā)網(wǎng)絡(luò)接口服務(wù)庆械,使用Apache Tomcat作為運行環(huán)境。是開發(fā)網(wǎng)絡(luò)服務(wù)的必要組件 -
Spring Data JPA
:Spring Data JPA是Spring菌赖,基于Hibernate開發(fā)的一個JPA框架缭乘,提供了更簡單更優(yōu)雅的訪問數(shù)據(jù)庫的方式,如果在項目中使用了關(guān)系型數(shù)據(jù)庫琉用,建議勾選上堕绩。
完成選擇依賴庫以后,請點擊右下角的Next
按鈕進入下一步邑时。
4. 第四步 選擇初始化位置
初始化位置選擇頁面
這也是初始化項目的最后一步了奴紧,填寫項目的名稱以及選擇文件的初始化位置。
-
Project name
:項目或系統(tǒng)名稱晶丘,可以是在第二步填寫的Artifact
黍氮,同時這個也是項目源代碼文件夾的名稱,建議使用駝峰命名法浅浮,提升可讀性滤钱。 -
Project location
:選擇項目代碼初始化的位置,點擊右側(cè)的...
按鈕選擇具體的路徑脑题。
以上信息填寫完成后件缸,請點擊右下角的Next
按鈕完成項目初始化。
5. 最后
項目創(chuàng)建完成后的目錄結(jié)構(gòu)
完成項目創(chuàng)建后您將看到以上目錄結(jié)構(gòu)叔遂,其中
XXXApplication
是項目的入口他炊。項目運行控制菜單
在窗口的右上方找到上圖的幾個按鈕争剿,點擊中間的
綠色三角
按鈕,即可運行項目痊末。在運行的過程中蚕苇,您可能會遇到
Failed to configure a DataSource: 'url' attribute is not specified and no embedd
的錯誤:運行錯誤截圖
請參考我前面的文章Spring Boot應(yīng)用報錯:Failed to configure a DataSource: 'url' attribute is not specified and no embedd來解決此問題。
項目運行成功的截圖
當您解決完所有問題后凿叠,再次運行后看到以上的截圖中的兩行日志涩笤,那么恭喜您,您的第一個Spring Boot項目創(chuàng)建完成了盒件。
寫在最后:大家在創(chuàng)建項目的過程中蹬碧,如果遇到任何問題,請在評論區(qū)留言交流炒刁。