Colin's Blog
[java] Java Apache CXF와 Docker 통합

이번 글에서는 Java와 Apache CXF를 사용하여 Docker와의 통합을 어떻게 할 수 있는지 알아보겠습니다. Apache CXF는 Java 기반의 웹 서비스 프레임워크로, Docker는 컨테이너화된 어플리케이션을 관리하는 플랫폼입니다.

1. Docker 설치 및 설정

Docker를 사용하기 위해서는 Docker를 설치해야 합니다. 해당하는 운영체제에 맞게 Docker를 설치하고, Docker daemon을 실행해야 합니다. Docker daemon은 Docker의 주요 구성 요소로, Docker 컨테이너를 생성하고 관리하는 역할을 합니다.

2. Apache CXF 웹 서비스 구성

Apache CXF를 사용하여 웹 서비스를 구축해야 합니다. Apache CXF는 다양한 프로토콜과 데이터 형식을 지원하며, 간단하고 효율적인 웹 서비스 개발을 위한 많은 기능을 제공합니다.

다음은 Apache CXF를 사용하여 간단한 Hello World 웹 서비스를 만드는 예시입니다.

// HelloWorld.java
package com.example;

import javax.jws.WebMethod;
import javax.jws.WebService;

@WebService
public class HelloWorld {
    @WebMethod
    public String sayHello(String name) {
        return "Hello, " + name + "!";
    }
}

Apache CXF는 웹 서비스를 개발하기 위해 JAXB(Java Architecture for XML Binding)를 사용합니다. 따라서 위의 예시에서 @WebService 어노테이션을 사용하여 웹 서비스를 정의하고, @WebMethod 어노테이션을 사용하여 웹 메서드를 정의합니다.

3. Docker 컨테이너 생성 및 실행

Docker 컨테이너를 생성하고 실행하기 위해 Docker 이미지를 빌드해야 합니다. Docker 이미지는 Docker 컨테이너를 생성하는 데 필요한 파일 및 설정 정보를 포함하고 있습니다.

Docker 이미지를 빌드하기 위해서는 Dockerfile을 작성해야 합니다. 다음은 Apache CXF와 Java를 사용하여 Docker 컨테이너를 생성하는 Dockerfile의 예시입니다.

# Dockerfile
FROM openjdk:8-jre-alpine

WORKDIR /app

COPY ./target/myapp.jar .

CMD ["java", "-jar", "myapp.jar"]

위의 Dockerfile은 OpenJDK 8 JRE 기반으로 동작하는 Docker 컨테이너를 생성하며, /app 디렉토리에 myapp.jar 파일을 복사한 후, java -jar myapp.jar 명령을 실행합니다.

Docker 이미지를 빌드하고 컨테이너를 실행하려면 다음 명령을 실행합니다.

$ docker build -t myapp .
$ docker run -p 8080:8080 myapp

4. Apache CXF와 Docker 컨테이너 연결

Docker 컨테이너를 실행한 후에는 Apache CXF와 Docker 컨테이너를 연결할 수 있습니다. 이를 통해 Apache CXF를 사용하여 웹 서비스에 접근할 수 있습니다.

아래 예시는 Apache CXF를 사용하여 Docker 컨테이너 내에 실행 중인 웹 서비스에 접근하는 Java 코드입니다.

// Client.java
package com.example.client;

import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;
import com.example.HelloWorld;

public class Client {
    public static void main(String[] args) {
        String endpointAddress = "http://localhost:8080/HelloWorld";
        JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean();
        factory.setServiceClass(HelloWorld.class);
        factory.setAddress(endpointAddress);
        
        HelloWorld service = (HelloWorld) factory.create();
        String result = service.sayHello("Alice");
        
        System.out.println(result);
    }
}

위의 예시는 JaxWsProxyFactoryBean을 사용하여 웹 서비스의 클라이언트를 생성하고, sayHello 메서드를 호출하여 결과를 출력합니다. endpointAddress는 실행 중인 Docker 컨테이너의 IP 주소와 포트를 가리킵니다.

이제 Apache CXF와 Docker를 통합하여 웹 서비스에 접근할 수 있는 환경이 구성되었습니다.

결론

이번 글에서는 Java Apache CXF와 Docker를 통합하는 방법에 대해 알아보았습니다. Docker를 사용하여 웹 서비스를 배포하고 Apache CXF를 사용하여 해당 웹 서비스에 접근할 수 있습니다. 이러한 통합은 애플리케이션의 배포 및 관리를 간편하게 할 수 있도록 도와줍니다.

더 자세한 내용은 Apache CXF 공식 문서를 참고하시기 바랍니다.

© 2018 Colin. All rights reserved.