2021SC@SDUSC

前文承接

上一篇文章以ExpressionToString类作为例子来分析了一下Expression DSL的使用方式，对于其他的Expression衍生类，关键的区别就在于不同的Expression DSL实现Expression接口的load()方法不同，在阅览其他的Expression类（即和ExpressionToString类同级的其他Expression开头的类）之后，觉得不能只看静态代码，所以这篇博客来分析一个ActiveJ源码中test包里的ExpressionTest类来学习一下Expression运行时提供的功能。

之所以本次分析ExpressionTest，test类的作用，在第一篇博客中讲到过，test通常是测试单个组件时做的工作（类似于软件工程课程中的单元测试），用来测试一个或一些局部的功能，例如一个方法能否正确返回结果或是调用正确过程等。test类中的代码在测试完毕后只要稍加修改就可以拿到正式的main包里去发布并且对外提供功能。

ExpressionTest

首先浏览ExpressionTest类的源码，映入眼帘的第一行代码：

@SuppressWarnings({"ArraysAsListWithZeroOrOneArgument"})

@SupressWarnings注解在整个ExpressionTest类中频繁出现，这里解释一下这个注解的意思：

/**
 * Indicates that the named compiler warnings should be suppressed in the
 * annotated element (and in all program elements contained in the annotated
 * element).
*/

即表示这个类对于 ArraysAsListWithZeroOrOneArgument 这个异常是忽略的，并且这里需要注意@SupressWarnings这个注解是有作用域的，即当一个类使用@SupressWarings，则这个类包含的方法也会自动忽略括号里的异常

之后，ExpressionTest定义了一个内部类 TestPojo，这里只需要注意有两个 int 属性就好，其方法的操作都是围绕两个int数据来进行的。这里所包含的方法就不再详细粘贴代码，其字面的意思基本是很容易理解的。

@SuppressWarnings("unused")
public static class TestPojo {
		public int property1;
		public int property2;

		public TestPojo(int property1, int property2) {
			this.property1 = property1;
			this.property2 = property2;
		}

		public TestPojo(int property1) {
		}

		public void setproperty1(int property1) {	
		}

		public int getproperty1() {	
		}

		@Override
		public boolean equals(Object o) {
		}

		@Override
		public int hashCode() {
			int result = property1;
			result = 31 * result + property2;
			return result;
		}

		@Override
		public String toString() {
			return "TestPojo{property1=" + property1 + ", property2=" + property2 + '}';
		}
	}

唯一需要注意的是这里的hashCode()是返回了一个int类型的数据，这个在之后的比较过程中会用到。

然后又定义了另一个内部类TestPojo2，虽然代码相比TestPojo多一点，但是整体结构和上一个内部类一模一样。

public static class TestPojo2 {
		public final String property1;
		public final int property2;
		public final long property3;
		public final float property4;
		public final int property5;
		public final double property6;
		public final String property7;

/**
*其后面的方法和TestPojo一样，不再列出
*/
}

对两个内部类定义结束后，ExpressionTest又定义了一个与这第一个内部类相对应的接口Test，这个接口定义的方法是与TestPojo类相一致的，用来之后进行Test与TestPojo内部类的功能比较，从而提供一种使用反射来为外界服务的类生成方式。

接口定义完毕后，剩下的就是对二者进行比较：

@org.junit.Test
	public void test() throws ReflectiveOperationException {
        Class<Test> testClass = ClassBuilder.create(Test.class).defineClass(CLASS_LOADER);
        Test test = testClass.getDeclaredConstructor().newInstance();
//      之后即使用testClass生成的对象test来执行方法并与结果比较
}

接下来test()方法代码的剩余内容，就是将常数结果与test对象执行的方法得到的结果进行assertEquals()比较。

通过对整个类的结构浏览，可以注意到在每一个测试方法里，代码结构都是如下（体现出优秀代码的规范结构，学到了）：

在第一个test()里，ActiveJ进行了一个与Test接口功能的对比：

assertEquals(11, (int) test.test(10));
assertEquals(33, test.hash(new TestPojo(1, 2)));
assertEquals(1, test.property1(new TestPojo(1, 2)));
assertEquals(new TestPojo(10, 20), test.setter(new TestPojo(1, 2)));
assertEquals(new TestPojo(1, 2), test.ctor());
test.setXY(1, (byte) 10);
assertEquals(1, (int) test.getX());
assertEquals(10, test.getY());

这里介绍一下assertEquals方法的使用，其实很简单，assertEquals方法对两个Long数据类型进行比较，例如在上诉的代码中，开发者分别对11与int(test.test(10))和33与test.hash()等多个数据进行了比较（这里的test.test(10)和test.hash()的返回值类型均为INT），ActiveJ将这两个数据与两个常数进行了assertEquals比较，如果相同的话则顺利得到如下执行结果：

这里是测试源码时控制台打印的结果

 而如果两个Long数据不同则引发一个ERROR异常：

对这里的ExpressionTest方法运行，得到正确的程序结束语句，代表使用这种Expression DSL来构造的类结构与正常的类在功能上是一样的。

在之后的ExpressionTest代码中，ActiveJ又对Neg（数据类型溢出）、Operation（运算符，源码只测试了取余运算）、sh（位左移和右移）、位运算（Bitwise）、Call（方法调用）、Iterator（迭代）、BuildInstance（对象构造）以及SetSaveBytecode（文件存储）等其他常用到的java方法进行了测试和比较，结果均为正确结果。

至此，对于ExpressionTest的功能认识分析结束，作为一个测试类，此类涵盖了多种Expression功能，是一个比较大的开发测试类。

Test与Expression的联系

在浏览完ExpressionTest这个类的组成和功能后，我们再回过头来看java包中Expression类：

可以看到在java类中的Expression包中，出现了很多以我们刚才在ExpressionTest类中看见的方法名，而这些不同的Expression DSL，提供的功能，完全就是我们刚才浏览分析的ExpressionTest中同名方法的功能嘛，例如ExpressionCall这个类：

final class ExpressionCall implements Expression {
	private final Expression owner;
	private final String methodName;
	private final Expression[] arguments;

	ExpressionCall(Expression owner, String methodName, Expression[] arguments) {
		this.owner = owner;
		this.methodName = methodName;
		this.arguments = arguments;
	}

	@Override
	public Type load(Context ctx) {
		return ctx.invoke(owner, methodName, arguments);
	}
}

这里的load()方法要求调用方发送正确的ctx参数内容才可以调用，合法的Context（例如这里显然是需要提供owner，methodName，arguments三个参数才可以）会被ExpressionCall类自动解析并调用methodName提供的方法。然后对比刚才分析的ExpressionTest类中对于Call()方法的使用：

@org.junit.Test
	public void testCall() {
		TestCall testCall = ClassBuilder.create(TestCall.class)
				.withMethod("callOther1", call(self(), "method", arg(0)))
				.withMethod("callOther2", call(self(), "method"))
				.withMethod("method", int.class, asList(int.class), arg(0))
				.withMethod("method", long.class, asList(), value(-1L))
				.withMethod("callStatic1", int.class, asList(int.class, int.class), staticCallSelf("method", arg(0), arg(1)))
				.withMethod("callStatic2", long.class, asList(long.class), staticCallSelf("method", arg(0)))
				.withStaticMethod("method", int.class, asList(int.class, int.class), arg(1))
				.withStaticMethod("method", long.class, asList(long.class), arg(0))
				.defineClassAndCreateInstance(CLASS_LOADER);

}

这里的testCall()中使用了刚才定义的ExpressionCall类，因为我们使用ctrl点击 call(self(), "method", arg(0)) 方法，便可以定位到ExpressionCall类里：

public static Expression call(Expression owner, String methodName, Expression... arguments) {
		return new ExpressionCall(owner, methodName, arguments);
}

项目代码中的一部分在测试类中执行成功，则代表这个ExpressionCall类的功能是没有问题的。这里也是学习软件开发规范的一步：先测试，测试成功后正式代码再发布对外提供调用的功能。

总结

通过对ExpressionTest类的分析，结合上周对于一个ExpressionToString类的分析，目前对Expression这个模块有了初步的认识，也进一步的描绘了其他单个Expression类的结构和功能。但是呢，截止到现在，也仅仅是分析了2周的结果，对于整个Expression和Codegen的大厦，至少对于我来说仍然是蒙在雾里，看不见轮廓。在Codegen的部分中，还有一个模块Report没有分析，Expression如何在整个ActiveJ项目中提供服务也不清楚，任重而道远吧。

往期回顾

ActiveJ框架学习——Codegen的初步认识

ActiveJ框架学习---起步