Author:zfive5(zhaozidong) Email :[email protected]
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:
主要实现方法重载后的重命名:
C#:
public static int i=0; [WebMethod(EnableSession=true)] public int Count() { i=i+1; return i; }
[WebMethod(EnableSession=true,MessageName="Count1")] public int Count(int da) { i=i+da; return i; }
通过count访问的是第一个方法,而通过count1访问的是第二个方法!
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就是指定缓存时间的属性。
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方法是否等到响应被完全缓冲完,才发送信息给请求端。普通应用要等完 全被缓冲完才被发送的!看看下面的程序:
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; } } }

|