Controller

Controller是SpringBoot里最基本的組件，他的作用是把用戶提交來的請(qǐng)求通過對(duì)URL的匹配，分配給不同的接收器，再進(jìn)行處理，然后向用戶返回結(jié)果。他的重點(diǎn)就在于如何從HTTP請(qǐng)求中獲得信息，提取參數(shù)，并分發(fā)給不同的處理服務(wù)。

基本組成

一個(gè)最經(jīng)典的Controller應(yīng)該大概長(zhǎng)這樣:

package com.example.demo.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
/**
 * Created by myths on 5/16/17.
 */
@Controller
public class IndexController {
    @RequestMapping(value = {"index", "/"})
    public String index(Model model) {
        return "index";
    }
}

復(fù)制

首先應(yīng)該在類的開頭，加上@Controller注解，告知Spring這是一個(gè)控制器。 然后在對(duì)應(yīng)的處理函數(shù)前面加上@RequestMapping，告知這個(gè)函數(shù)需要相應(yīng)的URL。 接著這個(gè)函數(shù)傳入了一個(gè)Model類型的參數(shù)，這個(gè)參數(shù)主要是用于向模板傳遞數(shù)據(jù)。 該函數(shù)最后返回了一個(gè)叫"index"的字符串，表示將調(diào)用名為"index"的模板，具體名稱取決于模板引擎，比如對(duì)于jsp他將訪問"index.jsp"這個(gè)文件,對(duì)于thymeleaf，他將訪問"index.html"這個(gè)文件。

上面的是最簡(jiǎn)單的用法，實(shí)際上有很多細(xì)節(jié)需要注意，下面就來一一解釋。

ResponseBody

如果我們想返回純字符串而不是渲染后的模板，那我們可以在需要返回字符串的函數(shù)前面加上@ResponseBody這個(gè)注解； 如果我們像對(duì)于整個(gè)類都返回字符串，我們也可以在這個(gè)類前面加上@ResponseBody注解，或者將@Controller注解換成@RestController，均可。

RequestMapping 基本用法

這個(gè)注解是用來告訴Spring，下面的這個(gè)函數(shù)或者類是用來映射到那個(gè)URL的，通常情況下有下面這些選項(xiàng)：

    @RequestMapping(
            path = {"/test"},
            params = {"name","userId"},
            method = {RequestMethod.GET},
            consumes = {"text/plain", "application/*"},
            produces = "text/plain",
            headers = "content-type=text/*"
    )

復(fù)制

我們可以指定這個(gè)路徑，參數(shù)，方法，頭信息，來作為一個(gè)Controller的入口。當(dāng)然，通常我們只需要指定path就行了。

對(duì)象轉(zhuǎn)json或xml

這里有一個(gè)使用的小竅門，比如有時(shí)候我們希望返回json字符串，我們當(dāng)然可以調(diào)用jackson,gson,fastjson等等工具來組合數(shù)據(jù)，但是這樣顯然比較麻煩。其實(shí)springboot自帶了將對(duì)象持久化的工具，只要我們?cè)?code>produces參數(shù)中指定頭信息，就可以將返回的對(duì)象直接轉(zhuǎn)換為json或xml。比如:

package com.mythsman.controller;
import com.mythsman.bean.TestBean;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class TestController {
    @RequestMapping(value = "test", produces = {"application/json;charset=UTF-8"})
    public TestBean test() {
        TestBean testBean = new TestBean();
        testBean.setName("myths");
        testBean.setAge(12);
        return testBean;
    }
}

復(fù)制

訪問后的返回結(jié)果就是{"name":"myths","age":12}。同理，也可以自動(dòng)轉(zhuǎn)換成xml格式，不過xml格式對(duì)與map等的數(shù)據(jù)結(jié)構(gòu)無法支持，因此我們還是建議采用json。

作用對(duì)象

這個(gè)注解可以注解一個(gè)函數(shù)，也可以注解一個(gè)類。當(dāng)注解一個(gè)類時(shí)，類中所有的方法都會(huì)在這個(gè)基礎(chǔ)上再進(jìn)行過濾：

@Controller
@RequestMapping("/path1")
public class TestController {
    @RequestMapping("/path2")
    @ResponseBody
    public String index() {
        return "ok";
    }
}

復(fù)制

這個(gè)函數(shù)就能匹配"/path1/path1"這個(gè)地址。

缺省參數(shù)

當(dāng)RequestMapping的參數(shù)是空的時(shí)候，他就表示匹配剩余所有的頁(yè)面,實(shí)際上也就是匹配所有的404頁(yè)面。

@Controller
public class IndexController {
    @RequestMapping
    public String index(Model model) {
        return "index";
    }
}

復(fù)制

當(dāng)RequestMapping不指定參數(shù)名時(shí)，默認(rèn)就是path參數(shù)。

@Controller
public class IndexController {
    @RequestMapping("/index")
    public String index(Model model) {
        return "index";
    }
}

復(fù)制

PathVariable

RequestMapping中的path也可以是一個(gè)未定的變量，比如下面的代碼:

@Controller
public class TestController {
    @RequestMapping("/{variable}")
    @ResponseBody
    public String index(@PathVariable("variable")String variable) {
        return variable;
    }
}

復(fù)制

通過花括號(hào)我們就可以指定這個(gè)變量，并且通過@PathVariable注解得到這個(gè)參數(shù)，非常方便。

RequestParam

RequestMapping也可以獲取類似表單傳回的信息形式，比如/index?name=XXX，這個(gè)name變量就可以通過RequestParam注解來獲得:

@Controller
public class TestController {
    @RequestMapping("/index")
    @ResponseBody
    public String index(@RequestParam(value = "name",required = false,defaultValue = "233")String name) {
        return name;
    }
}

復(fù)制

我們可以控制這個(gè)參數(shù)的名字，是否必須，以及設(shè)置默認(rèn)值，來更好的進(jìn)行匹配。

RequestBody

RequestBody用來獲取Post信息的消息體,只要在參數(shù)中通過@RequestBody注解就能得到這個(gè)參數(shù):

@Controller
public class TestController {
    @RequestMapping("/index")
    @ResponseBody
    public String index(@RequestBody String body) {
		//對(duì)body進(jìn)行解析即可
        return "success";
    }
}

到此這篇關(guān)于SpringBoot中的Controller用法的文章就介紹到這了,更多相關(guān)SpringBoot Controller用法內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論