利用Ruby简化你的Java测试
 

2009-10-22 作者:殷安平 来源:InfoQ

 

本文将从单元测试这个话题开始,让Java的开发人员能够在实际工作中利用Ruby提高工作效率。

Martin Fowler:当然(愿意花掉一半的时间来写单元测试)!因为单元测试能够使你更快地完成工作。无数次的实践已经证明这一点。你的时间越是紧张,就越是要写单元测试,它看上去慢,但实际上能够帮助你更快、更舒服地达到目标。

单元测试很重要,但是……

单元测试的重要性,我想再多做一些强调也不为过。但实际情况是我经常听到Java开发人员抱怨单元测试繁琐、难写。虽然勉强为之,却疲于奔命,并没有体会到它的好处!最终造成的结果是出现了大量只能运行一次的单元测试。是将责任简单归结于开发人员?还是开发流程或制度的不完善?

平心而论,我自己在做TDD或单元测试的时候,有很多时候也确实觉得无趣,尤其是在一些准备测试数据或测试环境的工作上,例如我们经常需要随机生成特定长度的字符串用于测试,需要如下代码:

    public String getRandomAlphabetic(int count) {
            count = count <= 0 ? 5 : count; //默认为5
            //构建一个包含所有英文字母的字符串
            String alphabet="abcdefghijklmnopqistuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
            StringBuffer sb = new StringBuffer(count);
            for (int i = 0; i < count; i++) {
                int character=(int)(Math.random()*26);
                sb.append(alphabet.substring(character, character+1));
            }
            return sb.toString();
    }

如果用Ruby的话:

    def random_alphabetic(size=5)
            chars = ('a'..'z').to_a + ('A'..'Z').to_a # 构建一个从a到Z的一个字母表数组
           (0...size).collect { chars[rand(chars.length)] }.join # 从chars数组中返回指定长度的随机字符数组(默认5个),调用join方法,将这个数组中的所有元素连接成一个字符串
    end

对比后大家感觉如何?有经验的开发人员马上会挑战说,我们有现成的commons-lang库,简单调用 RandomStringUtils.randomAlphabetic(5)就可以完成任务,可我想问的是,如果没有第三方库的支持,你更愿意用哪种方式?还可以想象构建一个树状结构的数据,Ruby的方式:

    data =<<-EOF
    {
    "order_id": "xxx-xxxxx-xxx",
    "books": [
        {"ISBN": "2323-2323", "number": 2, "price": 20.00},
        {"ISBN": "2323-2324", "number": 3, "price": 30.00},
        {"ISBN": "2323-2325", "number": 2, "price": 20.00},
        {"ISBN": "2323-2326", "number": 3, "price": 30.00},
        {"ISBN": "2323-2327", "number": 2, "price": 20.00}
      ]
    }
    EOF         # 该数据为json格式的一段字符串

    order = JSON.parse(data)
    p order['books'][0]['ISBN'] #=> 2323-2323

用Java该怎样完成,很多人会祭出Java世界中最被滥用的七种武器之首“xml”,即便如此能完成的如此优雅吗?如果不是简单的“语言宗教崇拜”,至少我会毫不犹豫的选择用Ruby的方式完成任务。省点时间,早点下班陪陪老婆也好啊!:)

在Ruby的世界里

那作为一个Java的开发人员,如何享受到Ruby在测试方面给我们带来的好处呢?事实上Java早就为Ruby、Python等脚本语言做好了准备,JRuby是sun对Ruby on JVM的官方支持,现在的版本是1.1.3,已经能够非常好的让Ruby运行在Java的世界里。

在开始之前,我想简单介绍一下跟本文相关的Ruby及JRuby的基本用法,具体参考Ruby Home。

   # 这是一段注释
    puts 'Hello, World !' #打印Hello, World!这个字符串,相当于Java中的System.out.println
    ('a'..'z')  #声明一个a到z的range类型的数据,range表示一个连续的范围,当然也可以是一段连续的数字
    ('a'..'z').to_a #简单调用方法to_a将一个range类型的数据转换成一个数组

    <<-EOF
    ...
    EOF  # Ruby通过配对EOF的方式声明一个多行的字符串

    [1,2,3,4,5] #声明一个数组
    [..].each {|it| puts it } #通过each方法遍历每个元素,其中{...}表示一个代码块,在这里的语义是在遍历每个元素时打印这个元素,其中it是隐式声明的参数,表示当前被遍历到的元素
    对于数组可以用select, find, collect等方法遍历,用<<, push, pop, delete等方法改变数组里的元素

    h = {'id'=>'1', 'name'=>'foo', 'age'=>24} #简单声明一个Hash
    h['name'] = 'bar' #对key为name的条目赋值
    h['age'] #24

    class Foo < Base #通过class关键字声明一个类,‘< Base’表示从基类Base继承
        @name     #声明一个实例变量
        @@count  #声明一个类变量,相当于Java中static关键字修饰的变量
    end

在JRuby中可以直接使用所有的Ruby类和方法,也能够很轻松的调用Java的类库,实际上JRuby将Ruby代码动态编译成JVM的字节码,具体参考JRuby:

    require 'java'                    #引入对Java的支持
    import 'java.util.ArrayList'   #导入需要的某个包

    list = ArrayList.new           #创建一个ArrayList
    [1,2,3,4,5].to_java           #将Ruby类型转成对应的Java类型

从上面简短的例子和基本介绍,我们能发现什么?Ruby对数组,字符串等基本类型提供了强大的支持,而这些恰恰是Java缺乏的,我们没有办法简单的创建一个数组,不能用简单的方式遍历这些集合,甚至都不能简单声明一个多行的字符串。而这些在进行测试工作,准备测试数据的时候都是必不可少的!利用Ruby 的这些特性,我们可以极大的增加开发的效率,摆脱相当多繁琐的工作。当然,这些只是Ruby为我们提供的诸多好处中最直观的部分,随着我们的讨论深入,我们将看到越来越多有意思的特性。

准备工作

用Ruby进行测试,我们需要JtestR这个专门为简化Java测试而准备的Ruby测试工具,当前的最新版本是0.3.1。如果你使用maven,在pom.xml中加入:

<plugins>

        ...

        <plugin>

            <groupId>org.jtestr</groupId>

            <artifactId>jtestr</artifactId>

            <version>0.3.1</version>

            <configuration>

                <!-- Ruby测试文件所在目录 -->

                <tests>src/test/ruby</tests>

            </configuration>

            <executions>

                <execution>

                    <goals>

                        <goal>test</goal>

                    </goals>

                </execution>

            </executions>

        </plugin>

        ...

    </plugins>

使用ant的开发人员请参考这里。用Ruby做单元测试和Java一样,简单从Test::Unit::TestCase继承即可:

    class MyFirstJRubyTests < Test::Unit::TestCase
        def test_true
            assert true
        end
    end

可以将这个测试文件简单拷贝到myProj/src/test/ruby目录下,运行mvn test,你会看到JtestR产生的测试结果输出:

    [INFO] [jtestr:test {execution: default}]

    Other TestUnit: 1 tests, 0 failures, 0 errors

在这段输出报告之上,你应该还能看到正常的Java unit testcase输出的测试结果,这表明,我们可以在开发的过程中同时选择用Java的方式测试,或用Ruby的方式测试!

JRuby测试之旅

好了,一切准备好之后,就可以开始我们的Ruby测试之旅了!你一定不希望自己苦心经营的blog或论坛上出现某些“不和谐”的词,尤其是在这举国欢庆的特殊阶段。你设计了一个专门用于过滤带有这些关键服务接口:

    public interface KeywordFilterService {
        //过滤访客评论字符串数组,返回一个新的不包含敏感关键字的结果
        String[] filter(String[] comments);
        //获取被过滤的访客评论
        String[] getFiltedComments();
    }

并写了一个很简单的实现类class KeywordFilterServiceImpl implements KeywordFilterService,这个类的实现我们就暂不关心,把重点聚集在如何对这个实现类进行测试上。首先在myProj/src/test/ruby目录下新建test_keyword_filter_service.rb文件,键入以下内容:

    require 'test/unit'

    class KeywordFilterServiceTest < Test::Unit::TestCase
        def setup
            @keywords = %w{X XX XXX XXXX XXXXX XXXXXX XXXXXXX} #不用加引号,更方便
        end
        def test_filter
           
        end
    end

setup方法准备了我们要测试的关键字数据,在Ruby中%w{...}用来简单定义字符串数组。test_xxx方法就是我们的测试方法。有了关键字数据后我们还需要一组用来测试的测试数据,里面一部分包含我们的关键字。我决定用上面定义的随机生成字符串的方式产生这些测试数据:

        def random_alphabetic(size=5)
            chars = ('a'..'z').to_a + ('A'..'Z').to_a
            (0...size).collect { chars[rand(chars.length)] }.join
        end
      
        def random_comments
            comments ||= []
            10.times do
                keyword = rand(10) % 3 == 0 ? ' ' : @keywords[rand(@keywords.length)] #随机决定是否包含关键字
                comment = random_alphabetic + keyword + random_alphabetic
                comments << comment
            end
            return comments
        end

这样,每次产生10条数据,有近三分之一的数据中包含不和谐的关键字。有了测试数据剩下的工作就很简单了,我们只需调用写好的Java服务,对返回的测试数据进行验证即可,由于需要调用Java服务,和Java一样,我们首先要引入类:

    import 'com.alisoft.research.JRuby.service.KeywordFilterServiceImpl'

测试方法实现如下:

        def test_filter
            comments = random_comments
            service = KeywordFilterServiceImpl.new(@keywords.to_java :String)
            filted = service.filter(comments.to_java :String)

            forbiddens = service.getFiltedComments
          
            assert forbiddens.length == comments.length - filted.length
            assert_equal forbiddens.sort, (comments - filted).sort
        end

其中,有两点需要注意,首先,我们可以通过to_java方法将Ruby类型转换成Java类型,例如上面将@keywords.to_java :String表明将Ruby数组转换成Java的String数组。第二,Ruby对数组支持“-”的操作,表示将一个数组减去和另一个数组中相同的元素,非常的直观!很明显,被过滤的数组应该等于原来的数组减去过滤后的结果!运行mvn test,我们将看到:

    [INFO] [jtestr:test {execution: default}]

    Other TestUnit: 2 tests, 0 failures, 0 errors

结论

说明新增加的测试通过!最后我们来对比一下实现同样的功能Ruby和Java的差别:

    Ruby:
    require 'test/unit'

    import 'com.alisoft.research.JRuby.service.KeywordFilterServiceImpl'

    class KeywordFilterServiceTest < Test::Unit::TestCase
        def setup
            @keywords = %w{X XX XXX XXXX XXXXX XXXXXX XXXXXXX}
        end
      
        def test_filter
            comments = random_comments
            service = KeywordFilterServiceImpl.new(@keywords.to_java :String)
            filted = service.filter(comments.to_java :String)

            forbiddens = service.getFiltedComments
          
            assert forbiddens.length == comments.length - filted.length
            assert_equal forbiddens.sort, (comments - filted).sort
        end
      
        def random_alphabetic(size=5)
            chars = ('a'..'z').to_a + ('A'..'Z').to_a
            (0...size).collect { chars[rand(chars.length)] }.join
        end
      
        def random_comments
            comments ||= []
            10.times do
                keyword = rand(10) % 3 == 0 ? ' ' : @keywords[rand(@keywords.length)]
                comment = random_alphabetic + keyword + random_alphabetic
                comments << comment
            end
            return comments
        end
    end

    Java:
    package com.alisoft.research.JRuby.test;

    import static org.junit.Assert.assertArrayEquals;
    import static org.junit.Assert.assertEquals;

    import Java.util.ArrayList;
    import Java.util.Arrays;
    import Java.util.List;

    import org.apache.commons.lang.RandomStringUtils;
    import org.apache.commons.lang.math.RandomUtils;
    import org.junit.Test;

    import com.alisoft.research.JRuby.service.KeywordFilterServiceImpl;

    public class KeywordFilterServiceTest {

        @Test
        public void testFilteredResults() {
            String[] comments = getRandomComments();

            KeywordFilterServiceImpl service = new KeywordFilterServiceImpl(
                    getKeywords());

            String[] filted = service.filter(comments);
            String[] forbiddens = service.getFiltedComments();

            assertEquals(filted.length + forbiddens.length, comments.length);

            assertArrayEquals(forbiddens, sub(comments, filted));
        }
        //实现减法操作
        private String[] sub(String[] all, String[] part) {
            List allList = new ArrayList(Arrays.asList(all));
            allList.removeAll(Arrays.asList(part));
            return allList.toArray(new String[allList.size()]);
        }

        private String[] getRandomComments() {
            String[] comments = new String[RandomUtils.nextInt(10)];
            for (int i = 0; i < comments.length; i++) {
                String comment = RandomStringUtils.randomAlphabetic(5);
                String keyword = RandomUtils.nextBoolean() ? getKeywords()[RandomUtils
                        .nextInt(getKeywords().length)]
                        : "";
                comment += keyword + RandomStringUtils.randomAlphabetic(5);
                comments[i] = comment;
            }
            return comments;
        }

        private String[] getKeywords() {
            String[] keywords = new String[] { "X", "XX", "XXX", "XXXX",
                    "XXXXX", "XXXXXX", "XXXXXXX" };
            return keywords;
        }

    }

在借助了apache-commons-lang之后,LOC: Java 58, Ruby 35。大家也可以注意一下Java中实现两个数组“减法”的代码对比Ruby的实现,Ruby明显更为直观,更有效率!

火龙果软件/UML软件工程组织致力于提高您的软件工程实践能力,我们不断地吸取业界的宝贵经验,向您提供经过数百家企业验证的有效的工程技术实践经验,同时关注最新的理论进展,帮助您“领跑您所在行业的软件世界”。

资源网站: UML软件工程组织