WebService学习之路一 :http://trylin.iteye.com/blog/1906819
WebService学习之路二 :http://trylin.iteye.com/blog/1907883
复杂类型的参数传替
前面的示例是一个简单,基本类型的WS,在平时的工作中,经常会用到复杂类型的传替。
试着在原有的WS加入自定义对象的参数。
1、创建自定义类型
Java代码
- public class User {
- private String userName; //名字
- private int age;//年龄
- private boolean isBoy;//是否是男
- private double money;//钱
- //忽略 get set
- }
2、新建一个接口和实现
Java代码
- @W @WebService(targetNamespace="service.ws.trylin.com")
- public interface IUser {
- public String printUser(User user);
- public void sendUser(User user);
- public User createUser(String userName,int age,boolean isBoy,
- double money);
- }
- @WebService(
- endpointInterface="com.trylin.ws.service.IUser",
- targetNamespace="impl.service.ws.trylin.com")
- public class UserImpl implements IUser {
- public String printUser(User user) {
- return "user info : "+user;
- }
- public void sendUser(User user) {
- System.out.println(" your send user info :"+user);
- }
- public User createUser(String userName, int age, boolean isBoy, double money) {
- User user= new User();
- user.setUserName(userName);
- user.setAge(age);
- user.setBoy(isBoy);
- user.setMoney(money);
- return user;
- }
- }
3、启动服务
Java代码
- public static void main(String[] args) {
- String address = "http://localhost:8888/WS";
- Endpoint.publish(address, new UserImpl());
- }
4、生成客户端测试
然后按照之前写的第一节的 wsimport命令生成客户端,然后测试调用服务。
Java代码
- @Test
- public void testUser1(){
- UserImplService service = new UserImplService();
- IUser iuser = service.getUserImplPort();
- User myUser = new User();
- myUser.setUserName("测试printUser");
- myUser.setAge(1);
- myUser.setBoy(false);
- myUser.setMoney(0.01);
- System.out.println(iuser.printUser(myUser));
- User u = iuser.createUser("测试createUser", 2, true, 100);
- System.out.println("user info :"+"userName="+u.getUserName()+"age="+u.getAge()+"isBoy="+u.isBoy()+"money="+u.getMoney());
- //延用上面的 myUser 修改下名字 发送到服务端
- myUser.setUserName("测试sendUser");
- iuser.sendUser(myUser);
- }
5、查看wsdl
输入 http://localhost:8888/WS 查看含有自定义类型的wsdl,并且和之前第一节中生成的wsdl有那些不同呢。这里我就不把wsdl的截图贴上了,主要解释下具体的不同之处。
我们发布的含有自定义类型的服务其实和之前的服务wsdl查不多,乍一看只是一个发布的服务名和方法不同,其实还有一个重要的地方就是 types 。
这里我们的type中多了一个我们的自定义类型,sendUser的参数arg0引用了User,自定义类型实际上就是在types中定义了一个 表示该类型的‘xml元素对象’。
User类型有了 ,那List是什么样的呢?然后List当中有User又是什么情况呢?
想到就必须实现解决嘛…呵呵
在User对象中 添加一个朋友的属性
Java代码- private List<User> friends;//朋友们
- 在接口的定义和实现中加入一个叫朋友的方法
- //IUser
- public User makeFriends(User user);
- //UserImpl
- public User makeFriends(User user) {
- //为了方便,我在User添加了有参的构造
- List<User> list = new ArrayList<User>();
- list.add(new User("朋友1",1,false,1));
- list.add(new User("朋友2",2,false,2));
- list.add(new User("朋友3",3,false,3));
- user.setFriends(list);
- return user;
- }
然后重新发布服务,发布成功后,找到生成wsdl中的types,找到User中的 friends属性
简单的解释下:
Nillable = true 表示该元素可以为null
MinOccurs = “0” 表示该元素的最小个数为0
MaxOccurs = “unbounded” 表示该元素不限定最大个数
这些属性的详细解释,请参考http://www.w3school.com.cn/schema/index.asp
这里把List看作为一系列的User对象,如果解释为xml 类似于这样:
<friends>
<user>…</user><user>…</user>
<friends>
试着重新生成客户端,调用一下试试,看看交朋友成功没。。。
我是屌丝,然后我在makeFriends中定义了很多女神。。。很happy
我们这里是只使用了webservice注解的@webService,还有很多的注解,边学习变了解各种注解的使用了。。。