我的KT库之-----扩展方法

了解或者认识KT:

      http://www.cnblogs.com/kingthy/archive/2011/08/08/2130973.html

     

在项目中如何使用KT?

     KT是一个库,所以将KT的dll文件引用到您的项目上即可使用KT里的函数功能。

本节将介绍大家认识KT库里的扩展方法和如何去使用扩展方法。KT里的扩展方法存放在“KT.Core.Extensions“下,当你已在你的项目里引用了KT库后,则写下以下代码就可以使用到KT里的所有扩展方法了。

using KT.Core.Extensions;

目前KT库只针对“Object”、“String”、“DateTime”、“IDictionary”,“NameValueCollection”等对象数据进行了方法扩展。

A、Object的扩展方法

1)、As<T>方法 : 万能转换方法

      将某种类型的数据转换为另外一种类型数据,如果转换失败则返回对应类型的默认值,如下示例代码:

     

            int i = "1".As<int>();          //i = 1
           
float f = "0.22".As<float>();   //f = 0.22f
            DayOfWeek dayOfWeek
= "Friday".As<DayOfWeek>();  //dayOfWeek = Friday
            DateTime time
= "2011-01-01".As<DateTime>();     //time = 2011-01-01
            Stream stream
= (new MemoryStream()).As<Stream>();  //stream = MemoryStream

           
object value = null;     
           
long l = value.As<long>();            //l = 0L

从上面的示例代码可以看出,As<T>扩展方法有点类似于as操作符与Convert类的结合体。但As<T>和Convert类又有几点不同。

A)、如果类型转换失败,As<T>扩展不会抛出任何的错误,只是返回对应类型的默认值。如上面例子中的“long l = value.As<long>();“,因为null无法转换为long类型,所以返回long类型的默认值“0”。

B)、支持转换为枚举类型。如上例中将“Friday”字符串转换为DayofWeek枚举,如果转换失败,则返回枚举定义中的第一个项!

注:此方法还有一个重载方法,即是多了一个默认值参数,当转换失败时返回方法传递的默认值。如下示例:

object value = null;
long l = value.As<long>(-1L);  //l = -1L

因为value=null,无法转换为long类型的值,所以返回-1L。

2)、ToJson方法: 将对象解析为Json格式的字符串

如果对象值为DateTime则返回一个JavaScript脚本的Date对象;如果是字符串,则对于非英文字母、数字的字符,将解析为“\uxxxx“格式的字符。

示例代码:

            User user = new User();
            user.Age
= 12;
            user.Name
= "张三";
            user.CreatedTime
= DateTime.Now;
            user.Location.Address
= "广东广州";
            user.Location.Zipcode
= "510000";
            Console.WriteLine(user.ToJson());

运行后,将输出以下数据:

{"Name":"\u5f20\u4e09","Age":12,"CreatedTime":new Date(1312790227779),"Address":"\u5e7f\u4e1c\u5e7f\u5dde","Zipcode":"510000","Location":{"Address":"\u5e7f\u4e1c\u5e7f\u5dde","Zipcode":"510000"}}

3)、IfNull<T>方法:如果对象为null则调用委托方法。

有时我们会经常这样做if条件判断:

        static void GetCurrentUserData(User user)
        {
           
if (user == null)
            {
               
//如果user为null则获取当前会话的用户
                user = GetCurrentContextUser();
            }
           
//其它操作代码
        }

有了此IfNull<T>扩展方法后,我们就可以省去此if了,可以直接写成这样:

        static void GetCurrentUserData(User user)
        {
            user
= user.IfNull<User>(GetCurrentContextUser);
           
//其它操作代码
        }

B、String的扩展方法

1)、MD5方法:采用UTF-8编码获取字符串的MD5哈希值(小写输出)

示例代码:

            Console.WriteLine("管理员".MD5());  //b1dae9bc5cabbc13e4bee21af11cdb8d
            Console.WriteLine("管理员".MD5(Encoding.GetEncoding("gbk")));  //8178134ede762c42e41a7b1695082e28

注:此方法有一个重载方法,用于设置求取MD5哈希值时使用的文本编码。如上例代码,对于汉字,如果采用不同编码获取到的哈希值是不同的。

2)、IfEmpty方法:如果字符串为null或空字符值,则返回替代值或调用委托函数获取新值,类似于Object的IfNull<T>方法

3)、IsInteger方法:判断字符串是否都是由阿拉伯数字组成的,即是否由(0-9)数字组成的字符串

4)、IsDateTime方法:判断是否是日期时间格式的字符串

5)、IsValidEmail方法:判断字符串的格式是否是邮件地址格式(注:此方法判断的邮件格式要求较宽松,只要符合XXX@XXX.XX格式的都会认为符合)

6)、IsMatch方法:判断字符串是否符合某种正则表达式的模式格式,如下面代码就是IsInteger方法的实现:

"0123123".IsMatch(@"^\d+$")

7)、IsContain方法:判断字符串中是否包含有某个分隔项。示例代码:

            Console.WriteLine("A,B,C,D".IsContain("A",","));   //true
            Console.WriteLine("A,B,C,D".IsContain("E", ","));  //false
            Console.WriteLine("A,B,C,D".IsContain("a", ","));  //false
            Console.WriteLine("A,B,C,D".IsContain("a", ",", true));  //true

注:此方法有一个重载方法,用于指示判断时是否区分大小写

8)、Replace方法:字符串替换方法

     此方法有几种不同的重载方法。

     a)、是否不区分大小写替换,示例代码:

"AbabAe".Replace("a", "C", true); //CbCbCe

     b)、带前缀、后缀的整批替换(集合),示例代码:

            Dictionary<string, string> items = new Dictionary<string, string>();
            items.Add(
"姓名", "张三");
            items.Add(
"年龄", "20");
            items.Add(
"婚否", "未婚");

            Console.WriteLine(
"用户:[姓名],今年[年龄]岁,婚姻状况:[婚否]".Replace(items, "[", "]"));   //输出:“用户:张三,今年20岁,婚姻状况:未婚”

    

      c)、带前缀、后缀的整批替换(委托)、示例代码:

    

            //UBB转换示例
            string text = "[b]粗体[/b][i]斜体[/i][red]红色[/red]";
            text
= text.Replace(key =>
            {
               
switch (key.ToLower())
                {
                   
case "b":
                       
return "<strong>";
                   
case "/b":
                       
return "</strong>";
                   
case "i":
                       
return "<i>";
                   
case "/i":
                       
return "</i>";
                   
case "red":
                       
return "<font color=\"red\">";
                   
case "/red":
                       
return "</font>";
                   
default:
                       
return null;
                }
            },
"[", "]");
            Console.WriteLine(text);   //输出:"<strong>粗体</strong><i>斜体</i><font color="red">红色</font>"

9)、ToJavaScriptString方法:将字符串格式化为Javascript脚本里的字符串,对于非英文字母、数字的字符将格式为“\uxxxx”格式的字符。

10)、ConvertTo方法:将字符串值转换为其它类型。此方法是Object里的As<T>方法的核心方法。

11)、ReadAllLines方法:将字符串按行读取,并返回所有行数据数组。

C、DateTime的扩展方法

1)、ToTimestamp方法:获取某个日期时间的时间戳值,时间戳值的计算是从1970-01-01 0:0:0开始计算的总毫秒数

2)、FromTimestamp方法:将某个时间戳值转换为当前时间值。

3)、ToRFC822Time方法:获取某个日期时间的RFC822定义的格式字符串,此格式时间在邮件交互里经常使用到。如"Thu, 21 Dec 2000 16:01:07 +0800"

D、IDictionary的扩展方法

1)、GetOrDefault方法: 从IDictionary对象里获取数据,如果没有数据则返回一个默认的值

2)、GetOrAdd方法: 从IDictionary对象里获取数据,如果没有数据则调用委托获取数据并添加到集合后返回。示例代码:

            Dictionary<string, string> items = new Dictionary<string, string>();
            Console.WriteLine(items.GetOrDefault(
"姓名", "张三"));     //张三
            Console.WriteLine(items.GetOrAdd(
"姓名", () => "李四"));   //李四
            Console.WriteLine(items.GetOrDefault(
"姓名", "张三"));     //李四

E、NameValueCollection的扩展方法

1)、Get<T>方法: 从NameValueCollection获取某个值,并且转换为对应类型,如果转换失败返回默认值

2)、TrimGet<T>方法:从NameValueCollection获取某个值,并去掉值的前后空白后转换为对应类型,如果转换失败则返回默认值。

示例代码:

int i = Request.QueryString.Get<int>("id");
string name = Request.QueryString.TrimGet<string>("name");
int year = Request.Form.Get<int>("year",2011);
DateTime time
= Request.From.Get<DateTime>("createdtime",DateTime.Now);

3)、CopyTo<T>方法:将NameValueCollection里的所有数据复制到某个对象中

假如我们的Web表格里提交了如下数据:

name=张三&age=12&location.zipcode=510000&location.city=广州&createdtime=2011-01-01 12:00:00

 

User user = new User();
Request.From.CopyTo(user);
Response.Write(user.ToJson());

运行以上代码后,user里的各个属性字段将对应取得上面提交的值。

 

 

好了,目前KT里的扩展方法只提供了这么多,虽然少,但却都是非常有用的功能函数。如果你有更好的扩展方法或建议,希望你能加入到KT项目的更新开发中来:)

 

posted @ 2011-08-08 17:17  Kingthy  阅读(3354)  评论(9编辑  收藏  举报