半步多 玄玉的博客

CXF之入门实例

2013-05-31
玄玉

服务端

首先是SEI,即服务端接口类HelloService.Java

package com.jadyer.service;
import java.util.List;
import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;
import com.jadyer.model.User;

@WebService(targetNamespace="https://jadyer.cn/")
public interface HelloService {
    @WebResult(name="sayHelloResult")
    public String sayHello(@WebParam(name="name")String name);
    /**
     * 获取指定编号的用户信息
     */
    public User getUserByID(int id);
    /**
     * 只有用户jadyer才可以获取所有用户信息,其它用户只能获取自己的用户信息
     */
    public List<User> getUserList(User user);
}

下面是SIB,即服务端接口实现类HelloServiceImpl.java

package com.jadyer.service;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import javax.jws.WebService;
import com.jadyer.model.User;

@WebService(endpointInterface="com.jadyer.service.HelloService", targetNamespace="https://jadyer.cn/")
public class HelloServiceImpl implements HelloService {
    //模拟的一个内存数据库
    private static Map<Integer, User> userMap = new HashMap<Integer, User>();
    static{
        userMap.put(1, new User(1, "admin", "xuanyu", 11));
        userMap.put(2, new User(2, "jadyer", "hongyu", 22));
    }

    @Override
    public String sayHello(String name) {
        System.out.println("Receive the name=[" + name + "]");
        if(null==name){
            return "Hello,World";
        }else{
            return "Hello," + name;
        }
    }

    @Override
    public User getUserByID(int id) {
        return userMap.get(id);
    }

    @Override
    public List<User> getUserList(User user) {
        List<User> userList = new ArrayList<User>();
        if(user.getUsername().equals("jadyer")){
            for(Map.Entry<Integer, User> entry : userMap.entrySet()){
                userList.add(entry.getValue());
            }
        }else{
            userList.add(user);
        }
        return userList;
    }
}

下面是用到的实体类User.java

package com.jadyer.model;

public class User {
    private int id;
    private String username;
    private String password;
    private int age;

    /*三个属性的setter和getter略*/

    public User(){}
    public User(int id, String username, String password, int age) {
        this.id = id;
        this.username = username;
        this.password = password;
        this.age = age;
    }
}

下面是自定义的用于接收SOAPHeader信息的LicenseHandler.java

package com.jadyer.handler;
import java.util.Iterator;
import java.util.Set;
import javax.xml.namespace.QName;
import javax.xml.soap.SOAPEnvelope;
import javax.xml.soap.SOAPException;
import javax.xml.soap.SOAPHeader;
import javax.xml.soap.SOAPHeaderElement;
import javax.xml.ws.handler.MessageContext;
import javax.xml.ws.handler.soap.SOAPHandler;
import javax.xml.ws.handler.soap.SOAPMessageContext;

public class LicenseHandler implements SOAPHandler<SOAPMessageContext> {
    @Override
    public Set<QName> getHeaders() {
        return null;
    }

    @Override
    public void close(MessageContext context) {}

    @Override
    public boolean handleFault(SOAPMessageContext context) {
        return false;
    }

    @SuppressWarnings("unchecked")
    @Override
    public boolean handleMessage(SOAPMessageContext context) {
        Boolean isOutBound = (Boolean)context.get(SOAPMessageContext.MESSAGE_OUTBOUND_PROPERTY);
        if(!isOutBound){
            SOAPHeader header = null;
            try {
                SOAPEnvelope envelope = context.getMessage().getSOAPPart().getEnvelope();
                header = envelope.getHeader();
                if(null == header){
                    header = envelope.addHeader();
                }
            } catch (SOAPException e) {
                e.printStackTrace();
            }
            Iterator<SOAPHeaderElement> iterator = header.getChildElements();
            while(iterator.hasNext()){
                SOAPHeaderElement headerElement = iterator.next();
                if(headerElement.getLocalName().equals("licenseInfo")){
                    System.out.println("Receive the header=[" + headerElement.getTextContent() + "]");
                }
            }
        }
        return true;
    }
}

最后是发布服务的ServerApp.java

package com.jadyer.server;
import java.util.ArrayList;
import java.util.List;
import javax.xml.ws.handler.Handler;
import org.apache.cxf.interceptor.LoggingInInterceptor;
import org.apache.cxf.interceptor.LoggingOutInterceptor;
import org.apache.cxf.jaxws.JaxWsServerFactoryBean;
import com.jadyer.handler.LicenseHandler;
import com.jadyer.service.HelloService;
import com.jadyer.service.HelloServiceImpl;

public class ServerApp {
    @SuppressWarnings("unchecked")
    public static void main(String[] args) {
        //基于JAX-WS的发布方式
        //Endpoint.publish("http://127.0.0.1:8088/myHelloService", new HelloServiceImpl());

        //基于CXF的发布方式
        JaxWsServerFactoryBean factory = new JaxWsServerFactoryBean();
        factory.setAddress("http://127.0.0.1:8088/myHelloService");
        factory.setServiceClass(HelloService.class);
        factory.setServiceBean(new HelloServiceImpl());

        //打印接收和响应的SOAP通信报文,这样就不需要tcpmon这类工具监测往来报文了
        factory.getInInterceptors().add(new LoggingInInterceptor());
        factory.getOutInterceptors().add(new LoggingOutInterceptor());

        //set Handler(只需此步,无需SIB注解@HandlerChain,也不用提供xml文件)
        //对于CXF而言,用Handler真的没有多大必要,我们完全可以用它的Interceptor来代替Handler
        List<Handler> handlers = new ArrayList<Handler>();
        handlers.add(new LicenseHandler());
        factory.setHandlers(handlers);

        factory.create();
    }
}

至此,服务端代码示例完毕

客户端

首先是自定义的用于发送SOAPHeader信息的LicenseHandler.java

package com.jadyer.handler;
import java.util.Set;
import javax.xml.namespace.QName;
import javax.xml.soap.SOAPEnvelope;
import javax.xml.soap.SOAPException;
import javax.xml.soap.SOAPHeader;
import javax.xml.ws.handler.MessageContext;
import javax.xml.ws.handler.soap.SOAPHandler;
import javax.xml.ws.handler.soap.SOAPMessageContext;

public class LicenseHandler implements SOAPHandler<SOAPMessageContext> {
    @Override
    public Set<QName> getHeaders() {
        return null;
    }

    @Override
    public void close(MessageContext context) {}

    @Override
    public boolean handleFault(SOAPMessageContext context) {
        return false;
    }

    @Override
    public boolean handleMessage(SOAPMessageContext context) {
        Boolean isOutBound = (Boolean)context.get(SOAPMessageContext.MESSAGE_OUTBOUND_PROPERTY);
        if(isOutBound){
            try {
                SOAPEnvelope envelope = context.getMessage().getSOAPPart().getEnvelope();
                SOAPHeader header = envelope.getHeader();
                if(null == header){
                    header = envelope.addHeader();
                }
                QName qname = new QName("https://jadyer.cn/", "licenseInfo", "ns");
                header.addHeaderElement(qname).setValue("Jadyer");
                return true;
            } catch (SOAPException e) {
                e.printStackTrace();
            }
        }
        return false;
    }
}

最后是客户端调用服务端的模拟入口ClientApp.java

注意:具体客户端代码由CXF提供的wsdj2java生成

package com.jadyer.client;
import java.util.ArrayList;
import java.util.List;
import javax.xml.ws.handler.Handler;
import net.csdn.blog.jadyer.HelloService;
import net.csdn.blog.jadyer.User;
import org.apache.commons.lang.builder.ReflectionToStringBuilder;
import org.apache.commons.lang.builder.ToStringStyle;
import org.apache.cxf.interceptor.LoggingInInterceptor;
import org.apache.cxf.interceptor.LoggingOutInterceptor;
import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;
import com.jadyer.handler.LicenseHandler;

/**
 * 使用CXF提供的wsdj2java
 * 1)将D:\Develop\apache-cxf-2.7.0\bin加入环境变量path中
 * 2)使用CXF提供的wsdl2java.bat生成客户端代码,其用法与JAX-WS的wsimport基本相同
 *   wsdl2java -d D:/Download/ -frontend jaxws21 -keep -verbose http://127.0.0.1:8088/myHelloService?wsdl
 * 补充:wsimport用法详见https://jadyer.cn/2013/03/19/jaxws-demo-and-wsimport/
 * Created by 玄玉<https://jadyer.cn/> on 2013/05/30 17:09.
 */
public class ClientApp {
    @SuppressWarnings("unchecked")
    public static void main(String[] args) {
        /**
         * 基于JAX-WS的客户端调用方式
         */
        //System.out.println(new HelloServiceService().getHelloServicePort().sayHello("玄玉"));
        /**
         * 基于CXF的客户端调用方式
         */
        JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean();
        factory.setAddress("http://127.0.0.1:8088/myHelloService");
        factory.setServiceClass(HelloService.class);
        factory.getInInterceptors().add(new LoggingInInterceptor());
        factory.getOutInterceptors().add(new LoggingOutInterceptor());
        List<Handler> handlers = new ArrayList<Handler>();
        handlers.add(new LicenseHandler());
        factory.setHandlers(handlers);
        HelloService hello = (HelloService)factory.create();
        //System.out.println(hello.sayHello("玄玉"));
        //System.out.println(ReflectionToStringBuilder.toString(hello.getUserByID(2)));
        User user = new User();
        user.setUsername("jadyer");
        List<User> userList = hello.getUserList(user);
        for(User uu : userList){
            System.out.println(ReflectionToStringBuilder.toString(uu, ToStringStyle.MULTI_LINE_STYLE));
        }
    }
}

控制台输出

服务端输出内容如下

2013-5-31 22:28:59 org.apache.cxf.services.HelloServiceService.HelloServicePort.HelloService
信息: Inbound Message
----------------------------
ID: 4
Address: http://127.0.0.1:8088/myHelloService
Encoding: UTF-8
Http-Method: POST
Content-Type: text/xml; charset=UTF-8
Headers: {Accept=[*/*], Cache-Control=[no-cache], connection=[keep-alive], Content-Length=[351], content-type=[text/xml; charset=UTF-8], Host=[127.0.0.1:8088], Pragma=[no-cache], SOAPAction=[""], User-Agent=[Apache CXF 2.7.0]}
Payload: <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Header><ns:licenseInfo xmlns:ns="https://jadyer.cn/">Jadyer</ns:licenseInfo></soap:Header><soap:Body><ns2:getUserList xmlns:ns2="https://jadyer.cn/"><arg0><age>0</age><id>0</id><username>jadyer</username></arg0></ns2:getUserList></soap:Body></soap:Envelope>
--------------------------------------
Receive the header=[Jadyer]
2013-5-31 22:28:59 org.apache.cxf.services.HelloServiceService.HelloServicePort.HelloService
信息: Outbound Message
---------------------------
ID: 4
Encoding: UTF-8
Content-Type: text/xml
Headers: {}
Payload: <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Header/><soap:Body><ns2:getUserListResponse xmlns:ns2="https://jadyer.cn/"><return><age>11</age><id>1</id><password>xuanyu</password><username>admin</username></return><return><age>22</age><id>2</id><password>hongyu</password><username>jadyer</username></return></ns2:getUserListResponse></soap:Body></soap:Envelope>
--------------------------------------

客户端输出内容如下

2013-5-31 22:28:58 org.apache.cxf.service.factory.ReflectionServiceFactoryBean buildServiceFromClass
信息: Creating Service {https://jadyer.cn/}HelloServiceService from class net.csdn.blog.jadyer.HelloService
2013-5-31 22:28:59 org.apache.cxf.services.HelloServiceService.HelloServicePort.HelloService
信息: Outbound Message
---------------------------
ID: 1
Address: http://127.0.0.1:8088/myHelloService
Encoding: UTF-8
Http-Method: POST
Content-Type: text/xml
Headers: {Accept=[*/*], SOAPAction=[""]}
Payload: <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Header><ns:licenseInfo xmlns:ns="https://jadyer.cn/">Jadyer</ns:licenseInfo></soap:Header><soap:Body><ns2:getUserList xmlns:ns2="https://jadyer.cn/"><arg0><age>0</age><id>0</id><username>jadyer</username></arg0></ns2:getUserList></soap:Body></soap:Envelope>
--------------------------------------
2013-5-31 22:28:59 org.apache.cxf.services.HelloServiceService.HelloServicePort.HelloService
信息: Inbound Message
----------------------------
ID: 1
Response-Code: 200
Encoding: UTF-8
Content-Type: text/xml;charset=UTF-8
Headers: {content-type=[text/xml;charset=UTF-8], Server=[Jetty(8.1.7.v20120910)], transfer-encoding=[chunked]}
Payload: <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Header/><soap:Body><ns2:getUserListResponse xmlns:ns2="https://jadyer.cn/"><return><age>11</age><id>1</id><password>xuanyu</password><username>admin</username></return><return><age>22</age><id>2</id><password>hongyu</password><username>jadyer</username></return></ns2:getUserListResponse></soap:Body></soap:Envelope>
--------------------------------------
net.csdn.blog.jadyer.User@168497f6[
  age=11
  id=1
  password=xuanyu
  username=admin
]
net.csdn.blog.jadyer.User@27db0da1[
  age=22
  id=2
  password=hongyu
  username=jadyer
]

Content