快捷導(dǎo)航

Spring中Controller應(yīng)用深入理解

更新時(shí)間：2022年12月08日 16:13:30 作者：居然天上樓

這篇文章主要介紹了Spring項(xiàng)目中的Controller，Spring Controller本身也是一個(gè)Spring Bean,只是它多提供了Web能力,只需要造類(lèi)上提供@Controller注解即可

概述

Controller是Spring接受并處理網(wǎng)頁(yè)請(qǐng)求的組件,是整個(gè)應(yīng)用的入口，因此學(xué)會(huì)Controller的常用注解對(duì)理解一個(gè)應(yīng)用是重中之重。SpringBoot的Controller中經(jīng)常會(huì)用到注解@Controller、@RestController、@RequestMapping、@RequestBody等，本短文主要對(duì)這些常用的Controller注解進(jìn)行簡(jiǎn)單介紹。

1. 添加依賴(lài)

首先，需要保障此項(xiàng)目中存在spring-boot-starter-web依賴(lài)項(xiàng)，否則，當(dāng)前項(xiàng)目并不具備Web應(yīng)用程序開(kāi)發(fā)所需的依賴(lài)！

提示：spring-boot-starter-web是建立在spring-boot-starter的基礎(chǔ)之上的，即包含了spring-boot-starter，所以，在此次調(diào)整依賴(lài)項(xiàng)時(shí)，只需要將原有的spring-boot-starter改為spring-boot-starter-web即可！

<!-- Spring Boot框架支持WEB開(kāi)發(fā)的依賴(lài)項(xiàng) -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

當(dāng)項(xiàng)目中存在以上依賴(lài)項(xiàng)時(shí)，就具備了Web開(kāi)發(fā)的依賴(lài)，且此依賴(lài)項(xiàng)中內(nèi)置了Tomcat，當(dāng)啟用項(xiàng)目時(shí)，會(huì)自動(dòng)將當(dāng)前項(xiàng)目編譯、打包、部署到內(nèi)置的Tomcat上，并啟動(dòng)Tomcat。

在根包下創(chuàng)建controller.AlbumController類(lèi)，將此類(lèi)配置為控制器類(lèi)，并處理“添加相冊(cè)”的請(qǐng)求：

@RestController
@RequestMapping("/album")
public class AlbumController {
    @Autowired
    private IAlbumService albumService;
    // http://localhost:8080/album/add-new?name=TestAlbum001&description=TestDescription001&sort=66
    @RequestMapping("/add-new")
    public void addNew(AlbumAddNewDTO albumAddNewDTO){
        albumService.addNew(albumAddNewDTO);
    }
}

完成后，啟動(dòng)項(xiàng)目，打開(kāi)瀏覽器，通過(guò)http://localhost:8080/album/add-new?name=TestAlbum001&description=TestDescription001&sort=66可以測(cè)試添加數(shù)據(jù)！

提示：目前添加相冊(cè)成功時(shí)，在瀏覽器中并不會(huì)有任何提示。

如果使用相同的請(qǐng)求參數(shù)反復(fù)提交請(qǐng)求，瀏覽器會(huì)顯示500錯(cuò)誤，這是因?yàn)闆](méi)有處理異常所導(dǎo)致的！

2. 關(guān)于異常

可能出現(xiàn)的異常

如果某個(gè)方法會(huì)拋出異常，則誰(shuí)調(diào)用，誰(shuí)處理；
如果調(diào)用的方法拋出了異常，當(dāng)前方法也沒(méi)有使用try...catch進(jìn)行捕獲并處理，相當(dāng)于當(dāng)前方法拋出了此異常；
如果服務(wù)器端程序運(yùn)行時(shí)出現(xiàn)了異常，始終未被處理，框架默認(rèn)的行為是響應(yīng)500錯(cuò)誤，此時(shí)應(yīng)該檢查服務(wù)器端的控制臺(tái)，在控制臺(tái)中應(yīng)該有異常的相關(guān)信息；
處理異常的本質(zhì)是：告訴客戶(hù)端執(zhí)行失敗，且失敗的原因是什么，以至于客戶(hù)端下次提交請(qǐng)求時(shí)可能成功，另外，對(duì)于某些特殊的情景，可能還需要補(bǔ)充執(zhí)行一些其它代碼；
關(guān)于異常的捕獲處理和拋出，在典型的服務(wù)器端項(xiàng)目中，Mapper、Service都不能處理異常，因?yàn)樗鼈儾慌c客戶(hù)端直接交互，如果它們處理了異常，Controller將不知道出現(xiàn)過(guò)錯(cuò)誤，反而響應(yīng)“成功”的結(jié)果到客戶(hù)端，但客戶(hù)端的請(qǐng)求是沒(méi)有達(dá)到預(yù)期的目標(biāo)的，而Controller有義務(wù)處理異常，因?yàn)樗桥c客戶(hù)端交互的組件