【SpringBoot WEB系列】WebFlux靜态資源配置與通路

上一篇博文介紹SpringMVC的靜态資源通路，那麼在WebFlux中，靜态資源的通路姿勢是否一緻呢

I. 預設配置

與SpringBoot的預設配置一樣，WebFlux同樣是

classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/

即，将靜态檔案放在這四個目錄下，可以直接通路

1. 項目示範

建立一個SpringBoot項目，添加依賴(本文使用的版本為:

2.2.1-RELEASE

)

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
</dependency>

複制

在資源路徑下添加目錄

static

，目錄下添加兩個html檔案，如下圖

實作啟動類，不添加額外邏輯，既可以直接通過完整url方式通路靜态資源

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

複制

主要觀察上面三個請求，放在

index.html

是無法直接通路到的，因為它所在的目錄并不在預設的四個靜态資源路徑中

2. Url映射

上面是直接通過靜态資源檔案名的方式進行通路，那麼WebFlux是否可以實作SpringMVC那種，根據視圖名傳回View的方式呢？

@Controller
public class ViewAction {
    @GetMapping(path = "a")
    public String a() {
        return "a.html";
    }
}

複制

直接通路，結果發現500，找不到名為

a.html

的視圖

這種方式不行的話，改用WebFlux的路由寫法

@Bean
public RouterFunction<ServerResponse> indexRouter() {
    return RouterFunctions.route(RequestPredicates.GET("/b"),
                    request -> ServerResponse.ok().contentType(MediaType.TEXT_HTML).bodyValue("b.html");
}

複制

II. 自定義配置路徑

如果我們希望指定一個自定義的路徑，是否可以如SpringMvc那樣，修改配置or代碼設定映射完成呢?

在資源目錄下，新加兩個檔案夾，分别是 o1, o2

1. 配置修改

如SpringMVC，修改靜态資源配置

spring:
  resources:
    static-locations: classpath:/o1/,classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/

複制

然後通路

/o1.html

，發現404，這種直接修改配置方式不行!!!

2. WebFluxConfigurer添加映射

參考自官方文檔: web-reactive.html#webflux-config-static-resources

直接修改啟動類，實作

WebFluxConfigurer

接口，手動添加資源映射

@SpringBootApplication
public class Application implements WebFluxConfigurer {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/**").addResourceLocations("classpath:/o2/");
    }

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

複制

接着通路

/o2.html

3. @Value方式

除了上述手動映射的方式之外，還有一種非主流的是方式，如

@Bean
public RouterFunction<ServerResponse> indexRouter(@Value("classpath:/index.html") final Resource indexHtml,
        @Value("classpath:/self/s.html") final Resource sHtml) {
    return RouterFunctions.route(RequestPredicates.GET("/index"),
            request -> ServerResponse.ok().contentType(MediaType.TEXT_HTML).bodyValue(indexHtml))
            .andRoute(RequestPredicates.GET("/s"),
                    request -> ServerResponse.ok().contentType(MediaType.TEXT_HTML).bodyValue(sHtml));
}

複制

請注意上面的兩個檔案，

s.html

index.html

都不在預設的靜态資源目錄下

III. 小結

文中給出了WebFlux的靜态資源通路姿勢，與SpringMVC有一些差別

url映射時，直接傳回視圖名，會提示 Could not resolve view with name xxx
通過修改配置 spring.resources.static-locations 指定新的靜态資源目錄無效

在WebFlux中，推薦使用實作

WebFluxConfigure

接口的方式，重寫

addResourceHandlers

方法來自定義資源路徑映射

也可以針對單獨的靜态資源，借助

@Value

來手動路由

II. 其他

0. 項目

工程：https://github.com/liuyueyi/spring-boot-demo
源碼：https://github.com/liuyueyi/spring-boot-demo/blob/master/spring-boot/200-webflux

1. 一灰灰Blog

盡信書則不如，以上内容，純屬一家之言，因個人能力有限，難免有疏漏和錯誤之處，如發現bug或者有更好的建議，歡迎批評指正，不吝感激

下面一灰灰的個人部落格，記錄所有學習和工作中的博文，歡迎大家前去逛逛

一灰灰Blog個人部落格 https://blog.hhui.top
一灰灰Blog-Spring專題部落格 http://spring.hhui.top