Atlas学习手记(8):调用本地Web Service简单介绍
Atlas对于调用Web Service作了很好的封装,使得我们用JS调用Web Service的工作变得非常的简单,只需要使用WebServiceName.WebMethod()就可以完成调用。本文将通过两个简单的例子来说明这一内容。
主要内容
1.调用简单的Web Service
2.传递复杂类型的数据
Atlas对于调用Web Service作了很好的封装,使得我们用JS调用Web Service的工作变得非常的简单,只需要使用WebServiceName.WebMethod()就可以完成调用。本文将通过两个简单的例子来说明这一内容。
一.调用简单的Web Service
这个例子中,我们调用Web Service来返回一个字符串,首先创建一个简单的Web Service,并编写一个接受字符串类型参数的Web Method。
public string EchoString(string s)
{
return "Hello : " + s;
}
创建Web Page,并且添加ScriptManager到页面中,并且在ServiceReference子控件中引入需要的Web Service。
<Services>
<atlas:ServiceReference Path="SimpleWebService.asmx" />
</Services>
</atlas:ScriptManager>
下面我们就可以在JS中调用Web Service了,注意EchoString方法只有一个参数,这里我们传递了两个,第一个显然是EchoString方法应有的参数,第二个OnComplete则调用方法成功返回时的Callback方法:
function OnbuttonGo_click()
{
// Call script proxy passing the input element data
requestSimpleService = SimpleWebService.EchoString(
document.getElementById('inputName').value, //params
OnComplete //Complete event
);
return false;
}
function OnComplete(result)
{
alert(result);
}
</script>
编译运行后:
调用:
二.传递复杂类型的数据
上面的例子中,我们只是做了一个最简单的调用Web Service的示例,而实际应用中我们遇到的类型会更加复杂,下面再看一个例子,它将返回一个我们自定义的类型,首先定义一个纯数据类Animal,它不带有操作:
{
String _name;
String _color;
public String Name
{
get { return _name; }
set { _name = value; }
}
public String Color
{
get { return _color; }
set { _color = value; }
}
}
编写Web Service,接收到该复杂类型后直接返回:
public Animal EchoAnimal(Animal a)
{
return a;
}
创建Web Page,并且添加ScriptManager到页面中,并且在ServiceReference子控件中引入需要的Web Service。
<Services>
<atlas:ServiceReference Path="ComplexWebService.asmx" />
</Services>
</atlas:ScriptManager>
提供给用户输入的界面:
Name:<input id="inputName" />
Color:<input id="inputColor" />
<input id="buttonGo" type="button" value="GO" onclick="return OnbuttonGo_click()" />
</h3>
现在就可以添加相应的JS了,把返回的结果Alert出来:
function OnbuttonGo_click()
{
//Call script proxy passing the input element data
var i1 = document.getElementById('inputName');
var i2 = document.getElementById('inputColor');
var object = new Animal();
object.Name = i1.value;
object.Color = i2.value;
requestComplexService = ComplexWebService.EchoAnimal(
object, //params
OnComplete //Complete eventt
);
return false;
}
function OnComplete(result)
{
alert("Name= " + result.Name + " Color= " + result.Color);
}
</script>
编译运行后:
调用:
可以看到,在Atlas中调用本地Web Service非常的简单,对于调用远程的Web Service又有一些不同,后面会说到,在实际使用中,我们还需要考虑错误、超时等的一些处理[文中的示例来源于Atlas官方网站]。