用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