教你如何正確的使用Spring Boot框架

本篇文章為大家展示了教你如何正確的使用Spring Boot框架，內(nèi)容簡(jiǎn)明扼要并且容易理解，絕對(duì)能使你眼前一亮，通過(guò)這篇文章的詳細(xì)介紹希望你能有所收獲。

Spring Boot主要有如下核心功能：

1.獨(dú)立運(yùn)行的Spring項(xiàng)目

Spring Boot可以以jar包的形式來(lái)運(yùn)行，運(yùn)行一個(gè)Spring Boot項(xiàng)目我們只需要通過(guò)Java -jar xx.jar類運(yùn)行。非常方便。

2.內(nèi)嵌Servlet容器

Spring Boot可以內(nèi)嵌Tomcat，這樣我們無(wú)需以war包的形式部署項(xiàng)目。

3.提供starter簡(jiǎn)化Maven配置

使用Spring或者SpringMVC我們需要添加大量的依賴，而這些依賴很多都是固定的，這里Spring Boot 通過(guò)starter能夠幫助我們簡(jiǎn)化Maven配置。

4.自動(dòng)配置Spring

5.準(zhǔn)生產(chǎn)的應(yīng)用監(jiān)控

6.無(wú)代碼生成和xml配置

OK，關(guān)于SpringBoot更詳細(xì)的優(yōu)缺點(diǎn)小伙伴們也可以自行搜索，我這里不再羅列，我們還是來(lái)看看代碼。

項(xiàng)目創(chuàng)建

初次接觸，我們先來(lái)看看如何創(chuàng)建一個(gè)Spring Boot項(xiàng)目，這里以IntelliJ IDEA為例，其他的IDE工具小伙伴們自行搜索創(chuàng)建方式:

首先創(chuàng)建一個(gè)項(xiàng)目，創(chuàng)建時(shí)選擇Spring Initializr，然后Next，如下圖：

填寫(xiě)項(xiàng)目信息，如下圖：

填寫(xiě)項(xiàng)目使用到的技術(shù)，上面的Spring Boot版本建議選擇最新的穩(wěn)定版，下面勾選上Web就可以了，如下圖：

最后一步，填寫(xiě)工程名字點(diǎn)擊finish：

OK，第一次創(chuàng)建時(shí)系統(tǒng)會(huì)去下載需要的依賴等，耗時(shí)稍長(zhǎng)，以后每次都會(huì)很快創(chuàng)建好。

OK，項(xiàng)目創(chuàng)建成功之后接下來(lái)我們來(lái)看看這個(gè)東西要怎么樣去運(yùn)行。首先我們看到在項(xiàng)目創(chuàng)建成功之后，在項(xiàng)目的根目錄下會(huì)有一個(gè)artifactId+Application命名規(guī)則的入口類，如下圖:

就是這個(gè)Test19SpringBoot2Application類，這是我們整個(gè)項(xiàng)目的入口類，這個(gè)類有一個(gè)@SpringBootApplication注解，這是整個(gè)Spring Boot的核心注解，它的目的就是開(kāi)啟Spring Boot的自動(dòng)配置。OK，那么我在這個(gè)類上再添加一個(gè)@RestController注解，使之變?yōu)橐粋€(gè)Controller，然后里邊提供一個(gè)地址轉(zhuǎn)換方法，如下：

@RestController
@SpringBootApplication
public class Test19SpringBoot2Application {

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

  @RequestMapping(value = "/",produces = "text/plain;charset=UTF-8")
  String index(){
    return "Hello Spring Boot!";
  }
}

然后點(diǎn)擊項(xiàng)目啟動(dòng)按鈕運(yùn)行，在IntelliJ中就是這個(gè)按鈕：

啟動(dòng)成功之后我們就可以直接在瀏覽器中訪問(wèn)了，如下：

OK，至此，我們一個(gè)簡(jiǎn)單的Spring Boot工程已經(jīng)創(chuàng)建出來(lái)了，并且成功的從瀏覽器中訪問(wèn)到了，但是為什么它最終會(huì)跑起來(lái)呢？想必小伙伴們還有許多疑問(wèn)，我們來(lái)分析下。

入口類和@SpringBootApplication注解

上文說(shuō)過(guò)，我們新建一個(gè)Project系統(tǒng)都會(huì)幫我們創(chuàng)建一個(gè)名為artifactId+Application的入口類，這個(gè)類中有一個(gè)main方法，這個(gè)main方法就是一個(gè)標(biāo)準(zhǔn)的Java應(yīng)用程序的入口方法。而這里的@SpringBootApplication則是一個(gè)組合注解，我們可以看看它的源碼：

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(
  excludeFilters = {@Filter(
  type = FilterType.CUSTOM,
  classes = {TypeExcludeFilter.class}
)}
)
public @interface SpringBootApplication {

}

 我們可以看到它組合了@SpringBootConfiguration、@EnableAutoConfiguration以及@ComponentScan，我們?cè)陂_(kāi)發(fā)的過(guò)程中如果不使用@SpringBootApplication，則可以組合使用這三個(gè)注解。這三個(gè)注解中，@SpringBootConfiguration實(shí)際上就是我們前面幾篇博客提到的@Configuration注解，表明這個(gè)類是一個(gè)配置類，@EnableAutoConfiguration則表示讓Spring Boot根據(jù)類路徑中的jar包依賴為當(dāng)前項(xiàng)目進(jìn)行自動(dòng)配置，最后一個(gè)@ComponentScan的作用我也不贅述了，唯一要注意的是如果我們使用了@SpringBootApplication注解的話，系統(tǒng)會(huì)去入口類的同級(jí)包以及下級(jí)包中去掃描實(shí)體類，因此我們建議入口類的位置在groupId+arctifactID組合的包名下。

關(guān)閉特定的自動(dòng)配置

在上面一小節(jié)中我們看到@ComponentScan注解是有一個(gè)過(guò)濾器的，如果我們只想要@SpringBootApplication去掃描特定的類而不是全部類，那么就可以關(guān)閉自動(dòng)配置，如下：

@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)

定制Banner

修改Banner

我們?cè)趩?dòng)Spring Boot項(xiàng)目的時(shí)候，在控制臺(tái)會(huì)默認(rèn)輸出一個(gè)啟動(dòng)圖案，如下：

當(dāng)然，這個(gè)圖案如果你需要的話是可以自己修改的，修改方式很簡(jiǎn)單：

1.在src/main/resources下新建一個(gè)banner.txt文檔

2.通過(guò)http://patorjk.com/software/taag網(wǎng)站生成需要的字符，將字符拷貝到步驟1所創(chuàng)建的txt文檔中，比如我這里為Hello Sang！生成字符，如下：

點(diǎn)擊左下角的選擇和拷貝按鈕，將這個(gè)字符拷貝到txt文檔中，然后再啟動(dòng)項(xiàng)目，這個(gè)時(shí)候控制臺(tái)輸出的文本就會(huì)自動(dòng)改變，如下：

關(guān)閉Banner

可以修改當(dāng)然也可以關(guān)閉，關(guān)閉Banner需要我們稍微修改一下main方法中的代碼，如下：

public static void main(String[] args) {
    SpringApplicationBuilder builder = new SpringApplicationBuilder(Test19SpringBoot2Application.class);
    //修改Banner的模式為OFF
    builder.bannerMode(Banner.Mode.OFF).run(args);
  }

OK，如此修改之后當(dāng)我們?cè)俅螁?dòng)Project的時(shí)候就看不到Banner了。

Spring Boot的配置文件

Spring Boot使用一個(gè)全局的配置文件application.properties或者application.yml，配置文件放在src/main/resources目錄下。properties是我們常見(jiàn)的一種配置文件，Spring Boot不僅支持properties這種類型的配置文件，也支持yaml語(yǔ)言的配置文件，我這里以properties類型的配置文件為例來(lái)看幾個(gè)案例。

1.修改Tomcat默認(rèn)端口和默認(rèn)訪問(wèn)路徑

Tomcat默認(rèn)端口是8080，我將之改為8081，默認(rèn)訪問(wèn)路徑是http://localhost:8080，我將之改為http://localhost:8081/helloboot,我們來(lái)看看這兩個(gè)需求要怎么樣通過(guò)簡(jiǎn)單的配置來(lái)實(shí)現(xiàn)。

很簡(jiǎn)單，在application.properties文件中添加如下代碼：

server.context-path=/helloboot
server.port=8081

然后再啟動(dòng)Project，在瀏覽器中就得這樣來(lái)訪問(wèn)了：

常規(guī)屬性配置

在前面的博客中我們介紹了如何在使用Spring容器框架下注入properties文件里的值。如果我們使用了Spring Boot，這項(xiàng)工作將會(huì)變得更加簡(jiǎn)單，我們只需要在application.properties中定義屬性，然后在代碼中直接使用@Value注入即可。
如下：

book.author=羅貫中
book.name=三國(guó)演義
book.pinyin=sanguoyanyi

我這里專門(mén)設(shè)置了中文，因?yàn)橹形牟蛔鎏厥馓幚頃?huì)亂碼，處理方式為繼續(xù)在application.properties中添加如下代碼：

server.tomcat.uri-encoding=UTF-8
spring.http.encoding.charset=UTF-8
spring.http.encoding.enabled=true
spring.http.encoding.force=true
spring.messages.encoding=UTF-8

然后 在IntelliJ IDEA中依次點(diǎn)擊File -> Settings -> Editor -> File Encodings

將Properties Files (*.properties)下的Default encoding for properties files設(shè)置為UTF-8，將Transparent native-to-ascii conversion前的勾選上。

然后在變量中通過(guò)@Value直接注入就行了，如下：

  @Value(value = "${book.author}")
  private String bookAuthor;
  @Value("${book.name}")
  private String bookName;
  @Value("${book.pinyin}")
  private String bookPinYin;

修改index方法，使之返回這些值：

@RequestMapping(value = "/",produces = "text/plain;charset=UTF-8")
  String index(){
    return "Hello Spring Boot! The BookName is "+bookName+";and Book Author is "+bookAuthor+";and Book PinYin is "+bookPinYin;
  }

然后在瀏覽器中訪問(wèn)，結(jié)果如下：

很簡(jiǎn)單吧。

類型安全的配置

剛剛說(shuō)的這種方式我們?cè)趯?shí)際項(xiàng)目中使用的時(shí)候工作量略大，因?yàn)槊總€(gè)項(xiàng)目要注入的變量的值太多了，這種時(shí)候我們可以使用基于類型安全的配置方式，就是將properties屬性和一個(gè)Bean關(guān)聯(lián)在一起，這樣使用起來(lái)會(huì)更加方便。我么來(lái)看看這種方式怎么實(shí)現(xiàn)。

1.在src/main/resources文件夾下創(chuàng)建文件book.properties

文件內(nèi)容如下：

book.name=紅樓夢(mèng)
book.author=曹雪芹
book.price=28

2.創(chuàng)建Book Bean,并注入properties文件中的值

代碼如下：

@Component
@ConfigurationProperties(prefix = "book",locations = "classpath:book.properties")
public class BookBean {
  private String name;
  private String author;
  private String price;

  public String getName() {
    return name;
  }

  public void setName(String name) {
    this.name = name;
  }

  public String getAuthor() {
    return author;
  }

  public void setAuthor(String author) {
    this.author = author;
  }

  public String getPrice() {
    return price;
  }

  public void setPrice(String price) {
    this.price = price;
  }
}

prefix是指前綴，location指定要注入文件的位置。

3.添加路徑映射

在Controller中添加如下代碼注入Bean：

@Autowired
  private BookBean bookBean;

 添加路徑映射：

@RequestMapping("/book")
  public String book() {
    return "Hello Spring Boot! The BookName is "+bookBean.getName()+";and Book Author is "+bookBean.getAuthor()+";and Book price is "+bookBean.getPrice();
  }

運(yùn)行效果如下：

日志配置

默認(rèn)情況下Spring Boot使用Logback作為日志框架，也就是我們前面幾篇博客中用到的打印日志方式，當(dāng)然如果有需要我們可以手動(dòng)配置日志級(jí)別以及日志輸出位置，相比于我們?cè)赟pring容器中寫(xiě)的日志輸出代碼，這里的配置簡(jiǎn)直就是小兒科了，只需要在application.properties中添加如下代碼：

logging.file=/home/sang/workspace/log.log
logging.level.org.springframework.web=debug

上面表示配置日志輸出位置，下面配置日志級(jí)別。

Profile配置問(wèn)題

在 Spring常用配置 這篇文章中，我們已經(jīng)介紹了Profile的作用，已經(jīng)如何在Spring框架下使用Profile，但是當(dāng)時(shí)小伙伴們看到了還是稍微有點(diǎn)麻煩，在Spring Boot 中系統(tǒng)提供了更為簡(jiǎn)潔的方式。全局Profile配置我們使用application-{profile}.properties來(lái)定義，然后在application.properties中通過(guò)spring.profiles.active來(lái)指定使用哪個(gè)Profile。OK，那么接下來(lái)我們來(lái)看一個(gè)簡(jiǎn)單的案例。

1.在src/main/resources文件夾下定義不同環(huán)境下的Profile配置文件，文件名分別為application-prod.properties和application-dev.properties，這兩個(gè)前者表示生產(chǎn)環(huán)境下的配置，后者表示開(kāi)發(fā)環(huán)境下的配置，如下：

application-prod.properties:

server.port=8081

application-dev.properties:

server.port=8080

然后在application.properties中進(jìn)行簡(jiǎn)單配置，如下：

spring.profiles.active=dev

這個(gè)表示使用開(kāi)發(fā)環(huán)境下的配置。然后運(yùn)行項(xiàng)目，我們得通過(guò)8080端口才可以訪問(wèn)：

如果想換為生產(chǎn)環(huán)境，只需要把spring.profiles.active=dev改為spring.profiles.active=prod即可，當(dāng)然訪問(wèn)端口這是也變?yōu)?081了，如下：

上述內(nèi)容就是教你如何正確的使用Spring Boot框架，你們學(xué)到知識(shí)或技能了嗎？如果還想學(xué)到更多技能或者豐富自己的知識(shí)儲(chǔ)備，歡迎關(guān)注億速云行業(yè)資訊頻道。