Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

이 콘텐츠는 선택한 언어로 제공되지 않습니다.

Chapter 178. Undertow

Undertow Component
링크 복사

Available as of Camel 2.16
The undertow component provides HTTP-based endpoints for consuming and producing HTTP requests. That is, the Undertow component behaves as a simple Web server. Undertow can also be used as an HTTP client, which mean you can also use it with Camel as a producer.
Maven users will need to add the following dependency to their pom.xml for this component: 
<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-undertow</artifactId>
    <version>x.x.x</version>
    <!-- use the same version as your Camel core version -->
</dependency>
Copy to Clipboard Toggle word wrap

URI format
링크 복사

undertow:http://hostname[:port][/resourceUri][?options]
Copy to Clipboard Toggle word wrap
You can append query options to the URI in the following format, ?option=value&option=value&...

Options
링크 복사

Expand
Name
Default Value
Description
httpMethodRestrict
Used to only allow consuming if the HttpMethod matches, such as GET/POST/PUT etc. Multiple methods can be specified separated by comma.
matchOnUriPrefix
Whether or not the consumer should try to find a target consumer by matching the URI prefix if no exact match is found.
headerFilterStrategy
To use a custom HeaderFilterStrategy to filter header to and from Camel message.
sslContextParameters
To configure security by using an SSLContextParameters object. See chapter "Configuring Transport Security for Camel Components" in "Security Guide".
throwExceptionOnFailure If the option is true, HttpProducer will ignore the Exchange.HTTP_URI header, and use the endpoint's URI for request. You may also set the option throwExceptionOnFailure to be false to let the producer send all the fault response back.
transferException Option to disable throwing the HttpOperationFailedException in case of failed responses from the remote server. This allows you to get all responses regardless of the HTTP status code.
undertowHttpBinding To use a custom UndertowHttpBinding to control the mapping between Camel message and undertow.
keepAlive true Camel 2.16.1: Producer only: Setting to ensure socket is not closed due to inactivity
tcpNoDelay true Camel 2.16.1: Producer only:Setting to improve TCP protocol performance
reuseAddresses true Camel 2.16.1: Producer only:Setting to facilitate socket multiplexing
options.XXX Camel 2.16.1: Producer only:Sets additional channel options. The options that can be used are defined in org.xnio.Options. To configure from endpoint uri, then prefix each option with "option.", such as "option.close-abort=true&option.send-buffer=8192"
enableOptions false Camel 2.17: Specifies whether to enable HTTP OPTIONS for this Undertow consumer. By default OPTIONS is turned off.

Message Headers
링크 복사

Camel uses the same message headers as the HTTP component. From Camel 2.2, it also uses Exchange.HTTP_CHUNKED,CamelHttpChunked header to turn on or turn off the chuched encoding on the camel-undertow consumer.
Camel also populates all request.parameter and request.headers. For example, given a client request with the URL, http://myserver/myserver?orderid=123, the exchange will contain a header named orderid with the value 123.

Component Options
링크 복사

The UndertowComponent provides the following options:
Expand
Name
Default Value
Description
undertowHttpBinding
To use a custom UndertowHttpBinding to control the mapping between Camel message and undertow.
httpConfiguration
To use the shared HttpConfiguration as base configuration.

Producer Example
링크 복사

The following is a basic example of how to send an HTTP request to an existing HTTP endpoint.
in Java DSL 
from("direct:start").to("undertow:http://www.google.com");
Copy to Clipboard Toggle word wrap
or in Spring XML 
<route>
    <from uri="direct:start"/>
    <to uri="undertow:http://www.google.com"/>
<route>
Copy to Clipboard Toggle word wrap

Consumer Example
링크 복사

In this sample we define a route that exposes a HTTP service at http://localhost:8080/myapp/myservice: 
<route>
  <from uri="undertow:http://localhost:8080/myapp/myservice"/>
  <to uri="bean:myBean"/>
</route>
Copy to Clipboard Toggle word wrap
When you specify localhost in a URL, Camel exposes the endpoint only on the local TCP/IP network interface, so it cannot be accessed from outside the machine it operates on.
If you need to expose a Jetty endpoint on a specific network interface, the numerical IP address of this interface should be used as the host. If you need to expose a Jetty endpoint on all network interfaces, the 0.0.0.0 address should be used.
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat