• 数据契约(DataContract)的作用


    服务契约定义了远程访问对象和可供调用的方法,数据契约则是服务端和客户端之间要传送的自定义数据类型。

    一旦声明一个类型为DataContract,那么该类型就可以被序列化在服务端和客户端之间传送,如下所示。

          [DataContract]

         public class UserInfo

         {

              //….

    }

    只有声明为DataContract的类型的对象可以被传送,且只有成员属性会被传递,成员方法不会被传递。WCF对声明为DataContract的类型提供更加细节的控制,可以把一个成员排除在序列化范围以外,也就是说,客户端程序不会获得被排除在外的成员的任何信息,包括定义和数据。默认情况下,所有的成员属性都被排除在外,因此需要把每一个要传送的成员声明为DataMember,如下所示。

        [DataContract]

        public class UserInfo

        {

            [DataMember]

            public string UserName

            {

                get;

                set;

            }

            [DataMember]

            public int Age

            {

                get;

                set;

            }

            [DataMember]

            public string Location

            {

                get;

                set;

            }

            public string Zodiac

            {

                get;

                set;

            }

    }

    上面这段代码把UserInfo类声明为DataContract,将UserName、Age、Location这3个属性声明为DataMember(数据成员)。Zodiac成员没有被声明为DataMember,因此在交换数据时,不会传输Zodiac的任何信息。

    DataContract也支持Name/Namespace属性,如同ServiceContract,Name和Namespace可以自定义名称和命名空间,客户端将使用自定义的名称和命名空间对DataContract类型进行访问。

    声明为DataMember的成员也可以自定义客户端可见的名称,例如:

    [DataMember(Name="Name")]

    public string UserName

    {

         get;

         set;

    }

    [DataMember(Name="Age")]

    public int UserAge

    {

              get;

              set;

    }

    除了Name和Namespace以外,DataMember还有以下参数,它们的含义分别如下。

    (1)IsRequired:值为true时,要求序列化引擎检查对象是否存在该值;若无,则会有异常抛出。

    (2)Order:bool类型值,值为true时,序列化和反序列化过程将会按成员定义的顺序进行,这对依赖于成员位置的反序列化过程无比重要。

    (3)EmitDefaultvalue:为成员属性设置一个默认值。

    一般情况下,将类型声明为DataContract就可以满足传送的需求了,不过特殊情况是难以避免的,这时就需要对要传送的SOAP消息进行更加精确的控制,MessageContract可以满足这种需求。

    把一个类型声明为MessageContract,意味着它可以被序列化为SOAP消息,可以声明类型的成员为SOAP消息的各个部分,如Header、Body等,如下所示。

        [MessageContract]

        public class UserMessage

        {

            private string user = String.Empty;

            private string authKey = String.Empty;

            [MessageBodyMember(

              Name = "UserName",

              Namespace = "http://www.wcf.com")]

            public string User

            {

                get { return user; }

                set { user = value; }

            }

            [MessageHeader(

              Name = "AuthKey",

              Namespace = "http://www.wcf.com",

              MustUnderstand = true

            )]

            public string AuthKey

            {

                get { return authKey; }

                set { this.authKey = value; }

            }

    }

    User成员被声明为MessageBody(消息体)的一个成员,AuthKey被声明为消息头(MessageHeader)的一个成员。这个类将可以生成如下的SOAP消息。

    <s:Envelope>

        <s:Header>

            <a:Action s:mustUnderstand="1">http://UserMessage/Action</a:Action>

            <h:AuthKey s:mustUnderstand="1" xmlns:h="http://www.wcf.com">xxxx</h:AuthKey>

        </s:Header>

        <s:Body>

            <UserMessage xmlns="Microsoft.WCF.Documentation">

                 <User xmlns="http://www.wcf.com">abcd</User>

           </UserMessage>

        </s:Body>   

    </s:Envelope>

    MessageHeader中,MustUnderstand参数表示读取该头的程序必须能够识别头的内容,否则不能继续处理。Name/Namespace的作用与前面的元素相同。另有Relay参数,若为true,头的内容被接收到以后会在响应消息中回发给消息发送端。

    例如:

    string html="{"Table":[{"IssueNum":"20130725023","Result":"0 3 7 9 1","AwardTime":"2013-07-25 01:55"},{"IssueNum":"20130725022","Result":"0 1 3 8 9","AwardTime":"2013-07-25 01:50"},{"IssueNum":"20130725021","Result":"9 4 5 5 0","AwardTime":"2013-07-25 01:45"},{"IssueNum":"20130725020","Result":"2 5 6 1 5","AwardTime":"2013-07-25 01:40"},{"IssueNum":"20130725019","Result":"1 5 2 6 8","AwardTime":"2013-07-25 01:35"},{"IssueNum":"20130725018","Result":"5 3 2 3 9","AwardTime":"2013-07-25 01:30"},{"IssueNum":"20130725017","Result":"9 3 6 7 4","AwardTime":"2013-07-25 01:25"},{"IssueNum":"20130725016","Result":"5 7 5 2 8","AwardTime":"2013-07-25 01:20"},{"IssueNum":"20130725015","Result":"2 7 0 3 9","AwardTime":"2013-07-25 01:15"},{"IssueNum":"20130725014","Result":"4 5 2 0 6","AwardTime":"2013-07-25 01:10"},{"IssueNum":"20130725013","Result":"8 7 7 5 7","AwardTime":"2013-07-25 01:05"},{"IssueNum":"20130725012","Result":"2 4 2 6 5","AwardTime":"2013-07-25 01:00"},{"IssueNum":"20130725011","Result":"9 6 4 8 8","AwardTime":"2013-07-25 00:55"},{"IssueNum":"20130725010","Result":"5 3 3 4 5","AwardTime":"2013-07-25 00:50"},{"IssueNum":"20130725009","Result":"3 8 3 1 3","AwardTime":"2013-07-25 00:45"},{"IssueNum":"20130725008","Result":"5 6 8 7 8","AwardTime":"2013-07-25 00:40"},{"IssueNum":"20130725007","Result":"8 1 3 7 9","AwardTime":"2013-07-25 00:35"},{"IssueNum":"20130725006","Result":"6 2 4 8 4","AwardTime":"2013-07-25 00:30"},{"IssueNum":"20130725005","Result":"3 4 3 9 5","AwardTime":"2013-07-25 00:25"},{"IssueNum":"20130725004","Result":"8 5 5 8 0","AwardTime":"2013-07-25 00:20"},{"IssueNum":"20130725003","Result":"9 4 4 2 9","AwardTime":"2013-07-25 00:15"},{"IssueNum":"20130725002","Result":"3 6 1 2 0","AwardTime":"2013-07-25 00:10"},{"IssueNum":"20130725001","Res
    ult":"5 6 0 2 4","AwardTime":"2013-07-25 00:05"}]}"

    //
     public static string GetJson(string html)
     {
                SSCSerialize ssc = new SSCSerialize(); //实体类名
                var json = ConvertJson(html,ssc.GetType()); // 解析JSON
                return json.ToString();
     }

    //解析JSON
    private static object ConvertJson(string json,Type t)
     {
                try
                {
                    DataContractJsonSerializer serializer = new DataContractJsonSerializer(t);
                    using (MemoryStream ms = new MemoryStream(Encoding.UTF8.GetBytes(json)))
                    {
                        return serializer.ReadObject(ms);
                        
                    }
                }
                catch (Exception ex)
                {
                    throw ex;
                }
    }

    //实体类
    [DataContract]
     public class SSCSerialize
    {
            [DataMember]
            public string IssueNum { get; set; }
            [DataMember]
            public string Result { get; set; }
            [DataMember]
            public string AwardTime { get; set; }
     }

    解析出来是FromData.IEnumerable.SSCSerialize类名.

  • 相关阅读:
    PostgreSQL高可用之Pgpool-II的故障转移和故障恢复参数详解
    PostgreSQL高可用之Pgpool-II的Health Check参数详解(健康检测)
    PostgreSQL之常用SQL命令
    PostgreSQL之WAL日志归档配置
    PostgreSQL13基于流复制搭建后备服务器
    PostgreSQL之密码文件.pgpass
    PostgreSQL之wal日志
    PostgreSQL之background writer
    PostgreSQL之checkpoint
    使用lambda会降低代码可读性吗?
  • 原文地址:https://www.cnblogs.com/wlming/p/5132820.html
Copyright © 2020-2023  润新知