4장. REST 서비스 정의

REST DSL( camel-core)은 REST 서비스를 정의하는 간소화된 빌더 API를 제공하는 facade 또는 래퍼 계층입니다. REST DSL은 자체적으로 REST 구현을 제공하지 않습니다. 기본 REST 구현과 결합해야 합니다. 예를 들어 다음 Java 코드는 REST DSL을 사용하여 간단한 Hello World 서비스를 정의하는 방법을 보여줍니다.

rest("/say")
    .get("/hello/{name}").route().transform().simple("Hello ${header.name}");

자세한 내용은 4.2절. “REST DSL을 사용하여 서비스 정의” 에서 참조하십시오.

Rest 구성 요소( camel-core)는 URI 구문을 사용하여 REST 서비스를 정의할 수 있는 래퍼 계층입니다. REST DSL과 마찬가지로 Rest 구성 요소는 자체적으로 REST 구현을 제공하지 않습니다. 기본 REST 구현과 결합해야 합니다.

HTTP 전송 구성 요소를 명시적으로 구성하지 않으면 REST DSL은 classpath에서 사용 가능한 구성 요소를 확인하여 사용할 HTTP 구성 요소를 자동으로 검색합니다. REST DSL은 모든 HTTP 구성 요소의 기본 이름을 찾고 찾은 첫 번째 구성 요소를 사용합니다. classpath에 HTTP 구성 요소가 없고 HTTP 전송을 명시적으로 구성하지 않은 경우 기본 HTTP 구성 요소는 camel-http 입니다.

다음 Java 코드는 camel-rest 구성 요소를 사용하여 간단한 Hello World 서비스를 정의하는 방법을 보여줍니다.

from("rest:get:say:/hello/{name}").transform().simple("Hello ${header.name}");

Spark-Rest 구성 요소( camel-spark-rest)는 URI 구문을 사용하여 REST 서비스를 정의할 수 있는 REST 구현입니다. Spark 프레임워크 자체는 Sinatra 프레임워크(Python API)를 기반으로 하는 Java API입니다. 예를 들어 다음 Java 코드는 Spark-Rest 구성 요소를 사용하여 간단한 Hello World 서비스를 정의하는 방법을 보여줍니다.

from("spark-rest:get:/say/hello/:name").transform().simple("Hello ${header.name}");

Rest 구성 요소와 달리 URI의 변수 구문은 {name} 대신 :name }입니다.

Restlet 구성 요소( camel-restlet)는 기본적으로 서로 다른 전송 프로토콜 위에 계층화할 수 있는 REST 구현입니다(이 구성 요소는 HTTP 프로토콜에 대해서만 테스트됨). 또한 이 구성 요소는 Java에서 REST 서비스를 개발하기 위한 상용 프레임워크인 Restlet Framework 와의 통합을 제공합니다. 예를 들어 다음 Java 코드는 Restlet 구성 요소를 사용하여 간단한 Hello World 서비스를 정의하는 방법을 보여줍니다.

from("restlet:http://0.0.0.0:9091/say/hello/{name}?restletMethod=get")
    .transform().simple("Hello ${header.name}");

자세한 내용은 Apache Camel 구성 요소 참조 가이드의 Restlet 을 참조하십시오.

Servlet 구성 요소( camel-servlet)는 Java 서블릿을 Camel 경로에 바인딩하는 구성 요소입니다. 즉, Servlet 구성 요소를 사용하면 표준 Java 서블릿인 것처럼 Camel 경로를 패키징하고 배포할 수 있습니다. 따라서 서블릿 구성 요소는 서블릿 컨테이너(예: Apache Tomcat HTTP 서버 또는 JBoss Enterprise Application Platform 컨테이너) 내에 Camel 경로를 배포해야 하는 경우 특히 유용합니다.

그러나 서블릿 구성 요소는 자체적으로 REST 서비스를 정의하기 위한 편리한 REST API를 제공하지 않습니다. 따라서 서블릿 구성 요소를 사용하는 가장 쉬운 방법은 사용자 친화적인 API로 REST 서비스를 정의할 수 있도록 REST DSL과 결합하는 것입니다.

자세한 내용은 Apache Camel 구성 요소 참조 가이드의 Servlet 을 참조하십시오.