.Net下WebMethod属性

作者:网络 来源:佚名 更新时间:2008-02-06 06:44:58 点击:
菜鸟学堂:
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;
}
}
}