關(guān)于SpringBoot
第1篇:SprintBoot的前世今生稍后會奉上,本篇是SpringBoot系列的第2篇文章,在后面系列的教程中,會詳細(xì)分享SpringBoot生態(tài)圈中的各個成員,例如:
- 最基礎(chǔ)的3層架構(gòu)
- 訪問數(shù)據(jù)庫的3種常用方案
- MyBatis
- MyBatis-Plus
- fluent mybatis
- NoSQL
- Redis
- MongoDB
- ElasticSearch
- 消息隊列
- RabbitMQ
- Kafka
- RocketMQ
- ...
系列教程特點
- 主流:分享的都是主流的技術(shù)點
- 詳細(xì):非常詳細(xì),會穿插各種小知識點
- 全面:如前文所述,數(shù)據(jù)訪問層會分享
- MyBatis
- MyBatis-Plus
- fluent mybatis
- sharding-JDB
- 深度:會分享研發(fā)過程中需要注意的各種知識點,比如日志輸出常遇到的坑,絕對的干貨
創(chuàng)建工程
- Step1: 啟動idea,我用的是IDEA Community Edition(不同版本,界面長的會稍微有些差別),點擊【New Project】按鈕,就是下圖中的【+】圖標(biāo)
- Step2:如下圖:
- 選擇Maven
- Project SDK:選擇你本地JDK版本,我本地安裝的是JDK11,想嘗鮮的同學(xué),可以安裝JDK的最新版本:JDK17
- 設(shè)置好JDK后,按【Next】按鈕
- Step3:下圖中設(shè)置項目的信息,點擊【Artifact Coordinates】會展開更詳細(xì)的信息
老碼農(nóng)設(shè)置的信息如下,根據(jù)你自己的項目實際情況,大家自行靈活調(diào)整
知識點:關(guān)于GroupId
groupId一般分為多個段,段之間用【.】分割,通常
- 第一段為域:比如org(非營利組織)、com(商業(yè)組織)、cn(中國)、top(國際通用頂級域名GTLD(Generictop-level domain top))等
- 第二段為公司名稱:比如我的就設(shè)置成coderoldgeek
- 第三段為項目名稱:我設(shè)置成的是【springboot】
- 第四段可以是子項目名稱:我設(shè)置成的是【examples】
groupId不要隨便設(shè)置,最好和包結(jié)構(gòu)保持一致。
設(shè)置好這些信息,直接按【Finish】按鈕。
- Step4: 項目開始創(chuàng)建,可能會需要幾秒鐘,創(chuàng)建好后,如下圖展示
- Step5: 關(guān)于目錄結(jié)構(gòu)說明
oldgeek-springboot-examples
├─.idea
│─src
│ └─main
│ ├─java
│ ├─resources
│ └─test
└─pom.xml
目錄詳細(xì)說明參照下表:
關(guān)于Maven的詳細(xì)教程:老碼農(nóng)正在認(rèn)真整理,稍后會分享給大家。
創(chuàng)建子模塊
為什么要創(chuàng)建子模塊?
- 本篇文章后面涉及的例子,其實不用創(chuàng)建子工程,直接在:src/main/java編寫代碼也可以完成。
- 創(chuàng)建子模塊:后面會分享很多內(nèi)容,所以想按照知識點創(chuàng)建子工程,便于大家根據(jù)自己需要去參考。
創(chuàng)建子模塊
- Step1: 右鍵選父工程:【oldgeek-springboot-examples 】連續(xù)點擊【New】 -> 【Module...】
- Step2: 同樣,選擇【Maven】-> 【Module SDK】,按【Next】按鈕
- Step3: 下圖中,只需要輸入Name即可,其他的不要修改
- Name:springboot-hello
- Step4: 創(chuàng)建子模塊,工程的目錄結(jié)構(gòu)如下
oldgeek-springboot-examples
├─.idea
├─springboot-hello
│ └─src
│ └─main
│ ├─java
│ └─resources
│ └─pom.xml
│─src
│ └─main
│ ├─java
│ └─resources
│ └─test
└─pom.xml
關(guān)于Maven的詳細(xì)教程:老碼農(nóng)正在認(rèn)真整理,稍后會分享給大家。
有些同學(xué)會有疑問
父工程
- src/main/java和src/main/resources/還有用嗎?可以刪掉嗎?
- 答:如果按模塊創(chuàng)建工程,這兩個目錄可以刪掉
- 父工程:pom.xml 文件可以刪掉嗎?
- 答:不可以,這個有大用處,本篇文章暫時不展開,咱們徐徐來,莫急
準(zhǔn)備編寫第一個能啟動工程,激動人心的時刻馬上就要來了,繼續(xù)跟著做
- Step1: 依次點擊:【springboot-hello】-> 【src】-> 【main】-> 【java】按右鍵,如下圖,依次點擊 【New】-> 【Package】
- Step2: 輸入如下的Package目錄信息 com.oldgeek.springboot.examples.hello
- Step3: 創(chuàng)建啟動類
創(chuàng)建過程,如下圖,右鍵選Package路徑【com.oldgeek.springboot.examples.hello】,依次【New】-> 【Java Class】
- Step4: 輸入類名:HelloApplication,回車,啟動類就創(chuàng)建好了
- Step5: 本次我們要分享的是SpringBoot,接下來我們需要配置SpringBoot的包
打開子工程:springboot-hello/pom.xml文件,文件內(nèi)容如下。
<?xml version="1.0" encoding="UTF-8"?>
<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">
<parent>
<artifactId>oldgeek-springboot-examples</artifactId>
<groupId>com.coderoldgeek.springboot.examples</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>springboot-hello</artifactId>
<properties>
<maven.compiler.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>
</properties>
</project>
我們添加和SpringBoot相關(guān)的依賴
- 添加我們使用的SpringBoot版本,在屬性中定義版本信息
<properties>
<maven.compiler.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>
<!-- spring-boot version -->
<spring-boot.version>2.5.0</spring-boot.version>
</properties>
- 添加SpringBoot依賴的包
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>${spring-boot.version}</version>
</dependency>
</dependencies>
- 子工程完整的pom文件如下
<?xml version="1.0" encoding="UTF-8"?>
<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">
<parent>
<artifactId>oldgeek-springboot-examples</artifactId>
<groupId>com.coderoldgeek.springboot.examples</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>springboot-hello</artifactId>
<properties>
<maven.compiler.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>
<!-- spring-boot version -->
<spring-boot.version>2.5.0</spring-boot.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>${spring-boot.version}</version>
</dependency>
</dependencies>
</project>
重要知識點:
- 依賴包的版本盡量在屬性中定義定義,不要散落在各子工程中直接硬編碼,容易導(dǎo)致版本混亂
- 盡量在父工程中定義,后面會講到,本篇不展開。
- 不要添加沒有使用的依賴,用啥天啥,千萬不要整太多垃圾。
- 下面這張圖要注意,修改完pom.xml文件配置選項,一般不會自動刷新,需要按照下面步驟刷新,主要是從遠(yuǎn)端倉庫獲取jar包,放到本地倉庫。
- 如下圖:選中工程,按右鍵,選擇【Maven】->【Reload project】,按下后,會去Maven中央服務(wù)器拉取我們所需要的jar包,拉取的時間看你當(dāng)時的網(wǎng)速,慢的話,可能需要幾分鐘。耐心等待就行。
- Step6: 編寫啟動類代碼,完整代碼如下
package com.oldgeek.springboot.examples.hello;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class HelloApplication {
public static void main(String[] args) {
SpringApplication.run(HelloApplication.class, args);
}
}
代碼解釋:
- 啟動類添加注解:@SpringBootApplication
- Main方法中調(diào)用SpringApplication.run(HelloApplication.class, args);
- SpringBoot實例初始化完成后,就會調(diào)用run方法啟動服務(wù)。
延伸知識點:我們可以看下SpringBootApplication是SpringBoot的核心注解,他是一個組合注解,我們可以查看注解的源代碼,截取部分源代碼,源代碼的分享不是本篇文章重點。
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(excludeFilters = { @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
@Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) })
public @interface SpringBootApplication {
- SpringBootConfiguration:如下源代碼,繼承自:Configuration,此注解是個配置類,容器啟動時會配置初始化參數(shù)
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Configuration
@Indexed
public @interface SpringBootConfiguration
- EnableAutoConfiguration:啟動SpringBoot自動配置機(jī)制,根據(jù)pom包中依賴為當(dāng)前項目自動進(jìn)行配置,例如,添加了 spring-boot-starter-web 依賴,會自動添加 Tomcat 和 Spring MVC 的依賴,那么 Spring Boot 會對 Tomcat 和 Spring MVC 進(jìn)行自動配置。
- ComponentScan:掃描包的配置,注意:他會自動掃描同級目錄或者下級包里的Bean,所以本入口類建議放置在 grounpID + arctifactID 組合的包名下,我們是:com.oldgeek.springboot.examples.hello
- Step7: 點擊啟動類:HelloApplication,按右鍵,選擇【Run 'HelloApplication.main()'】開始啟動咱們的工程。
- Step8: 若果你能看到如圖所示的畫面,恭喜你,大概率工程是已經(jīng)正常啟動了。
- 小知識點
- 出現(xiàn)問題,先看日志,養(yǎng)成看日志習(xí)慣
-
日志從下往上看,容易定位問題
- Step9: 我們試著訪問下,打開你的瀏覽器,輸入:http://localhost:8080,點回車,悲劇,下面畫面會出現(xiàn) 沒關(guān)系,我們現(xiàn)在只是把服務(wù)啟動了,還沒給他添加任何業(yè)務(wù)邏輯呢,自然會掛。
添加業(yè)務(wù)邏輯
- Step1: 選中Package:com.oldgeek.springboot.examples.hello,【New】->【Package】
向下圖輸入:controller,完整的package:com.oldgeek.springboot.examples.hello.controller
- Step2: 添加控制類:HelloController
選中controller,點擊右鍵:【New】->【Java Class】,創(chuàng)建控制類
輸入控制類名字:HelloController
- Step3: 編寫業(yè)務(wù)邏輯
package com.oldgeek.springboot.examples.hello.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.ResponseBody;
@Controller
public class HelloController {
/**
* Hello World
*/
@GetMapping("hello")
@ResponseBody
public String hello() {
return "歡迎您光臨小碼匠和老碼農(nóng)的SpringBoot家園<br>未來的日子中,我們一起學(xué)編程,一起分享技術(shù)";
}
}
代碼說明:
- 注解:@Controller:控制器Controller負(fù)責(zé)處理由DispatcherServlet 分發(fā)的請求,它把用戶請求的數(shù)據(jù)經(jīng)過業(yè)務(wù)處理層處理之后封裝成一個Model ,然后再把該Model 返回給對應(yīng)的View 進(jìn)行展示。
- 注解:@GetMapping("hello"):定義Request請求和Controller 方法之間的映射,此處我們是用Get方式請求
- 注解:@ResponseBody:把處理的結(jié)果直接寫入 HTTP response body 中,返回給調(diào)用方
- Step4:
- 重新啟動服務(wù)
- 訪問,再次啟動瀏覽器,地址欄中輸入:http://localhost:8080/hello
特別關(guān)注
- pom中添加新依賴時,要執(zhí)行maven的【Reload Project】操作,不然很可能編譯失敗
- groupId和artifactId的命名規(guī)則,不要隨意命名,專業(yè)人士做專業(yè)事
關(guān)注公眾號【小碼匠和老碼農(nóng)】收獲小碼匠和老碼農(nóng)精心挑選的電子書
- 回復(fù): java, 獲得Java基礎(chǔ)教程
- 回復(fù): jvm, 獲得JVM資料
- 回復(fù): springboot, 獲得SpringBoot資料
- 回復(fù): springcloud, 獲得springcloud資料
- 回復(fù): python, 獲得Python資料
- 回復(fù): 算法, 獲得算法資料
本文摘自 :https://blog.51cto.com/u