Util应用程序框架公共操作类(六):验证扩展
前面介绍了仓储的基本操作，下面准备开始扩展查询，在扩展查询之前，首先要增加两个公共操作类，一个是经常要用到的验证方法，另一个是Lambda表达式的操作类。
很多时候，我们会判断一个对象是否为null，由于null是一个不能接受的值，它会导致“未将对象引用设置到对象的实例”的严重错误，所以当检测到null值时一般直接抛出ArgumentNullException异常。
public void Test( string name ) {
if( name == null )
throw new ArgumentNullException( "name" );
//其它操作
}
由于判断null是一个频繁操作，可以用一个扩展方法来封装它，像下面这样调用。
public void Test( string name ) {
name.CheckNull( "name" );
//其它操作
}
我直接将CheckNull扩展到object对象上，因为绝大部分对象都需要这个操作。注意，扩展object要非常谨慎，会导致大面积污染，因为所有对象都会看见这个扩展方法，如果这个操作对某些对象有副作用，就会造成更多混乱。
另一个常用的方法也是判断是否为空，比如字符串的””，或者Guid的Guid.Empty。
对于string，我们一般通过string.IsNullOrWhiteSpace来进行判断。
public void Test( string name ) {
if ( string.IsNullOrWhiteSpace( name ) )
return;
//其它操作
}
使用扩展方法封装后，简化为下面的代码。
public void Test( string name ) {
if ( name.IsEmpty() )
return;
//其它操作
}
IsEmpty扩展方法，我定义在string、Guid、Guid?等具体类型上，不能扩展到object，因为每种类型的实现不同，当然可以进行各种判断，但执行效率可能非常低下，毕竟这是一个常用方法。
在Util项目中添加Extensions.Validate文件，它是Extensions的部分类，代码如下。
using System;
namespace Util {
/// <summary>
/// 验证扩展
/// </summary>
public static partial class Extensions {
/// <summary>
/// 检测空值,为null则抛出ArgumentNullException异常
/// </summary>
/// <param name="obj">对象</param>
/// <param name="parameterName">参数名</param>
public static void CheckNull( this object obj, string parameterName ) {
if ( obj == null )
throw new ArgumentNullException( parameterName );
}
/// <summary>
/// 是否为空
/// </summary>
/// <param name="value">值</param>
public static bool IsEmpty( this string value ) {
return string.IsNullOrWhiteSpace( value );
}
/// <summary>
/// 是否为空
/// </summary>
/// <param name="value">值</param>
public static bool IsEmpty( this Guid? value ) {
if ( value == null )
return true;
return IsEmpty( value.Value );
}
/// <summary>
/// 是否为空
/// </summary>
/// <param name="value">值</param>
public static bool IsEmpty( this Guid value ) {
if ( value == Guid.Empty )
return true;
return false;
}
}
}
单元测试代码如下。
using System;
using Microsoft.VisualStudio.TestTools.UnitTesting;
namespace Util.Tests.Extensions {
/// <summary>
/// 验证扩展测试
/// </summary>
[TestClass]
public class ValidateExtensionTest {
/// <summary>
/// 检查空值，不为空则正常执行
/// </summary>
[TestMethod]
public void TestCheckNull() {
var test = new object();
test.CheckNull( "test" );
}
/// <summary>
/// 检查空值，值为null则抛出异常
/// </summary>
[TestMethod]
[ExpectedException( typeof( ArgumentNullException ) )]
public void TestCheckNull_Null_Throw() {
try {
object test = null;
test.CheckNull( "test" );
}
catch ( ArgumentNullException ex ) {
Assert.IsTrue( ex.Message.Contains( "test" ), ex.Message );
throw;
}
}
/// <summary>
/// 测试是否空值
/// </summary>
[TestMethod]
public void TestIsEmpty_String() {
string value = null;
Assert.IsTrue( value.IsEmpty() );
Assert.IsTrue( "".IsEmpty() );
Assert.IsTrue( " ".IsEmpty() );
Assert.IsFalse( "a".IsEmpty() );
}
/// <summary>
/// 测试是否空值
/// </summary>
[TestMethod]
public void TestIsEmpty_Guid() {
Guid value = Guid.Empty;
Assert.IsTrue( value.IsEmpty() );
value = Guid.NewGuid();
Assert.IsFalse( value.IsEmpty() );
}
/// <summary>
/// 测试是否空值
/// </summary>
[TestMethod]
public void TestIsEmpty_Guid_Nullable() {
Guid? value = null;
Assert.IsTrue( value.IsEmpty() );
value = Guid.Empty;
Assert.IsTrue( value.IsEmpty() );
value = Guid.NewGuid();
Assert.IsFalse( value.IsEmpty() );
}
}
}
本文简单介绍了两个验证方法的扩展，下一篇将介绍对Lambda表达式的操作进行封装，它是对IQueryable核心Where方法扩展的基础。
我在下载的代码中已经加入了后面两篇需要用到的代码文件，有兴趣可以下载。
.Net应用程序框架交流QQ群: 386092459，欢迎有兴趣的朋友加入讨论。
谢谢大家的持续关注，我的博客地址：http://www.cnblogs.com/xiadao521/
下载地址：https://files.cnblogs.com/xiadao521/Util.2014.12.22.1.rar
