Interface Class

다음은 Movie Service의 인터페이스 클래스를 작성한 MovieService.java의 일부이다.

이때 유의할 사항은 @XmlSeeAlso annotation인데, JAXB Databinding 수행 시 Map 객체 내에 저장된 Movie 클래스 타입을 알아야 하기 때문에 @XmlSeeAlso annotation을 설정하고 있는 것에 유의하도록 한다. 만약 이 웹서비스의 다른 메소드에서 Movie 객체를 Input 혹은 Output parameter 클래스 타입으로 사용하고 있다면 @XmlSeeAlso annotation을 설정할 필요가 없다.

@WebService
@XmlSeeAlso(Movie.class)		            	
public interface MovieFinder {

    @XmlJavaTypeAdapter(CXFMapAdapter.class)
    Map<String, Movie> get(String movieId) throws Exception;
    중략...

XmlAdapter Class [Anyframe 제공 클래스]

Movie Service의 인터페이스 메소드 중 리턴 타입이 Map인 경우, XmlAdapter 클래스가 추가 작성되어야 한다. Map 타입을 사용하지 않는 경우 작성할 필요 없다. 다음은 XmlAdapter 클래스를 상속받아 구현한 CXFMapAdapter.java 의 일부이다. 개발자들은 따로 구현할 필요없이 Anyframe에서 제공하는 org.anyframe.cxf.adapter.CXFMapAdapter 클래스를 사용한다.

public class CXFMapAdapter extends XmlAdapter<CXFMap, Map<String, Object>> {
    public CXFMap marshal(Map<String, Object> v) throws Exception {
        CXFMap map = new CXFMap();
        for (Map.Entry<String, Object> e : v.entrySet()) {
            CXFMap.CXFEntry iue = new CXFMap.CXFEntry();
            iue.setValue(e.getValue());
            iue.setKey(e.getKey());
            map.getEntries().add(iue);
        }
        return map;
    }

    public Map<String, Object> unmarshal(CXFMap v) throws Exception {
        Map<String, Object> map = new LinkedHashMap<String, Object>();
        for (CXFMap.CXFEntry e : v.getEntries()) {
            map.put(e.getKey(), e.getValue());
        }
        return map;
    }
}
중략...

XmlAdapter Class에서 사용하는 부가 클래스 [Anyframe 제공 클래스]

위에서 작성한 XmlAdapter 클래스 내에서 marshalling/unmarshalling 작업 시 사용되는 CXFMap 클래스 또한 추가 작성되어야 한다. Map 타입을 사용하지 않는 경우 작성할 필요 없다. 다음은 CXFMap 클래스를 작성한 CXFMap.java 의 일부이다. 개발자들은 따로 구현할 필요없이 Anyframe에서 제공하는 org.anyframe.cxf.adapter.CXFMap 클래스를 사용한다.

@XmlType(name = "CXFMap")
@XmlAccessorType(XmlAccessType.FIELD)
public class CXFMap {
    @XmlElement(nillable = false, name = "entry")
    private List<CXFEntry> entries = new ArrayList<CXFEntry>();

    public List<CXFEntry> getEntries() {
        return entries;
    }

    @XmlAccessorType(XmlAccessType.FIELD)
    @XmlType(name = "IdentifiedCXF")
    static class CXFEntry {
        // Map keys cannot be null
        @XmlElement(required = true, nillable = false)
        private String key;
        private Object value;

        public String getKey() {
            return key;
        }
        public void setKey(String key) {
            this.key = key;
        }
        public Object getValue() {
            return value;
        }
        public void setValue(Object value) {
            this.value = value;
        }
        중략...

Interface Class

SEI(Service Endpoint Interface) 클래스의 메소드에서 List 형태의 결과값을 리턴하는 메소드가 존재하고 해당 List내에 저장된 Java Type 클래스에 대해서는 참조하지 않을 때, 클라이언트가 해당 메소드를 호출할 때 Runtime시에 JAXB Databinding을 시도하려고 하면서 Marshalling Error가 발생하게 된다. 이를 방지하기 위해서 @XmlSeeAlso Annotation 혹은 JDK1.5의 Generic Type을 설정하도록 한다.

@XmlSeeAlso 사용 예제

@WebService
@XmlSeeAlso({Movie.class})
public interface MovieService {

    public List getMovieList(SearchVO searchVO);
    중략...

JDK 1.5의 Generic Type 사용 예제

@WebService
public interface MovieService {

    public List<Movie> getMovieList(SearchVO searchVO);
    중략...

JavaBeans Class

다음은 Movie Service의 인터페이스 메소드를 통해 클라이언트와 서버 간 주고받는 데이터인 Movie 클래스를 작성한 Movie.java 의 일부이다.

public class Movie implements Serializable {
    private String movieId = "";
    private String title = "";
    private String director = "";

    <!-- MTOM을 사용하지 않고 기존에 XML 문서의 일부로 바이너리 데이터를 전송하는 경우 -->
    private byte[] posterImgByteArray = null;

    <!-- MTOM을 이용하여 XML 문서 일부가 아닌 첨부파일 형태로 바이너리 데이터를 전송하는 경우 -->
    @XmlMimeType("application/octet-stream")
    private DataHandler posterImgDataHandler = null;

    public byte[] getPosterImgByteArray() {
        return posterImgByteArray;
    }

    public void setPosterImgByteArray(byte[] posterImgByteArray) {
        this.posterImgByteArray = posterImgByteArray;
    }

    public DataHandler getPosterImgMTOM() {
        return posterImgDataHandler;
    }

    public void setPosterImgDataHandler(DataHandler posterImgDataHandler) {
        this.posterImgDataHandler = posterImgDataHandler;
    }
        중략...

Test case

Spring Configuration XML Server 설정 이용(JAX-WS Frontend)

Spring Configuration XML 설정을 통해 MTOM Databinding 사용을 정의할 수 있다.

<!-- JAX-WS Frontend to expose MovieService with MTOM Databinding -->
<jaxws:endpoint id="movieService" implementor="org.anyframe.sample.cxf.jaxws.movie.impl.MovieServiceImpl" address="/ws">
     <jaxws:properties>
        <entry key="mtom-enabled" value="true"/>
     </jaxws:properties>
</jaxws:endpoint>
중략...

Test Case

MTOM을 이용하여 XML 문서 일부가 아닌 첨부파일 형태로 바이너리 데이터를 전송하는 경우에 MTOM Databinding 기능이 올바로 동작하여 Movie의 poster image 바이너리 파일을 조회하고 수정이 되는지 테스트한다.

Spring Configuration XML Client 설정 이용(JAX-WS Frontend)

Spring Configuration XML 설정을 통해 MTOM Databinding 사용을 정의할 수 있다.

<!-- JAX-WS Frontend to access MovieService with MTOM Databinding -->
<jaxws:client id="movieService" serviceClass="org.anyframe.sample.cxf.jaxws.movie.MovieService" 
     address="http://localhost:8080/myproject/cxf-jaxws/ws">
     <jaxws:properties>
        <entry key="mtom-enabled" value="true"/>
     </jaxws:properties>
</jaxws:client>
중략...