用IE的Web服务建立ASP.NET应用程序(3)

发表于:2007-06-30来源:作者:点击数: 标签:
在嵌入了上面的代码后,我们就可以使用 Java Script代码调用行为并把它链接到兼容WSDL 1.1的Web服务了。这是通过引用被嵌入的行为id(前面代码中的服务)和调用它的useService方法来实现的: service.useService("http://localhost/MyProjects/WebServiceBeh
     在嵌入了上面的代码后,我们就可以使用JavaScript代码调用行为并把它链接到兼容WSDL 1.1的Web服务了。这是通过引用被嵌入的行为id(前面代码中的服务)和调用它的useService方法来实现的:
  
   service.useService("http://localhost/MyProjects/WebServiceBehavior/EmployeeService.asmx?WSDL","sVCEmployee");
  
     你需要在页面的onLoad事件句柄中调用useService方法,这样才能确保在调用Web服务的任何方法之前,该Web服务已经映射了。
  
     UseService方法有下面两个参数:
  
     · Web服务的WSDL文件的路径。
  
     · 用于以后引用该Web服务的一个"友好的"名字。每次使用行为调用EmployeeService.asmx文件中的方法的时候都会使用这个名字。
   现在已经建立了Web服务并可以访问它了。异步调用Web服务方法可以分为两个步骤。异步调用的优点是Web页面不用等待Web服务返回。第一步,你调用Web方法并把回调(callback)函数作为参数。第二步,在执行了需要的方法后,Web服务返回,启动回调函数。
  
     下面是完整的源代码列表:
  
   <%@ Page language="C#" Codebehind="EmployeeServiceClient.ASPx.cs"
   AutoEventWireup="false" Inherits="
   EmployeeWebServiceClient.EmployeeServiceClient" %>
   <HTML>
   <HEAD>
   <title>Employee Details</title>
   <SCRIPT LANGUAGE="JScript">
   //定义一个模块级的变量来捕捉事件id
   var iCallID ;
  
   function GetEmployeeDetails()
   {
    // 调用svcEmployee Web服务的GetEmployeeDetails方法
    iCallID =
     service.svcEmployee.callService(DisplayResults,"GetEmpDetailsByEmpID",txtEmployeeID.value);
   }
  
   function DisplayResults(result)
   {
    var strXML,objXMLNode,objXMLDoc,objEmployee,strHTML;
    
    //检查事件id是否相同
    if (iCallID != result.id)
     return;
    if(result.error)
    {
     // 显示错误信息
     var faultCode = result.errorDetail.code;
     var faultString = result.errorDetail.string;
     alert("ERROR: Code = " + faultCode + ", Fault String=" + faultString);
    }
    else
    {
     //把结果值赋予本地变量
     objXMLNode = result.value;
     objXMLDoc = new ActiveXObject("Microsoft.XMLDOM");
     //把返回的XML字符串载入XMLDOM对象
     objXMLDoc.loadXML(objXMLNode.xml);
     //得到Employees节点的指针
     objEmployee =
   objXMLDoc.selectSingleNode("GetEmpDetailsByEmpIDResult").selectSingleNode("EmployeesRoot").selectSingleNode("Employees");
     //检查从服务器返回的雇员指针是否有效
     strHTML = "<font color=’#0000FF’>";
     if (objEmployee != null)
     {
      //动态生成HTML,并把它添加到一个字符串变量中
       strHTML += "<br><br>Employee ID :<b>" +
         objEmployee.selectSingleNode("EmployeeID").text + "</b><br><br>";
       strHTML += "Employee First Name :<b>" +
         objEmployee.selectSingleNode("FirstName").text +
         "</b><br><br>";
       strHTML += "Employee Last Name :<b>" +
         objEmployee.selectSingleNode("LastName").text + "</b><br><br>";
       strHTML += "Employee Title :<b>" +
         objEmployee.selectSingleNode("Title").text + "</b><br><br>";
       strHTML += "Employee Title :<b>" +
         objEmployee.selectSingleNode("Title").text + "</b><br><br>";
       strHTML += "Title Of Courtesy:<b>" +
         objEmployee.selectSingleNode("TitleOfCourtesy").text + "</b><br><br>";
       strHTML += "Postal Code:<b>" +
         objEmployee.selectSingleNode("PostalCode").text + "</b><br><br>";
     }
     else
     {
      strHTML += "<br><br><b>Employee
      not found</b>";
     }
     strHTML += "</font>"
     //把动态生成的HTML赋予div标记
     divContents.innerHTML = strHTML;
    }
   }
  
   function init()
   {
    // 建立Web服务的实例并把它叫做svcEmployee
    service.useService("http://localhost/MyProjects/15Seconds/WebServiceBehavior/_
      EmployeeWebService/EmployeeService.asmx?WSDL","svcEmployee");
   }
  
   </SCRIPT>
   </HEAD>
   <body onload="init()">
   <div id="service" style="BEHAVIOR: url(webservice.htc)"></div>
   <H1 align="center">
   <font color="#800080">Employee Details</H1>
   </FONT>
   <br><br>
   <P align="left"><font color="#800080"><b>Enter the
   Employee ID:</b></font> <INPUT
   id="txtEmployeeID" name="txtEmployeeID" style="LEFT: 149px; TOP:
   72px"><INPUT id="btnAdd" type="button" value="Get Employee Details"
   name="btnGetEmployee" onclick="return GetEmployeeDetails()"></P><P></P>
   <div id="divContents">
   </div>
   <P></P>
   </body>
   </HTML>
  
     在GetEmployeeDetails方法中,你通过把回调方法名称和输入参数作为参数传递给Web服务来调用该Web服务的web方法。这是通过调用Web服务行为的callService方法实现的:
  
   function GetEmployeeDetails()
   {
   // 调用svcEmployee web服务的GetEmployeeDetails方法
   iCallID =
   service.svcEmployee.callService(DisplayResults,"GetEmpDetailsByEmpID",txtEmployeeID.value);
   }
  
     CallService方法返回一个唯一的标识符,它可以用于识别Web服务调用。如果你进行多个异步Web服务调用,接着在客户端浏览器中把结果拼装在一起,那么这个标识符就是必要的。在这种情况下,你把这个ID与作为result对象的一个属性返回的ID进行匹配。匹配过程是在回调函数中完成的:
  
   function DisplayResults(result)
   {
   var strXML,objXMLNode,objXMLDoc,objEmployee,strHTML;
  
     在下面几行代码中,你把result对象的ID与callService方法返回的ID进行匹配:
  
   //检查事件是否相同
   if (iCallID != result.id)
   return;
  
     接着检查error属性以确定在Web服务的执行过程中是否发生过错误。如果发生过错误,就在消息窗口中显示错误信息。如果没有错误,就处理返回的结果并把它们显示在HTML DIV标记中:
  
   if(result.error)
   {
    // 读取错误信息
    var faultCode = result.errorDetail.code;
    var faultString = result.errorDetail.string;
    alert("ERROR: Code = " + faultCode + ", Fault String=" + faultString);
   }
   else
   {
    //把结果值赋予本地变量
    objXMLNode = result.value;
    objXMLDoc = new ActiveXObject("Microsoft.XMLDOM");
    //把返回的XML字符串载入XMLDOM 对象
    objXMLDoc.loadXML(objXMLNode.xml);
    //得到Employees节点的指针
    objEmployee = objXMLDoc.selectSingleNode("GetEmpDetailsByEmpIDResult").
     selectSingleNode("EmployeesRoot").selectSingleNode("Employees");
    //查看从服务器返回的employee 指针是否有效
    strHTML = "<font color=’#0000FF’>";
    if (objEmployee != null)
    {
     //动态生成HTML并添加到字符串的内容中
     strHTML += "<br><br>Employee ID :<b>" +
      objEmployee.selectSingleNode("EmployeeID").text +
      "</b><br><br>";
     strHTML += "Employee First Name :<b>" +
      objEmployee.selectSingleNode("FirstName").text +
      "</b><br><br>";
     strHTML += "Employee Last Name :<b>" +
      objEmployee.selectSingleNode("LastName").text +
      "</b><br><br>";
     strHTML += "Employee Title :<b>" +
      objEmployee.selectSingleNode("Title").text +
      "</b><br><br>";
     strHTML += "Employee Title :<b>" +
      objEmployee.selectSingleNode("Title").text +
      "</b><br><br>";
     strHTML += "Title Of Courtesy:<b>" +
      objEmployee.selectSingleNode("TitleOfCourtesy").text +
      "</b><br><br>";
     strHTML += "Postal Code:<b>" +
      objEmployee.selectSingleNode("PostalCode").text +
      "</b><br><br>";
    }
    else
    {
     strHTML += "<br><br><b>Employee
     not found</b>";
    }
    strHTML += "</font>"
    //把动态生成的HTML赋予div标记
    divContents.innerHTML = strHTML;
    }
   }
  
     在上面的例子中,你使用调用Web服务时指定的回调函数来处理Web服务返回的结果。还有一种办法,在定义DIV标记的时候你也可以指定一个回调函数(用这种方法把Web服务行为包含在页面中)。例如,在下面的代码中,你使用Web服务行为支持的onresult事件句柄指定了回调函数:
  
   <div id="service" style="BEHAVIOR: url(webservice.htc)"
   onresult="DisplayResults()"></div>
  
     有了上面的定义后,你就可以在DisplayResults函数中处理Web服务返回的结果了。下面的代码演示了DisplayResults函数的一种实现示例:
  
   function DisplayResults()
   {
    //检查事件id是否相同
    if (iCallID != event.result.id)
     return;
    if(event.result.error)
    {
     var faultCode = event.result.errorDetail.code;
     var faultString = event.result.errorDetail.string;
     alert("ERROR: Code = " + faultCode + ", Fault String=" +
     faultString);
    }
    else
    {
     //显示结果值
     alert(event.result.value);
    }
   }
  
     在代码中你可以看到,我们使用event对象得到包含Web服务调用返回结果的result对象的指针。
  
     把代码放在一起
  
     如果使用浏览器查看上面的ASP.NET页面,你看到的输出类似下图。在employee文本框中输入一个有效的Employee ID并点击"Get Employee Details"调用远程Web服务。这种操作将导致对该Web服务的异步调用,并且该Web服务返回的结果将显示在Web页面的DIV元素中。
  
  
  
   我要再次重点强调,对于IE Web服务行为,需要IE 5或以上版本,因此如果你能够确定用户所使用的浏览器类型,这种技术就很适合用于企业内部网应用程序。
  
    结论
  
    在本文中,你看到了Web服务行为是如何提供一种从Web服务器向客户端浏览器传递信息的改进的解决方法的。使用Web服务行为调用远程Web方法简化了客户端的操作,使Web服务的使用更加有吸引力。我们同时看到Web服务行为是如何通过提供动态的交互操作Web页面,帮助我们提高了用户体验的。由于Web服务行为(webservice.htc文件)封装了使用SOAP调用远程Web服务所需要的代码,随着SOAP标准的演化,你可以独立地更新行为而不需要改变客户端脚本。

原文转自:http://www.ltesting.net