用POJO实现0配置的WebService
Axis2是一套崭新的WebService引擎,该版本是对Axis1.x重新设计的产物。Axis2不仅支持SOAP1.1和SOAP1.2,还集成了非常流行的REST WebService,同时还支持Spring、JSON等技术。这些都将在后面的系列教程中讲解。在本文中主要介绍了如何使用Axis2开发一个不需要任何配置文件的WebService,并在客户端使用Java和C#调用这个WebService。
一、Axis2的下载和安装
读者可以从如下的网址下载Axis2的最新版本:
https://www.sodocs.net/doc/8a17676574.html,/axis2/
在本文使用了目前Axis2的最新版本1.4.1。读者可以下载如下两个zip包:
axis2-1.4.1-bin.zip
axis2-1.4.1-war.zip
其中axis2-1.4.1-bin.zip文件中包含了Axis2中所有的jar文件, axis2-1.4.1-war.zip 文件用于将WebService发布到Web容器中。
将axis2-1.4.1-war.zip文件解压到相应的目录,将目录中的axis2.war文件放到
在浏览器地址栏中输入如下的URL:
http://localhost:8080/axis2/
如果在浏览器中显示出如图1所示的页面,则表示Axis2安装成功。
图1
二、编写和发布WebService
对于用Java实现的服务程序给人的印象就是需要进行大量的配置,不过这一点在Axis2中将被终结。在Axis2中不需要进行任何的配置,就可以直接将一个简单的POJO发布成WebService。其中POJO中所有的public方法将被发布成WebService方法。
下面我们来实现一个简单的POJO,代码如下:
public class SimpleService
{
public String getGreeting(String name)
{
return "你好 " + name;
}
public int getPrice()
{
return new java.util.Random().nextInt(1000);
}
}
在SimpleService类中有两个方法,由于这两个方法都是public方法,因此,它们都将作为WebService方法被发布。
编译SimpleService类后,将SimpleService.class文件放到 录>\webapps\axis2\WEB-INF\pojo目录中(如果没有pojo目录,则建立该目录)。现在 我们已经成功将SimpleService类发布成了WebService。在浏览器地址栏中输入如下的URL: http://localhost:8080/axis2/services/listServices 这时当前页面将显示所有在Axis2中发布的WebService,如图2所示。 图2 在浏览器地址栏中输入如下的两个URL来分别测试getGreeting和getPrice方法:http://localhost:8080/axis2/services/SimpleService/getGreeting?name=bill http://localhost:8080/axis2/services/SimpleService/getPrice 图3和图4分别显示了getGreeting和getPrice方法的测试结果。 图3 getGreeting方法的测试结果 图4 getPrice方法的测试结果 在编写、发布和测试0配置的WebService时应注意如下几点: 1. POJO类不能使用package关键字声明包。 2. Axis2在默认情况下可以热发布WebService,也就是说,将WebService的.class文件复制到pojo目录中时,Tomcat不需要重新启动就可以自动发布WebService。如果想取 消Axis2的热发布功能,可以打开 INF\conf\axis2.xml,找到如下的配置代码: 将true改为false即可。要注意的是,Axis2在默认情况下虽然是热发布,但并不是热更新,也就是说,一旦成功发布了WebService,再想更新该WebService,就必须重启Tomcat。这对于开发人员调试WebService非常不方便,因此,在开发WebService时,可以将Axis2设为热更新。在axis2.xml文件中找到 name="hotupdate">false 3. 在浏览器中测试WebService时,如果WebService方法有参数,需要使用URL的请求参数来指定该WebService方法参数的值,请求参数名与方法参数名要一致,例如,要测试getGreeting方法,请求参数名应为name,如上面的URL所示。 4. 发布WebService的pojo目录只是默认的,如果读者想在其他的目录发布WebService,可以打开axis2.xml文件,并在 上面的配置允许在 三、用Java实现调用WebService的客户端程序 WebService是为程序服务的,只在浏览器中访问WebService是没有意义的。因此,在本节使用Java实现了一个控制台程序来调用上一节发布的WebService。调用WebService 的客户端代码如下: package client; import https://www.sodocs.net/doc/8a17676574.html,space.QName; import org.apache.axis2.addressing.EndpointReference; import org.apache.axis2.client.Options; import org.apache.axis2.rpc.client.RPCServiceClient; public class RPCClient { public static void main(String[] args) throws Exception { // 使用RPC方式调用WebService RPCServiceClient serviceClient = new RPCServiceClient(); Options options = serviceClient.getOptions(); // 指定调用WebService的URL EndpointReference targetEPR = new EndpointReference( "http://localhost:8080/axis2/services/SimpleService"); options.setTo(targetEPR); // 指定getGreeting方法的参数值 Object[] opAddEntryArgs = new Object[] {"超人"}; // 指定getGreeting方法返回值的数据类型的Class对象 Class[] classes = new Class[] {String.class}; // 指定要调用的getGreeting方法及WSDL文件的命名空间 QName opAddEntry = new QName("https://www.sodocs.net/doc/8a17676574.html,/axis2", "getGreeti ng"); // 调用getGreeting方法并输出该方法的返回值 System.out.println(serviceClient.invokeBlocking(opAddEntry, opAddEntryArg s, classes)[0]); // 下面是调用getPrice方法的代码,这些代码与调用getGreeting方法的代码类似 classes = new Class[] {int.class}; opAddEntry = new QName("https://www.sodocs.net/doc/8a17676574.html,/axis2", "getPrice"); System.out.println(serviceClient.invokeBlocking(opAddEntry, new Object[]{ }, classes)[0]); } } 运行上面的程序后,将在控制台输出如下的信息: 你好超人 443 在编写客户端代码时应注意如下几点: 1. 客户端代码需要引用很多Axis2的jar包,如果读者不太清楚要引用哪个jar包,可以在Eclipse的工程中引用Axis2发行包的lib目录中的所有jar包。 2. 在本例中使用了RPCServiceClient类的invokeBlocking方法调用了WebService中的方法。invokeBlocking方法有三个参数,其中第一个参数的类型是QName对象,表示要调用的方法名;第二个参数表示要调用的WebService方法的参数值,参数类型为 Object[];第三个参数表示WebService方法的返回值类型的Class对象,参数类型为Class[]。当方法没有参数时,invokeBlocking方法的第二个参数值不能是null,而要使用new Object[]{}。 3. 如果被调用的WebService方法没有返回值,应使用RPCServiceClient类的invokeRobust方法,该方法只有两个参数,它们的含义与invokeBlocking方法的前两个参数的含义相同。 4. 在创建QName对象时,QName类的构造方法的第一个参数表示WSDL文件的命名空间名,也就是 xmlns:ns="https://www.sodocs.net/doc/8a17676574.html,/axis2" xmlns:wsaw="https://www.sodocs.net/doc/8a17676574.html,/2006/ 05/addressing/wsdl" xmlns:http="https://www.sodocs.net/doc/8a17676574.html,/wsdl/http/" xmlns:xs="http://www.w3. org/2001/XMLSchema" xmlns:mime="https://www.sodocs.net/doc/8a17676574.html,/wsdl/mime/" xmlns:soap="http://sch https://www.sodocs.net/doc/8a17676574.html,/wsdl/soap/" xmlns:soap12="https://www.sodocs.net/doc/8a17676574.html,/wsdl/soap12/" targetNamespace="https://www.sodocs.net/doc/8a17676574.html,/axis2"> 四、用wsdl2java简化客户端的编写 也许有很多读者会说“有没有搞错啊,只调用两个WebService方法用要写这么多代码,太麻烦了”。 不过幸好Axis2提供了一个wsdl2java.bat命令可以根据WSDL文件自动产生调用WebService的代码。wsdl2java.bat命令可以在 在Windows控制台输出如下的命令行来生成调用WebService的代码: %AXIS2_HOME%\bin\wsdl2java -uri http://localhost:8080/axis2/services/SimpleService?wsdl -p client -s -o stub 其中-url参数指定了wsdl文件的路径,可以是本地路径,也可以是网络路径。-p参数指定了生成的Java类的包名,-o参数指定了生成的一系列文件保存的根目录。在执行完上面的命令后,读者就会发现在当前目录下多了个stub目录,在."stub"src"client目录可以找到一个SimpleServiceStub.java文件,该文件复杂调用WebService,读者可以在程序中直接使用这个类,代码如下: package client; import https://www.sodocs.net/doc/8a17676574.html,space.QName; import org.apache.axis2.addressing.EndpointReference; import org.apache.axis2.client.Options; import org.apache.axis2.rpc.client.RPCServiceClient; public class StubClient { public static void main(String[] args) throws Exception { SimpleServiceStub stub = new SimpleServiceStub(); SimpleServiceStub.GetGreeting gg = new SimpleServiceStub.GetGreeting(); gg.setName("比尔"); System.out.println( stub.getGreeting(gg).get_return()); System.out.println(stub.getPrice().get_return()); } } 上面的代码大大简化了调用WebService的步骤,并使代码更加简洁。但要注意的是,wsdl2java.bat命令生成的Stub类将WebService方法的参数都封装在了相应的类中,类名为方法名,例如,getGreeting方法的参数都封装在了GetGreeting类中,要想调用getGreeting方法,必须先创建GetGreeting类的对象实例。 五、使用C#调用WebService 从理论上说,WebService可以被任何支持SOAP协议的语言调用。在Visual Studio中使用C#调用WebService是在所有语言中最容易实现的(https://www.sodocs.net/doc/8a17676574.html,的调用方法类似,也同样很简单)。 新建一个Visual Studio工程,并在引用Web服务的对话框中输入如下的URL,并输入Web引用名为“WebService”: http://localhost:8080/axis2/services/SimpleService?wsdl 然后引用Web服务的对话框就会显示该WebService中的所有的方法,如图5所示。 图5 在完成上面的工作后,只需要如下三行C#代码就可以调用getGreeting和getPrice方法,并显示这两个方法的返回值: WebService.SimpleService simpleService = new WSC.WebService.SimpleService( ); MessageBox.Show( simpleService.getGreeting("比尔")); MessageBox.Show(simpleService.getPrice().@return.ToString()); 在.net解析WSDL文件时直接将getGreeting方法的参数映射为String类型,因此,可以直接进行传值。 从上面的调用过程可以看出,添加Web引用的过程就相当于在Java中调用 wsdl2java.bat自动生成stub类的过程。只是在调用stub类时与C#有一定的区别,但从总体上来说,都大大简化了调用WebService的过程。 WebService大讲堂之Axis2(2):复合类型数据的传递 在实际的应用中,不仅需要使用WebService来传递简单类型的数据,有时也需要传递更复杂的数据,这些数据可以被称为复合类型的数据。数组与类(接口)是比较常用的复合类型。在Axis2中可以直接使用将WebService方法的参数或返回值类型声明成数组或类(接口)。但要注意,在定义数组类型时只能使用一维数组,如果想传递多维数组,可以使用分隔符进行分隔,如下面的代码所示: String[] strArray = new String[]{ "自行车,飞机,火箭","中国,美国,德国", "超人,蜘蛛侠,钢铁侠" } ; 上面的代码可以看作是一个3*3的二维数组。 在传递类的对象实例时,除了直接将数组类型声明成相应的类或接口,也可以将对象实例进行序列化,也就是说,将一个对象实例转换成字节数组进行传递,然后接收方再进行反序列化,还原这个对象实例。 下面的示例代码演示了如何传递数组与类(接口)类型的数据,并演示如何使用字节数组上传图像。本示例的客户端代码使用Java和C#编写。要完成这个例子需要如下几步: 一、实现服务端代码 ComplexTypeService是一个WebService类,该类的代码如下: import java.io.FileOutputStream; import data.DataForm; public class ComplexTypeService { // 上传图像,imageByte参数表示上传图像文件的字节, // length参数表示图像文件的字节长度(该参数值可能小于imageByte的数组长度)public boolean uploadImageWithByte(byte[] imageByte, int length) { FileOutputStream fos = null; try { // 将上传的图像保存在D盘的test1.jpg文件中 fos = new FileOutputStream("d:\\test1.jpg"); // 开始写入图像文件的字节 fos.write(imageByte, 0, length); fos.close(); } catch (Exception e) { return false; } finally { if (fos != null) { try { fos.close(); } catch (Exception e) { } } } return true; } // 返回一维字符串数组 public String[] getArray() { String[] strArray = new String[]{ "自行车", "飞机", "火箭" }; return strArray; } // 返回二维字符串数组 public String[] getMDArray() { String[] strArray = new String[]{ "自行车,飞机,火箭","中国,美国,德国", "超人,蜘蛛侠,钢铁侠" } ; return strArray; } // 返回DataForm类的对象实例 public DataForm getDataForm() { return new DataForm(); } // 将DataForm类的对象实例序列化,并返回序列化后的字节数组 public byte[] getDataFormBytes() throws Exception { java.io.ByteArrayOutputStream baos = new java.io.ByteArrayOutputStream (); java.io.ObjectOutputStream oos = new java.io.ObjectOutputStream(baos); oos.writeObject(new DataForm()); return baos.toByteArray(); } } 二、实现DataForm类 DataForm是要返回的对象实例所对应的类,该类的实现代码如下: package data; public class DataForm implements java.io.Serializable { private String name = "bill"; private int age = 20; public String getName() { return name; } public void setName(String name) { https://www.sodocs.net/doc/8a17676574.html, = name; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } } 三、发布WebService 由于本示例的WebService类使用了一个Java类(DataForm类),因此,在发布WebService之前,需要先将DataForm.class文件复制到 录>\webapps\axis2\WEB-INF\classes\data目录中,然后将ComplexTypeService.class文件复制到 四、使用Java编写调用WebService的客户端代码 在客户端仍然使用了RPC的调用方式,代码如下: package client; import https://www.sodocs.net/doc/8a17676574.html,space.QName; import org.apache.axis2.addressing.EndpointReference; import org.apache.axis2.client.Options; import org.apache.axis2.rpc.client.RPCServiceClient; public class ComplexTypeRPCClient { public static void main(String[] args) throws Exception { RPCServiceClient serviceClient = new RPCServiceClient(); Options options = serviceClient.getOptions(); EndpointReference targetEPR = new EndpointReference( "http://localhost:8080/axis2/services/ComplexTypeService"); options.setTo(targetEPR); // 下面的代码调用uploadImageWithByte方法上传图像文件 ///////////////////////////////////////// // 打开图像文件,确定图像文件的大小 java.io.File file = new java.io.File("f:\\images.jpg"); java.io.FileInputStream fis = new java.io.FileInputStream("f:\\images.jpg"); // 创建保存要上传的图像文件内容的字节数组 byte[] buffer = new byte[(int) file.length()]; // 将图像文件的内容读取buffer数组中 int n = fis.read(buffer); System.out.println("文件长度:" + file.length()); Object[] opAddEntryArgs = new Object[]{ buffer, n }; Class[] classes = new Class[]{ Boolean.class }; QName opAddEntry = new QName("https://www.sodocs.net/doc/8a17676574.html,/axis2","uploadIm ageWithByte"); fis.close(); // 开始上传图像文件,并输出uploadImageWithByte方法的返回传 System.out.println(serviceClient.invokeBlocking(opAddEntry,opAddEntryArg s, classes)[0]); ///////////////////////////////////////// // 下面的代码调用了getArray方法,并返回一维String数组 ///////////////////////////////////////// opAddEntry = new QName("https://www.sodocs.net/doc/8a17676574.html,/axis2", "getArray"); String[] strArray = (String[]) serviceClient.invokeBlocking(opAddEntry, new Object[]{}, new Class[]{String[].class })[0]; for (String s : strArray) System.out.print(s + " "); System.out.println(); ///////////////////////////////////////// // 下面的代码调用了getMDArray方法,并返回一维String数组 ///////////////////////////////////////// opAddEntry = new QName("https://www.sodocs.net/doc/8a17676574.html,/axis2", "getMDArray"); strArray = (String[]) serviceClient.invokeBlocking(opAddEntry, new Object[] {}, new Class[]{String[].class})[0]; for (String s : strArray) { String[] array = s.split(","); for(String ss: array) System.out.print("<" + ss + "> "); System.out.println(); } System.out.println(); ///////////////////////////////////////// // 下面的代码调用了getDataForm方法,并返回DataForm对象实例///////////////////////////////////////// opAddEntry = new QName("https://www.sodocs.net/doc/8a17676574.html,/axis2", "getDataForm"); data.DataForm df = (data.DataForm) serviceClient.invokeBlocking(opAddEnt ry, new Object[]{}, new Class[]{data.DataForm.class}) [0]; System.out.println(df.getAge()); ///////////////////////////////////////// // 下面的代码调用了getDataFormBytes方法,并返回字节数组,最后将返回的字节数组反序列化后,转换成DataForm对象实例 ///////////////////////////////////////// opAddEntry = new QName("https://www.sodocs.net/doc/8a17676574.html,/axis2", "getDataFormByte s"); buffer = (byte[]) serviceClient.invokeBlocking(opAddEntry, new Object[]{}, new Class[]{byte[].class})[0]; java.io.ObjectInputStream ois = new java.io.ObjectInputStream( new java.io.ByteArrayInputStream(buffer)); df = (data.DataForm) ois.readObject(); System.out.println(df.getName()); ////////////////////////////////////////// } } 运行上面的程序,将输出如下的内容: 文件长度:3617 true 自行车飞机火箭 <自行车> <飞机> <火箭> <中国> <美国> <德国> <超人> <蜘蛛侠> <钢铁侠> 20 bill 五、使用C#编写调用WebService的客户端代码 在Visual Studio中使用WebService就简单得多。假设引用WebService时的引用名为complexType,则下面的代码调用了uploadImageWithByte方法来上传图像文件。在Visual Studio引用WebService时,uploadImageWithByte方法多了两个out参数,在使用时要注意。 https://www.sodocs.net/doc/8a17676574.html,plexTypeService cts = new https://www.sodocs.net/doc/8a17676574.html,plexTypeSer vice(); System.IO.FileStream fs = new System.IO.FileStream(@"f:\images.jpg", System. IO.FileMode.Open); byte[] buffer = new byte[fs.Length]; fs.Read(buffer, 0, (int)fs.Length); bool r; bool rs; cts.uploadImageWithByte( buffer, (int)fs.Length, true, out r, out rs); 在获得二维数组时,可以将数据加载到DataGridView或其他类似的控件中,代码如下:String[] strArray = cts.getMDArray(); for (int i = 0; i < strArray.Length; i++) { // 用正则表达式将带分隔符的字符串转换成String数组 String[] columns = strArray[i].Split(','); // 如果DataGridView的表头不存在,向DataGridView控件添加三个带表头的列if (dataGridView1.Columns.Count == 0) for (int j = 0; j < columns.Length; j++) dataGridView1.Columns.Add("column" + (j + 1).ToString(), "列 " + (j + 1).ToString()); // 添加行 dataGridView1.Rows.Add(1); for(int j = 0; j < columns.Length; j++) { dataGridView1.Rows[i].Cells[j].Value = columns[j]; } } 向DataGridView控件添加数据后的效果如图1所示。 图1 对于其他的WebService方法的调用都非常简单,读者可以自己做这个实验。 要注意的是,由于.net和java序列化和反序列化的差异,通过序列化的方式传递对象实例只使用于客户端与服务端为同一种语言或技术的情况,如客户端和服务端都使用Java来编写。 如果读者要上传大文件,应尽量使用FTP的方式来传递,而只通过WebService方法来传递文件名等信息。这样有助于提高传输效率。 WebService大讲堂之Axis2(3):使用services.xml文件发布WebService 用Axis2实现Web Service,虽然可以将POJO类放在axis2\WEB-INF\pojo目录中直接发布成Web Service,这样做不需要进行任何配置,但这些POJO类不能在任何包中。这似乎有些不方便,为此,Axis2也允许将带包的POJO类发布成Web Service。 先实现一个POJO类,代码如下: package service; public class MyService { public String getGreeting(String name) { return "您好 " + name; } public void update(String data) { System.out.println("<" + data + ">已经更新"); } } 这个类有两个方法,这两个方法都需要发布成Web Service方法。这种方式和直接放在pojo目录中的POJO类不同。要想将MyService类发布成Web Service,需要一个services.xml文件,这个文件需要放在META-INF目录中,该文件的内容如下: Web Service例子 service.MyService class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/> 其中 http://localhost:8080/axis2/services/myService?wsdl 其中name属性名就是上面URL中"?"和"/"之间的部分。 使用这种方式发布WebService,必须打包成.aar文件,..aar文件实际上就是改变了扩展名的.jar文件。在现在建立了两个文件:MyService.java和services.xml。将MyService.java编译,生成MyService.class。services.xml和MyService.class文件的位置如下: D:\ws\service\MyService.class D:\ws\META-INF\services.xml 在windows控制台中进入ws目录,并输入如下的命令生成.aar文件(实际上,.jar文件也可以发布webservice,但axis2官方文档中建议使用.aar文件发布webservice): jar cvf ws.aar . 最后将ws.aar文件复制到 另外services.xml文件中也可以直接指定WebService类的方法,如可以用下面的配置代码来发布WebService: Web Service例子 service.MyService class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/> 上面的配置代码前面的部分和以前的services.xml文件的内容相同,但后面使用了 如果想发布多个WebService,可以使用 package service public class MyService1 { public String getName() { return "bill"; } } 在services.xml文件中可以使用如下的配置代码来配置MyService和MyService1类: Web Service例子 service.MyService class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/> Web Service例子 service.MyService1 class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/> 下一篇:WebService大讲堂之Axis2(4):二进制文件传输 在《WebService大讲堂之Axis2(2):复合类型数据的传递》中讲过,如果要传递二进制文件(如图像、音频文件等),可以使用byte[]作为数据类型进行传递,然后客户端使用RPC方式进行调用。这样做只是其中的一种方法,除此之外,在客户端还可以使用wsdl2java 命令生成相应的stub类来调用WebService,wsdl2java命令的用法详见《WebService大讲堂之Axis2(1):用POJO实现0配置的WebService》。 WebService类中包含byte[]类型参数的方法在wsdl2java生成的stub类中对应的数据类型不再是byte[]类型,而是javax.activation.DataHandler。DataHandler类是专门用来映射WebService二进制类型的。 在WebService类中除了可以使用byte[]作为传输二进制的数据类型外,也可以使用javax.activation.DataHandler作为数据类型。不管是使用byte[],还是使用 javax.activation.DataHandler作为WebService方法的数据类型,使用wsdl2java命令生成的stub类中相应方法的类型都是javax.activation.DataHandler。而象使用.net、delphi生成的stub类的相应方法类型都是byte[]。这是由于 javax.activation.DataHandler类是Java特有的,对于其他语言和技术来说,并不认识javax.activation.DataHandler类,因此,也只有使用最原始的byte[]了。 下面是一个上传二进制文件的例子,WebService类的代码如下: package service; import java.io.InputStream; import java.io.OutputStream; import java.io.FileOutputStream; import javax.activation.DataHandler; public class FileService { // 使用byte[]类型参数上传二进制文件 public boolean uploadWithByte(byte[] file, String filename) { FileOutputStream fos = null; try { fos = new FileOutputStream(filename); fos.write(file); fos.close(); } catch (Exception e) { return false; } finally { if (fos != null) { try { fos.close(); } catch (Exception e) { } } } return true; } private void writeInputStreamToFile(InputStream is, OutputStream os) throws Exception { int n = 0; byte[] buffer = new byte[8192]; while((n = is.read(buffer)) > 0) { os.write(buffer, 0, n); } } // 使用DataHandler类型参数上传文件 public boolean uploadWithDataHandler(DataHandler file, String filename) { FileOutputStream fos = null; try { fos = new FileOutputStream(filename); // 可通过DataHandler类的getInputStream方法读取上传数据 writeInputStreamToFile(file.getInputStream(), fos); fos.close(); } catch (Exception e) { return false; } finally { if (fos != null) { try { fos.close(); } catch (Exception e) { } } } return true; } } 上面代码在services.xml文件的配置代码如下: 文件服务 service.FileService class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/> Web Service 的基本概念 Web Service也叫XML Web Service WebService是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求,轻量级的独立的通讯技术。是:通过SOAP在Web上提供的软件(服务),使用WSDL文件进行(说明),并通过(UDDI)进行注册。 XML:(Extensible Markup Language)扩展型可标记语言。面向短期的临时数据处理、面向万维网络,是Soap的基础。 Soap:(Simple Object Access Protocol)简单对象存取协议。是XML Web Service 的通信协议。当用户通过UDDI找到你的WSDL描述文档后,他通过可以SOAP 调用你建立的Web服务中的一个或多个操作。SOAP是XML文档形式的调用方法的规范,它可以支持不同的底层接口,像HTTP(S)或者SMTP。 WSDL:(Web Services Description Language) WSDL 文件是一个XML 文档,用于说明一组 SOAP 消息以及如何交换这些消息。大多数情况下由软件自动生成和使用。 UDDI (Universal Description, Discovery, and Integration) 是一个主要针对Web服务供应商和使用者的新项目。在用户能够调用Web服务之前,必须确定这个服务内包含哪些商务方法,找到被调用的接口定义,还要在服务端来编制软件,UDDI是一种根据描述文档来引导系统查找相应服务的机制。UDDI利用SOAP消息机制(标准的XML/HTTP)来发布,编辑,浏览以及查找注册信息。它采用XML格式来封装各种不同类型的数据,并且发送到注册中心或者由注册中心来返回需要的数据。 概念补充: http soap关系 http:是一个客户端和服务器端请求和应答的标准(TCP)。http协议其目的是为了提供一种发布和接收htttp页面的方法 一http协议的客户端与服务器的交互:由HTTP客户端发起一个请求,建立一个到服务器指定端口(默认是80端口)的TCP连接。HTTP服务器则在那个端口监听客户端发送过来的请求。一旦收到请求,服务器(向客户端)发回一个状态行,比如"HTTP/1.1 200 OK",和(响应的)消息,消息的消息体可能是请求的文件、错误消息、或者其它一些信息。 webservice注解详解 javax.jws.WebService 当实现Web Service 时,@WebService 注释标记Java 类;实现Web Service 接口时,标记服务端点接口(SEI)。 要点: ? 实现Web Service 的Java 类必须指定@WebService 或@WebServiceProvider 注释。不能同时提供这两种注释。 此注释适用于客户机/服务器SEI 或JavaBeans 端点的服务器端点实现类。 ? 如果注释通过endpointInterface属性引用了某个SEI,那么还必须使用@WebService 注释来注释该SEI。 ? 请参阅适用于使用@WebService 注释的类的方法的规则,以了解更多信息 ?注释目标:类型 ?属性: - name wsdl:portType的名称。缺省值为Java 类或接口的非限定名称。(字符串)- targetNamespace 指定从Web Service 生成的WSDL 和XML 元素的XML 名称空间。缺省值为从包含该Web Service 的包名映射的名称空间。(字符串) - serviceName 指定Web Service 的服务名称:wsdl:service。缺省值为Java 类的简单名称 + Service。(字符串) - endpointInterface 指定用于定义服务的抽象Web Service 约定的服务端点接口的限定名。如果指定了此限定名,那么会使用该服务端点接口来确定抽象WSDL 约定。(字符串)- portName wsdl:portName。缺省值为https://www.sodocs.net/doc/8a17676574.html,+Port。(字符串) Web Service学习笔记(1) Web Service的宗旨是创建不需要用户界面就能与其他应用程序交互的Web应用程序。 举例说明它的优点,假如你正在为一家股票投资公司创建网站,你并不需要把不同证劵交易所得数据库与自己的后台数据库进行整合,因为你的应用程序可以使用Web Service,并使用XML格式交换数据。 Web Service是松耦合的,它与服务器端和客户端使用的操作系统、编程语言都无关。假如你既拥有客户端又有服务器端的访问和管理权,这种情况更适合用.NET 的Remoting技术,而不是Web service。 创建Web Service必须保证的是,服务器端和客户端都要支持HTTP、SOAP(简单对象访问协议)和XML等行业标准协议。 Web Service是如何工作的 Web Service允许两个程序之间交换XML文档。在这个架构的顶层,微软实现了一个远程过程调用(Remote Procedure Call,PRC)模型。 Web Service架构包括以下特性: 1。WebServcie的服务器端和客户端应用程序都能够连接到互联网。 2。用于进行通信的数据格式必须遵守相同的开放标准,并且在大多数情况下,这个标准几乎总是SOAP。 3。客户端和服务器端的系统是松耦合的。即Web Service不关心客户端和服务器端所使用的操作系统、对象模型或者编程语言。只要Web Service和使用Web Service的应用程序都能够发送和接收遵守适当协议标准的消息即可。 下图为Web Service流程的逻辑架构 如图所示,一个Web Service使用着会向Web Service发出一个调用请求。使用者会认为它通过Internet直接和Web Service进行交流,当然这实际上是个幻象。实际上,真正的调用由代理类完成。代理类对于Web Service使用者来说是一个本地类。代理会处理所有的负责的复杂架构,包括通过Internet发送请求道服务器、从web Service取回结果并呈现给Web Service使用者。 由于代理类在之前已在消费程序中注册,所有一切工作才可以顺利进行。注册有开发消费程序的程序员完成。 开发Web Service 开发Web Service的流程与开发网页的流程近乎一致: 1。所有构成网页和服务的源文件都是文本文件,它们可以使用任何文本编辑器创建和修改。而类文件可以在控制台命令行中通过命令工具进行编译。 2。可以在vs2005及以上版本中创建网页和Web Service 3。网页和Web Service既可以使用代码隐藏模型,也可以使用内联编码(inline coding)模型。Web Service中不需要使用代码隐藏技术,因为Web Service并不包括任何可视化内容。 4。网页和Web Service都充分利用了CLR和.NET Framework。 XMLWebService完全实例详细解析 首先,我们必须了解什么是webservice.就概念上来说,可能比较复杂,不过我们可以有个宏观的了解:webservice就是个对外的接口,里面有函数可供外部客户调用(注意:里面同样有客户不可调用的函数).假若我们是服务端,我们写好了个webservice,然后把它给了客户(同时我们给了他们调用规则),客户就可以在从服务端获取信息时处于一个相对透明的状态.即是客户不了解(也不需要)其过程,他们只获取数据. webservice传递的数据只能是序列化的数据,典型的就是xml数据,这里我们也只讨论XML数据的传输. 有了一些对XML webservice的初步了解后,我们将切入正题,即是用一个具体的webservice事例的形式来讲解具体的webservice用法,用具体的事例来讲解一个概念我想怎么也要比单纯的说理能让人容易理解吧. 这里,我们将以一个简单的分布式课件搜索系统为例来讲解.使用VS2003为编译环境,C#为语言,SqlServcer2000为数据库.(这个例子来源于一位网上朋友的文章的启发,觉得很能代表webservice的特点,就按那个想法做了这么个系统来示例了) 首先,明确我们要做什么.我们需要一个对客户的接口,也就是个站点,我们把它称做ServiceGatherSite,它是何种形式都无所谓,甚至它本身并不需要数据库,它只是提供给用户一个查询的接口,真正的服务,普通用户是不接触到的.然后,这里我们还需要若干个提供服务的站点,我们可以称它们为资源站,这里为简单起见,假设有两个资源站,分别叫WebSiteA,WebSiteB,它们可以是不对外公布的,只是为了丰富查询数据而存在.最后,是我们最需要关注的东西---资源站提供给ServiceGatherSite的服务.两个资源站,就有两个服务,我们称为SiteAService和 SiteBService.两个服务间没有任何关系,内部提供的方法也完全没关联,只是需要把方法如何使用告诉ServiceGatherSite,意思是,服务只提供查询接口,返回的数据如何处理,服务本身并不管,全由使用服务的站点分配. 写了这么多,算是简要的介绍了下有关XML webservice的概念和我们这个例子的结构,下篇文章,我们将开始真正进入代码的设计阶段. 上篇文章介绍了些webservice的基本特性和我们例子的结构,这篇文章我们将开始具体的代码编写工作. SAP开发webservice接口教程 在client=100中进行开发: 1.创建RFC函数 SE80,在函数组下,右击->创建,创建函数模块,填写函数模块名称及描述。 2.函数属性标签页,选择“远程启用的模块”,其余默认不变。 3.函数导入标签页,需要添加调用时传入的参数(表),“传递值”需勾选。 表类型:ZSHR_EMPLOYEER_T (需要自己创建) 行类型:ZSHR_EMPLOYEER (需要自己创建) 4.函数导出标签页,需要添加调用返回的参数(表),“传递值”需勾选。 表类型:ZSHR_EMPLOYEER_OUT_T (需要自己创建) 行类型:ZSHR_EMPLOYEER_OUT (需要自己创建) 5.函数源代码标签页,需要写代码实现把传入的数据保存在透明表中。 至此,函数创建完成。 6.创建Web Services 右击包名创建企业服务,进入如下页面,选择“Service Provider”,因为我们是服务提供者,点击“继续”。 7.选择“Existing ABAP Object (Inside Out)”,点击“继续”。 8.给服务起名,并填写描述,点击“继续” 9.选择“Function Module”,点击“继续”。 10.填写我们第一步创建的函数,并勾选“Map Name”,点击“继续”。 11.SOAP Appl默认不变,Profie下拉框选择第四个选择,即不进行权限认证。点击“继续”。 12.填写对于的包和请求,点击“继续”。 下一步,直接点击“完成”。服务创建成功。 13.配置SOA 使用T-CODE:soamanager,进入web页面的SOA管理(client=100)。 14.点击“简化Web服务配置”,进入如下设置页面,点击“执行”,从列表中找到自己创建的 服务,勾选第一个checkbox,User Name/Password(basic),点击列表左上角的“保存”,之后页面右上角的“返回”按钮,返回首页。 这一步设置,代表我们只设置用户名/密码的调用认证方式。 javax.jws.WebService 当实现Web Service 时,@WebService注释标记Java 类;实现Web Service 接口时,标记服务端点接口(SEI)。 要点: ? 实现Web Service 的Java 类必须指定@WebService 或@WebServiceProvider 注释。 不能同时提供这两种注释。 此注释适用于客户机/服务器SEI 或JavaBeans 端点的服务器端点实现类。 ? 如果注释通过endpointInterface属性引用了某个SEI,那么还必须使用@WebService 注释来注释该SEI。 ? 请参阅适用于使用@WebService 注释的类的方法的规则,以了解更多信息 ?注释目标:类型 ?属性: - name wsdl:portType的名称。缺省值为Java 类或接口的非限定名称。(字符串)- targetNamespace 指定从Web Service 生成的WSDL 和XML 元素的XML 名称空间。缺省值为从包 含该Web Service 的包名映射的名称空间。(字符串) - serviceName 指定Web Service 的服务名称:wsdl:service。缺省值为Java 类的简单名称 + Service。(字符串) - endpointInterface 指定用于定义服务的抽象Web Service 约定的服务端点接口的限定名。如果指定了此 限定名,那么会使用该服务端点接口来确定抽象WSDL 约定。(字符串) - portName wsdl:portName。缺省值为https://www.sodocs.net/doc/8a17676574.html,+Port。(字符串) 【WebService】接口的测试方法 有以下多种方式: 一、通过WSCaller.jar工具进行测试: 前提:知道wsdl的url。 wsCaller可执行程序的发布方式为一个wsCaller.jar包,不包含Java运行环境。你可以把wsCaller.jar复制到任何安装了Java运行环境(要求安装JRE/JDK 1.3.1或更高版本)的计算机中,用以下命令运行wsCaller: java -jar wsCaller.jar 使用wsCaller软件的方法非常简单,下面是wsCaller的主界面: 首先在WSDL Location输入框中输入你想调用或想测试的Web Service的WSDL位置,如“https://www.sodocs.net/doc/8a17676574.html,/axis/services/StockQuoteService?wsdl”,然后点“Find”按钮。wsCaller就会检查你输入的URL地址,并获取Web Service的WSDL信息。如果信息获取成功,wsCaller会在Service和Operation下拉列表框中列出该位置提供的Web Service服务和服务中的所有可调用的方法。你可以在列表框中选择你要调用或测试的方法名称,选定后,wsCaller窗口中间的参数列表框就会列出该方法的所有参数,包括每个参数的名 称、类型和参数值的输入框(只对[IN]或[IN, OUT]型的参数提供输入框)。你可以输入每个参数的取值。如下图: 这时,如果你想调用该方法并查看其结果的话,只要点下面的“Invoke”按钮就可以了。如果你想测试该方法的执行时间,则可以在“Invoke Times”框中指定重复调用的次数,然后再按“Invoke”按钮。wsCaller会自动调用你指定的方法,如果调用成功,wsCaller会显示结果对话框,其中包括调用该方法所花的总时间,每次调用的平均时间和该方法的返回值(包括返回值和所有输出型的参数)。如下图: C#调用WebService实例和开发 一、基本概念 Web Service也叫XML Web Service WebService是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求,轻量级的独立的通讯技术。是:通过SOAP在Web上提供的软件服务,使用WSDL文件进行说明,并通过UDDI进行注册。简单的理解就是:webservice就是放在服务器上的函数,所有人都可以调用,然后返回信息。比如google就有一个web service,你调用它就可以很容易的做一个搜索网站。就像调用函数一样,传入若干参数(比如关键字、字符编码等),然后就能返回google检索的内容(返回一个字符串)。其中, Soap:(Simple Object Access Protocol)简单对象存取协议。是XML Web Service 的通信协议。当用户通过UDDI找到你的WSDL描述文档后,他通过可以SOAP调用你建立的Web服务中的一个或多个操作。SOAP是XML文档形式的调用方法的规范,它可以支持不同的底层接口,像HTTP(S)或者SMTP。 WSDL:(Web Services Description Language)WSDL文件是一个XML文档,用于说明一组SOAP消息以及如何交换这些消息。大多数情况下由软件自动生成和使用。 UDDI(Universal Description,Discovery,and Integration)是一个主要针对Web服务供应商和使用者的新项目。在用户能够调用Web服务之前,必须确定这个服务内包含哪些商务方法,找到被调用的接口定义,还要在服务端来编制软件,UDDI是一种根据描述文档来引导系统查找相应服务的机制。UDDI利用SOAP 消息机制(标准的XML/HTTP)来发布,编辑,浏览以及查找注册信息。它采用XML格式来封装各种不同类型的数据,并且发送到注册中心或者由注册中心来返回需要的数据。 二、优点缺点 Web Service的主要目标是跨平台的可互操作性。为了实现这一目标,Web Service完全基于XML(可扩展标记语言)、XSD(XML Schema)等独立于平台、独立于软件供应商的标准,是创建可互操作的、分布式应用程序的新平台。因此使用Web Service有许多优点: 1、跨防火墙的通信 如果应用程序有成千上万的用户,而且分布在世界各地,那么客户端和服务器之间的通信将是一个棘手的问题。因为客户端和服务器之间通常会有防火墙或者代理服务器。传统的做法是,选择用浏览器作为客户端,写下一大堆ASP页面,把应用程序的中间层暴露给最终用户。这样做的结果是开发难度大,程序很难维护。要是客户端代码不再如此依赖于HTML表单,客户端的编程就简单多了。如果中间层组件换成Web Service的话,就可以从用户界面直接调用中间层组件, Eclipse下WebService学习 文档作者:weichaoduo 日期:2006.7.7 1.准备工作 收集相关资料,下载并安装必备的工具。由于以前对WebService学习不是很重视,因此对WebService还不是很熟悉,不过我还是对它有些印象的,因为以前我曾经使用Delphi 和https://www.sodocs.net/doc/8a17676574.html,做过相关的例子。阅读几遍的相关资料后对有些抽象的概念还是有些模糊,但总体上认清了WebService的本质或者是用途吧。WebService其实就是向外部(跨语言甚至平台)公开一些函数方法等等内容,使外部能访问到所要发布的“服务”。几经周折终于完成了WebSerrvice环境的配置工作。 相关资料有: ●《Tomcat5.0.28下AXIS完全安装手册》 ●《详解怎样使用Axis开发Web Service的实例.》 ●《SOAP 是如何工作的》 ●《SOAP的协议规范》 ●《SOAP净化有线协议》 ●〈Web Services技術介紹〉 相关工具: ●Sun java JDK1.5 ●Apache Tomcat5.0/5.5 ●SUN JWSDP开发包 ●Axis开发包 ●Eeclipse集成开发环境 ●Eclipse插件—Workshop Studio ●Netbeans5.0 安装环境步骤省略。(其实直接下载JDK5。0+Tomcat5.0(最好是SUN公司的jwsdp-1_4-windows-i586.exe) + Workshop Studio就可以了) 2.初探Java中的WebService 首先按着资料上的例子做,利用JWS方法,建立一个温度转换的Java函数,然后发布出来,并最终调用它。步骤如下: (1)打开Eclipse配置好相关的环境,新建立一个”动态Web应用程序”—>新建立一个类 在该类中写入温度转换函数。如下列图: 图2.1 建立新的”动态Web应用程序“ 感谢你使用由济南职业学院小小鸟团队开发的基于Web Service的3G手机应用《小小翻译》软件。请在使用该软件之前认真阅读配套的用户操作手册,当您开始使用软件时,小小鸟团队认为您已经阅读了本使用手册。本用户操作手册的内容将随着词典软件的更新而改变,恕不另行通知。 《小小翻译》将进行不断的升级。无论是功能的增加、性能的提高还是各种版本的增加,都关系到其实际的使用价值。所以,在使用本产品的过程中请您随时关注本团队的网站,以便及时获得升级程序或更新换代产品。 客户忠告 请将所购产品认真进行核对,以确定产品的完整性。确认购买的产品为小小鸟队正版产品。 在使用本系统之前请您一定要认真阅读本操作手册,由于用户违规操作所导致的软件问题均有用户承担,特此声明! 最终解释权归本团队所有! 小小鸟队联系方式 如果遇到了问题,在您寻求技术支持之前,请务必先仔细阅读本使用手册,或者直接访问济南职业学院小小鸟队网站寻找您遇到的问题和解决办法,我们将尽力帮助您解决问题。若您所遇到的问题仍然没有解决,请发送电子邮件。电子邮件:(网站内有标注,请您从小小鸟团队网站直接发送) 网址: 邮政编码:250103 通信地址:济南市历城区彩石镇 济南职业学院(新校区)09级 软件技术一班 1. 概述 1.1 编写目的 编写用户操作手册的目的在于更好的服务于广大使用者,使用户能够快捷的掌握此软件的各项功能。并且为用户更好的了解此软件提供了便捷的条件。 预期读者:齐鲁软件设计大赛组委会、使用该软件的开发人员。 1.2 背景 1.3 定义 小 小鸟 :小小鸟团队,是由来自济南职业学院09软件班的5位同学组成的开发团队。其开发项目是基于Web Service 的3G 手机应用 。小小鸟,The Little Bird ,刚刚起飞的梦想团队;希望这一段经历可以成为每一个成员的美好回忆。 a. 待开发软件的名称:基于Web Service 的3G 手机应用 b. 本项目提出者:齐鲁软件设计大赛组委会 c. 开发者:济南职业学院 小小鸟团队 d. 预期用户:齐鲁软件设计大赛组委会,使用此软件的开发人员 该软件同其他软件关系:本软件参考《有道词典》设计 第一章proxy(代理)的生成 首先通过se80进入到我们要创建proxy(代理)的package(包)。以我的zhr_password_change程序为例,该程序的目的是帮助用户修改密码,所以进入的是ZHR包。 进入ZHR包后,右键选择Create -> Enterprise Service / Web Service -> Proxy Object,弹出如下选择框: 由于我们是外调Web Service,所以选择Service Consumer选项,并点击继续。随后出现下面的选择界面: 这个选择界面中,如果我们自己的机器就是服务器,那么可以选择Local File,然后给出WSDL文件所在地。不过 一般情况下,我们是通过URL/HTTP访问WSDL文件的。这里,我得到的WSDL文件地址为: http://10.3.11.123/jfids/ChangePwService?wsdl 我们需要先确认这个链接的有效性,可以在浏览器中打开这个链接,如果链接有效,则我们可以看到对应的xml 代码: 将有效的URL地址输入,点击继续,如图: 接下来要选择package(包)和prefix(前缀),package即proxy(代理)所在的包,prefix即代理各种属性(比如名称)、包含数据类型(比如输入数据类型、输出数据类型)等的前缀,主要用于与系统变量进行区分。我这里选择的包是ZHR、前缀为ZCMIS_。 输入包名、前缀后选择继续,此时会出现确认信息: 完成后,会看到workbench request,设置请求号和描述: 然后我们会发现package(包)里出现了Enterprise Service选项,里面包含了代理类及其用到的数据类型。我们需要保存并激活Enterprise Service选项: Android调用WebService WebService是一种基于SOAP协议的远程调用标准,通过webservice可以将不同操作系统平台、不同语言、不同技术整合到一块。在Android SDK中并没有提供调用WebService的库,因此,需要使用第三方的SDK来调用WebService。PC版本的WEbservice客户端库非常丰富,例如Axis2,CXF等,但这些开发包对于Android系统过于庞大,也未必很容易移植到Android系统中。因此,这些开发包并不是在我们的考虑范围内。适合手机的WebService客户端的SDK有一些,比较常用的有Ksoap2,可以从https://www.sodocs.net/doc/8a17676574.html,/p/ksoap2-android/downloads/list进行下载;将下载的ksoap2-android-assembly-2.4-jar-with-dependencies.jar包复制到Eclipse工程的lib目录中,当然也可以放在其他的目录里。同时在Eclipse工程中引用这个jar包。 具体调用调用webservice的方法为: (1)指定webservice的命名空间和调用的方法名,如: SoapObject request =new SoapObject(http://service,”getName”); SoapObject类的第一个参数表示WebService的命名空间,可以从WSDL文档中找到WebService的命名空间。第二个参数表示要调用的WebService方法名。 (2)设置调用方法的参数值,如果没有参数,可以省略,设置方法的参数值的代码如下: Request.addProperty(“param1”,”value”); Request.addProperty(“param2”,”value”); 要注意的是,addProperty方法的第1个参数虽然表示调用方法的参数名,但该参数值并不一定与服务端的WebService类中的方法参数名一致,只要设置参数的顺序一致即可。 (3)生成调用Webservice方法的SOAP请求信息。该信息由SoapSerializationEnvelope对象描述,代码为: SoapSerializationEnvelope envelope=new SoapSerializationEnvelope(SoapEnvelope.VER11); Envelope.bodyOut = request; 创建SoapSerializationEnvelope对象时需要通过SoapSerializationEnvelope类的构造方法设置SOAP协议的版本号。该版本号需要根据服务端WebService的版本号设置。在创建SoapSerializationEnvelope对象后,不要忘了设置SOAPSoapSerializationEnvelope类的bodyOut属性,该属性的值就是在第一步创建的SoapObject对象。 (4)创建HttpTransportsSE对象。通过HttpTransportsSE类的构造方法可以指定WebService的WSDL文档的URL: HttpTransportSE ht=new HttpTransportSE(“http://192.168.18.17:80 /axis2/service/SearchNewsService?wsdl”); (5)使用call方法调用WebService方法,代码: ht.call(null,envelope); Webservice服务端的开发和客户端调用 1 初始化 (2) 1.1 准备一个web项目 (2) 1.2 设置Axis2环境 (2) 2 接口的发布 (3) 2.1 建立WebService 项目 (3) 2.2 WebService配置 (3) 2.2.1 确认要发布的接口的类,选择二级模式(Assemble service)创建 (3) 2.2.2 选择运行Apache Axis2 运行环境 (4) 2.3 将项目打包为EAR (4) 2.4 在Weblogic 服务器上面,添加项目并运行服务器 (4) 2.5 输入url地址,可见发布了的接口 (4) 3 使用soulUI 对接口进行测试 (5) 3.1 测试接口 (5) 4 客户端项目 (6) 4.1 首先建立一个web 项目 (6) 4.2 建立WebService 项目 (6) 4.3 Serverice 定义 (7) 4.4 编写客户端程序,测试运行 (8) 1初始化 1.1准备一个web项目 1.2设置Axis2环境 2接口的发布 2.1建立WebService 项目 先选择一个接口实现类→new →Web Services →Web Service 2.2WebService配置 2.2.1确认要发布的接口的类,选择二级模式(Assemble service)创建 2.2.2选择运行Apache Axis2 运行环境Configuration → Web service runtime:Apache Axis →Choose Web service runtime first →Apache Axis2 2.3将项目打包为EAR 2.4在Weblogic 服务器上面,添加项目并运行服务器 2.5输入url地址,可见发布了的接口 Axis2 教程 文章分类:Java编程 Axis2是一套崭新的WebService引擎,该版本是对Axis1.x重新设计的产物。Axis2不仅支持SOAP1.1和SOAP1.2,还集成了非常流行的REST WebService,同时还支持Spring、JSON等技术。这些都将在后面的系列教程中讲解。在本文中主要介绍了如何使用Axis2开发一个不需要任何配置文件的WebService,并在客户端使用Java和C#调用这个WebService。 一、Axis2的下载和安装 读者可以从如下的网址下载Axis2的最新版本: https://www.sodocs.net/doc/8a17676574.html,/axis2/ 在本文使用了目前Axis2的最新版本1.4.1。读者可以下载如下两个zip包: axis2-1.4.1-bin.zip axis2-1.4.1-war.zip 其中axis2-1.4.1-bin.zip文件中包含了Axis2中所有的jar文件, axis2-1.4.1-war.zip文件用于将WebService发布到Web容器中。 将axis2-1.4.1-war.zip文件解压到相应的目录,将目录中的axis2.war 文件放到 二、编写和发布WebService 对于用Java实现的服务程序给人的印象就是需要进行大量的配置,不过这一点在Axis2中将被终结。在Axis2中不需要进行任何的配置,就可以直接将一个简单的POJO发布成WebService。其中POJO中所有的public方法将被发布成WebService方法。 下面我们来实现一个简单的POJO,代码如下: public class SimpleService { public String getGreeting(String name) { return "你好 " + name; } public int getPrice() { return new java.util.Random().nextInt(1000); } } WebService调查报告 作成者:XXX 一、调查目的 由于cardioNet心电管理系统其中的模块都有用到WebService,自己之前并没有在项目中用过WebService,所以做次调查,学习WebService的相关内容。 二、调查内容 1.面向服务的架构(SOA) (1) 什么是面向服务的架构(SOA)? 面向服务的体系结构(Service-Oriented Architecture,SOA)是一个组件模型,它将应用程序的不同功能单元(称为服务)通过这些服务之间定义良好的接口和契约联系起来。接口是采用中立的方式进行定义的,它应该独立于实现服务的硬件平台、操作系统和编程语言。这使得构建在各种这样的系统中的服务可以一种统一和通用的方式进行交互。SOA可以根据需求通过网络对松散耦合的粗粒度应用组件进行分布式部署、组合和使用。服务层是SOA的基础,可以直接被应用调用,从而有效控制系统中与软件代理交互的人为依赖性。它是一种粗粒度、松耦合服务架构,服务之间通过简单、精确定义接口进行通讯,不涉及底层编程接口和通讯模型。SOA可以看作是B/S模型、XML/Web Service技术之后的自然延伸。 (2)面向服务架构的作用? 对 SOA 的需要来源于需要使业务 IT 系统变得更加灵活,以适应业务中的改变。通过允许强定义的关系和依然灵活的特定实现,IT 系统既可以利用现有系统的功能,又可以准备在以后做一些改变来满足它们之间交互的需要。比如,通过利用 WSDL 接口在操作方面的灵活性,每个公司都可以将它们的现有系统保持现状,而仅仅匹配 WSDL 接口并制订新的服务级协定,这样就不必完全重构它们的软件系统了。这是业务的水平改变,也就是说,它们改变的是合作伙伴,而所有的业务操作基本上都保持不变。这里,业务接口可以作少许改变,而内部操作却不需要改变,之所以这样做,仅仅是为了能够与外部合作伙伴一起工作。还有一种形式的改变时内部改变,比如一个系统需要加入一个新的内部软件实现新的功能,在这种情况下,SOA 模型保持原封不动,而内部实现却发生了变化。虽然可以将新的方面添加到 SOA 模型中来加入新的功能,但是大多数业务操作都保持不变。在SOA中垂直改变也是可行的,如果垂直改变完全从最底层开始的话,就会带来 SOA 模型结构的显著改变,与之一起改变的还可能有新的系统、软件、流程以及关系。在这种情况下,SOA 模型的好处是它从业务操作和流程的角度考虑问题而不是从应用程序和程序的角度考虑问题,这使得业务管理可以根据业务的操作清楚地确定什么需要添加、修改或删除。然后可以将软件系统构造为适合业务处理的方式,而不是在许多现有的软件平台上常常看到的其他方式。 不同种类的操作系统、应用软件、系统软件和应用基础结构相互交织,这便是IT企业的现状。一些现存的应用程序被用来处理当前的业务流程,因此从头建立一个新的基础环境是不可能的。企业应该能对业务的变化做出快速的反应,利用对现有的应用程序和应用基础结构的投资来解决新的业务需求,为客户,商业伙伴以及供应商提供新的互动渠道,并呈现一个可以支持有机业务的构架。SOA 凭借其松耦合的特性,使得企业可以按照模块化的方式来添加新服务或更新现有 第一个的webservice实例 超简单,才5步 1> 获取axis及关联的jar包 https://www.sodocs.net/doc/8a17676574.html,/topics/download/6a76de1e-d506-35bc-a41b-508d4be04025 2> 新建一个模拟服务java类 package server; public class SayHello { public String getName(String name) { return "你好," + name; } } 3> 在web.xml 下新增一个servelt 1、上传pls文件生成ildt文件: $IAS_ORACLE_HOME/perl/bin/perl $FND_TOP/bin/irep_parser.pl -g -v -username=sysadmin sql:cux_webservice_test_pkg.pls:120.0=/xxx/cux/12.0.0/webservice/pls/cux_webservice_tes t_pkg.pls Pls文件为包定义格式: /* $Header: cux_webservice_tst_pkg.pls $ */ /*# * This is the public interface for Web Service ESB. * @rep:scope public * @rep:product AR * @rep:displayname ESB WebService * @rep:lifecycle active * @rep:compatibility S * @rep:category BUSINESS_ENTITY HZ_CUSTOMER_ACCOUNT */ /*# * Main Procedure for synchronous test * @param p_char charactor parameter * @param p_num number parameter * @param p_date date parameter * @param responseType response type * @param respnoseCode response code * @param responseMessage response message * @rep:scope public * @rep:lifecycle active * @rep:displayname synchronous test1 */ PROCEDURE synchronous_p(p_char IN VARCHAR2 ,p_num IN NUMBER ,p_date IN DATE ,responsetype OUT VARCHAR2 ,respnosecode OUT VARCHAR2 ,responsemessage OUT VARCHAR2); 2、将iLDT文件注册成Web Service FNDLOAD apps/apps 0 Y UPLOAD $FND_TOP/patch/115/import/wfirep.lct cux_webservice_test_pkg_pls.ildt - CUSTOM_MODE=FORCE Web Service入门简介 一、Web Service简介 1.1、Web Service基本概念 Web Service也叫XML Web Service WebService是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求,轻量级的独立的通讯技术。是:通过SOAP在Web上提供的软件服务,使用WSDL文件进行说明,并通过UDDI进行注册。 XML:(Extensible Markup Language)扩展型可标记语言。面向短期的临时数据处理、面向万维网络,是Soap的基础。 Soap:(Simple Object Access Protocol)简单对象存取协议。是XML Web Service 的通信协议。当用户通过UDDI找到你的WSDL描述文档后,他通过可以SOAP调用你建立的Web服务中的一个或多个操作。SOAP是XML文档形式的调用方法的规范,它可以支持不同的底层接口,像HTTP(S)或者SMTP。 WSDL:(Web Services Description Language) WSDL 文件是一个 XML 文档,用于说明一组 SOAP 消息以及如何交换这些消息。大多数情况下由软件自动生成和使用。UDDI (Universal Description, Discovery, and Integration) 是一个主要针对Web服务供应商和使用者的新项目。在用户能够调用Web服务之前,必须确定这个服务内包含哪些商务方法,找到被调用的接口定义,还要在服务端来编制软件,UDDI是一种根据描述文档来引导系统查找相应服务的机制。UDDI利用SOAP消息机制(标准的XML/HTTP)来发布,编辑,浏览以及查找注册信息。它采用XML格式来封装各种不同类型的数据,并且发送到注册中心或者由注册中心来返回需要的数据。 1.2、XML Web Service的特点 Web Service的主要目标是跨平台的可互操作性。为了实现这一目标,Web Service完全基于XML(可扩展标记语言)、XSD(XML Schema)等独立于平台、独立于软件供应商的标准,是创建可互操作的、分布式应用程序的新平台。因此使用Web Service有许多优点: 1、跨防火墙的通信 如果应用程序有成千上万的用户,而且分布在世界各地,那么客户端和服务器之间的通信将是一个棘手的问题。因为客户端和服务器之间通常会有防火墙或者代理服务器。传统的做法是,选择用浏览器作为客户端,写下一大堆ASP页面,把应用程序的中间层暴露给最终用户。这样做的结果是开发难度大,程序很难维护。要是客户端代码不再如此依赖于HTML 表单,客户端的编程就简单多了。如果中间层组件换成Web Service的话,就可以从用户界面直接调用中间层组件,从而省掉建立ASP页面的那一步。要调用Web Service,可以直接使用Microsoft SOAP Toolkit或.net这样的SOAP客户端,也可以使用自己开发的SOAP客户端,然后把它和应用程序连接起来。不仅缩短了开发周期,还减少了代码复杂度,c#-操作webservice(经典入门教程)
webservice注解详解
Webservice学习
XMLWebService完全实例详细解析
SAP开发webservice接口教程
webservice注解详解
【WebService】接口的测试方法
C#调用WebService实例和开发
Eclipse下WebService学习
基于WebService的G手机应用手机应用操作手册
ABAP外调WebService过程的介绍
android调用WebService接口详解
Webservice服务端的开发和客户端调用
Axis2从入门到精通--Webservice在eclipse下开发教程
WebService调查报告
第一个webservice例子
Oracle EBS中发布WebService
webservice入门基础