我們每做一個(gè)新項(xiàng)目，通常都是從另一個(gè)項(xiàng)目把代碼拷貝過來，然后在其上做開發(fā)。但是這種模式的一個(gè)比較大的問題就是會(huì)有很多上個(gè)項(xiàng)目的遺留代碼。因此，開發(fā)一個(gè)公共的應(yīng)用骨架系統(tǒng)，在開始其他新項(xiàng)目時(shí)，從這個(gè)骨架系統(tǒng)開始開發(fā)，是一個(gè)很好的選擇。

我們首先需要?jiǎng)?chuàng)建一個(gè)SpringBoot工程，我們可以使用：https://start.spring.io/

如下所所：

上圖中比較關(guān)鍵的是從頁面右側(cè)“Add Dependencies”按鈕彈出的列表中選擇“Spring Web”。網(wǎng)站上的工具會(huì)生成一個(gè)基本的SpringBoot工程，并自動(dòng)將zip文件下載到本地。
將該文件解壓，以idea community版本打開（也可以使用商業(yè)版，但是該版本是收費(fèi)版，出于尊重知識(shí)產(chǎn)權(quán)的原因，使用免費(fèi)的社區(qū)版）。

我們首先將系統(tǒng)自帶的src/main/resources下面的application.properties文件刪除，添加application.yaml文件，添加如下內(nèi)容：

server:
 port: ${port:2208}
spring:
 application:
  name: first-service
logging:
 pattern:
  console: "%d{HH:mm:ss.SSS} %-5level %logger{36} - %msg%n"
  file: "%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n"
 level:
  org.springframework.web: DEBUG
 file: app.log

下面我們以Person對象的增、刪、改、查操作為例，創(chuàng)建一個(gè)REST風(fēng)格的API。
我們首先在repository包中創(chuàng)建Person對象：

public class Person {
  private Long personId;
  private String firstName;
  private String lastName;
  private int age;
// getter and setters
//......
}

接下來我們來創(chuàng)建REST服務(wù)端，在controller包中創(chuàng)建DemoController類：

@RestController
@RequestMapping("/person")
public class DemoController {
  private List<Person> persons = new ArrayList<>();

  @GetMapping
  public List<Person> findAll() {
    return persons;
  }

  @GetMapping("/{personId}")
  public Person findById(@PathVariable("personId") Long personId,
              HttpServletRequest request) {
    String mode = request.getParameter("mode");
    System.out.println("mode=" + mode + "!");
    return persons.stream().filter(item -> item.getPersonId().equals(personId)).findFirst().get();
  }

  @PostMapping
  public Person add(@RequestBody Person p) {
    p.setPersonId((long)(persons.size()+1));
    persons.add(p);
    return p;
  }

  @DeleteMapping("/{personId}")
  public void delete(@PathVariable("personId") Long personId) {
    List<Person> ps = persons.stream().filter(item -> item.getPersonId().
        equals(personId)).collect(Collectors.toList());
    persons.removeAll(ps);
  }

  @PutMapping
  public void update(@RequestBody Person p) {
    Optional<Person> person = persons.stream().filter(item -> item.getPersonId().
        equals(p.getPersonId())).findFirst();
    person.ifPresent(po->persons.set(persons.indexOf(po), p));
  }
}

由于用到了Jdk8以后的一些特性，這里稍做一些解釋：

• 第1行：代表其是一個(gè)REST風(fēng)格服務(wù)的類；
• 第2行：規(guī)定所有/person開頭的請求，都由本類來進(jìn)行處理；
• 第4行：使用泛型技術(shù)定義Person列表對象屬性；
• 第6~9行：定義http://server/person請求，返回Json格式Person列表；
• 第11行：定義http://server/person/101?mode=2形式的請求，首先定義路徑中包含的參數(shù)101為personId，分別在GetMapping和函數(shù)參數(shù)中用@RequestParam來定義，其次請求中的queryString使用函數(shù)形參中的第二個(gè)參數(shù)HttpServletRequest來獲取；
• 第14、15行：獲取QueryString中的mode參數(shù)；
• 第16行：在過去，我們?nèi)缫雽ist對象進(jìn)行查找，需要自己遍歷List對象，在Jdk8之后，提供了Stream API，可以幫助我們更加高效的進(jìn)行查找。首先創(chuàng)建stream，這里其實(shí)還可以指定是否使用.parellel()并行技術(shù)來利用CPU的多核特性。然后在filter中定義查詢條件，該查詢條件是一個(gè)Lambda表達(dá)式，也是Jdk8之后引入的新特性，就是對列表中的每個(gè)元素item，首先獲取personId屬性，然后與personId參數(shù)進(jìn)行比較，取相等的記錄，由于相等的記錄可能存在多條，我們用findFirst來取第一條，其返回結(jié)果為Optional類型，Optional同樣是Jdk8之后引入的新特性，專門用于避免空指針異常。我們這里，我們非常確信其一定包括Person對象，所以通過.get函數(shù)獲取出Person對象，并返回；
• 第19行：在REST風(fēng)格中，POST請求用于添加新對象；
• 第20行：在缺省情況下，POST請求的內(nèi)容通過application/json傳遞，即客戶端需要將內(nèi)容轉(zhuǎn)換為Json格式，放入POST的請求體中，SpringBoot會(huì)自動(dòng)將請求體的Json內(nèi)容轉(zhuǎn)化為@RequestBody指定的值對象；
• 第26行：在REST風(fēng)格中，DELETE請求用于刪除對象，即當(dāng)用戶發(fā)送的請求為DELETE /person/101 HTTP/1.0時(shí)，代表刪除personId=101的對象；
• 第27行：定義delete函數(shù)，獲取請求路徑上的personId參數(shù)；
• 第28、29行：求出符合查詢條件的Person對象列表，同樣是先用成stream，在filter中定義查詢條件，最后通過collect函數(shù)將查詢結(jié)果轉(zhuǎn)換為列表；
• 第30行：從persons列表中刪除符合條件記錄；
• 第33行：在REST風(fēng)格中，用PUT請求來進(jìn)行對象更新；
• 第34行：通過請求體中的Json字符串，由SpringBoot自動(dòng)創(chuàng)建Person值對象；
• 第35、36行：查詢出符合條件的記錄，類型為Optional，在這里我們雖然可以使用if (ps.ifPresent()) {…}，但是這和過去null的處理方式?jīng)]有什么區(qū)別，我們采用更Jdk8的形式，在ifPresent函數(shù)中提供了Lambda表達(dá)式，這義了對象更新邏輯；
  

我們下面需要對REST服務(wù)進(jìn)行測試，我們可以通過PostMan來進(jìn)行測試，但是在這里，我們將采用Swagger來進(jìn)行測試。這樣做主要好處是可以同時(shí)生成REST服務(wù)的文檔。
我們首先在項(xiàng)目根目錄下的pom.xml中添加如下內(nèi)容：

<!-- 開始：添加Swagger支持 -->
		<dependency>
			<groupId>io.springfox</groupId>
			<artifactId>springfox-swagger2</artifactId>
			<version>2.7.0</version>
		</dependency>
		<dependency>
			<groupId>io.springfox</groupId>
			<artifactId>springfox-swagger-ui</artifactId>
			<version>2.7.0</version>
		</dependency>
		<!-- 結(jié)束：添加Swagger支持 -->
		<!-- 開始：讀取maven pox.xml文件 -->
		<dependency>
			<groupId>org.apache.maven</groupId>
			<artifactId>maven-model</artifactId>
			<version>3.0</version>
		</dependency>
		<!-- 結(jié)束：讀取maven pox.xml文件 -->

同時(shí)給應(yīng)用類StpApplication添加如下標(biāo)注：

@EnableSwagger2
@SpringBootApplication
public class StpApplication {
	......

	@Bean
	public Docket api() throws IOException, XmlPullParserException {
		MavenXpp3Reader reader = new MavenXpp3Reader();
		Model model = reader.read(new FileReader("pom.xml"));
		ApiInfoBuilder builder = new ApiInfoBuilder()
				.title("智慧交通平臺(tái)")
				.description("智慧交通平臺(tái)API接口文檔")
				.version(model.getVersion())
				.contact(new Contact("最老程序員", "www.abc.com", "ua@"));
		return new Docket(DocumentationType.SWAGGER_2).select().
				apis(RequestHandlerSelectors.basePackage("com.zhuanjingkj.stp.demo.controller"))
						.paths(PathSelectors.any()).build()
						.apiInfo(builder.build());
	}
}

就是添加@EnableSwagger2標(biāo)注信息。在瀏覽器中輸入如下地址：http://localhost:2208/swagger-ui.html

會(huì)顯示如下圖所示頁面：

我們可以點(diǎn)擊進(jìn)入對應(yīng)的接口，可以看到接口的調(diào)用方法，同時(shí)可以填寫真實(shí)的數(shù)據(jù)，對接口進(jìn)行測試。

到此這篇關(guān)于SpringCloud應(yīng)用骨架開發(fā)詳解的文章就介紹到這了,更多相關(guān)SpringCloud應(yīng)用骨架 內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論