【已解决】Java 中的可变参数应用

🌈场景描述：在实际工作场景中遇到这样一个需求：根据筛选条件对某个模块进行查询，查询结果需要分页在前端页面显示，并将所有页的查询记录导出，生成 Excel 报表。

🌈问题描述：已经查询接口的参数需要包括：模块标识(指定对哪个模块进行查询)、查询字段(对模块的哪个字段进行查询)、查询字段值(用于精确或模糊匹配字段内容) 以及分页信息(Page)；导出 Excel 报表接口的参数的主要参数除了查询接口中的分页信息以外，其他与查询接口参数一致。

🎉为了减少冗余代码的产生，这里采用 JDK 1.5 之后新增的可变函数(variable arguments)，将查询接口方法中的分页信息参数（Page）设置为可变参数，在调用方法时忽略 Page 参数，直接返回所有记录的结果即可。

🌈下面，简单介绍一下 Java 中的可变参数：

🎉可变参数的应用场景：

🏷在定义一个方法的时候，参数的类型确定，但是参数的个数不确定，只有在调用的时候才能够确定具体的参数个数，这个时候便考虑使用可变参数。

🎈可变参数的语法形式如下：

void method(DataType... var) {
	//方法体
}

🎉在上面的代码段中，DataType... var 就是在一个方法中将形参 var 定义为可变参数，用 ... 来表示。

🎉使用可变参数的注意事项：

• 🎈当有多个参数时，可变参数放在最后一个位置
• 🎈一个方法只能有一个可变参数
• 🎈每次使用可变参数时，Java 编译器都会创建一个数组来保存给定的参数，因此不可以直接对可变参数进行操作，要像操作数组一样操作可变参数

🎉下面的示例中，在主函数中调用一个求和函数，其中求和函数中的参数 a 就是一个可变参数

public final class Test {
    static void sumNum(int... a) {
        int sum = 0;
        for (int x : a) {
            sum += x;
        }
        System.out.println(sum);
    }
    public static void main(String[] args) {
        sumNum(1,2,3);
    }
}

🎉对程序就行 debug 调试运行，可以发现 a 其实是一个数组，这个数组的内容就是传入的实参值 1,2,3，即 a={1,2,3}，下面是调试运行的截图

🎉下面给出在业务场景中将分页参数 Page 设置为可变参数的应用案列：

🎈查询接口方法实现：

@Override
public ResponsePage queryModelData(String selectUnique, Object key, String type, 
										String unique, boolean isMust, Page... page) {
	 //此处省略100w行代码
	 if (page.length > 0 && page[0] != null) {  //page是一个数组，也获得前端传入的分页信息，应该是获取page[0]
        	query_model_field.skip(page[0].getPageNum());
        	query_model_field.limit(page[0].getPageSize());
      }
      //此处省略100w行代码
      //根据是否传入分页信息情况，返回对应的结果（page.length>0表示传入了分页信息）
      return page.length > 0 ? ResponsePage.success(resourceVo, count, page[0]):ResponsePage.success(resourceVo, count, new Page());
}

🎈导出报表接口方法实现

public void exportModelExcel(ServletOutputStream outputStream, HttpServletResponse response, 
				String selectUnique, Object key, String keyType, String unique, boolean isMust) {
	//此处省略100w行代码
	 ResourceVo resourceVo = (ResourceVo) queryModelData(selectUnique, key, keyType, unique, isMust).getData(); //复用查询接口，不分页返回根据条件筛选的查询结果
     List<Map> mapList = resourceVo.getData(); //获得查询结果列表
     //此处省略100w行代码
}

🎉正是得益于使用可变参数的便利，使得可以直接复用查询接口方法，减少了代码冗余，使方法整体更加简洁！