编写 Junit 测试以覆盖异常和 catch 块

Writing Junit test to cover exception and catch block

我已经为以下功能编写了 Junit 测试用例。检查 JACOCO 测试覆盖率时。它显示只有 try 块被测试用例覆盖。我是编写测试用例的新手。如何在测试用例中涵盖异常和 catch 块

这里有一个方法

  public static List<Student> readCsvFile(String fileName)
    {

       BufferedReader fileReader = null;

//logic to read file    
}
catch (Exception e)
{
   System.out.println("Error in CsvFileReader !!!");
   e.printStackTrace();
        } finally
        {
            try
            {
                fileReader.close();
            } catch (IOException e)
            {
                System.out.println("Error while closing fileReader !!!");
                e.printStackTrace();
            }
        }
        return students;
    }

和测试方法

@Test
    public void ReadCsvFileTest()
    {
        String fileName = "test.csv";
        List<Student> result = new ArrayList<Student>();
        result = CsvFileReader.readCsvFile(fileName);

        Student student1 = null;

        Iterator<Student> it = result.iterator();
        while (it.hasNext())
        {
            Student s = it.next();
            if ("471908US".equals(s.getId()))
            {
                student1 = s;
                break;
            }
        }

        assertTrue(student1 != null);
    }

考虑到您正在测试的方法的当前签名,实现全面覆盖并不容易:您的 catch 块仅在 try 块中抛出异常时执行。

解决这个问题的一种方法:不要传入文件名,而是 reader 对象本身。喜欢:

public static List<Student> readCsvFile(String fileName) {
  return readCsvFile(new BufferedReader(fileName));
}

static List<Student> readCsvFile(BufferedReader reader) { 
  try {
    ...
  } catch( ...

现在您可以为第二种方法编写几个特定的​​单元测试。您保留只做 "correct" 阅读的测试;但是您在传入模拟的 reader 对象的地方添加了一个...它只是在某个时候抛出异常。请注意,我只将新方法设置为受保护的包——您可能不想使用它 "public";并将其设为私有会阻止对其进行单元测试。

这应该可以帮助您实现全面覆盖。当然,您还需要至少对 "cover" 字符串获取方法进行一次测试。

一些注意事项:

  1. 小心重复发明轮子。已经有许多现有的 CSV 解析器。请放心:编写一个能够处理所有 "correct" 输入 CSV 的 correct CSV 解析器比听起来要难得多。如果这不是 "learning purposes" 我强烈建议 不要 编写你自己的 CSV 解析器。
  2. 小心做这样的事情静态。如前所述,真正的 CSV 解析器是一件复杂的事情,值得拥有它 class。所以没有静态辅助方法 - 一个正常的 class 实例化然后调用它的方法(这也将用于使用 依赖注入 这将有助于解决你正在询问的问题...在 try 块中抛出异常)
  3. 您在代码示例中遇到了 Exception。不要那样做 - 尝试准确捕获您的代码实际可能产生的那些异常(在您的情况下可能是 IOException)。

在这种情况下,您可能经常会考虑在 class 中引入额外的依赖项。这是我的意思,举一个粗略的例子。为读者创建工厂:

interface BufferedReaderFactory
{
    public BufferedReader createBufferedReader(String fileName) throws IOException;
}

然后你将得到一个几乎不需要任何测试的简单实现,例如类似的东西:

class BufferedReaderFactoryImpl implements BufferedReaderFactory
{
    @Override
    public BufferedReader createBufferedReader(String fileName) throws IOException
    {
        return new BufferedReader(new FileReader(fileName));
    }
}

然后你必须找到一种方法将这种依赖关系注入你的 class。我通常在日常工作中使用 Guice,但您可以尝试一些简单的方法,例如使用构造函数注入并使您的方法非静态。这是一个例子:

class CsvFileReader
{
    private final BufferedReaderFactory factory;

    public CsvFileReader(BufferedReaderFactory factory)
    {
        this.factory = factory;
    }

    public List<Student> readCsvFile(String fileName)
    {

        BufferedReader fileReader = null;
        try
        {
            fileReader = factory.createBufferedReader(fileName);
            ...
        }
        catch(IOException e)
        {
            ...
        }
        finally
        {
            ...
        }
        return new LinkedList<>();
    }
}

有了像 Mockito 这样的模拟框架,class 在 IOException-s 的情况下的行为现在更容易测试(请注意,您也可以 return从工厂抛出异常的模拟)。这是一个示例:

@RunWith(MockitoJUnitRunner.class)
public class MyTest
{
    @Mock
    private BufferedReaderFactory mockFactroy;

    @Test
    public void testIOException() throws IOException
    {
        String ivalidFileName = "invalid.txt";
        //throw exception in case that invalid file name is passed to the factory
        Mockito.when(mockFactroy.createBufferedReader(ivalidFileName)).thenThrow(new IOException("Hello!"));

        CsvFileReader csvFileReader = new CsvFileReader(mockFactroy);
        //invoke with a factory that throws exceptions
        csvFileReader.readCsvFile(ivalidFileName);
        //...
        //and make a sensible test here, e.g. check that empty list is returned, or proper message is logged, etc.
    }
}

当然,您可以在没有 Mockito 的情况下通过实施测试工厂来做到这一点。但这更麻烦,尤其是在更复杂的用例中。一旦 IOException 抛出,您将获得 JaCoCo 的适当覆盖率报告。

还要注意在 节中提到的 JaCoCo 的限制 有例外的源代码行显示没有覆盖。为什么?