Web Service学习笔记：创建一个示例和WebMethod特性解析

现在开始学习Web服务，写下自己学习过程中的一些感受，拿出来与大家分享，欢迎批评指正。希望能给跟我一样初学Web服务的朋友一些帮助。

文章在我小站的地址：Web Service学习笔记：创建一个示例和WebMethod特性解析

Web服务的宗旨是创建不需要用户界面就能与其他应用程序交互的Web应用程序。它是松耦合的，并与服务器端和客户端所使用的操作系统、编程语言都无关，这样就在一定的情况下就会使你的效率大大提高。但创建Web服务必须保证的是，服务器端和客户端都要支持行业标准协议HTTP、SOAP（simple object access protocal 简单对象访问协议）和XML。

创建Web服务的过程：

(1):打开VS，创建一个ASP.NET WEB服务应用程序；

(2):输入下列代码，这是一个有关学生信息的二维数组和几个方法

 

// 构造并填充info数组
string [,] strStuInfo  = {
                    { " 200511020120 " , " 贰零零五届 " , " 人文法律学院 " , " 社会工作 " , " (1)班 " , " 无悔 " , " 1 " },
                    { " 200511020121 " , " 贰零零五届 " , " 人文法律学院 " , " 社会工作 " , " (1)班 " , " 梁需 " , " 2 " },
                    { " 200511010122 " , " 贰零零五届 " , " 人文法律学院 " , " 法律专业 " , " (1)班 " , " 陆磊 " , " 3 " },
                    { " 200511010220 " , " 贰零零五届 " , " 人文法律学院 " , " 法律专业 " , " (2)班 " , " 白灵 " , " 4 " },
                    { " 200511010221 " , " 贰零零五届 " , " 人文法律学院 " , " 法律专业 " , " (2)班 " , " 剑付 " , " 5 " },
                    { " 200511020222 " , " 贰零零五届 " , " 人文法律学院 " , " 社会工作 " , " (2)班 " , " 敬意 " , " 6 " },
                    { " 200511100120 " , " 贰零零五届 " , " 化工生物学院 " , " 生物制药 " , " (1)班 " , " 黄兴 " , " 7 " },
                    { " 200511100221 " , " 贰零零五届 " , " 化工生物学院 " , " 生物制药 " , " (2)班 " , " 蕾蕾 " , " 8 " },
                    { " 200511100322 " , " 贰零零五届 " , " 化工生物学院 " , " 生物制药 " , " (3)班 " , " 白冰 " , " 9 " },
                    { " 200611120120 " , " 贰零零六届 " , " 化工生物学院 " , " 发酵工程 " , " (1)班 " , " 书并 " , " 10 " },
                    { " 200611120121 " , " 贰零零六届 " , " 化工生物学院 " , " 发酵工程 " , " (1)班 " , " 小鱼 " , " 11 " },
                    { " 200611120421 " , " 贰零零六届 " , " 化工生物学院 " , " 发酵工程 " , " (4)班 " , " 声声 " , " 12 " },
                 };

[WebMethod(Description  =   " 根据学号获得学生的姓名 " )]
public   string  GetName( string  strStuNum)
{
     for  ( int  i  =   0 ; i  <  strStuInfo.GetLength( 0 ); i ++ )
    {
         if  (String.Compare(strStuNum, strStuInfo[i,  0 ],  true )  ==   0 )
             return  strStuInfo[i,  5 ].ToString();
    }
     return   " 您输入的学号不存在 " ;
}

[WebMethod(Description  =   " 根据学号获得学生的专业和班级 " )]
public   string  GetClass( string  strStuNum)
{
     for  ( int  i  =   0 ; i  <  strStuInfo.GetLength( 0 ); i ++ )
    {
         if  (String.Compare(strStuNum, strStuInfo[i,  0 ],  true )  ==   0 )
        {
             return  strStuInfo[i,  3 ].ToString()  +  strStuInfo[i,  4 ].ToString();
        }
    }
     return   " 您输入的学号不存在 " ;
}

[WebMethod(Description  =   " 根据学号获得学生的入学时间 " )]
public   string  GetYear( string  strStuNum)
{
     for  ( int  i  =   0 ; i  <  strStuInfo.GetLength( 0 ); i ++ )
    {
         if  (String.Compare(strStuNum, strStuInfo[i,  0 ],  true )  ==   0 )
        {
             return  strStuInfo[i,  1 ].ToString();
        }
    }
     return   " 您输入的学号不存在 " ;
}

[WebMethod(Description  =   " 根据学号获得学生的学院 " ]
public   string  GetCollege( string  strStuNum)
{
     for  ( int  i  =   0 ; i  <  strStuInfo.GetLength( 0 ); i ++ )
    {
         if  (String.Compare(strStuNum, strStuInfo[i,  0 ],  true )  ==   0 )
        {
             return  strStuInfo[i,  2 ].ToString();
        }
    }
     return   " 您输入的学号不存在 " ;
}

[WebMethod(Description  =   " 点击次数 " , EnableSession  =   true )]
public   int  HitCounter()
{
     if  (Session[ " HitCounter " ]  ==   null )
    {
        Session[ " HitCounter " ]  =   1 ;
    }
     else
    {
        Session[ " HitCounter " ]  =  (( int )Session[ " HitCounter " ])  +   1 ;
    }
     return  (( int )Session[ " HitCounter " ]);
}

 

（3）生成Web服务，在浏览器中打开（效果如下）

 

（4）创建个其他程序，调用就可以了！

 

 

WebMethod特性的EnableSession属性

此属性默认为false。如果设置为true，web方法将会启用会话状态，且继承自WebService类，那么会话状态集合可以使用WebService.Session属性访问，如果没有集成，则可以直接从HttpContext.Current.Session访问。

上面代码中HitCounter()方法为每个会话准备了单击计数器。

会话状态为应用程序增加了额外的开销，如果移除会话状态可以提高性能。然而，会话状态作为全局变量很有用，因为它能够超出成员变量的工作范围。

需要注意的是：会话状态在Web服务中是通过cookies实现的，如果传输机制不是HTTP的话，则不可用。

 

WebMethod特性的MessageName属性

Web服务禁止使用函数重载。MessageName属性可以解决由多个相同的名称的方法造成的无法识别的问题，它允许对每一个方法的重载使用唯一的别名。当从在方法在SOAP消息中引用时，SOAP将使用MessageName而非方法名。

在上面的例子中,为了试验这个属性，我改了一下，写两个GetCollege()方法。

 

 

       [WebMethod(Description  =   " 根据学号获得学生的学院 " , MessageName  =   " GetCollegeStuNum " )]
         public   string  GetCollege( string  strStuNum)
        {
             for  ( int  i  =   0 ; i  <  strStuInfo.GetLength( 0 ); i ++ )
            {
                 if  (String.Compare(strStuNum, strStuInfo[i,  0 ],  true )  ==   0 )
                {
                     return  strStuInfo[i,  2 ].ToString();
                }
            }
             return   " 您输入的学号不存在 " ;
        }

        [WebMethod(Description  =   " 根据排名获得学生的学院 " , MessageName  =   " GetCollegeStuRank " )]
         public   string  GetCollege( int  intStuRank)
        {
             for  ( int  i  =   0 ; i  <  strStuInfo.GetLength( 0 ); i ++ )
            {
                 if  (String.Compare(intStuRank.ToString(), strStuInfo[i,  6 ],  true )  ==   0 )
                {
                     return  strStuInfo[i,  2 ].ToString();
                }
            }
             return   " 您输入的学生排名不存在 " ;
        }

 

 

可是当你从新生成的时候，会发现不会在报错了，但是在浏览器打开时，却会出现下面的问题。

 

 

后来看书发现了这个问题的原因在于：

由于默认WebServiceBinding特性遵循WS-1 BP V1.1，如果两个方法处于相同的数据绑定，那么该规范不允许方法的重载（尽管使用了MessageName属性）可以做两种选择：

（1）重命名方法，当然用这种方法最好是客户端没有链接到Web服务。

（2）创建一个新的绑定来代特重载方法

做法如下：

1）为类添加新的属性（文件的摘要下面），代码如下：

 

 

[WebService(Namespace  =   " http://tempuri.org/ " )]
[WebServiceBinding(ConformsTo  =  WsiProfiles.BasicProfile1_1, Name  =   " OverloadedGetCollege " ,EmitConformanceClaims = true )]
[ToolboxItem( false )]

 

多添加了这个两个属性：Name = "OverloadedGetCollege",EmitConformanceClaims=true

 

2）在任意一个GetCollege（）方法上部添加SoapDocumentMethod特性：

        [SoapDocumentMethod(Binding="OverloadedGetCollege")]
        [WebMethod(Description = "根据学号获得学生的学院", MessageName = "GetCollegeStuNum")]
        public string GetCollege(string strStuNum)

3）重新生成，就成功了。效果如下：

 

想了解这样的好处，点击如上图的“服务说明”，就可以看到WSDL的变化，我也就不多说了！

 

 

转载于:https://www.cnblogs.com/VisualStudio/archive/2008/10/11/1308541.html