那些年用过的xUnit.net的简单用法

0x01 前言

单元测试，总是伴随着我们的开发过程，优劣自行google。当然呢，不排除有些公司是不做单元测试的，

但是呢，学多一点东西用来防身还是可以的。

0x02 简单的Demo

写个两数求和的方法，来进行简单的测试。

namespace Catcher.Lib
{
    public class Method
    {
        public int Add(int num1,int num2)
        {
            return num1 + num2;
        }
    }
}

新建一个测试项目，添加xunit的相关引用以及我们测试方法所在的程序。

编写测试类MethodTest

using Xunit;
namespace Catcher.Lib.Test
{
    public class MethodTest
    {
        Method method = new Method();
        [Fact]
        public void add_two_integers_should_success()
        {
            int num1 = 3;
            int num2 = 5;
            int expected = 8;
            int actual = method.Add(num1,num2);
            Assert.Equal(expected,actual);
        }
    }
}

打开测试窗口，运行测试，看看测试结果

OK，测试通过。

注：要通过NuGet安装xunit.runner.visualstudio才可以看到测试窗口！

0x03 结合Moq来模拟数据访问层的操作

添加对应数据访问层的接口和类，以及模型(这里没有将模型单独抽出来。)

 

我在这里添加了一个IUserDAL接口和UserDAL类

IUserDAL具体如下

using Catcher.Lib.Model;
using System.Collections.Generic;
namespace Catcher.Lib
{
    public interface IUserDAL
    {
        IList<UserInfo> GetAllUsers();
        bool AddUser(UserInfo user);
        UserInfo GetUser(int id);       
    }
}

UserDAL具体如下

using Catcher.Lib.Model;
using System.Collections.Generic;
using System.Linq;
namespace Catcher.Lib.Implement
{
    public class UserDAL : IUserDAL
    {
        public bool AddUser(UserInfo user)
        {
            using (DB db = new DB())
            {
                db.UserInfoes.Add(user);
                return db.SaveChanges() > 0;
            }
        }
        public IList<UserInfo> GetAllUsers()
        {
            using (DB db = new DB())
            {
                return db.UserInfoes.ToList();
            }
        }
        public UserInfo GetUser(int id)
        {
            using (DB db = new DB())
            {
                return db.UserInfoes.Find(id);
            }
        }
    }
}  

都是些简单的操作，用到了EF，不做过多解释。

在测试项目添加一个UserDALTest的测试类。

using Catcher.Lib.Model;
using Moq;
using System;
using System.Collections.Generic;
using Xunit;
namespace Catcher.Lib.Test
{
    public class UserDALTest
    {
        private List<UserInfo> _userList;
        private UserInfo _user;
        public UserDALTest()
        {
           //fake data  
            _userList = new List<UserInfo>();
            _userList.Add(new UserInfo { UserID = 1, UserName="catcher", UserIsActive=true });
            _userList.Add(new UserInfo { UserID = 2, UserName = "hawk", UserIsActive = false });
            _user = new UserInfo() { UserID=3, UserIsActive=true, UserName = "tom" }; 
        }
        [Fact]
        public void get_all_users_should_success()
        {
            //arrange
            var fakeObject = new Mock<IUserDAL>();
            fakeObject.Setup(x=>x.GetAllUsers()).Returns(_userList);
            //act
            var res = fakeObject.Object.GetAllUsers();
            //assert
            Assert.Equal(2,res.Count);
        }
        [Fact]
        public void add_a_user_should_success()
        {
            var fakeObject = new Mock<IUserDAL>();
      
            fakeObject.Setup(x => x.AddUser(It.IsAny<UserInfo>())).Returns(true);
            var res =  fakeObject.Object.AddUser(_user);
            Assert.Equal<bool>(true,res);
        }
        [Fact]
        public void add_a_user_should_fail()
        {
            var fakeObject = new Mock<IUserDAL>();
            fakeObject.Setup(x => x.AddUser(It.IsAny<UserInfo>())).Returns(false);
            var res = fakeObject.Object.AddUser(_user);
            Assert.Equal<bool>(false, res);
        }
        [Fact]
        public void get_a_user_by_valid_id_should_success()
        {
            var fakeObject = new Mock<IUserDAL>();
            fakeObject.Setup(x=>x.GetUser(It.IsAny<int>())).Returns(_user);
            var res = fakeObject.Object.GetUser(3);
            Assert.Equal(3,res.UserID);
            Assert.Equal("tom",res.UserName);
            Assert.Equal(true,res.UserIsActive);
        }
        [Fact]
        public void get_a_user_by_invalid_id_should_throw_exception()
        {
            var fakeObject = new Mock<IUserDAL>();
            fakeObject.Setup(x => x.GetUser(It.IsAny<int>())).Throws(new NullReferenceException());           
            Assert.Throws<NullReferenceException>(()=> fakeObject.Object.GetUser(4));               
        }
    }
}

这里对上面的UserDAL进行简单的说明，

在构造函数中制造了一个模拟的数据，

get_all_users_should_success  测试方法是测试GetAllUsers方法的。

add_a_user_should_success  测试方法是测试AddUser方法的，这个是添加成功的测试。

add_a_user_should_fail  测试方法是测试AddUser方法的，这个是添加失败的测试。

get_a_user_by_valid_id_should_success  测试方法是测试GetUser方法的，这个是查询成功的测试。

get_a_user_by_invalid_id_should_throw_exception  测试方法是测试GetUser方法的，这个是查询抛出异常的测试。

注：测试方法的命名应尽可能包含其操作与结果(个人看法)。

运行测试效果如下：

0x04 写在最后

平时要养成编写单元测试的好习惯。