Ruby，Python和Java中的Web服务

今天，我不得不准备一些示例来说明Web服务是可互操作的。因此，我已经使用Metro使用Java创建了一个简单的Web服务，并在Tomcat上启动了它。

然后尝试使用Python和Ruby消耗它们。这是全部完成的过程…

Java中的Web服务

我从Java中的简单Web服务开始：

package com.wordpress.jdevel.ws;import java.io.File;
import java.io.FileFilter;
import java.io.FilenameFilter;
import java.util.ArrayList;
import java.util.List;
import javax.jws.WebService;
import javax.jws.WebMethod;
import javax.jws.WebParam;@WebService(serviceName = "Music")
public class Music {private static final File FOLDER = new File("D:/TEMP/SONGS");@WebMethod(operationName = "listSongs")public Song[] listSongs(@WebParam(name = "artist") String artist) {List<Song> songs = new ArrayList<Song>();System.out.println("ARTIST: " + artist);if (artist != null) {File folder = new File(FOLDER, artist);if (folder.exists() && folder.isDirectory()) {File[] listFiles = folder.listFiles(new FilenameFilter() {public boolean accept(File dir, String name) {return name.toUpperCase().endsWith(".MP3");}});for (File file : listFiles) {String fileName = file.getName();String author = file.getParentFile().getName();int size = (int) (file.length() / 1048576); //MegabytesSong song = new Song(fileName, author, size);songs.add(song);}}}return songs.toArray(new Song[songs.size()]);}@WebMethod(operationName = "listArtists")public String[] listArtists() {File[] folders = getFolders(FOLDER);List<String> artists = new ArrayList<String>(folders.length);for (File folder : folders) {artists.add(folder.getName());}return artists.toArray(new String[artists.size()]);}private File[] getFolders(File parent) {FileFilter filter = new FileFilter() {public boolean accept(File pathname) {return pathname.isDirectory();}};File[] folders = parent.listFiles(filter);return folders;}public static void main(String[] args) {Music listFiles = new Music();String[] artists = listFiles.listArtists();System.out.println("Artists: " + artists);for (String artist : artists) {Song[] listSongs = listFiles.listSongs(artist);for (Song song : listSongs) {System.out.println(song.getArtist() + " : " + song.getFileName() + " : " + song.getSize() + "MB");}}}
}

还需要一个简单的bean来获取一些更复杂的类型：

package com.wordpress.jdevel.ws;import java.io.Serializable;public class Song implements Serializable {String fileName;String artist;int size;public Song() {}public Song(String fileName, String artist, int size) {this.fileName = fileName;this.artist = artist;this.size = size;}public String getArtist() {return artist;}public void setArtist(String artist) {this.artist = artist;}public String getFileName() {return fileName;}public void setFileName(String fileName) {this.fileName = fileName;}public int getSize() {return size;}public void setSize(int size) {this.size = size;}
}

它只是在硬编码的FOLDER目录中列出所有子目录，并将其视为音乐收藏中的艺术家列表。然后，您可以执行listSongs方法并在artist子文件夹中获取mp3文件的列表。

要使其成为Web服务，您要做的就是使用@WebService（serviceName =“ Music”）注释类，并且要公开为Web服务操作的每个方法都必须使用@WebMethod（operationName =“ listArtists”）进行标记。

如果您要在GlassFish上部署它，那么应该就这些了，但是我已经使用了Tomcat，因此还需要3个步骤：

1.将Metro 2.0罐子添加到WEB-INF / lib
2.将Metro Servlet和侦听器添加到web.xml：

<listener><listener-class>com.sun.xml.ws.transport.http.servlet.WSServletContextListener</listener-class>
</listener>
<servlet><servlet-name>Music</servlet-name><servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class><load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping><servlet-name>Music</servlet-name><url-pattern>/Music</url-pattern>
</servlet-mapping>

您可能不应在此处进行任何更改。只需将其粘贴到web-app节点中的web.xml中即可。

3.使用端点声明将sun-jaxws.xml文件添加到WEB-INF：

<?xml version="1.0" encoding="UTF-8"?>
<endpoints version="2.0" xmlns="http://java.sun.com/xml/ns/jax-ws/ri/runtime"><endpoint implementation="com.wordpress.jdevel.ws.Music" name="Music" url-pattern="/Music"/>
</endpoints>

实现必须匹配您的@WebService类
名称必须与@WebService批注中的serviceName匹配
url-pattern必须与您在servlet映射中声明的url-pattern匹配

如果在NetBeans中创建XML文件，则也无需编辑这些XML文件。

现在启动Tomcat并部署您的应用程序。您应该可以通过以下方式访问服务

http：// localhost：8080 / WSServer /音乐

看到这样的事情：

可以通过以下方式访问WSDL

http：// localhost：8080 / WSServer / Music？wsdl

复杂类型的架构：

http：// localhost：8080 / WSServer / Music？xsd = 1

如果您能正常工作，则可以从以下客户端开始。

Python客户端
我已经开始搜寻一些不错的python网络服务库，并找到了Suds。我还没有真正使用过这样的东西。实施WS客户大约花了15分钟。支持复杂类型的课程，而上一次我使用Python编写大于5行的代码大约是3年前了。您真的必须尝试一下。

所以这是代码：

import sudsclass Client:def __init__(self):self.client = suds.client.Client("http://localhost:8080/WSServer/Music?wsdl")def get_artists(self):return self.client.service.listArtists()def get_songs(self, artist):return self.client.service.listSongs(artist)if(__name__ == "__main__"):client = Client()artists = client.get_artists()for artist in artists:print artistsongs = client.get_songs(artist)for song in songs:print "\t%s : %s : %d%s" % (song.fileName, song.artist, song.size, "MB")

而已。简单明了。解析WSDL后，动态生成复杂类型。美丽的东西。对于我来说，要实现这样的事情有点困难。

Ruby客户端
使用SOAP4R库。只需执行

宝石安装soap4r

要获得它（真的很喜欢这个工具）。首先让我们从代码开始：

require 'soap/rpc/driver'
require 'soap/wsdlDriver'class Clientdef initializefactory = SOAP::WSDLDriverFactory.new("http://localhost:8080/WSServer/Music?wsdl")@driver = factory.create_rpc_driverenddef get_songs(artist)songs = @driver.listSongs(:artist => artist)return songsenddef get_artistsartists = @driver.listArtists(nil)return artistsend
enddef print_songs(songs)if songsend
endclient = Client.new
artists = client.get_artists
artists["return"].each{|artist|puts artistsongs = client.get_songs(artist)["return"];songs.each {|song| puts "\t%s : %s : %d%s" % [song.fileName, song.artist, song.size, "MB"]}
}

它的功能完全相同。调用Web服务以获取艺术家列表，然后为每个艺术家调用mp3文件。然后只需将所有内容打印到控制台即可。

我花了相当长的时间才能开始工作。首先–很难找到任何文档。其次– SOAP4R在没有一点黑客的情况下不能与ruby 1.9一起工作：

http://railsforum.com/viewtopic.php?id=41231

下一步–当您不使用WSDL创建驱动程序对象时，结果会稍微好一些，但是随后您必须确切地知道要拥有哪些服务并想要执行。在这个简单的示例中，这不是问题，但是如果您需要使其更通用一些，就会遇到麻烦。

我说“好一点”是什么意思？一，代码：

@driver = SOAP::RPC::Driver.new("http://localhost:8080/WSServer/Music", "http://ws.jdevel.wordpress.com/");
@driver.add_method(ARTISTS_METHOD)
@driver.add_method(SONGS_METHOD, "artist")

这样，我负责为要使用的服务声明端点和名称空间。我还需要声明我将要使用的所有操作以及参数（“作者”）。有什么不同？当我不使用WSDL时，SOAP4R库会从调用服务中提供更好的返回类型。我可以简单地省略[“ return”]并得到类似使用Python的信息。

我需要在Ruby中知道的是每种复杂类型的外观如何，从而使我的实现对Web服务更改更加敏感。如何知道应该使用哪个键来获取复杂类型的数据？检查WSDL并查找您要调用的操作：

<operation name="listArtists"><input wsam:Action="http://ws.jdevel.wordpress.com/Music/listArtistsRequest" message="tns:listArtists"/><output wsam:Action="http://ws.jdevel.wordpress.com/Music/listArtistsResponse" message="tns:listArtistsResponse"/>
</operation>

接下来在xsd中找到输出复杂类型

<xs:complexType name="listArtistsResponse"><xs:sequence><xs:element name="return" type="xs:string" nillable="true" minOccurs="0" maxOccurs="unbounded"/></xs:sequence>
</xs:complexType>

您需要的是name属性的值。无论如何，这两种实现看起来都非常不错，而且更重要的是，它们可以正常工作。 Ruby和Python都有不错的Web服务库，可以处理复杂类型和WSDL解析。

参考：我们的JCG合作伙伴在“ Development world story”博客上提供了Ruby，Python和Java的Web服务。

相关文章：