WebService 方法特性描述

WebMethod有6个属性:
.Description
.EnableSession
.MessageName
.TransactionOption
.CacheDuration
.BufferResponse
1)Description:
是对webservice方法描述的信息。就像webservice方法的功能注释,可以让调用者看见
的注释。
C#:
[WebMethod(Description="Author:ZFive5Function:HelloWorld")]
publicstringHelloWorld()
{
return"HelloWorld";
}
WSDL:
-<portTypename="Service1Soap">
-<operationname="HelloWorld">
<documentation>Author:ZFive5Function:HelloWorld</documentation>
<inputmessage="s0:HelloWorldSoapIn"/>
<outputmessage="s0:HelloWorldSoapOut"/>
</operation>
</portType>
-<portTypename="Service1HttpGet">
-<operationname="HelloWorld">
<documentation>Author:ZFive5Function:HelloWorld</documentation>
<inputmessage="s0:HelloWorldHttpGetIn"/>
<outputmessage="s0:HelloWorldHttpGetOut"/>
</operation>
</portType>
-<portTypename="Service1HttpPost">
-<operationname="HelloWorld">
<documentation>Author:ZFive5Function:HelloWorld</documentation>
<inputmessage="s0:HelloWorldHttpPostIn"/>
<outputmessage="s0:HelloWorldHttpPostOut"/>
</operation>
</portType>
2)EnableSession:
指示webservice否启动session标志,主要通过cookie完成的,默认false。
C#:
publicstaticinti=0;
[WebMethod(EnableSession=true)]
publicintCount()
{
i=i 1;
returni;
}
在ie地址栏输入:
http://localhost/WebService1/Service1.asmx/Count?
点刷新看看
......
<?xmlversion="1.0"encoding="utf-8"?>
<intxmlns="http://tempuri.org/">19</int>
<?xmlversion="1.0"encoding="utf-8"?>
<intxmlns="http://tempuri.org/">20</int>
......
......
通过它实现webservice数据库访问的事物处理,做过实验,可以哦!
3)MessageName:
主要实现方法重载后的重命名:
C#:
publicstaticinti=0;
[WebMethod(EnableSession=true)]
publicintCount()
{
i=i 1;
returni;
}
[WebMethod(EnableSession=true,MessageName="Count1")]
publicintCount(intda)
{
i=i da;
returni;
}
通过count访问的是第一个方法,而通过count1访问的是第二个方法!
4)TransactionOption:
指示XMLWebservices方法的事务支持。
这是msdn里的解释:
由于HTTP协议的无状态特性,XMLWebservices方法只能作为根对象参与事务。
如果COM对象与XMLWebservices方法参与相同的事务,并且在组件服务管理工
具中被标记为在事务内运行,XMLWebservices方法就可以调用这些COM对象。
如果一个TransactionOption属性为Required或RequiresNew的XMLWebservices
方法调用另一个TransactionOption属性为Required或RequiresNew的XMLWebservices方法,
每个XMLWebservices方法将参与它们自己的事务,因为XMLWebservices方法只能用作事务中的
根对象。
如果异常是从Web服务方法引发的或未被该方法捕获,则自动放弃该事务。如果未发生异常,则自动提
交该事务,除非该方法显式调用SetAbort。
禁用
指示XMLWebservices方法不在事务的范围内运行。当处理请求时,将在没有事务
的情况下执行XMLWebservices方法。
[WebMethod(TransactionOption=TransactionOption.Disabled)]
NotSupported
指示XMLWebservices方法不在事务的范围内运行。当处理请求时,将在没有事务的
情况下执行XMLWebservices方法。
[WebMethod(TransactionOption=TransactionOption.NotSupported)]
Supported(msdn里写错了,这里改正)
如果有事务,指示XMLWebservices方法在事务范围内运行。如果没有事务,将在没有事务的情况
下创建XMLWebservices。
[WebMethod(TransactionOption=TransactionOption.Supported)]
必选
指示XMLWebservices方法需要事务。由于Web服务方法只能作为根对象参与事务,因
此将为Web服务方法创建一个新事务。
[WebMethod(TransactionOption=TransactionOption.Required)]
RequiresNew
指示XMLWebservices方法需要新事务。当处理请求时,将在新事务内创建XMLWebservices。
[WebMethod(TransactionOption=TransactionOption.RequiresNew)]
这里我没有实践过,所以只能抄袭msdn,这里请包涵一下了
C#
<@WebServiceLanguage="C#"Class="Bank">
<@assemblyname="System.EnterpriseServices">
usingSystem;
usingSystem.Web.Services;
usingSystem.EnterpriseServices;
publicclassBank:WebService{
[WebMethod(TransactionOption=TransactionOption.RequiresNew)]
publicvoidTransfer(longAmount,longAcctNumberTo,longAcctNumberFrom){
MyCOMObjectobjBank=newMyCOMObject();
if(objBank.GetBalance(AcctNumberFrom)<Amount)
//Explicitlyabortthetransaction.
ContextUtil.SetAbort();
else{
//CreditandDebitmethodsexplictlyvotewithin
//thecodefortheirmethodswhethertocommitor
//abortthetransaction.
objBank.Credit(Amount,AcctNumberTo);
objBank.Debit(Amount,AcctNumberFrom);
}
}
}
5)CacheDuration:
Web支持输出高速缓存,这样webservice就不需要执行多遍,可以提高访问效率,
而CacheDuration就是指定缓存时间的属性。
C#:
publicstaticinti=0;
[WebMethod(EnableSession=true,CacheDuration=30)]
publicintCount()
{
i=i 1;
returni;
}
在ie的地址栏里输入:
http://localhost/WebService1/Service1.asmx/Count?
刷新它,一样吧!要使输出不一样,等30秒。。。
因为代码30秒后才被再次执行,之前返回的结果都是在服务器高速缓存里的内容。
6)BufferResponse
配置WebService方法是否等到响应被完全缓冲完,才发送信息给请求端。普通应用要等完
全被缓冲完才被发送的!看看下面的程序:
C#:
[WebMethod(BufferResponse=false)]
publicvoidHelloWorld1()
{
inti=0;
strings="";
while(i<100)
{
s=s "i<br>";
this.Context.Response.Write(s);
i ;
}
return;
}
[WebMethod(BufferResponse=true)]
publicvoidHelloWorld2()
{
inti=0;
strings="";
while(i<100)
{
s=s "i<br>";
this.Context.Response.Write(s);
i ;
}
return;
}
从两个方法在ie里执行的结果就可以看出他们的不同,第一种,是推技术哦!
有什么数据马上返回,而后一种是把信息一起返回给请求端的。
我的例子本身破坏了webservice返回结构,所以又拿出msdn里的例子来,不要
怪哦!
[C#]
<@WebServiceclass="Streaming"language="C#">
usingSystem;
usingSystem.IO;
usingSystem.Collections;
usingSystem.Xml.Serialization;
usingSystem.Web.Services;
usingSystem.Web.Services.Protocols;
publicclassStreaming{
[WebMethod(BufferResponse=false)]
publicTextFileGetTextFile(stringfilename){
returnnewTextFile(filename);
}
[WebMethod]
publicvoidCreateTextFile(TextFilecontents){
contents.Close();
}
}
publicclassTextFile{
publicstringfilename;
privateTextFileReaderWriterreaderWriter;
publicTextFile(){
}
publicTextFile(stringfilename){
this.filename=filename;
}
[XmlArrayItem("line")]
publicTextFileReaderWritercontents{
get{
readerWriter=newTextFileReaderWriter(filename);
returnreaderWriter;
}
}
publicvoidClose(){
if(readerWriter!=null)readerWriter.Close();
}
}
publicclassTextFileReaderWriter:IEnumerable{
publicstringFilename;
privateStreamWriterwriter;
publicTextFileReaderWriter(){
}
publicTextFileReaderWriter(stringfilename){
Filename=filename;
}
publicTextFileEnumeratorGetEnumerator(){
StreamReaderreader=newStreamReader(Filename);
returnnewTextFileEnumerator(reader);
}
IEnumeratorIEnumerable.GetEnumerator(){
returnGetEnumerator();
}
publicvoidAdd(stringline){
if(writer==null)
writer=newStreamWriter(Filename);
writer.WriteLine(line);
}
publicvoidClose(){
if(writer!=null)writer.Close();
}
}
publicclassTextFileEnumerator:IEnumerator{
privatestringcurrentLine;
privateStreamReaderreader;
publicTextFileEnumerator(StreamReaderreader){
this.reader=reader;
}
publicboolMoveNext(){
currentLine=reader.ReadLine();
if(currentLine==null){
reader.Close();
returnfalse;
}
else
returntrue;
}
publicvoidReset(){
reader.BaseStream.Position=0;
}
publicstringCurrent{
get{
returncurrentLine;
}
}
objectIEnumerator.Current{
get{
returnCurrent;
}
}
}

转载于:https://www.cnblogs.com/SissyNong/archive/2010/01/05/1639652.html

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值