package org.springframework.web.servlet;

import javax.servlet.http.HttpServletRequest;

/**
1.定义一个将请求和处理器进行映射的接口。
开发人员也可以自己实现这个接口，虽然这是不必须的，因为现在的springmvc中已经提供了大量的实现，最典型的就是
BeanNameUrlHandlerMapping,SimpleUrlHandlerMapping，RequestMappingHandlerMapping等等，以前的版本中，如果我们没有显示的设置的话
那么就是前面的两个RequestMapping，但是现在的版本是BeanNameUrlHandlerMapping,DefaultAnnotationHandlerMapping这两个，配置了mvc:annotation-driven注解的话 就是
RequestMappingHandlerMapping
)
2.在映射的结果中可以包括0或多个的拦截器，在执行处理器的前面会先执行preHandle，如果拦截器都返回true的时候，才会执行处理器的逻辑
同时处理参数的能力也是非常的强大的，我们可以定义RequestMapping处理各种参数（但是明显不用这样做的，我们可以直接定义参数转化器）

3.因为系统可以设置多个的HandlerMapping，所以我们应该实现Ordered这个接口，表示个各自的优先级，越小优先级越高。默认是Integer.MAX_VALUE.优先级是最低的
*/

public interface HandlerMapping {

   　//这个属性表示的是url对应的HandlerMapping
    String PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE = HandlerMapping.class.getName() + ".pathWithinHandlerMapping";

  　//这个request匹配度最高的HanlderMapping 
    String BEST_MATCHING_PATTERN_ATTRIBUTE = HandlerMapping.class.getName() + ".bestMatchingPattern";

　　//是否支持类级别的映射 像我们的DefaultAnnotationHandlerMapping就使用了这个属性来表示支持类级别的。（如果我们没有设置的话，默认就是支持的
　　//@see AnnotationMethodHandlerAdapter$ServletHandlerMethodResolver.useTypeLevelMapping()）
    String INTROSPECT_TYPE_LEVEL_MAPPING = HandlerMapping.class.getName() + ".introspectTypeLevelMapping";

    //也是request中的KEY名称，值时map，存放在的是键值对
    String URI_TEMPLATE_VARIABLES_ATTRIBUTE = HandlerMapping.class.getName() + ".uriTemplateVariables";

  　//和上面差不多，但是类别有一些不同 存放的是Matrix Variable（就是值可以用;分割的那个）
    String MATRIX_VARIABLES_ATTRIBUTE = HandlerMapping.class.getName() + ".matrixVariables";

　　//HandlerMapping支持的媒体类型
    String PRODUCIBLE_MEDIA_TYPES_ATTRIBUTE = HandlerMapping.class.getName() + ".producibleMediaTypes";

  　/**
　　这个这个类的唯一一个方法，根据职责单一原则，我们就明白了，HandlerMapping的唯一职责就是将一个请求根据不同的策略
　　最终转化为HandlerExecutionChain这样的一个对象，这里不是一个接口，而是一个类，这个类就是封装了处理器和一系列的
　　拦截器，并且代理了这一系列处理的的前置和后置处理
　　*/
    HandlerExecutionChain getHandler(HttpServletRequest request) throws Exception;

}

    @Override
    public final HandlerExecutionChain getHandler(HttpServletRequest request) throws Exception {
        Object handler = getHandlerInternal(request);
        if (handler == null) {
            handler = getDefaultHandler();
        }
        if (handler == null) {
            return null;
        }
        // Bean name or resolved handler?
        if (handler instanceof String) {
            String handlerName = (String) handler;
            handler = getApplicationContext().getBean(handlerName);
        }
        return getHandlerExecutionChain(handler, request);
    }