zoukankan      html  css  js  c++  java
  • WebMethod属性详解

    WebMethod有6个属性:
    .Description
    .EnableSession
    .MessageName
    .TransactionOption
    .CacheDuration
    .BufferResponse


    1) Description:
    是对webservice方法描述的信息。就像webservice方法的功能注释,可以让调用者看见的注释。

    C#:

    [WebMethod(Description="Author:ZFive5 Function:Hello World") ]
    public string HelloWorld()
    {
      return "Hello World";
    }

    WSDL:

    - <portType name="Service1Soap">
    - <operation name="HelloWorld">
      <documentation>Author:ZFive5 Function:Hello World</documentation>
      <input message="s0:HelloWorldSoapIn" />
      <output message="s0:HelloWorldSoapOut" />
      </operation>
      </portType>
    - <portType name="Service1HttpGet">
    - <operation name="HelloWorld">
      <documentation>Author:ZFive5 Function:Hello World</documentation>
      <input message="s0:HelloWorldHttpGetIn" />
      <output message="s0:HelloWorldHttpGetOut" />
      </operation>
      </portType>
    - <portType name="Service1HttpPost">
    - <operation name="HelloWorld">
      <documentation>Author:ZFive5 Function:Hello World</documentation>
      <input message="s0:HelloWorldHttpPostIn" />
      <output message="s0:HelloWorldHttpPostOut" />
      </operation>
      </portType>
     
    2)EnableSession:

    指示webservice否启动session标志,主要通过cookie完成的,默认false。

    C#:

    public static int i=0;
    [WebMethod(EnableSession=true)]
    public int  Count()
    {
       i=i+1;
       return i;
    }


    在ie地址栏输入:
    http://localhost/WebService1/Service1.asmx/Count?

    点刷新看看

    ......
    <?xml version="1.0" encoding="utf-8" ?>
      <int xmlns="http://tempuri.org/">19</int>
     
    <?xml version="1.0" encoding="utf-8" ?>
      <int xmlns="http://tempuri.org/">20</int>
    ......

    通过它实现webservice数据库访问的事物处理,做过实验,可以哦!


    3)MessageName:
    主要实现方法重载后的重命名:

    在下面的示例中,MessageName 用于消除两个 Add 方法的歧义。
    [Visual Basic]
    <%@ WebService Language="VB" Class="Calculator" %>

    Imports System
    Imports System.Web.Services

    Public Class Calculator
        Inherits WebService
       
        ' The MessageName property defaults to Add for this XML Web service method.
        <WebMethod()> _
        Overloads Public Function Add(i As Integer, j As Integer) As Integer
           
            Return i + j
        End Function
       
        <WebMethod(MessageName := "Add2")> _
        Overloads Public Function Add(i As Integer, j As Integer, k As Integer) As Integer
           
            Return i + j + k
        End Function   
    End Class
    [C#]
    <%@ WebService Language="C#" Class="Calculator" %>
     
     using System;
     using System.Web.Services;
     
     public class Calculator : WebService {
        // The MessageName property defaults to Add for this XML Web service method.
        [WebMethod]
        public int Add(int i, int j) {
           return i + j;
        }  
        [WebMethod(MessageName="Add2")]
        public int Add(int i, int j, int k) {
           return i + j + k;
        }  
     }


    通过Add访问的是第一个方法,而通过Add2访问的是第二个方法!


    4)TransactionOption:
    指示 XML Web services 方法的事务支持。

    这是msdn里的解释:

    由于 HTTP 协议的无状态特性,XML Web services 方法只能作为根对象参与事务。
    如果 COM 对象与 XML Web services 方法参与相同的事务,并且在组件服务管理工
    具中被标记为在事务内运行,XML Web services 方法就可以调用这些 COM 对象。
    如果一个 TransactionOption 属性为 Required 或 RequiresNew 的 XML Web services
    方法调用 另一个 TransactionOption 属性为 Required 或 RequiresNew 的 XML Web services 方法,
    每个 XML Web services 方法将参与它们自己的事务,因为XML Web services 方法只能用作事务中的
    根对象。

    如果异常是从 Web 服务方法引发的或未被该方法捕获,则自动放弃该事务。如果未发生异常,则自动提
    交该事务,除非该方法显式调用 SetAbort。

    禁用
     指示 XML Web services 方法不在事务的范围内运行。当处理请求时,将在没有事务
     的情况下执行 XML Web services 方法。
    [WebMethod(TransactionOption= TransactionOption.Disabled)]
     
    NotSupported
    指示 XML Web services 方法不在事务的范围内运行。当处理请求时,将在没有事务的
    情况下执行 XML Web services 方法。
    [WebMethod(TransactionOption= TransactionOption.NotSupported)]
     
    Supported (msdn里写错了,这里改正)

    如果有事务,指示 XML Web services 方法在事务范围内运行。如果没有事务,将在没有事务的情况
    下创建 XML Web services。
    [WebMethod(TransactionOption= TransactionOption.Supported)]
     
    必选
    指示 XML Web services 方法需要事务。由于 Web 服务方法只能作为根对象参与事务,因
    此将为 Web 服务方法创建一个新事务。
    [WebMethod(TransactionOption= TransactionOption.Required)]
     
    RequiresNew
    指示 XML Web services 方法需要新事务。当处理请求时,将在新事务内创建 XML Web services。
    [WebMethod(TransactionOption= TransactionOption.RequiresNew)]
     
    这里我没有实践过,所以只能抄袭msdn,这里请包涵一下了

    C#
    <%@ WebService Language="C#" Class="Bank"%>
    <%@ assembly name="System.EnterpriseServices" %>
     
     using System;
     using System.Web.Services;
     using System.EnterpriseServices;
     
     public class Bank : WebService {
     
        [ WebMethod(TransactionOption=TransactionOption.RequiresNew) ]
        public void Transfer(long Amount, long AcctNumberTo, long AcctNumberFrom)  {
          MyCOMObject objBank = new MyCOMObject();
            
          if (objBank.GetBalance(AcctNumberFrom) < Amount )
             // Explicitly abort the transaction.
             ContextUtil.SetAbort();
          else {
             // Credit and Debit methods explictly vote within
             // the code for their methods whether to commit or
             // abort the transaction.
             objBank.Credit(Amount, AcctNumberTo);
             objBank.Debit(Amount, AcctNumberFrom);
          }
        }
     }


    5)CacheDuration:
    Web支持输出高速缓存,这样webservice就不需要执行多遍,可以提高访问效率,
    而CacheDuration就是指定缓存时间的属性。我一般定义为12个小时,对于一些不是需要经常取数据的情况。

    C#:
    public static int i=0;
    [WebMethod(EnableSession=true,CacheDuration=30)]
    public int  Count()
    {
       i=i+1;
       return i;
    }


    在ie的地址栏里输入:

    http://localhost/WebService1/Service1.asmx/Count?

    刷新它,一样吧!要使输出不一样,等30秒。。。
    因为代码30秒后才被再次执行,之前返回的结果都是在服务器高速缓存里的内容。


    6)BufferResponse

    配置WebService方法是否等到响应被完全缓冲完,才发送信息给请求端。普通应用要等完
    全被缓冲完才被发送的!看看下面的程序:
    通常情况下,只有当已知 XML Web services 方法将大量数据返回到客户端时,才需要将 BufferResponse 设置为 false。对于少量数据,将 BufferResponse 设置为 true 可提高 XML Web services 的性能。

    BufferResponsefalse 时,将对 XML Web services 方法禁用 SOAP 扩展名

    C#:

    [WebMethod(BufferResponse=false)]
    public void HelloWorld1()
    {
       int i=0;
       string s="";
       while(i<100)
      {
       s=s+"i<br>";
       this.Context.Response.Write(s);
       i++;
       }
       return;
     }
     
     

    [WebMethod(BufferResponse=true)]
    public void HelloWorld2()
    {
       int i=0;
       string s="";
       while(i<100)
      {
       s=s+"i<br>";
       this.Context.Response.Write(s);
       i++;
       }
       return;
     }
     
    从两个方法在ie里执行的结果就可以看出他们的不同,第一种,是推技术哦!
    有什么数据马上返回,而后一种是把信息一起返回给请求端的。

    我的例子本身破坏了webservice返回结构,所以又拿出msdn里的例子来,不要
    怪哦!

    [C#]
    <%@WebService class="Streaming" language="C#"%>

    using System;
    using System.IO;
    using System.Collections;
    using System.Xml.Serialization;
    using System.Web.Services;
    using System.Web.Services.Protocols;

    public class Streaming {

      [WebMethod(BufferResponse=false)]
      public TextFile GetTextFile(string filename) {
        return new TextFile(filename);
      }

      [WebMethod]
      public void CreateTextFile(TextFile contents) {
        contents.Close();
      }

    }

    public class TextFile {
      public string filename;
      private TextFileReaderWriter readerWriter;

      public TextFile() {
      }

      public TextFile(string filename) {
        this.filename = filename;
      }

      [XmlArrayItem("line")]
      public TextFileReaderWriter contents {
        get {
          readerWriter = new TextFileReaderWriter(filename);
          return readerWriter;
        }
      }

      public void Close() {
        if (readerWriter != null) readerWriter.Close();
      }
    }

    public class TextFileReaderWriter : IEnumerable {

      public string Filename;
      private StreamWriter writer;

      public TextFileReaderWriter() {
      }

      public TextFileReaderWriter(string filename) {
        Filename = filename;
      }

      public TextFileEnumerator GetEnumerator() {
        StreamReader reader = new StreamReader(Filename);
        return new TextFileEnumerator(reader);
      }

      IEnumerator IEnumerable.GetEnumerator() {
        return GetEnumerator();
      }

      public void Add(string line) {
        if (writer == null)
          writer = new StreamWriter(Filename);
        writer.WriteLine(line);
      }

      public void Close() {
        if (writer != null) writer.Close();
      }

    }

    public class TextFileEnumerator : IEnumerator {
      private string currentLine;
      private StreamReader reader;

      public TextFileEnumerator(StreamReader reader) {
        this.reader = reader;
      }

      public bool MoveNext() {
        currentLine = reader.ReadLine();
        if (currentLine == null) {
          reader.Close();
          return false;
        }
        else
          return true;
      }

      public void Reset() {
        reader.BaseStream.Position = 0;
      }

      public string Current {
        get {
          return currentLine;
        }
      }

      object IEnumerator.Current {
        get {
          return Current;
        }
      }
    }
     

  • 相关阅读:
    静静的看twittervision
    MSSQL中的随机函数
    紧张非封闭式开发中
    be my friend
    这个五一
    检讨
    SilverLight,有多少人关心呢?
    并查集模板题P3367 【模板】并查集
    并查集简单介绍
    约数之和模板题
  • 原文地址:https://www.cnblogs.com/liubiqu/p/168623.html
Copyright © 2011-2022 走看看