35.3. 구성 요소 옵션


Netty 구성 요소는 아래 나열된 73 옵션을 지원합니다.

Expand
이름설명기본값유형

구성 (일반)

엔드포인트를 만들 때 NettyConfiguration을 구성으로 사용하려면 다음을 수행합니다.

 

NettyConfiguration

연결 해제 (일반)

사용 후 Netty 채널에서 연결을 끊을지 여부입니다. 소비자와 생산자 모두에 사용할 수 있습니다.

false

boolean

keepalive (common)

비활성으로 인해 소켓이 종료되지 않도록 를 설정합니다.

true

boolean

reuseAddress (일반)

을 설정하여 소켓 멀티플렉싱을 지원합니다.

true

boolean

reuseChannel (일반)

이 옵션을 사용하면 생산자 및 소비자(클라이언트 모드)가 Exchange를 처리하는 라이프사이클 동안 동일한 Netty 채널을 재사용할 수 있습니다. 이는 Camel 경로에서 서버를 여러 번 호출해야 하고 동일한 네트워크 연결을 사용하려는 경우에 유용합니다. 이 옵션을 사용하면 Exchange가 완료될 때까지 채널이 연결 풀로 반환되지 않거나 연결 끊기 옵션이 true로 설정된 경우 연결이 끊어지지 않습니다. 재사용되는 채널은 NettyConstants#NETTY_CHANNEL 키를 사용하여 Exchange 속성에 저장되며 라우팅 중에 채널을 가져와도 사용할 수 있습니다.

false

boolean

sync (common)

endpoint를 one-way 또는 request-response로 설정합니다.

true

boolean

tcpNoDelay (일반)

TCP 프로토콜 성능을 개선하기 위해 를 설정합니다.

true

boolean

bridgeErrorHandler (consumer)

소비자를 Camel 라우팅 오류 처리기에 브리징할 수 있습니다. 이는 소비자가 들어오는 메시지를 선택하는 동안 예외가 발생한 것을 의미하며, 이제 메시지로 처리되어 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 기록되고 무시되는 예외를 처리합니다.

false

boolean

송 (consumer)

를 설정하여 UDP를 통해 멀티캐스트를 선택합니다.

false

boolean

clientMode (consumer)

clientMode가 true인 경우 netty 소비자는 주소를 TCP 클라이언트로 연결합니다.

false

boolean

다시 연결 (consumer)

소비자의 clientMode에서만 사용되는 소비자는 활성화된 경우 소비자는 disconnection에서 다시 연결을 시도합니다.

true

boolean

재연결 간격 (consumer)

reconnect 및 clientMode가 활성화된 경우 사용됩니다. 다시 연결을 시도하기 위한 간격(밀리코어)입니다.

10000

int

backlog (advanced)

네트워크 소비자(서버)에 대한 백로그를 구성할 수 있습니다. 백로그는 OS에 따라 최상의 노력일 뿐입니다. 이 옵션을 200, 500 또는 1000과 같은 값으로 설정하면 TCP 스택에 이 옵션이 구성되지 않은 경우 백로그가 OS 설정에 따라 달라집니다.

 

int

bossCount (advanced)

netty가 nio 모드에서 작동하면 Netty의 기본 bossCount 매개변수를 1입니다. 사용자는 이 옵션을 사용하여 Netty에서 기본 bossCount를 재정의할 수 있습니다.

1

int

bossGroup (advanced)

NettyEndpoint에서 서버 측의 새 연결을 처리하는 데 사용할 BossGroup을 설정합니다.

 

EventLoopGroup

disconnectOnNoReply (advanced)

동기화가 활성화된 경우 이 옵션은 NettyConsumer를 지정합니다. 이 옵션은 회신이 다시 보낼 응답이 없는 위치에서 분리해야 하는 경우 NettyConsumer를 지정합니다.

true

boolean

executorService (advanced)

지정된 EventExecutorGroup을 사용하려면 다음을 수행합니다.

 

EventExecutorGroup

maximumPoolSize (advanced)

netty 소비자 주문 스레드 풀의 최대 스레드 풀 크기를 설정합니다. 기본 크기는 2 x cpu_core + 1입니다. 이 값을 eg 10으로 설정하면 2 x cpu_core plus 1이 더 높은 경우 10 스레드를 사용합니다. 그러면 재정의되고 사용됩니다. 예를 들어 8개의 코어가 있는 경우 소비자 스레드 풀은 17입니다. 이 스레드 풀은 Netty by Camel에서 받은 메시지를 라우팅하는 데 사용됩니다. 우리는 별도의 스레드 풀을 사용하여 메시지의 순서를 확인하고 일부 메시지가 차단되는 경우 작업자 스레드 (event loop)에 영향을 미치지 않습니다.

 

int

nettyServerBootstrapFactory (consumer (advanced))

사용자 지정 NettyServerBootstrapFactory를 사용하려면 다음을 수행합니다.

 

NettyServerBootstrapFactory

NetworkInterface (advanced)

UDP를 사용하는 경우 이 옵션을 사용하여 멀티캐스트 그룹에 참여하도록 eth0과 같이 네트워크 인터페이스를 이름에 지정할 수 있습니다.

 

문자열

noReplyLogLevel (advanced)

동기화가 활성화된 경우 이 옵션이 NettyConsumer에 로깅을 기록할 때 사용할 로깅 수준을 지정합니다.

열거형 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

WARN

LoggingLevel

ServerClosedChannelExceptionCaughtLogLevel (advanced)

서버(NettyConsumer)가 java.nio.channels.ClosedChannelException을 catch하는 경우 이 로깅 수준을 사용하여 기록된 것입니다. 이를 통해 클라이언트가 순조롭게 연결을 끊은 다음 Netty 서버에서 폐쇄된 예외가 발생할 수 있으므로 폐쇄 채널 예외를 로깅하지 않도록 합니다.

열거형 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

DEBUG

LoggingLevel

ServerExceptionCaughtLogLevel (advanced)

서버(NettyConsumer)가 예외를 catch하면 이 로깅 수준을 사용하여 로그됩니다.

열거형 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

WARN

LoggingLevel

serverInitializerFactory (advanced)

사용자 지정 ServerInitializerFactory를 사용하려면 다음을 수행합니다.

 

ServerInitializerFactory

UsingExecutorService (advanced)

이벤트가 동일한 채널에서 순서대로 처리되도록 정렬된 스레드 풀을 사용할지 여부입니다.

true

boolean

ConnectTimeout (producer)

소켓 연결을 사용할 수 있을 때까지 대기하는 시간입니다. 값은 밀리초 단위입니다.

10000

int

lazyStartProducer (producer)

생산자가 지연(첫 번째 메시지에서) 시작되어야 하는지 여부입니다. 지연을 시작하면 이 명령을 사용하여 시작 중에 생산자가 실패할 수 있고 경로가 시작되지 않는 상황에서 CamelContext 및 경로를 시작할 수 있습니다. 이 시작이 지연되는 것을 지연하는 것을 지연하면 Camel의 라우팅 오류 처리기를 통해 메시지를 라우팅하는 동안 시작 오류를 처리할 수 있습니다. 그런 다음 첫 번째 메시지가 처리되면 생산자를 만들고 시작하는 데 시간이 조금 걸리고 처리의 총 처리 시간이 길어질 수 있다는 점에 유의하십시오.

false

boolean

requestTimeout (producer)

원격 서버를 호출할 때 Netty 생산자에 시간 초과를 사용할 수 있습니다. 기본적으로 시간 초과는 사용되지 않습니다. 이 값은 밀리 초이므로 30000초는 30초입니다. requestTimeout은 Netty의 ReadTimeoutHandler를 사용하여 타임아웃을 트리거합니다.

 

long

clientInitializerFactory (advanced)

사용자 지정 ClientInitializerFactory를 사용하려면 다음을 수행합니다.

 

ClientInitializerFactory

상관 관계 관리자 (producer(advanced))

사용자 지정 상관 관계 관리자를 사용하여 netty 생산자와 함께 request/reply를 사용할 때 요청 및 응답 메시지가 매핑되는 방법을 관리합니다. 이는 요청 및 응답 메시지에 모두 상관 관계가 있는 경우와 같이 응답과 함께 요청을 매핑하는 방법이 있는 경우에만 사용해야 합니다. 이 기능은 동일한 채널(연결이라고도 함)에서 여러 개의 동시 메시지를 공유하려는 경우 사용할 수 있습니다. 이렇게 하면 요청 및 응답 메시지의 상관관계가 있어야 합니다. 따라서 inflight Camel Exchange에 올바른 응답을 저장하기 전에 계속 라우팅할 수 있습니다. 사용자 지정 상관 관계 관리자를 빌드할 때 TimeoutCorrelationManagerSupport를 확장하는 것이 좋습니다. 이렇게 하면 시간 초과 및 기타 복잡성도 지원됩니다. 자세한 내용은 producerPoolEnabled 옵션도 참조하십시오.

 

NettyCamelStateCorrelationManager

lazyChannelCreation (producer(advanced))

Camel 생산자가 시작될 때 원격 서버가 시작되어 실행되지 않는 경우 예외를 피하기 위해 채널을 지연할 수 있습니다.

true

boolean

producerPoolEnabled (advanced)

생산자 풀이 활성화되어 있는지 여부입니다. 중요: 이 기능을 해제하는 경우 단일 공유 연결이 생산자에 사용되는 경우에도 요청/응답에 적용됩니다. 즉, 응답이 주문되지 않은 경우 교차 응답과 관련하여 발생할 수 있는 문제가 있음을 의미합니다. 따라서 요청 및 응답 메시지에 상관 관계 ID가 있어야 Camel 콜백을 계속 처리하는 Camel 콜백에 대한 응답을 적절하게 연결할 수 있습니다. 이를 위해서는 NettyCamelStateCorrelationManager를 상관 관계 관리자로 구현하고 correlationManager 옵션을 통해 구성해야 합니다. 자세한 내용은 correlationManager 옵션도 참조하십시오.

true

boolean

producerPoolMaxIdle (advanced)

풀의 유휴 인스턴스 수에 대한 제한을 설정합니다.

100

int

producerPoolMaxTotal (advanced)

지정된 시간에 풀에서 할당할 수 있는 오브젝트 수(클라이언트로 확인 또는 유휴 대기 중) 수에 대한 제한을 설정합니다. 제한없이 음수 값을 사용합니다.

-1

int

producerPoolMinEvictableIdle (advanced)

유휴 오브젝트 제거자가 제거될 수 있기 전에 오브젝트가 풀에 유휴 상태로 있을 수 있는 최소 시간(값)을 설정합니다.

300000

long

producerPoolMinIdle (advanced)

제거 스레드(활성)가 새 오브젝트를 생성하기 전에 생산자 풀에 허용되는 최소 인스턴스 수를 설정합니다.

 

int

udpConnectionlessSending (producer(advanced))

이 옵션은 실제 화재 및 잊어버린 연결 덜 udp 전송을 지원합니다. 연결된 udp send는 수신 포트에서 수신 대기 중인 사람이 없는 경우 PortUnreachableException을 수신합니다.

false

boolean

useByteBuf (producer (advanced)

useByteBuf가 true이면 netty 생산자가 메시지 본문을 ByteBuf로 변환한 후 외부로 전송합니다.

false

boolean

hostnameVerification (보안)

SSLEngine에서 호스트 이름 확인을 활성화/비활성화하려면 다음을 수행합니다.

false

boolean

allowSerializedHeaders (advanced)

transferExchange가 true인 경우에만 TCP에 사용됩니다. true로 설정하면 헤더 및 속성의 serializable 개체가 교환에 추가됩니다. 그러지 않으면 Camel은 non-serializable 오브젝트를 제외하고 WARN 수준에서 로깅합니다.

false

boolean

autowiredEnabled (advanced)

autowiring이 활성화되었는지 여부입니다. 이는 레지스트리에서 자동 자동 연결 옵션(옵션을 autowired로 표시)에 사용하여 단일 일치 인스턴스가 있는지 확인하여 구성 요소에 구성됩니다. 이는 JDBC 데이터 소스, JMS 연결 팩토리, AWS 클라이언트 등에 자동으로 구성하는 데 사용할 수 있습니다.

true

boolean

channelGroup (advanced)

명시적인 ChannelGroup을 사용하려면 다음을 수행합니다.

 

ChannelGroup

nativeTransport (advanced)

NIO 대신 네이티브 전송 사용 여부입니다. 네이티브 전송은 호스트 운영 체제를 사용하며 일부 플랫폼에서만 지원됩니다. 사용 중인 호스트 운영 체제에 대한 netty JAR을 추가해야 합니다. 자세한 내용은 다음에서 참조하십시오. .

false

boolean

옵션 (고급)

의 접두사로 option.을 사용하여 추가 netty 옵션을 구성할 수 있습니다. 예를 들어, netty 옵션 child.keepAlive=false를 설정하는 option.child.keepAlive=false입니다. 사용할 수 있는 옵션은 Netty 설명서를 참조하십시오.

 

map

receiveBufferSize (advanced)

인바운드 통신 중에 사용할 TCP/UDP 버퍼 크기입니다. 크기는 바이트입니다.

65536

int

receiveBufferSizePredictor (advanced)

버퍼 크기 예측자를 구성합니다. Jetty 문서 및 이 메일 스레드의 세부 정보를 참조하십시오.

 

int

sendBufferSize (advanced)

아웃바운드 통신 중에 사용할 TCP/UDP 버퍼 크기입니다. 크기는 바이트입니다.

65536

int

transferExchange (advanced)

TCP에만 사용됩니다. 당신은 단지 몸 대신 전선을 통해 교환을 전송할 수 있습니다. 다음 필드가 전송됩니다. 본문, Out body, fault body, In headers, Out headers, fault headers, exchange properties, exchange exception로 전송됩니다. 이렇게 하려면 개체가 직렬화 가능 해야 합니다.This requires that the objects are serializable. Camel은 non-serializable 오브젝트를 제외하고 WARN 수준에서 로깅합니다.

false

boolean

udpByteArrayCodec (advanced)

UDP 전용. Java serialization 프로토콜 대신 바이트 배열 코덱을 사용하는 경우.

false

boolean

workercount (advanced)

netty가 nio 모드에서 작동하면 Netty(CPU_core_threads x 2)의 기본 workerCount 매개변수를 사용합니다. 사용자는 이 옵션을 사용하여 Netty에서 기본 workerCount를 덮어쓸 수 있습니다.

 

int

workerGroup (advanced)

명시적 EventLoopGroup을 보스 스레드 풀로 사용하려면 다음을 수행합니다. 예를 들어 여러 소비자 또는 생산자와 스레드 풀을 공유합니다. 기본적으로 각 소비자 또는 생산자에는 2 x CPU 수 코어 스레드가 있는 자체 작업자 풀이 있습니다.

 

EventLoopGroup

allowDefaultCodec (codec)

netty 구성 요소는 인코더/디코더 모두 null이고 텍스트 줄은 false인 경우 기본 codec를 설치합니다. allowDefaultCodec를 false로 설정하면 netty 구성 요소가 필터 체인의 첫 번째 요소로 기본 codec를 설치하지 못하게 합니다.

true

boolean

autoAppendDelimiter (codec)

텍스트 줄 코덱을 사용하여 보낼 때 끝 구분 기호를 자동으로 추가할지 여부입니다.

true

boolean

디코더MaxLineLength (codec)

텍스트 줄 코덱에 사용할 최대 줄 길이입니다.

1024

int

디코더 (codec)

사용할 디코더 목록입니다. 값이 쉼표로 구분되어 있는 String을 사용하여 레지스트리에 값을 조회할 수 있습니다.You can use a String which have values separated by comma, and have the values be looked up in the Registry. # so Camel이 조회해야 함을 알 수 있도록 값 앞에 접두사를 붙여야 합니다.

 

list

구분 기호 (codec)

텍스트 줄 코덱에 사용할 구분 기호입니다. 가능한 값은 LINE 및 NULL입니다.

열거형 값:

  • LINE
  • NULL

LINE

TextLineDelimiter

인코 더(codec)

사용할 인코더 목록입니다. 값이 쉼표로 구분되어 있는 String을 사용하여 레지스트리에 값을 조회할 수 있습니다.You can use a String which have values separated by comma, and have the values be looked up in the Registry. # so Camel이 조회해야 함을 알 수 있도록 값 앞에 접두사를 붙여야 합니다.

 

list

인코딩 (codec)

텍스트 줄 코덱에 사용할 인코딩( charset 이름)입니다. 제공되지 않는 경우 Camel은 JVM 기본 Charset을 사용합니다.

 

문자열

텍스트 라인 (codec)

TCP에만 사용됩니다. 코덱을 지정하지 않으면 이 플래그를 사용하여 텍스트 라인 기반 코덱을 나타낼 수 있습니다. 지정하지 않거나 값이 false인 경우 Object Serialization은 TCP를 통해 가정되지만 기본적으로 문자열만 직렬화할 수 있습니다.

false

boolean

enabledProtocols (security)

SSL을 사용할 때 사용할 수 있는 프로토콜은 무엇입니까.

TLSv1,TLSv1.1,TLSv1.2

문자열

keyStoreFile (security)

암호화에 사용할 클라이언트 측 인증서 키 저장소입니다.

 

파일

keyStoreFormat (보안)

페이로드 암호화에 사용할 키 저장소 형식입니다. 설정하지 않는 경우 기본값은 JKS입니다.

 

문자열

keyStoreResource (security)

암호화에 사용할 클라이언트 측 인증서 키 저장소입니다. 기본적으로 classpath에서 로드되지만, classpath:, file: 또는 http:를 사용하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

needClientAuth (security)

SSL을 사용할 때 서버에 클라이언트 인증이 필요한지 여부를 구성합니다.

false

boolean

암호 (보안)

SSH를 사용하여 전송된 페이로드를 암호화/암호 해독하기 위해 사용할 암호 설정입니다.

 

문자열

securityProvider (security)

페이로드 암호화에 사용할 보안 공급자입니다. 설정하지 않는 경우 기본값은 SunX509입니다.

 

문자열

SSL (보안)

SSL 암호화가 이 엔드포인트에 적용되는지 여부를 지정하기 위해 설정합니다.

false

boolean

sslClientCertHeaders (security)

SSL 모드에서 및 SSL 모드에서 사용하는 경우 Netty 소비자는 주체 이름, 발급자 이름, 일련 번호, 유효한 날짜 범위와 같은 클라이언트 인증서에 대한 정보가 포함된 Camel Message를 보강합니다.

false

boolean

sslContextParameters (security)

SSLContextParameters를 사용하여 보안을 구성하려면 다음을 수행합니다.

 

SSLContextParameters

sslHandler (security)

SSL 핸들러를 반환하는 데 사용할 수 있는 클래스에 대한 참조입니다.

 

SslHandler

trustStoreFile (security)

암호화에 사용할 서버 사이드 인증서 키 저장소입니다.

 

파일

trustStoreResource (보안)

암호화에 사용할 서버 사이드 인증서 키 저장소입니다. 기본적으로 classpath에서 로드되지만, classpath:, file: 또는 http:를 사용하여 다른 시스템에서 리소스를 로드할 수 있습니다.

 

문자열

useGlobalSslContextParameters (security)

글로벌 SSL 컨텍스트 매개 변수의 사용을 활성화합니다.

false

boolean

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2026 Red Hat
맨 위로 이동