一、接口開(kāi)關(guān)功能

　　1、可配置化，依賴(lài)配置中心

　　2、接口訪問(wèn)權(quán)限可控

　　3、springmvc不會(huì)掃描到，即不會(huì)直接的將接口暴露出去

二、接口開(kāi)關(guān)使用場(chǎng)景

　　和業(yè)務(wù)沒(méi)什么關(guān)系，主要方便查詢(xún)系統(tǒng)中的一些狀態(tài)信息。比如系統(tǒng)的配置信息，中間件的狀態(tài)信息。這就需要寫(xiě)一些特定的接口，不能對(duì)外直接暴露出去（即不能被springmvc掃描到，不能被swagger掃描到）。

三、SimpleUrlHandlerMapping官方解釋

　　SimpleUrlHandlerMapping實(shí)現(xiàn)HandlerMapping接口以從URL映射到請(qǐng)求處理程序bean。
　　支持映射到bean實(shí)例和映射到bean名稱(chēng);后者是非單身處理程序所必需的。
　　“urlMap”屬性適合用bean引用填充處理程序映射，例如通過(guò)XML bean定義中的map元素。
　　可以通過(guò)“mappings”屬性以java.util.Properties類(lèi)接受的形式設(shè)置bean名稱(chēng)的映射，如下所示：/welcome.html=ticketController /show.html=ticketController語(yǔ)法為PATH = HANDLER_BEAN_NAME。　　
　　如果路徑不以斜杠開(kāi)頭，則前置一個(gè)。支持直接匹配（給定“/ test” - >注冊(cè)“/ test”）和“*”模式匹配（給定“/ test” - >注冊(cè)“/ t *”）。

四、接口開(kāi)關(guān)實(shí)現(xiàn)

　　就像SimpleUrlHandlerMapping javadoc中描述的那樣，其執(zhí)行原理簡(jiǎn)單理解就是根據(jù)URL尋找對(duì)應(yīng)的Handler。借助這種思想，我們?cè)贖andler中再借助RequestMappingHandlerMapping和RequestMappingHandlerAdapter來(lái)幫助我們完成URL的轉(zhuǎn)發(fā)。這樣做的好處是不需要直接暴露的接口開(kāi)發(fā)規(guī)則只需要稍作修改，接下來(lái)將詳細(xì)介紹一下。

　　請(qǐng)求轉(zhuǎn)發(fā)流程如下

　　

　　想法是好的，如何實(shí)現(xiàn)這一套流程呢？首先要解決以下問(wèn)題。

　　1、定義的接口不能被springmvc掃描到。

　　2、接口定義還是要按照@RequestMaping規(guī)則方式編寫(xiě)，這樣才能減少開(kāi)發(fā)量并且能被RequestMappingHandlerMapping處理。

　　3、如何自動(dòng)注冊(cè)u(píng)rl->handler到SimpleUrlHandlerMapping中去。

　　對(duì)于上面需要實(shí)現(xiàn)的，首先要了解一些springmvc相關(guān)源碼。

　　RequestMappingHandlerMapping初始化method mapping

/*** Scan beans in the ApplicationContext, detect and register handler methods.* @see #isHandler(Class)* @see #getMappingForMethod(Method, Class)* @see #handlerMethodsInitialized(Map)*/ protected void initHandlerMethods() {if (logger.isDebugEnabled()) {logger.debug("Looking for request mappings in application context: " + getApplicationContext());}String[] beanNames = (this.detectHandlerMethodsInAncestorContexts ?BeanFactoryUtils.beanNamesForTypeIncludingAncestors(getApplicationContext(), Object.class) :getApplicationContext().getBeanNamesForType(Object.class));for (String beanName : beanNames) {if (!beanName.startsWith(SCOPED_TARGET_NAME_PREFIX)) {Class<?> beanType = null;try {beanType = getApplicationContext().getType(beanName);}catch (Throwable ex) {// An unresolvable bean type, probably from a lazy bean - let's ignore it.if (logger.isDebugEnabled()) {logger.debug("Could not resolve target class for bean with name '" + beanName + "'", ex);}}if (beanType != null && isHandler(beanType)) {detectHandlerMethods(beanName);}}}handlerMethodsInitialized(getHandlerMethods()); }

?　　isHandler方法【判斷方法是不是一個(gè)具體handler】邏輯如下

protected boolean isHandler(Class<?> beanType) {return (AnnotatedElementUtils.hasAnnotation(beanType, Controller.class) ||AnnotatedElementUtils.hasAnnotation(beanType, RequestMapping.class)); }

　　所以我們定義的開(kāi)關(guān)接口為了不被springmvc掃描到，直接去掉類(lèi)注釋上的@Controller注解和@RequestMapping注解就好了，如下。

@Component @ResponseBody public class CommonsStateController {@GetMapping("/url1")public String handleUrl1() {return null;}

　　@GetMapping("/url2")public String handleUrl2() {return null;} }

　　按照如上的定義，url? -> handler（/message/state/* ->?CommonsStateController ）形式已經(jīng)出來(lái)了，但是還缺少父類(lèi)路徑 /message/state/ 以及 如何讓RequestMappingHandlerMapping識(shí)別CommonsStateController這個(gè)handler 中的所有子handler。

　　抽象Handler以及自定義RequestMappingHandlerMapping

import org.apache.commons.lang3.StringUtils; import org.springframework.beans.factory.InitializingBean; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.servlet.HandlerExecutionChain; import org.springframework.web.servlet.ModelAndView; import org.springframework.web.servlet.mvc.AbstractController; import org.springframework.web.servlet.mvc.method.RequestMappingInfo; import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter; import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping;import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.lang.reflect.Method; import java.util.Objects;/*** @author hujunzheng* @create 2018-08-10 12:53**/ public abstract class BaseController extends AbstractController implements InitializingBean {private RequestMappingHandlerMapping handlerMapping = new BaseRequestMappingHandlerMapping();@Autowiredprivate RequestMappingHandlerAdapter handlerAdapter;@Overrideprotected ModelAndView handleRequestInternal(HttpServletRequest request, HttpServletResponse response) throws Exception {HandlerExecutionChain mappedHandler = handlerMapping.getHandler(request);return handlerAdapter.handle(request, response, mappedHandler.getHandler());}@Overridepublic void afterPropertiesSet() {handlerMapping.afterPropertiesSet();}private class BaseRequestMappingHandlerMapping extends RequestMappingHandlerMapping {
　　　　 //初始化子handler mapping@Overrideprotected void initHandlerMethods() {detectHandlerMethods(BaseController.this);}
//合并父路徑和子handler路徑@Overrideprotected RequestMappingInfo getMappingForMethod(Method method, Class<?> handlerType) {RequestMappingInfo info = super.getMappingForMethod(method, handlerType);if (!Objects.isNull(info) && StringUtils.isNotBlank(getBasePath())) {info = RequestMappingInfo.paths(getBasePath()).build().combine(info);}return info;}}//開(kāi)關(guān)接口定義父路徑public abstract String getBasePath(); }

　　所有開(kāi)關(guān)接口handler都繼承這個(gè)BaseController?抽象類(lèi)，在對(duì)象初始時(shí)創(chuàng)建所有的子handler mapping。SimpleUrlHandlerMapping最終會(huì)調(diào)用開(kāi)關(guān)接口的handleRequestInternal方法，方法內(nèi)部通過(guò)RequestMappingHandlerMapping和RequestMappingHandlerAdapter 將請(qǐng)求轉(zhuǎn)發(fā)到具體的子handler。

@Component @ResponseBody public class CommonsStateController extends BaseController {@GetMapping("/url1")public String handleUrl1() {return null;}@GetMapping("/url2")public String handleUrl2() {return null;} }

?

　　自動(dòng)注冊(cè)u(píng)rl-handler到SimpleUrlHandlerMapping

import org.apache.commons.lang3.StringUtils; import org.springframework.util.CollectionUtils; import org.springframework.web.servlet.handler.SimpleUrlHandlerMapping;import java.util.HashMap; import java.util.List; import java.util.Map;/*** @author hujunzheng* @create 2018-08-10 13:57**/ public class EnhanceSimpleUrlHandlerMapping extends SimpleUrlHandlerMapping {public EnhanceSimpleUrlHandlerMapping(List<BaseController> controllers) {if (CollectionUtils.isEmpty(controllers)) {//NOSONARreturn;}Map<String, BaseController> urlMappings = new HashMap<>();controllers.forEach(controller -> {String basePath = controller.getBasePath();if (StringUtils.isNotBlank(basePath)) {if (!basePath.endsWith("/*")) {basePath = basePath + "/*";}urlMappings.put(basePath, controller);}});this.setUrlMap(urlMappings);} }

　　獲取BaseController父路徑，末尾加上‘/*’，然后將url -> handler關(guān)系注冊(cè)到SimpleUrlHandlerMapping的urlMap中去。這樣只要請(qǐng)求路徑是 父路徑/*的模式都會(huì)被SimpleUrlHandlerMapping處理并轉(zhuǎn)發(fā)給對(duì)應(yīng)的handler（BaseController），然后在轉(zhuǎn)發(fā)給具體的子handler。

　　接口開(kāi)關(guān)邏輯

import com.cmos.wmhopenapi.service.config.LimitConstants; import com.google.common.collect.Lists; import org.apache.commons.lang3.StringUtils; import org.springframework.web.servlet.handler.HandlerInterceptorAdapter; import org.springframework.web.servlet.handler.SimpleUrlHandlerMapping;import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.util.stream.Collectors;/*** @author hujunzheng* @create 2018-08-10 15:17**/ public class UrlHandlerInterceptor extends HandlerInterceptorAdapter {private SimpleUrlHandlerMapping mapping;private LimitConstants limitConstants;public UrlHandlerInterceptor(SimpleUrlHandlerMapping mapping, LimitConstants limitConstants) {this.mapping = mapping;this.limitConstants = limitConstants;}@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {String lookupUrl = mapping.getUrlPathHelper().getLookupPathForRequest(request);String urllimits = limitConstants.getUrllimits();if (StringUtils.isNotBlank(urllimits)) {for (String urllimit : Lists.newArrayList(urllimits.split(",")).stream().map(value -> value.trim()).collect(Collectors.toList())) {if (mapping.getPathMatcher().match(urllimit, lookupUrl)) {return false;}}}return true;} }

　　基本思路就是通過(guò) UrlPathHelper獲取到request的lookupUrl（例如 /message/state/url1） ，然后獲取到配置中心配置的patter path（例如message/state/*），最后通過(guò) AntPathMatcher進(jìn)行二者之間的匹配，如果成功則禁止接口訪問(wèn)。

?五、接口開(kāi)關(guān)配置

@Bean public SimpleUrlHandlerMapping simpleUrlHandlerMapping(ObjectProvider<List<BaseController>> controllers, LimitConstants limitConstants) {SimpleUrlHandlerMapping mapping = new EnhanceSimpleUrlHandlerMapping(controllers.getIfAvailable());mapping.setOrder(Ordered.HIGHEST_PRECEDENCE + 1);mapping.setInterceptors(new UrlHandlerInterceptor(mapping, limitConstants));return mapping; }

　　創(chuàng)建自定義的SimpleUrlHandlerMapping，然后將類(lèi)型為BaseController所有handler以構(gòu)造參數(shù)的形式傳給SimpleUrlHandlerMapping，并設(shè)置接口開(kāi)關(guān)邏輯攔截器。

　　至此，接口開(kāi)關(guān)能力已經(jīng)實(shí)現(xiàn)完畢。再也不用在擔(dān)心接口會(huì)直接暴露出去了，可以通過(guò)配置隨時(shí)更改接口的訪問(wèn)權(quán)限。

轉(zhuǎn)載于:https://www.cnblogs.com/hujunzheng/p/9902475.html

總結(jié)

以上是生活随笔為你收集整理的Springmvc借助SimpleUrlHandlerMapping实现接口开关功能的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。