快捷導(dǎo)航

使用Spring Boot創(chuàng)建Web應(yīng)用程序的示例代碼

更新時(shí)間：2018年05月28日 10:44:41 作者：彭政生

本篇文章主要介紹了使用Spring Boot創(chuàng)建Web應(yīng)用程序的示例代碼，我們將使用Spring Boot構(gòu)建一個(gè)簡(jiǎn)單的Web應(yīng)用程序，并為其添加一些有用的服務(wù)，小編覺(jué)得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧

在這篇文章中，我們將探討使用Spring Boot創(chuàng)建Web應(yīng)用程序的細(xì)節(jié)。我們將探索Spring Boot如何幫助你加速應(yīng)用程序開(kāi)發(fā)。

我們將使用Spring Boot構(gòu)建一個(gè)簡(jiǎn)單的Web應(yīng)用程序，并為其添加一些有用的服務(wù)。

1. 介紹

啟動(dòng)一個(gè)新項(xiàng)目的主要挑戰(zhàn)之一是該項(xiàng)目的初始設(shè)置。我們需要對(duì)不同的目錄結(jié)構(gòu)進(jìn)行調(diào)用，并且需要確保我們遵循所有行業(yè)標(biāo)準(zhǔn)。對(duì)于使用Spring Boot創(chuàng)建Web應(yīng)用程序，我們需要以下工具：

我們自己喜歡的IDE (我將使用IntelliJ)
Maven
JDK 1.8+

2. 創(chuàng)建項(xiàng)目結(jié)構(gòu)

有多種方式可以使用Spring Boot Initializr為你生成項(xiàng)目結(jié)構(gòu)：

使用Spring Initializr Web界面。
使用Spring Boot CLI工具。
使用你的IDE

為了簡(jiǎn)化這篇文章，我們使用Spring Initializer的網(wǎng)頁(yè)界面來(lái)生成項(xiàng)目結(jié)構(gòu)。

用你的瀏覽器訪問(wèn)Spring Initializr Web界面，你將看到一個(gè)向?qū)?lái)開(kāi)始你的配置。

你需要填寫(xiě)網(wǎng)頁(yè)界面中的一些信息才能開(kāi)始。

你想要生成什么類型的項(xiàng)目（Maven或Gradle）
你選擇什么語(yǔ)言（除了Java，你還可以選擇Kotlin或Groovy）？
Spring Boot版本
標(biāo)準(zhǔn)的項(xiàng)目組和工件細(xì)節(jié)。
依賴

依賴是Web界面中的一個(gè)有趣功能，根據(jù)你選擇的依賴，Web界面會(huì)自動(dòng)在生成的pom.xml文件中添加Spring Boot Starter依賴。如果你希望對(duì)生成的項(xiàng)目結(jié)構(gòu)進(jìn)行更多控制，或者不確定所有你想要添加到項(xiàng)目中的依賴，請(qǐng)單擊“Switch to the full version”按鈕。

在本文中，我們將使用Web和Thymeleaf（用于用戶界面）兩個(gè)Starter。

3. 項(xiàng)目結(jié)構(gòu)

Spring Boot不需要任何特定的代碼布局或結(jié)構(gòu)。我們始終可以遵循Spring Boot團(tuán)隊(duì)提出的一些最佳實(shí)踐，但最終結(jié)構(gòu)將由你的項(xiàng)目需求驅(qū)動(dòng)。

下圖是我們例子應(yīng)用的項(xiàng)目結(jié)構(gòu)：

4. pom.xml

我們來(lái)看看pom.xml文件，詳細(xì)地了解Spring Boot配置。我將僅涵蓋pom.xml中與Spring Boot相關(guān)的更改。以下是我們示例項(xiàng)目中的pom.xml文件。

 <?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">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.javadevjournal</groupId>
  <artifactId>javadevspringboot</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>war</packaging>
  <name>javadevspringboot</name>
  <description>Java Dev Journal project for Spring Boot</description>
  <parent>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-parent</artifactId>
   <version>1.5.4.RELEASE</version>
   <relativePath/> <!-- lookup parent from repository -->
  </parent>
  <properties>
   <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
   <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
   <java.version>1.8</java.version>
  </properties>
  <dependencies>
   <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-thymeleaf</artifactId>
   </dependency>
   <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-web</artifactId>
   </dependency>
   <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-tomcat</artifactId>
     <scope>provided</scope>
   </dependency>
   <dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-starter-test</artifactId>
     <scope>test</scope>
   </dependency>
  </dependencies>
</project>

Spring Boot的主要特性之一是“Starter”，它們是在我們的類路徑中添加所需依賴項(xiàng)（jar包）的簡(jiǎn)單方法。當(dāng)使用Spring Boot時(shí)，我們不必在我們的類路徑中添加jar包或依賴項(xiàng)（如果starter不可用，你可能必須將這些依賴項(xiàng)添加到pom.xml中，或者可以創(chuàng)建自己的自定義starter）。我們只需要在我們的pom.xml文件中添加正確的“Starter”，Spring Boot將確保自動(dòng)添加這些依賴。

5. 主應(yīng)用

如下所示是我們的Spring Boot應(yīng)用程序主類，它也是一個(gè)Spring配置類。注解@SpringBootApplication啟用Spring上下文以及Spring Boot的所有啟動(dòng)魔法。

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

5. 1 @SpringBootApplication 注解

@SpringBootApplication相當(dāng)于使用@Configuration，@EnableAutoConfiguration和@ComponentScan以及它們的默認(rèn)值。如果要開(kāi)始項(xiàng)目，建議使用這個(gè)注解。

在主類中使用@SpringBootApplication相當(dāng)于同時(shí)使用以下3個(gè)注解：

@Configuration作為bean定義的來(lái)源。
@EnableAutoConfiguration，它為Spring Boot提供了如何配置應(yīng)用程序。
@ComponentScan自動(dòng)獲取所有Spring組件，包括@Configuration類。

5. 2 主方法

我們主類的另一個(gè)有趣特點(diǎn)是主方法。這是遵循標(biāo)準(zhǔn)Java工作流程的標(biāo)準(zhǔn)方法。我們的主類將把控制權(quán)交給Spring Boot SpringApplication類。

SpringApplication類的run方法將用于引導(dǎo)一個(gè)應(yīng)用程序。

6. Welcome Controller

我們?cè)O(shè)置的最后一部分，我們將創(chuàng)建一個(gè)welcome controller，負(fù)責(zé)通過(guò)返回View的名稱（在本例中為“welcome”）處理/greeting的GET請(qǐng)求。視圖負(fù)責(zé)呈現(xiàn)HTML內(nèi)容。

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class WelcomeController {
  @RequestMapping("/welcome")
  public String welcome() {
    return "welcome";
  }
}

這是一個(gè)非常簡(jiǎn)單的控制器，但在我們的設(shè)置中涵蓋了很多要點(diǎn)。

@Controller注解表示被注解的類是“控制器”（例如Web controller）。
@RequestMapping注解可確保將對(duì)/welcome的HTTP請(qǐng)求映射到welcome()方法。
我們沒(méi)有為@RequestMapping注解指定任何HTTP方法，因此默認(rèn)情況下，映射所有HTTP方法。
由于我們使用Thymeleaf進(jìn)行視圖技術(shù)并從welcome()方法返回“welcome”，因此Thymeleaf會(huì)解析模板welcome.html并生成輸出。

6. 1 UI Template

如下我們簡(jiǎn)單的Thymeleaf HTML模板。

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head>
  <title>Getting Started: Serving Web Content</title>
</head>
<body>
Hello and Welcome to our Web Application
</body>
</html>

當(dāng)使用Thymeleaf作為我們的模板引擎時(shí)，Spring Boot將通過(guò)在視圖名稱前后加上前綴和后綴（配置參數(shù)分別是：spring.thymeleaf.prefix和spring.thymeleaf.suffix，它們的默認(rèn)的值是：'classpath:/templates/‘和'html'）。

7. 運(yùn)行程序

我們完成了我們簡(jiǎn)單的Web應(yīng)用程序，現(xiàn)在是時(shí)候運(yùn)行我們的應(yīng)用程序了。盡管可以將此服務(wù)作為傳統(tǒng)WAR文件打包以部署到外部應(yīng)用程序服務(wù)器上，但更簡(jiǎn)單的方法是創(chuàng)建獨(dú)立應(yīng)用程序。要從IDE運(yùn)行我們的應(yīng)用程序，我們需要將我們的Web應(yīng)用程序作為獨(dú)立的Java應(yīng)用程序運(yùn)行。