Spring之SpringMVC的MethodNameResolver(源码)分析

前言

　　在介绍SpringMVC  的Controller的具体实现中，我们讲到了MultiActionController。在获取处理请求对于的方法的时候我们用到了下面的代码，来自于MultiActionController的handleRequestInternal的方法：

	protected ModelAndView handleRequestInternal(HttpServletRequest request, HttpServletResponse response)
			throws Exception {
		try {
			String methodName = this.methodNameResolver.getHandlerMethodName(request);
			return invokeNamedMethod(methodName, request, response);
		}
		catch (NoSuchRequestHandlingMethodException ex) {
			return handleNoSuchRequestHandlingMethod(ex, request, response);
		}
	}

　　MultiActionController通过methodNameResolver的getHandlerMethodName()方法获取处理该请求的具体方法名字。来看下methodNameResolver具体实现。

1.MethodNameResolver介绍

MethodNameResolver是个接口，来看看定义

public interface MethodNameResolver {

	String getHandlerMethodName(HttpServletRequest request) throws NoSuchRequestHandlingMethodException;

}

　　这个接口用于MultiActionController方法中获取具体的参数，它是通过策略模式来实现的。它可以通过具体的请求映射到处理的方法名上，他们的改变也不会影响到其他应用程序。看看下面其他的具体实现。MethodNameResolver的实现类包括ParameterMethodNameResolver、AbstractUrlMethodNameResolver、InternalPathMethodNameResolver、PropertiesMethodNameResolver。

2.ParameterMethodNameResolver

ParameterMethodNameResolver实现了MethodNameResolver接口，它支持通过参数值来映射到方法名上。通过注释知道可以通过下面的过程来获取具体的方法：

　　1.根据请求的参数名解析功能方法名;

　　2.根据请求参数名的值解析功能方法名，默认的参数名是 action，即请求的参数中含有“action=query” ，则功能处理方法名为 query;

　　3.逻辑功能方法名到真实功能方法名映射;

　　4.默认的方法名，当以上策略失败时默认调用的方法名。

来具体获取处理器方法名过程：

{
		String methodName = null;

		// 检查参数名是否存在
		if (this.methodParamNames != null) {
			for (String candidate : this.methodParamNames) {
				if (WebUtils.hasSubmitParameter(request, candidate)) {
					methodName = candidate;
					if (logger.isDebugEnabled()) {
						logger.debug("Determined handler method '" + methodName +
								"' based on existence of explicit request parameter of same name");
					}
					break;
				}
			}
		}

		// 检查参数名的值是否存在
		if (methodName == null && this.paramName != null) {
			methodName = request.getParameter(this.paramName);
			if (methodName != null) {
				if (logger.isDebugEnabled()) {
					logger.debug("Determined handler method '" + methodName +
							"' based on value of request parameter '" + this.paramName + "'");
				}
			}
		}

		if (methodName != null && this.logicalMappings != null) {
			// Resolve logical name into real method name, if appropriate.
			String originalName = methodName;
			methodName = this.logicalMappings.getProperty(methodName, methodName);
			if (logger.isDebugEnabled()) {
				logger.debug("Resolved method name '" + originalName + "' to handler method '" + methodName + "'");
			}
		}

		if (methodName != null && !StringUtils.hasText(methodName)) {
			if (logger.isDebugEnabled()) {
				logger.debug("Method name '" + methodName + "' is empty: treating it as no method name found");
			}
			methodName = null;
		}

		if (methodName == null) {
			if (this.defaultMethodName != null) {
				// No specific method resolved: use default method.
				methodName = this.defaultMethodName;
				if (logger.isDebugEnabled()) {
					logger.debug("Falling back to default handler method '" + this.defaultMethodName + "'");
				}
			}
			else {
				// If resolution failed completely, throw an exception.
				throw new NoSuchRequestHandlingMethodException(request);
			}
		}

		return methodName;
	}

　　3、PropertiesMethodNameResolver

　　PropertiesMethodNameResolver和InternalPathMethodNameResolver继承了抽象类AbstractUrlMethodNameResolver。而AbstractUrlMethodNameResolver提供了方法名的获取的方法。

public final String getHandlerMethodName(HttpServletRequest request)
			throws NoSuchRequestHandlingMethodException {

		String urlPath = this.urlPathHelper.getLookupPathForRequest(request);
		String name = getHandlerMethodNameForUrlPath(urlPath);
		if (name == null) {
			throw new NoSuchRequestHandlingMethodException(urlPath, request.getMethod(), request.getParameterMap());
		}
		if (logger.isDebugEnabled()) {
			logger.debug("Returning handler method name '" + name + "' for lookup path: " + urlPath);
		}
		return name;
	}

　　由上面的代码可知，子类的差异在于 String name = getHandlerMethodNameForUrlPath(urlPath);这段代码getHandlerMethodNameForUrlPath是抽象方法，具体的实现见子类。首先看下PropertiesMethodNameResolver的getHandlerMethodNameForUrlPath的实现：

PropertiesMethodNameResolver提供自定义的从请求 URL 解析功能方法的方法名，使用一组用户自定义的模式到功能方法名的映射，映射使用 Properties 对象存放，

	protected String getHandlerMethodNameForUrlPath(String urlPath) {
		String methodName = this.mappings.getProperty(urlPath);
		if (methodName != null) {
			return methodName;
		}
		Enumeration propNames = this.mappings.propertyNames();
		while (propNames.hasMoreElements()) {
			String registeredPath = (String) propNames.nextElement();
			if (this.pathMatcher.match(registeredPath, urlPath)) {
				return (String) this.mappings.get(registeredPath);
			}
		}
		return null;
	}

　　用法如下：

<bean id="propertiesMethodNameResolver"
	class="org.springframework.web.servlet.mvc.multiaction.PropertiesMethodNameResolver">
	<property name="mappings">
		<props>
			<prop key="/create">create</prop>
			<prop key="/update">update</prop>
			<prop key="/delete">delete</prop>
			<prop key="/list">list</prop>
			<!-- 默认的行为 -->
			<prop key="/**">list</prop>
		</props>
	</property>
</bean>

　　4.InternalPathMethodNameResolver

InternalPathMethodNameResolver是MethodNameResolver的默认实现，在MultiActionController中的MethodNameResolver的初始化可知，

private MethodNameResolver methodNameResolver = new InternalPathMethodNameResolver()

　　这个解析器提供从请求 URL 路径解析处理器方法的方法名，从请求的最后一个路径（/）开始，并忽略扩展名；如请求 URL 是“/user/list.html” ，则解析的功能处
理方法名为“list” ，即调用 list 方法。该解析器还可以指定前缀和后缀，通过 prefix 和 suffix 属性来判断。下面就是详细的getHandlerMethodName方法的实现过程。

	public final String getHandlerMethodName(HttpServletRequest request)
			throws NoSuchRequestHandlingMethodException {

		String urlPath = this.urlPathHelper.getLookupPathForRequest(request);
		String name = getHandlerMethodNameForUrlPath(urlPath);
		if (name == null) {
			throw new NoSuchRequestHandlingMethodException(urlPath, request.getMethod(), request.getParameterMap());
		}
		if (logger.isDebugEnabled()) {
			logger.debug("Returning handler method name '" + name + "' for lookup path: " + urlPath);
		}
		return name;
	}

　　

5.总结说明

　　　　MethodNameResolver 的实现是通过策略模式来的，通过这个也可以是发现，Spring的实现中大量采用了设计模式的相关知识，如果Controller的实现中采用了模板设计模式一样。如果自己能够灵活应用这些设计模式，并且有个很好的思想，我想写出这样优秀的代码应该也不是问题，加油，共勉。