controller版本号控制

最新推荐文章于 2025-10-05 04:34:29 发布
原创 最新推荐文章于 2025-10-05 04:34:29 发布 · 1.5k 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#controller版本控制

该博客介绍了如何使用SpringMVC、AOP、反射和注解来实现Controller接口的版本控制。通过配置切入点、编写切面类以及处理不同版本的方法，实现了根据请求的version动态调用对应版本的Controller方法。
  1. springmvc+aop+reflect+annotation
  2. 实现思路：将controller接口配置成切点，然后在切面环绕通知中，获取到请求的version,然后反射执行对应版本号的controller中的方法。
  3. 配置springmvc的Controller为切入点
    <aop:config>
        <aop:pointcut expression="execution(* com.*.*.*.controller.*Controller.*PlatformEntry(..))"
                                                                                                 id="platformMethodPoint"/>
        <aop:aspect ref="platformMethodAspect">
            <aop:around method="aroundAdvice" pointcut-ref="platformMethodPoint"/>
        </aop:aspect>
    </aop:config>
  4. 编写自己的切面，执行环绕通知
    public class PlatformMethodAspect{
	
	
	protected Logger logger = LoggerFactory.getLogger(getClass());
	
	private static final String METHOD_VERSION_BUSIDATA = "busiData";
	private static final String METHOD_VERSION_BUSIDATA_BASE = "BASE";
	private static final String METHOD_VERSION_REQUESTDATA = "requestData";
	private static final String METHOD_VERSION_ELEMENT_NAME = "VERSION";
	
	private Map<String,Map<String,String>> versionManager;
	private static final String SUPPORT_MIN_VERSION = "supportMinVersion";
	private static final String DEFAULT_VERSION = "defaultVersion";
	
	private WebApplicationContext appContext;
/**
	 * 获取到指定版本号的方法
	 * @param version     版本号
	 * @param clazz       目标Controller
	 * @return
	 */
	public Method getMethodByVersionAndClass(String entryMethodName,String version,Class<?> clazz){
		Method targetMethod = null;
		
		Method[] methods = clazz.getMethods();
		
		if(null != methods && methods.length > 0){
			for(Method method : methods){
				PlatformMethod findAnnotation = AnnotationUtils.findAnnotation(method,PlatformMethod.class);
				if(null != findAnnotation && entryMethodName.equals(findAnnotation.entryHandlerName()) 
						                    && version.equals(findAnnotation.version())){
					targetMethod = method;
					break;
				}
			}
		}
		
		return targetMethod;
	}
/**
	 * 根据busiData获取version
	 * @param handlerDataValue       业务数据
	 * @return               返回接口version
	 * @throws DocumentException 
	 */
	public String getVersionByBusiData(String handlerDataName,String handlerDataValue) throws DocumentException{
		
		InputStream inputStream = new ByteArrayInputStream(handlerDataValue.getBytes());
	   
		SAXReader saxReader = new SAXReader();
	   
		Document document = null;
		try {
			document = saxReader.read(inputStream);
		} catch (DocumentException e) {
			logger.error("$$$$$$解析xml busiData，获取version异常,busiData={}",handlerDataValue,e);
			throw e;
		}
	    
	    Element rootElement = document.getRootElement();

	    Element versionElement = null;
	    
	    if(METHOD_VERSION_REQUESTDATA.equals(handlerDataName)){
	    	versionElement = (Element) rootElement.selectSingleNode(METHOD_VERSION_ELEMENT_NAME);
	    }else if(METHOD_VERSION_BUSIDATA.equals(handlerDataName)){
	    	Element baseElement = rootElement.element(METHOD_VERSION_BUSIDATA_BASE);
	    	if(null != baseElement){
	    		versionElement = (Element) baseElement.selectSingleNode(METHOD_VERSION_ELEMENT_NAME);
	    	}else{
	    		versionElement = (Element) rootElement.selectSingleNode(METHOD_VERSION_ELEMENT_NAME);
	    	}
	    }
	    
	    return versionElement == null ? null:versionElement.getText(); 
	}
/**
	 * 获取到methodVersion
	 * @param methodParams   请求参数
	 * @return               version值
	 */
	public String getMethodVersion(Map<String,Object> methodParams) throws DocumentException{
		
		String busiDataValue = "";
		String requestDataValue = "";
		
		String handlerDataName = ""; 
		String handlerDataValue = "";
		
		if(null == methodParams){
			return null;
		}
		
		busiDataValue = (String)methodParams.get(METHOD_VERSION_BUSIDATA);
		requestDataValue = (String)methodParams.get(METHOD_VERSION_REQUESTDATA);
		
		if(StringUtils.isNotEmpty(busiDataValue)){
			handlerDataName = METHOD_VERSION_BUSIDATA;
			handlerDataValue = busiDataValue;
		}else if(StringUtils.isNotEmpty(requestDataValue)){
			handlerDataName = METHOD_VERSION_REQUESTDATA;
			handlerDataValue = requestDataValue;
		}else{
			return null;
		}
		
		//解析xml,获取到version
		String version = getVersionByBusiData(handlerDataName,handlerDataValue);
		
		return version;
	}
	/**
	 * 获取参数 name、value
	 * @param cls                        当前class对象
	 * @param clazzName                  目标控制器全类名
	 * @param methodName                 目标控制器方法名
	 * @param args                       目标控制器方法参数
	 * @return                           参数名称、value的map
	 * @throws NotFoundException 
	 */
	public Map<String,Object> getTargetMethodFields(Class<?> cls, String clazzName, String methodName, Object[] args)throws NotFoundException{
		
		Map<String,Object> map = new HashMap<String,Object>();
		
		//获得类加载（加载所有的CtClass）
		ClassPool classPool = ClassPool.getDefault();
		
		//设置类加载器的类搜索路径（默认是JVM的classpath,指定用户的classes）
		ClassClassPath classPath = new ClassClassPath(cls);    
		classPool.insertClassPath(classPath);    
		
		//CtClass可以操作class文件(获取target handler)
		CtClass cc;
		try {
			cc = classPool.get(clazzName);
		} catch (NotFoundException e) {
			logger.error("$$$$$$未找到类名为{}的class",clazzName,e);
			throw e; 
		}   
		
		//获取handelr method
        CtMethod cm;
		try {
			cm = cc.getDeclaredMethod(methodName);
		} catch (NotFoundException e) {
			logger.error("$$$$$$未找到类名:{},方法名:{}的method",clazzName,methodName,e);
			throw e; 
		}
        MethodInfo methodInfo = cm.getMethodInfo();  
        
        //获取方法属性
        CodeAttribute codeAttribute = methodInfo.getCodeAttribute();    
        LocalVariableAttribute attr = (LocalVariableAttribute) codeAttribute.getAttribute(LocalVariableAttribute.tag);    
		
        //目标方法没有参数
        if(null == attr){
        	return null;
        }
		
        //获取方法修饰符
        // 非静态的成员函数的第一个参数是this  
        int pos = Modifier.isStatic(cm.getModifiers()) ? 0 : 1;    
        
        try {
			for (int i = 0; i < cm.getParameterTypes().length; i++){    
			    map.put( attr.variableName(i + pos),args[i]);//paramNames即参数名    
			}
		} catch (NotFoundException e) {
			logger.error("$$$$$$未找到类名:{},方法名:{}的参数个数",clazzName,methodName,e);
			throw e; 
		}    
        
		return map;
	}
private boolean verifyVersionFormat(String version){
		Pattern pattern=Pattern.compile("^([1-9]{0,1}[0-9]{0,1}+(.[0-9]{1,2}))?$"); // 判断小数点后2位的数字的正则表达式  
	    Matcher match=pattern.matcher(version);   
	    return match.matches();
	}
	
private boolean verifyExeMethodVersion(HttpServletRequest request,String exeMethodVersion){
		boolean result = false;
		String supportMinVersion =  this.getServerVersion(request,SUPPORT_MIN_VERSION);
		if(StringUtils.isEmpty(supportMinVersion)){
			result = true;
		}else{
			Double exeVersion = new Double(exeMethodVersion);
			Double supportVersion = new Double(supportMinVersion);
			if(exeVersion.compareTo(supportVersion) != -1){
				result = true;
			}
		}
		return result;
	}
private String exeTargetMethod(Method methodObj,Class clazz,Object[] paramObjs) throws Exception{
		
		String result = "";
    			
		//注意！： 这里不能newInstance,否则不受spring控制  result = (String)methodObj.invoke(clazz.newInstance(), paramObjs);//执行对应版本号的方法
		String classSimpleName = clazz.getSimpleName();
		classSimpleName = toLowerCaseFirstOne(classSimpleName);
		Object obj = appContext.getBean(classSimpleName);
		
		result = (String)methodObj.invoke(obj, paramObjs);//执行对应版本号的方法
		
		return result;
	}
private  String getServerVersion(HttpServletRequest request,String targetVersion){
		String versionResult = "";
		String serverUrl = request.getRequestURI();
		if(null != request && null != versionManager && StringUtils.isNotBlank(serverUrl)){
			Map<String,String> versionMap = versionManager.get(serverUrl);
			if(null != versionMap)
				versionResult = versionMap.get(targetVersion);
		}
		return versionResult;
	}
	
	public static String toLowerCaseFirstOne(String s){
		  if(Character.isLowerCase(s.charAt(0)))
		    return s;
		  else
		    return (new StringBuilder()).append(Character.toLowerCase(s.charAt(0))).append(s.substring(1)).toString();
	}


	public Map<String, Map<String, String>> getVersionManager() {
		return versionManager;
	}


	public void setVersionManager(Map<String, Map<String, String>> versionManager) {
		this.versionManager = versionManager;
	}
/**
	 * 环绕通知
	 * @param joinpoint
	 * @return
	 */
	public String aroundAdvice(ProceedingJoinPoint joinpoint) {
		
		ResMessage resMessage = new ResMessage();
		
		String targetClassName = joinpoint.getTarget().getClass().getName();//获取目标方法的类名
		
		Class<?> clazz = null;//加载目标class
		try {
			clazz = Class.forName(targetClassName);
		} catch (ClassNotFoundException e) {
			logger.error("$$$$$$加载className={},异常",targetClassName,e);
    		
		}
		
		String clazzName = clazz.getName();//获取目标类名
		
	    String methodName = joinpoint.getSignature().getName(); //获取方法名称 
	    
	  	Object[] paramObjs = joinpoint.getArgs(); //获取目标方法参数
		
	  	//获取目标方法参数名称、值
	    Map<String, Object> methodParams = new HashMap<String,Object>();
		try {
			methodParams = this.getTargetMethodFields(this.getClass(),clazzName,methodName,paramObjs);
		} catch (NotFoundException e) {
    		
		}
		
	    //从请求参数中，获取version
	    String methodVersion = "";
		try {
			methodVersion = this.getMethodVersion(methodParams);
		} catch (Exception e) {
			logger.error("$$$$$$从请求参数中，获取version异常,entryMethodName={},className={}",methodName,clazzName);
			
		}
	    
		
		//注意！：入口方法请求参数中必须有HttpServletRequest request
		HttpServletRequest  request = (HttpServletRequest )methodParams.get("request");
		if(null == appContext){
			appContext = (WebApplicationContext)request.getAttribute(DispatcherServlet.WEB_APPLICATION_CONTEXT_ATTRIBUTE);
		}
		
	    //执行handler
	    String result = "";
	    
        if(StringUtils.isNotBlank(methodVersion)){
        	
        	//验证上送版本号，是否符合规则
        	boolean versionFormat = verifyVersionFormat(methodVersion);
        	if(!versionFormat){
        		logger.error("$$$$$$上送版本号格式不正确，entryMethodName={},version={}的HandlerMethod,className={}",methodName,methodVersion,clazzName);
        	
        	}
        	
        	//校验客户上送版本号是否满足最低版本号控制
        	boolean verifyMin = verifyExeMethodVersion(request,methodVersion);
        	
        	if(!verifyMin){
        		logger.error("$$$$$$上送版本号低于支持的最低版本号，entryMethodName={},version={}的HandlerMethod,className={}",methodName,methodVersion,clazzName);
        		
        	}
        	
        	Method methodObj = this.getMethodByVersionAndClass(methodName,methodVersion,clazz);//不为空，找到对应版本号方法
        	
        	if(null == methodObj){//抛出异常，未找到对应version的method
        		logger.error("$$$$$$未找到entryMethodName={},version={}的HandlerMethod,className={}",methodName,methodVersion,clazzName);
        		
        	}else{
        		
        		try {
        			result = exeTargetMethod(methodObj,clazz,paramObjs);
        		} catch (Exception e) {
					logger.error("$$$$$$执行className={},methodName={},version={}异常",clazzName,methodName,methodVersion,e);
					
				}
        	}
        	
        }else{//版本号为空
        	//获取默认支持版本号
        	String defaultVersion = getServerVersion(request,DEFAULT_VERSION);
        	
        	if(StringUtils.isNotBlank(defaultVersion)){
        		
        		Method methodObj = this.getMethodByVersionAndClass(methodName,defaultVersion,clazz);//不为空，找到对应版本号方法
        		
	    		if(null == methodObj){//抛出异常，未找到对应version的method
	        		logger.error("$$$$$$未找到默认版本号对应的method,entryMethodName={},version={}的HandlerMethod,className={}",methodName,defaultVersion,clazzName);
	        		
	        	}else{
	        		try {
	        			result = exeTargetMethod(methodObj,clazz,paramObjs);
	        		} catch (Exception e) {
						logger.error("$$$$$$执行className={},methodName={},version={}异常",clazzName,methodName,methodVersion,e);
						
					}
	        		
	        	}
        		
        	}else{
        		logger.error("$$$$$$未找到entryMethodName={},className={}的默认执行版本号",methodName,clazzName);
        		
        	}
        	
        	
        }
		
		return result;
	}
    1. 针对服务地址，在切面bean注入配置最低、默认版本号支持
    2. <bean id="platformMethodAspect" class="PlatformMethodAspect">
              <property name="versionManager"> <!-- 管理服务接口，最低、默认版本号 -->
                  <map>
                      <entry key="/*/*/*.do">
                          <map>
                              <entry key="supportMinVersion" value="1.1"/>
                              <entry key="defaultVersion" value="1.1"/>
                          </map>
                      </entry>
                  </map>        
              </property>
      </bean>


qt程序打包（四）Linux（UOS）系统生成deb包
qq_41104439的博客
08-08 3585
如何构建符合uos应用商店打包规则的安装包：链接：https://pan.baidu.com/s/1Y6bc0YlL3jKO3tL6UWYemw。uos规定第三方的应用程序装在/opt/apps路径下，我们在打安装包的时候先建立好目录结构，填入相应的内容，就可以打包了。经过这一步，我们得到一个文件夹，这个文件夹里包括：可执行程序、.sh脚本（用于寻找和执行程序）以及用到的库和配置文件。3.icons目录存放的是应用程序的图标，根据像素大小分开放置，图片只能用svg或png，不能用别的类型直接改后缀！...
Controller 层编码规范
Park33的博客
08-12 602
如果只是将Controller中的内容解开，@RestController则将Controller中的内容解析器的视图的解法，或者将配置方法重新设置为返回使用HTML格式的方法，或者返回解析器返回常用的方法InternalResourceViewResolver，返回js的内容。如，使用@Controller注释解，在的方法上，查看解析器可以解析返回的jsp，html页面，跳转到相应页面；使用注意解说@Validated，有特色的自动评测开始了，它是spring-contex中性的注释解说；...
VersionController:项目的版本控制器
03-25
版本控制器
自定义IHttpControllerSelector实现WebAPI版本控制
03-29
利用自定义IHttpControllerSelector实现WebAPI版本控制， 重载GetControllerMapping()，GetControllerMapping()用于返回程序集中所有Control的名字和描述关系。用于获取所有继承自ApiController的非抽象类。 利用正则表达式获取NameSpace中的版本号、控制器名称并生成key。 重载SelectController()方法，请求时调用SelectController()方法并返回一个Controller处理请求，从路由（请求路径）数据中获取Controller和版本号生成key ，根据key从键值集合中返回Control。
controller-runtime中的Version：版本号管理
最新发布
gitblog_00076的博客
10-05 978
在Kubernetes生态系统中，版本号管理是确保项目稳定性和兼容性的关键环节。controller-runtime作为Kubebuilder子项目，其版本控制策略直接影响着基于它构建的控制器应用。本文将深入解析controller-runtime的版本管理机制，帮助开发者理解版本号背后的含义及升级策略。 ## 版本控制基础 controller-runtime遵循[KubeBuilder通用...
SpringBoot 2.X——接口版本控制
专注写bug
12-18 2915
一个项目上线后，会根据不同的需求不断的进行更新和维护操作。有可能接口的请求也会发生改变，比如之前 /api/v1 ，后来随着业务变更，需要使用 /api/v9，但有些接口根本就无需变更，一样沿用即可。 如何做到一个接口多个版本可以动态适用呢？ 一、自定义一个注解 import java.lang.annotation.Documented; import java.lang.annotation....
Idea中Version Control的使用
weixin_42397269的博客
03-11 4659
Idea中Version Control的使用 最近做的微服务项目使用的工具是Idea，相比MyEclipse来说确实简便很多，但是用了几个月了，还是有很多不熟悉的地方。 比如今天从git上拉取代码下来，打开log不显示，右边不显示修改了哪些文件。如图1.1所示。 各种在view中设置都没找到解决办法，最后发现其实是下面的这块把上面覆盖掉了，从横线处往下拉，便能显示。如图1.2所示 ...
version-controller:使用自定义版本号简化替换参数
05-18
这个名为“version-controller”的工具，正如其标题所示，旨在帮助开发者通过自定义版本号来简化替换参数的过程，从而提高开发效率和代码管理的规范性。在JavaScript项目中，我们经常需要管理依赖库的版本，确保项目...
amd sata controller（AMD SATA控制器）
03-06
如果问题仍未解决，可以尝试展开“IDE ATA/ATAPI控制器”类别，看看是否有黄色感叹号或问号标记的设备，这代表驱动未安装或不正确。 7. 如果发现有问题的设备，右键点击它，选择“更新驱动程序”，然后指向刚刚安装...
springmvcAPI版本控制
09-13
1. **URL路径版本控制**：最直观的方式是在URL中显式包含版本号，如`/v1/users`和`/v2/users`。这样，客户端可以直接指定所需版本，服务器根据路径处理不同版本的请求。 2. **请求头版本控制**：另一种方法是将版本...
springboot+swagger+版本控制 DEMO
07-16
1. URL路径版本控制：这是最直接的方式，通过在URL路径中添加版本号，如`/v1/users`或`/v2/users`。在Spring Boot应用中，可以通过定义不同的Controller或使用PathVariable来实现。 2. HTTP头版本控制：通过在HTTP...
Camara_Controller.rar_VC控制_视频监控
09-23
另一个文件"2.5.2"可能是版本号，表明这是项目的某个特定版本，可能包含了对前一版本的改进或修复。 总的来说，这个项目提供了学习和实践VC++实现视频监控云台控制的宝贵资源，涵盖了从底层通信协议到上层用户交互...
ControllerRevision
喝醉酒的小白
09-18 1236
通用的版本管理对象
必看！Spring Boot 项目新老版本 Controller 低侵入式切换实战秘籍
kingwinstar的博客
04-01 686
该项目在进行迁移重构时，考虑到大部分业务逻辑雷同，为了降低系统复杂度和维护成本，并没有新开服务，而是在原来的项目中添加新的 Controller。这就意味着所有的操作都要在同一个 JVM 进程项目的前提下进行，如何在不影响现有系统正常运行的情况下，实现新老版本 Controller 的低侵入式切换，成为了摆在开发团队面前的一道难题。这是业务部门研发团队最初采用的实现方案，通过自定义注解和 AOP（面向切面编程）的方式，实现了新老版本 Controller 的切换。1、自定义注解。
idea将version controller不见了
京北游戏官方
11-02 872
如下图,设置一下就好了
Kubernetes Controller 如何管理资源？
云原生实验室
12-28 704
一、Introduction起因：工作上要重构一个现有的组件管理工具，要求实现全生命周期管理，还有上下游解耦，我心里一想这不就是 k8s controller 嘛！所以决定在动手前先学习一...
一个Controller网关根据请求参数和版本号调用分发多个Service和方法
Interesting
09-06 1492
一个Controller网关根据请求参数和版本号分发Service 文章目录一个Controller网关根据请求参数和版本号分发Service1.获取bean2.基准Service接口3.版本号控制的注解注解常量4.网关5.服务实现6.调用结果 公司原有项目就是根据请求参数进行分发逻辑的，这次想着通过反射加入了版本号的分发，减轻各种版本的业务代码逻辑耦合度。 在一个项目中需要写很多的controller去调用不同的service，而写一个网关可以省去写controller层的痛苦，其实就是策略模式的体现。
如何配置api版本管理
不知名博客
01-07 2138
文章目录介绍架构演示apiversion包ApiVersion自定义注解(贴在接口方法上)ApiVersionAutoConfiguration.classApiVersionProperties.classApiVersionRequestCondition.classApiVersionWebMvcRegistrations.classInnerUtils.classVersionedRequestMappingHandlerMapping.classEnableApiVersioning自定义注解(贴
ApiVersion接口版本管理
qq_41777392的博客
07-21 1114
经测试，将两个方法定义的顺序交换，该api版本变为v15，也就是原api管理的代码没有实现识别最新版本接口的功能（应完善ApiVersionRequestMappingHandlerMapping类）。这样注册时/{version}/pub的version被设置为v16，latestVersion为yaml配置中config.api.version的值，version为实际请求的值。请求url中带的version，在conpareVersion中该变量名为version。请求url：/v18/pub。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值