Interface Class

다음은 Movie Service의 인터페이스 클래스를 작성한 MovieService.java 의 일부이다. 인터페이스 클래스 상단에 @WebService Annotation을 작성해줘야 한다. @WebService Annotation의 속성 값들도 다양하게 존재하고, 각 메소드와 파라미터 별로 정의할 수 있는 Annotation의 종류도 여러가지가 있으나 필수 사항으로 필요한 Annotation은 @WebService뿐이다. 다른 종류의 Annotation에 대해서 추가 작성하는 방법에 대해서는 [참고] Web Services 작성 시 Annotation 설정 방법 을 참고하도록 한다.

@WebService
public interface MovieService {

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

	Page getPagingList(Movie movie, int pageIndex) throws Exception;
	
	중략...
}

Implementation Class

Interface Class를 구현한 클래스로 Web Service 구현과 관련된 부분 없이 작성될 수 있다. 다음은 Movie Service의 인터페이스 클래스를 구현한 MovieServiceImpl.java 의 일부이다. 내부적으로 MovieDao를 사용하여 Movie 정보를 관리하고 있다. 구현 클래스 상단에 @WebService Annotation을 작성해줄 수도 있다. 이미 인터페이스 클래스 상단에 @WebService Annotation을 작성해주었으므로 여기서는 생략시킨다. Annotation 설정 방법에 대해서는 [참고] Web Services 작성 시 Annotation 설정 방법 을 참고하도록 한다.

@Service("cxfJaxWsMovieService")
@Transactional(rollbackFor = { Exception.class }, propagation = Propagation.REQUIRED)
public class MovieServiceImpl implements MovieService {

	@Inject
	@Named("cxfJaxWsMovieDao")
	private MovieDao movieDao;

	public Map<String, Movie> get(String movieId) throws Exception {
		return this.movieDao.get(movieId);
	}

	public Page getPagingList(Movie movie, int pageIndex) throws Exception {
		return this.movieDao.getPagingList(movie, pageIndex);
	}
    중략...
}

다음은 비즈니스 레이어의 서비스를 Web Service로 노출시키는 <jaxws:endpoint/> tag 속성을 정의한 context-cxf-jaxws.xml 의 일부이다.

Configuration

<beans xmlns="http://www.springframework.org/schema/beans"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:cxf="http://cxf.apache.org/core"
  xmlns:jaxws="http://cxf.apache.org/jaxws"	
  xsi:schemaLocation="http://www.springframework.org/schema/beans
  http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
  http://cxf.apache.org/core http://cxf.apache.org/schemas/core.xsd
  http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd"> 
          			
    <!-- Load CXF modules from cxf.jar -->
    <import resource="classpath:META-INF/cxf/cxf.xml" />
    <import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />
    <import resource="classpath:META-INF/cxf/cxf-servlet.xml" /> 
	
    <!-- Enable message logging using the CXF logging feature -->   
    <cxf:bus>
        <cxf:features>
            <cxf:logging />
        </cxf:features>
    </cxf:bus>	
	
    <!-- JAX-WS Frontend to expose movieService using endpoint tag -->
    <jaxws:endpoint id="cxfJaxWsServerMovieService" implementor="#cxfJaxWsMovieService" address="/ws"/>

Jetty 혹은 Tomcat 서버 등의 WAS를 이용하여 웹 어플리케이션을 구동하고 비즈니스 레이어의 서비스를 Web Service로 노출시키게 되는데, 이때 web.xml 파일에 Spring 속성 정의 XML 파일을 org.springframework.web.context.ContextLoaderListener를 이용하여 등록시켜 줘야 한다. 다음은 CXFServlet과 ContextLoaderListener를 정의한 web.xml의 일부이다.

<web-app 
    중략...
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>
            classpath:/spring/context-*.xml
        </param-value>
    </context-param>
	
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
	중략...
    <!-- cxf-configuration-START -->  
    <servlet>
        <servlet-name>CXF-JAXWS-Servlet</servlet-name>
           <servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>	
	
    <servlet-mapping>
        <servlet-name>CXF-JAXWS-Servlet</servlet-name>
        <url-pattern>/cxf-jaxws/*</url-pattern>
    </servlet-mapping>	
    <mime-mapping>
        <extension>wsdl</extension>
        <mime-type>text/xml</mime-type>
    </mime-mapping>
    <mime-mapping>
        <extension>xsd</extension>
        <mime-type>text/xml</mime-type>
    </mime-mapping>    
    중략...
</web-app>

Apache CXF JaxWsServerFactoryBean을 사용한 서버 구동

다음은 비즈니스 레이어의 서비스를 Web Service로 노출시키는 서버를 구동하는 코드 작성 예이다.

MovieServiceImpl implementor = new MovieServiceImpl();
JaxWsServerFactoryBean svrFactory=new JaxWsServerFactoryBean();
svrFactory.setServiceClass(MovieService.class);
svrFactory.setAddress("http://localhost:8080/myproject/cxf-jaxws/ws");
svrFactory.setServiceBean(implementor);     
svrFactory.create();

Configuration

다음은 Web Services로 노출된 Movie Service에 접근하는 <jaxws:client/> tag 속성을 정의한 cxf-jaxws-servlet.xml 의 일부이다.

<beans xmlns="http://www.springframework.org/schema/beans"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:cxf="http://cxf.apache.org/core"
  xmlns:jaxws="http://cxf.apache.org/jaxws"	
  xsi:schemaLocation="http://www.springframework.org/schema/beans
  http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
  http://cxf.apache.org/core http://cxf.apache.org/schemas/core.xsd
  http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd">           				
  <jaxws:client id="cxfJaxWsClientMovieService" serviceClass="myproject.cxf.jaxws.moviefinder.service.MovieService"
    address="http://localhost:8080/myproject/cxf-jaxws/ws" />

Controller

다음은 앞서 정의한 속성 설정 파일들을 기반으로 하여 Web Services로 노출된 Movie Service에 접근하는 Controllert 클래스인 MovieController.java의 일부이다.

@Controller("cxfJaxWsMovieController")
@RequestMapping("/cxfJaxWsMovie.do")
@SessionAttributes(types = Movie.class)
public class MovieController {

	@Inject
	@Named("cxfJaxWsClientMovieService")
	private MovieService movieService;

	@RequestMapping(params = "method=get")
	public String get(@RequestParam("movieId") String movieId, Model model)
			throws Exception {
		Map<String, Movie> resultMap = this.movieService.get(movieId);
		model.addAttribute(resultMap.get("movie"));

		return "cxf-jaxws/moviefinder/movie/form";
	}
중략...

Apache CXF JaxWsProxyFactoryBean 사용한 클라이언트

다음은 Apache CXF에서 제공하는 JaxWsProxyFactoryBean 클래스를 사용하여 Web Services로 노출된 Movie Service에 접근하는 코드 작성 예이다.

JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean();
factory.setServiceClass(MovieService.class);
factory.setAddress("http://localhost:8080/myproject/cxf-jaxws/ws");

MovieService movieService = (MovieService) factory.create();
Map<String, Movie> resultMap = movieService.get("MV-00003");

@WebService annotation 설정이 적용된 클래스 내의 메소드 규칙

Interface Class

다음은 Movie Service의 인터페이스 클래스를 작성한 MovieService.java의 일부이다. 인터페이스 클래스 상단에 @WebService Annotation 작성은 필수 사항이다. 이외에 @WebMethod, @Oneway, @WebParam Annotation을 설정해보고 어떻게 동작하는지 살펴보도록 한다.

@WebService
public interface MovieService {
    // ================= method for Annotation tests
    @WebMethod(exclude = true)
    public void testAnnotationMethodExclude();

    @WebMethod(operationName = "testAnnotationMethodInclude")
    public void testAnnotationMethod();

    @Oneway
    public String testAnnotationOneWay();

    public String testAnnotationWebParam(
            @WebParam(name = "movieAnnotationWebParam") String input);
    중략...

Implementation Class

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

@Service("cxfJaxWsMovieService")
public class MovieServiceImpl implements MovieService {

	@Inject
	@Named("cxfJaxWsMovieDao")
	private MovieDao movieDao;

	// ================= method for Annotation tests
	public void testAnnotationMethodExclude() {
		MovieService.LOGGER.debug("testAnnotationMethodExclude method is called.");
	}

	public void testAnnotationMethod() {
		MovieService.LOGGER.info("testAnnotationMethod method is called.");
	}

	public String testAnnotationOneWay() {
		MovieService.LOGGER.debug("testAnnotationOneWay method is called.");
		return "testAnnotationOneWay";
	}

	public String testAnnotationWebParam(String input) {
		MovieService.LOGGER.debug("testAnnotationWebParam method is called with the input parameter="
						+ input);
		return "testAnnotationWebParam";
	}
    중략...

Test case

다음은 Apache CXF에서 제공하는 JaxWsProxyFactoryBean 클래스를 사용하여 Web Services로 노출된 Movie Service에 접근하는 테스트케이스 JaxWsFrontendServerFactoryAnnotationTest.java의 일부이다. WebServices Annotation 설정 값에 따라 어떻게 동작하는지 확인해보도록 한다.

@RunWith(JUnit4.class)
public class JaxWsFrontendServerFactoryAnnotationTest extends ServerRunner {				
    /**
     * [Flow #-1] Positive Case : @WebMethod annotation을 이용하여
     *                            특정 method를 Web Service method로 노출되지 않도록 한다.
     *                            @WebMethod의 속성 값 중 exclude 값을 true로 설정한다.
     *                            (ex. @WebMethod(exclude=true) )
     */      
    @Test
    public void testAnnotationMethodExclude() {
        Client client = new JaxWsClient();
        MovieService movieService =
            (MovieService) client.getClient(new ClientInfo(MovieService.class,
                "http://localhost:9002/Movie", false));

        try {
            movieService.testAnnotationMethodExclude();
            Assert.fail();
        } catch (Exception e) {
            // Exception should be occurred.
            if (!(e instanceof WebServiceException))
            	Assert.fail();
        }
    }

    /**
     * [Flow #-2] Positive Case : @WebMethod annotation을 이용하여
     *                            특정 method name을 다른 name으로 변경하여 호출가능하도록 한다.
     *                            @WebMethod의 속성 값 중 operationName 값을 다른 name으로 설정한다.
     *                            (ex. @WebMethod(operationName="testAnnotationMethodInclude") )
     *                            
     *                            실제 SEI에서 제공하는 method는 testAnnotationMethod 뿐이고, 
     *                            @WebMethod 속성 값 중 operationName값을 testAnnotationMethodInclude로 설정해놓았으므로,
     *                            Client에서 Web Service method를 호출할 때에는 testAnnotationMethodInclude method를 갖는
     *                            Service Interface class를 재정의해서 호출하여 사용하도록 한다.
     */   
    @Test
    public void testAnnotationMethodInclude() {
        Client client = new JaxWsClient();
        org.anyframe.sample.cxf.jaxws.moviefinder.service.MovieServiceWebMethod movieService =
            (org.anyframe.sample.cxf.jaxws.moviefinder.service.MovieServiceWebMethod) client.getClient(
            		new ClientInfo(org.anyframe.sample.cxf.jaxws.moviefinder.service.MovieServiceWebMethod.class,
            		"http://localhost:9002/Movie", false));
        
        try {
            movieService.testAnnotationMethodInclude();
        } catch (Exception e) {
            // It should not be failed.
        	Assert.fail();
        }
    }
중략...

Temporary Interface Class

다음은 Movie Service의 인터페이스 클래스를 작성한 MovieServiceAsynch.java의 일부이다. JAX-WS Frontend 모델을 이용하여 Web Service를 구현하므로, 인터페이스 클래스 상단에 @WebService Annotation을 작성해줘야 한다. 인터페이스 메소드로는 findMovieListAll() 메소드를 정의하고, 클라이언트에서 asynchronous하게 이 메소드를 호출하고자 한다. 실제로는 이 인터페이스를 사용하지 않는다. WSDL 파일을 생성시키고자 하는 목적에서 작성한 것 이다. 실제로는 WSDL 파일로부터 생성된 인터페이스 클래스를 사용하게 됨에 유의하도록 한다.

@WebService(targetNamespace = "http://service.asynch.moviefinder.jaxws.cxf.sample.anyframe.org/asynch_soap_http")
public interface MovieServiceAsynch {

    public List<Movie> findMovieListAll() throws Exception;

}
...중략

WSDL 파일 생성

인터페이스 클래스를 기준으로 WSDL 파일을 생성시키도록 한다. 이때 Apache CXF에서 제공하는 Tool 중 java2ws을 이용하여 생성시킨다. Command Prompt 상에서 아래와 같은 명령어를 수행시키도록 한다. 수행 시키는 위치는 프로젝트가 존재하는 루트 폴더이다.

command>java2ws -wsdl -cp target/classes org.anyframe.sample.cxf.jaxws.moviefinder.asynch.service.MovieServiceAsynch

다음은 생성된 WSDL 파일(MovieServiceAsynchService.wsdl)의 일부이다. 생성된 후 soap:address location 정보 등 수정하고 싶은 정보가 있는 경우 변경하도록 한다.

<wsdl:definitions name="MovieServiceAsynchService" 
    targetNamespace="http://service.asynch.moviefinder.jaxws.cxf.sample.anyframe.org/asynch_soap_http" 
    중략...
    <wsdl:binding name="MovieServiceAsynchServiceSoapBinding" type="tns:MovieServiceAsynch">
        <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
        <wsdl:operation name="findMovieListAll">
            <soap:operation soapAction="" style="document"/>
            <wsdl:input name="findMovieListAll">
                <soap:body use="literal"/>
            </wsdl:input>
            <wsdl:output name="findMovieListAllResponse">
                <soap:body use="literal"/>
            </wsdl:output>
        </wsdl:operation>
    </wsdl:binding>
    <wsdl:service name="MovieServiceAsynchService">
        <wsdl:port name="MovieServiceAsynchPort" binding="tns:MovieServiceAsynchServiceSoapBinding">
            <soap:address location="http://localhost:9002/Movie"/>
        </wsdl:port>
    </wsdl:service>
</wsdl:definitions>
...중략

Configuration

Asynchronous 기능을 제공하는 Java 소스 코드를 생성하기 위해서는 WSDL 파일 뿐아니라 asynch_binding.xml 파일도 함께 필요하다. 다음은 asynch_binding.xml 의 일부이다. 여기서 wsdlLocation 부분에 유의하여 작성하도록 한다.

<bindings
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
    wsdlLocation="MovieServiceAsynchService.wsdl"
    xmlns="http://java.sun.com/xml/ns/jaxws">
    <bindings node="wsdl:definitions">
        <enableAsyncMapping>true</enableAsyncMapping>
    </bindings>
</bindings>
중략...

Java 코드 생성

지금까지 준비된 WSDL 파일과 asynch_binding.xml 파일을 이용하여 Asynchronous 기능을 제공하는 Java 소스 코드를 생성하도록 한다. 이때 Apache CXF에서 제공하는 Tool 중 wsdl2java을 이용하여 생성시킨다. Command Prompt 상에서 아래와 같은 명령어를 수행시키도록 한다. 수행 시키는 위치는 프로젝트가 존재하는 루트 폴더이다.

command>wsdl2java -d src -b src/test/resources/jaxws/asynch/wsdl/asynch_binding.xml
                    src/test/resources/jaxws/asynch/wsdl/MovieServiceAsynchService.wsdl

Tool을 통해 생성되는 Java 코드들은 모두 org.anyframe.sample.cxf.jaxws.moviefinder.asynch.service.asynch_soap_http package 하위에 위치한다. MovieService의 인터페이스 클래스인 MovieServiceAsynch.java, MovieService 접근을 위한 WebService Client 클래스인 MovieServiceAsynchService.java, JavaBeans 클래스인 Movie.java 클래스 등 여러 가지의 Java 소스 코드가 생성된다. 다음은 생성된 인터페이스 클래스인 MovieServiceAsynch.java의 일부이다. 이 인터페이스 클래스가 실제로 사용된다. Polling approach 방식 및 Callback approach에서 사용되는 2개의 findMovieListAllAsync() 메소드가 추가로 생성되어 있음을 확인할 수 있다.

@WebService(targetNamespace = "http://service.asynch.moviefinder.jaxws.cxf.sample.anyframe.org/asynch_soap_http", 
    name = "MovieServiceAsynchService")
@XmlSeeAlso( {ObjectFactory.class })
public interface MovieServiceAsynch {

    @ResponseWrapper(localName = "findMovieListAllResponse", 
      targetNamespace = "http://service.asynch.moviefinder.jaxws.cxf.sample.anyframe.org/asynch_soap_http", 
      className = "org.anyframe.sample.cxf.jaxws.moviefinder.asynch.service.asynch_soap_http.FindMovieListAllResponse")
    @RequestWrapper(localName = "findMovieListAll", 
      targetNamespace = "http://service.asynch.moviefinder.jaxws.cxf.sample.anyframe.org/asynch_soap_http", 
      className = "org.anyframe.sample.cxf.jaxws.moviefinder.asynch.service.asynch_soap_http.FindMovieListAll")
    @WebResult(name = "return", targetNamespace = "")
    @WebMethod
    public java.util.List<org.anyframe.sample.cxf.jaxws.moviefinder.asynch.service.asynch_soap_http.Movie> 
      findMovieListAll() throws Exception;

    @ResponseWrapper(localName = "findMovieListAllResponse", 
      targetNamespace = "http://service.asynch.moviefinder.jaxws.cxf.sample.anyframe.org/asynch_soap_http", 
      className = "org.anyframe.sample.cxf.jaxws.moviefinder.asynch.service.asynch_soap_http.FindMovieListAllResponse")
    @RequestWrapper(localName = "findMovieListAll", 
      targetNamespace = "http://service.asynch.moviefinder.jaxws.cxf.sample.anyframe.org/asynch_soap_http", 
      className = "org.anyframe.sample.cxf.jaxws.moviefinder.asynch.service.asynch_soap_http.FindMovieListAll")
    @WebMethod(operationName = "findMovieListAll")
    public Response<org.anyframe.sample.cxf.jaxws.moviefinder.asynch.service.asynch_soap_http.FindMovieListAllResponse> 
      findMovieListAllAsync();

    @ResponseWrapper(localName = "findMovieListAllResponse", 
      targetNamespace = "http://service.asynch.moviefinder.jaxws.cxf.sample.anyframe.org/asynch_soap_http", 
      className = "org.anyframe.sample.cxf.jaxws.moviefinder.asynch.service.asynch_soap_http.FindMovieListAllResponse")
    @RequestWrapper(localName = "findMovieListAll", 
      targetNamespace = "http://service.asynch.moviefinder.jaxws.cxf.sample.anyframe.org/asynch_soap_http", 
      className = "org.anyframe.sample.cxf.jaxws.moviefinder.asynch.service.asynch_soap_http.FindMovieListAll")
    @WebMethod(operationName = "findMovieListAll")
    public Future<?> findMovieListAllAsync(
      @WebParam(name = "asyncHandler", targetNamespace = "")
      AsyncHandler<org.anyframe.sample.cxf.jaxws.moviefinder.asynch.service.asynch_soap_http.FindMovieListAllResponse> 
          asyncHandler);
중략...

Implementation Class

Interface Class를 구현한 구현 클래스로 2개의 findMovieListAllAsync() 메소드에 대해서 빈 내용으로 구현 메소드만 작성해놓는다. 실제로 호출되지는 않는다. 다음은 Movie Service의 인터페이스 클래스인 MovieServiceAsynch를 구현한 MovieServiceImpl.java 의 일부이다.

@WebService(serviceName = "MovieServiceAsynchService", portName = "MovieServiceAsynchPort", 중략...
public class MovieServiceImpl implements MovieServiceAsynch {
    public List<Movie> findMovieListAll() throws Exception {
        return this.movieDao.findMovieListAll();
    }

    public Response<FindMovieListAllResponse> findMovieListAllAsync() {
        return null;
        /* not called */
    }

    public Future<?> findMovieListAllAsync(
            AsyncHandler<FindMovieListAllResponse> asyncHandler) {
        return null;
        /* not called */
    }
중략...

Apache CXF JaxWsServerFactoryBean 사용한 서버 구동

다음은 서버 사이드의 서비스를 Web Services로 노출시키는 서버를 구동하는 코드 작성 예이다. 인터페이스 클래스, 구현 클래스의 인스턴스, Web Services 주소를 JaxWsServerFactoryBean 속성 정보로 설정해준다.

MovieServiceImpl implementor = new MovieServiceImpl();
JaxWsServerFactoryBean svrFactory=new JaxWsServerFactoryBean();
svrFactory.setServiceClass(MovieServiceAsynch.class);
svrFactory.setAddress("http://localhost:9002/Movie");
svrFactory.setServiceBean(implementor);     
svrFactory.create();

Callback approach 사용 시 AsyncHandler 클래스 구현

Polling approach 방식을 사용하면 부가 작성해야 하는 클래스가 없지만, Callback approach 방식을 사용하려면 AsynchHandler 클래스를 추가 구현해줘야 한다. javax.xml.ws.AsyncHandler 인터페이스를 implement 하며, handleReponse method를 구현하여야 한다. 다음은 AsyncHandler 클래스를 구현한 MovieAsyncHandler.java의 일부이다.

public class MovieAsyncHandler implements AsyncHandler<FindMovieListAllResponse> {
    
    private FindMovieListAllResponse reply;

    public void handleResponse(Response<FindMovieListAllResponse> response) {
        try {
            LOGGER.debug("The handleResponse method of MovieAsyncHandler is called.");
            reply = response.get();
        } catch (Exception ex) {
            ex.printStackTrace();
        }
    }
    
    public List<Movie> getResponse() {
        return reply.getReturn();
    }
    ...중략

Test case

다음은 앞서 작성한 코드와 Tool을 통해 생성된 Java 코드들을 이용하여 Web Services로 노출된 Movie Service에 접근하는 JaxWsAsynchTest.java의 일부이다. Tool을 통해 생성된 WebService Client 코드인 MovieServiceAsynchService를 통해, Web Services로 노출된 Movie Service의 인터페이스 메소드를 asynchronous하게 호출한다. 이때 WSDL 파일과 서비스명을 이용하여 접근하도록 한다. Movie Service를 얻은 후에는 Movie Service에서 findMovieListAllAsync() 메소드를 비동기 방식으로 호출하여 동작이 올바른지 테스트해본다.

@RunWith(JUnit4.class)
public class JaxWsAsynchTest extends ServerRunner {
    
    private static final QName SERVICE_NAME =
        new QName("http://service.asynch.moviefinder.jaxws.cxf.sample.anyframe.org/asynch_soap_http",
            "MovieServiceAsynchService");
          				
    /**
     * [Flow #-2] Positive Case : Asynchronous method invocation 방식 중 Polling approach 방법으로
     *                            List 형태의 Movie 전체 목록을 조회한다.
     * @throws Exception
     *         throws exception which is from service
     */   
    @Test
    public void testFindMovieListAllPolling() throws Exception {

        File wsdl = new File("src/test/resources/jaxws/asynch/wsdl/MovieServiceAsynchService.wsdl");

        MovieServiceAsynchService client =
            new MovieServiceAsynchService(wsdl.toURL(), SERVICE_NAME);
        MovieServiceAsynch movieService = client.getMovieServiceAsynchPort();

        // 1. find movie list all
        Response<FindMovieListAllResponse> response =
            movieService.findMovieListAllAsync();

        // 2. wait for response after asynchronous method invocation
        while (!response.isDone()) {
            Thread.sleep(100);
        }

        // 3. check the movie list count
        FindMovieListAllResponse reply = response.get();
        Assert.assertEquals(2, reply.getReturn().size());
    }

    /**
     * [Flow #-3] Positive Case : Asynchronous method invocation 방식 중 Callback approach 방법으로
     *                            List 형태의 Movie 전체 목록을 조회한다.
     * @throws Exception
     *         throws exception which is from service
     */   
    @Test
    public void testFindMovieListAllCallback() throws Exception {

        File wsdl = new File("src/test/resources/jaxws/asynch/wsdl/MovieServiceAsynchService.wsdl");

        MovieServiceAsynchService client =
            new MovieServiceAsynchService(wsdl.toURL(), SERVICE_NAME);
        MovieServiceAsynch movieService = client.getMovieServiceAsynchPort();

        // 1. find movie list all
        MovieAsyncHandler asynchHandler = new MovieAsyncHandler();
        Future<?> response = movieService.findMovieListAllAsync(asynchHandler);

        // 2. wait for response after asynchronous method invocation
        while (!response.isDone()) {
            Thread.sleep(100);
        }

        // 3. check the movie list count
        List<Movie> reply = asynchHandler.getResponse();
        Assert.assertEquals(2, reply.size());
    }          				
중략...

Anyframe에서 제공하는 Plugin들은 Jetty 기반으로 구성되어 있으므로 기본적으로 8080 포트를 이용한다. 따라서, WebLogic을 활용할 경우에는 샘플 어플리케이션의 cxf-jaxws-servlet.xml 파일을 열고, 'http://localhost:8080/...' 부분을 'http://localhost:{Weblogic 사용 포트}/...'로 변경해주어야 한다.

EAR Folder를 구성한다. 예를 들어 myproject라는 이름의 프로젝트를 ear로 작업한다면 다음과 같이 2개의 폴더 형태로 구성할 수 있다.

myproject.ear/ META-INF
             / myproject

META-INF 폴더에 application.xml을 배포한다. 아래 내용을 예시로 참고한다.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE application PUBLIC "-//Sun Microsystems,Inc.//DTD J2EE Application 1.3//EN"
    "http://java.sun.com/dtd/application_1_3.dtd">
<application>
    <display-name>Sample</display-name>
    <module>
        <web>
            <web-uri>myproject</web-uri>
            <context-root>/myproject</context-root>
        </web>
    </module>
</application>

META-INF 폴더에 weblogic-application.xml 파일을 배포한다. javax.jws package에 대해서 WEB-INF/lib 폴더 내에 있는 라이브러리를 우선 참조하도록 설정한다. 아래 내용을 예시로 참고한다. weblogic-application.xml 작성 방법은 이곳 을 참고하도록 한다.

<?xml version="1.0" encoding="UTF-8"?>
<weblogic-application xmlns="http://www.bea.com/ns/weblogic/90">
    <prefer-application-packages>
	    <package-name>javax.jws.*</package-name>
    </prefer-application-packages>
</weblogic-application>

myproject 폴더 내 WEB-INF에 weblogic.xml 파일을 배포한다. 웹 어플리케이션 내 라이브러리 및 클래스 파일들을 우선 참조하도록 설정한다. 아래 내용을 예시로 참고한다.

<?xml version="1.0" encoding="ISO-8859-1"?>
<weblogic-web-app xmlns="http://www.bea.com/ns/weblogic/90">
  	 <container-descriptor>
	     <prefer-web-inf-classes>true</prefer-web-inf-classes>
	 </container-descriptor>
</weblogic-web-app>

myproject 폴더 내 WEB-INF/lib 폴더 내에 있는 xmlbeans-x.x.x.jar 파일을 제거한다.

JDK_HOME/jre/lib/endorsed 폴더에 geronimo-ws-metadata_2.0_spec-1.1.2.jar 파일을 복사한다.

WebLogic 서버 설치 시 설정했던 JDK 1.5의 위치를 확인하여 JDK_HOME/jre/lib 폴더 하위에 endorsed 폴더를 생성하고, 현재 배포하려고 하는 웹 어플리케이션의 WEB-INF/lib 폴더 하위의 geronimo-ws-metadata_2.0_spec-1.1.2.jar 파일을 endorsed 폴더 하위로 복사해 넣도록 한다.

[참고사항] 이 경우, 위 작업 내용이 WebLogic 서버 전체에 영향을 미치므로 주의하도록 한다.

Anyframe에서 제공하는 Plugin들은 Jetty 기반으로 구성되어 있으므로 기본적으로 8080 포트를 이용한다. 따라서, WebLogic을 활용할 경우에는 샘플 어플리케이션의 cxf-jaxws-servlet.xml 파일을 열고, 'http://localhost:8080/...' 부분을 'http://localhost:{Weblogic 사용 포트}/...'로 변경해주어야 한다.

EAR Folder를 구성한다. 예를 들어 myproject라는 이름의 프로젝트를 ear로 작업한다면 다음과 같이 2개의 폴더 형태로 구성할 수 있다.

myproject.ear/ META-INF
             / myproject

META-INF 폴더에 application.xml을 배포한다. 아래 내용을 예시로 참고한다.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE application PUBLIC "-//Sun Microsystems,Inc.//DTD J2EE Application 1.3//EN"
    "http://java.sun.com/dtd/application_1_3.dtd">
<application>
    <display-name>Sample</display-name>
    <module>
        <web>
            <web-uri>myproject</web-uri>
            <context-root>/myproject</context-root>
        </web>
    </module>
</application>

META-INF 폴더에 weblogic-application.xml 파일을 배포한다. javax.jws package에 대해서 WEB-INF/lib 폴더 내에 있는 라이브러리를 우선 참조하도록 설정한다. 아래 내용을 예시로 참고한다.

<?xml version="1.0" encoding="UTF-8"?>
<weblogic-application>
    <prefer-application-packages>
    	<package-name>javax.persistence.*</package-name>
	    <package-name>javax.jws.*</package-name>
    </prefer-application-packages>
</weblogic-application>

myproject 폴더 내 WEB-INF에 weblogic.xml 파일을 배포한다. 웹 어플리케이션 내 라이브러리 및 클래스 파일들을 우선 참조하도록 설정한다. 아래 내용을 예시로 참고한다.

<?xml version="1.0" encoding="ISO-8859-1"?>
<weblogic-web-app>
  	 <container-descriptor>
	     <prefer-web-inf-classes>true</prefer-web-inf-classes>
	 </container-descriptor>
</weblogic-web-app>

myproject 폴더 내 WEB-INF/lib 폴더 내에 있는 xmlbeans-x.x.x.jar 파일을 제거한다.

Anyframe에서 제공하는 Plugin들은 Jetty 기반으로 구성되어 있으므로 기본적으로 8080 포트를 이용한다. 따라서, WebLogic을 활용할 경우에는 샘플 어플리케이션의 cxf-jaxws-servlet.xml 파일을 열고, 'http://localhost:8080/...' 부분을 'http://localhost:{Weblogic 사용 포트}/...'로 변경해주어야 한다.

EAR Folder를 구성한다. 예를 들어 myproject라는 이름의 프로젝트를 ear로 작업한다면 다음과 같이 2개의 폴더 형태로 구성할 수 있다.

myproject.ear/ META-INF
             / myproject

META-INF 폴더에 application.xml을 배포한다. 아래 내용을 예시로 참고한다.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE application PUBLIC "-//Sun Microsystems,Inc.//DTD J2EE Application 1.3//EN"
    "http://java.sun.com/dtd/application_1_3.dtd">
<application>
    <display-name>Sample</display-name>
    <module>
        <web>
            <web-uri>myproject</web-uri>
            <context-root>/myproject</context-root>
        </web>
    </module>
</application>

META-INF 폴더에 weblogic-application.xml 파일을 배포한다. 아래 내용을 예시로 참고한다.

<?xml version="1.0" encoding="UTF-8"?>
<weblogic-application>
    <prefer-application-packages>
    	<package-name>javax.persistence.*</package-name>
    </prefer-application-packages>
</weblogic-application>

myproject 폴더 내 WEB-INF에 weblogic.xml 파일을 배포한다. 웹 어플리케이션 내 라이브러리 및 클래스 파일들을 우선 참조하도록 설정한다. 아래 내용을 예시로 참고한다.

<?xml version="1.0" encoding="ISO-8859-1"?>
<weblogic-web-app>
  	 <container-descriptor>
	     <prefer-web-inf-classes>true</prefer-web-inf-classes>
	 </container-descriptor>
</weblogic-web-app>

Apache CXF 2.3 사용 시: 현재 배포되는 Anyframe cxf-jaxws plugin은 Apache CXF 2.3 버전을 사용하고 있다. 이 경우 WEB-INF/lib 폴더 내에 있는 xercesImpl-x.x.x.jar 파일을 제거하고, 사용하려는 Weblogic 도메인 하위의 lib 폴더에 배포시키도록 한다.

[참고] Apache CXF 2.2.7 사용 시: 이전 버전의 Anyframe cxf plugin은 Apache CXF 2.2.7 버전을 사용하고 있다. 이 경우 WEB-INF/lib 폴더 내에 있는 xercesImpl-x.x.x.jar, stax-api-x.x.jar 파일을 제거하고 이중 xercesImpl-x.x.x.jar 파일만을 사용하려는 Weblogic 도메인 하위의 lib 폴더에 배포시키도록 한다.

myproject 폴더 내 WEB-INF/lib 폴더 내에 있는 xmlbeans-x.x.x.jar 파일과 geronimo-stax-api_1.0_spec-x.x.x.jar 파일을 제거한다.