36.3. 구성 요소 옵션


Paho 구성 요소는 아래 나열된 31 가지 옵션을 지원합니다.

Expand
이름설명기본값유형

automaticReconnect (일반)

연결이 끊어진 경우 클라이언트가 자동으로 서버에 다시 연결하려고 하는지 여부를 설정합니다. false로 설정하면 연결이 손실되는 경우 클라이언트가 자동으로 서버에 다시 연결을 시도하지 않습니다. 연결이 손실되는 경우 클라이언트가 서버에 다시 연결을 시도합니다.In the event that the connection is lost, the client will attempt to reconnect to the server. 다시 연결을 시도하기 전에 처음에는 1 초를 기다린 후 실패한 모든 다시 시도에 대해 지연은 2분 후에 지연이 2분 후에 유지될 때까지 두 배가 됩니다.

true

boolean

brokerUrl (common)

MQTT 브로커의 URL입니다.

tcp://localhost:1883

문자열

cleanSession (common)

다시 시작한 후 클라이언트 및 서버가 상태를 기억하고 다시 연결해야 하는지 여부를 설정합니다. false로 설정하면 클라이언트와 서버가 모두 클라이언트, 서버 및 연결을 다시 시작할 때 상태를 유지합니다. 상태가 유지됨: 클라이언트, 서버 또는 연결이 다시 시작된 경우에도 지정된 QOS에 메시지 전달이 안정적으로 충족됩니다. 서버에서 서브스크립션을 내구성으로 처리합니다. true로 설정하면 클라이언트와 서버는 클라이언트, 서버 또는 연결을 다시 시작할 때 상태를 유지하지 않습니다. 즉, 클라이언트, 서버 또는 연결을 다시 시작하면 지정된 QOS에 대한 메시지 전달을 유지 관리할 수 없습니다. 서버가 서브스크립션을 내구성이 아닌 것으로 취급합니다.

true

boolean

clientID( 일반)

MQTT 클라이언트 식별자입니다. 식별자는 고유해야 합니다.

 

문자열

구성 (일반)

공유 Paho 구성을 사용합니다.

 

PahoConfiguration

ConnectionTimeout (일반)

연결 제한 시간 값을 설정합니다. 이 값은 초 단위로 측정된 이 값은 클라이언트가 MQTT 서버에 대한 네트워크 연결이 설정될 때까지 대기할 최대 시간 간격을 정의합니다. 기본 제한 시간은 30초입니다. 값 0은 네트워크 연결이 성공하거나 실패할 때까지 클라이언트가 대기함을 의미합니다.

30

int

filePersistenceDirectory (일반)

파일 지속성에 사용되는 기본 디렉터리입니다. 는 기본적으로 사용자 디렉터리를 사용합니다.

 

문자열

keepAliveInterval (common)

keep live interval을 설정합니다. 이 값은 초 단위로 측정되며 전송되거나 수신된 메시지의 최대 시간 간격을 정의합니다. TCP/IP 제한 시간을 기다릴 필요 없이 클라이언트가 서버를 더 이상 사용할 수 없는지 감지할 수 있습니다. 클라이언트는 각 활성 기간 내에 하나 이상의 메시지가 네트워크를 통해 이동하도록 합니다. 일정 기간 동안 데이터 관련 메시지가 없으면 클라이언트는 매우 작은 ping 메시지를 전송하여 서버가 승인합니다. 값 0은 클라이언트의 keepalive 처리를 비활성화합니다. 기본값은 60초입니다.

60

int

maxInflight (일반)

최대 inflight를 설정합니다. 높은 트래픽 환경에서 이 값을 늘리십시오. 기본값은 10입니다.

10

int

maxReconnectDelay (일반)

다시 연결 사이에 최대 시간(밀리코어)을 기다립니다.

128000

int

mqttVersion (일반)

MQTT 버전을 설정합니다. 기본 동작은 버전 3.1.1에 연결하고, 실패하는 경우 3.1로 대체하는 것입니다. 버전 3.1.1 또는 3.1은 MQTT_VERSION_3_1 또는 MQTT_VERSION_3_1 옵션을 각각 사용하여 표시되지 않고 구체적으로 선택할 수 있습니다.

 

int

지속성 (일반)

사용할 클라이언트 지속성 - 메모리 또는 파일.

열거형 값:

  • 파일
  • MEMORY

MEMORY

PahoPersistence

QoS (Common)

서비스 수준(0-2)의 클라이언트 품질.

2

int

보존 (일반)

옵션 유지.

false

boolean

serverURIs (common)

클라이언트가 연결할 수 있는 하나 이상의 서버 URI 목록을 설정합니다. 여러 서버를 쉼표로 구분할 수 있습니다. 각 serverURI는 클라이언트가 연결할 수 있는 서버의 주소를 지정합니다. TCP 연결의 경우 tcp://와 SSL/TLS에 의해 보호되는 TCP 연결의 경우 ssl:// 두 가지 유형의 연결이 지원됩니다. 예를 들어, tcp://localhost:1883 ssl://localhost:8883 포트가 지정되지 않은 경우 기본적으로 tcp:// URI의 경우 1883으로, ssl:// URI의 경우 8883으로 설정됩니다. serverURIs가 설정되면 MQTT 클라이언트 생성자에서 전달된 serverURI 매개 변수를 덮어씁니다. 연결 시도가 시작되면 클라이언트가 목록의 첫 번째 serverURI로 시작하고 서버와의 연결이 설정될 때까지 목록을 통해 작업합니다. 서버에 연결할 수 없는 경우 연결 시도가 실패합니다. 클라이언트가 연결할 수 있는 서버 목록을 몇 가지 용도로 지정합니다. 고가용성 및 신뢰할 수 있는 메시지 전달 일부 MQTT 서버는 두 개 이상의 equal MQTT 서버 공유 상태를 지원하는 고가용성 기능을 지원합니다. MQTT 클라이언트는 동일한 서버에 연결할 수 있으며 메시지가 안정적으로 전달되고 내구성 있는 서브스크립션이 클라이언트가 연결하는 서버에 관계없이 유지 관리되도록 보장할 수 있습니다. 내구성 서브스크립션 및/또는 신뢰할 수 있는 메시지 전달이 필요한 경우 cleansession 플래그를 false로 설정해야 합니다. 헌팅 목록(High Availability 옵션에서와 같이)의 서버 세트는 동일하지 않은 서버 집합이 지정될 수 있습니다. 서버에서 신뢰할 수 있는 메시지 전달 및 내구성 서브스크립션이 유효하지 않으므로 상태가 공유되지 않습니다. 헌팅 목록 모드를 사용하는 경우 cleansession 플래그를 true로 설정해야 합니다.

 

문자열

willPayload (common)

연결에 대한 Last Will 및 Testament(LWT)를 설정합니다. 이 클라이언트가 서버에 대한 연결이 예기치 않게 손실되는 경우 서버는 제공된 세부 정보를 사용하여 자체에 메시지를 게시합니다. 메시지에 대한 The byte payload에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지가 유지되어야 하는지 여부입니다.

 

문자열

willQos (common)

연결에 대한 Last Will 및 Testament(LWT)를 설정합니다. 이 클라이언트가 서버에 대한 연결이 예기치 않게 손실되는 경우 서버는 제공된 세부 정보를 사용하여 자체에 메시지를 게시합니다. 메시지에 대한 The byte payload에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지가 유지되어야 하는지 여부입니다.

 

int

willRetained (common)

연결에 대한 Last Will 및 Testament(LWT)를 설정합니다. 이 클라이언트가 서버에 대한 연결이 예기치 않게 손실되는 경우 서버는 제공된 세부 정보를 사용하여 자체에 메시지를 게시합니다. 메시지에 대한 The byte payload에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지가 유지되어야 하는지 여부입니다.

false

boolean

willTopic (common)

연결에 대한 Last Will 및 Testament(LWT)를 설정합니다. 이 클라이언트가 서버에 대한 연결이 예기치 않게 손실되는 경우 서버는 제공된 세부 정보를 사용하여 자체에 메시지를 게시합니다. 메시지에 대한 The byte payload에 게시할 주제입니다. 메시지를 게시하는 서비스 품질(0, 1 또는 2)입니다. 메시지가 유지되어야 하는지 여부입니다.

 

문자열

bridgeErrorHandler (consumer)

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

false

boolean

lazyStartProducer (producer)

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

false

boolean

autowiredEnabled (advanced)

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

true

boolean

클라이언트 (고급)

공유 Paho 클라이언트를 사용합니다.

 

MqttClient

customWebSocketHeaders (advanced)

WebSocket Connection에 대한 Custom WebSocket 헤더를 설정합니다.

 

속성

executorServiceTimeout (advanced)

정상적으로 종료하기 전에 executor 서비스가 종료할 때 대기해야 하는 시간(초)을 설정합니다. 필요한 것을 확신하지 않는 한 이 값을 변경하는 것은 권장되지 않습니다.

1

int

httpsHostnameVerificationEnabled (security)

SSL HostnameVerifier 사용 여부입니다. 기본값은 true입니다.

true

boolean

암호 (보안)

MQTT 브로커에 대한 인증에 사용할 암호입니다.

 

문자열

socketFactory (security)

사용할 SocketFactory를 설정합니다. 이를 통해 애플리케이션에서 네트워크 소켓 생성에 대한 자체 정책을 적용할 수 있습니다. SSL 연결을 사용하는 경우 SSLSocketFactory를 사용하여 애플리케이션별 보안 설정을 제공할 수 있습니다.

 

SocketFactory

sslClientProps (security)

연결에 대한 SSL 속성을 설정합니다. 이러한 속성은 Java Secure Socket Extensions(JSSE)의 구현을 사용할 수 있는 경우에만 유효합니다. 이러한 속성은 사용자 지정 SocketFactory가 설정된 경우 사용되지 않습니다. 다음 속성을 사용할 수 있습니다. com.ibm.ssl.protocol one of: SSL, SSLv3, TLSv1, SSL_TLS. com.ibm.ssl.contextProvider Underlying JSSE 공급자. 예를 들어 IBMJSSE2 또는 SunJSSE com.ibm.ssl.keyStore는 KeyManager가 사용할 KeyStore 개체가 포함된 파일의 이름입니다. 예를 들어 /mydir/etc/key.p12 com.ibm.ssl.keyStorePassword는 KeyManager가 사용할 KeyStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있거나 정적 메서드 com.ibm.micro.Password.obfuscate(char 암호)를 사용하여 난독 처리될 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독화합니다. 이는 일반 텍스트 암호를 난독화하는 간단한 scrambler입니다. 키 저장소 com.ibm.ssl.keyStoreType Type(예: PKCS12, JKS 또는 JCEKS)의 com.ibm.ssl.keyStoreProvider 키 저장소 공급자(예: IBMJCE 또는 IBMJCEFIPS)입니다. IBM.ssl.trustStore TrustManager가 사용할 KeyStore 오브젝트가 포함된 파일의 이름입니다. com.ibm.ssl.trustStorePassword TrustManager에서 사용할 TrustStore 오브젝트의 암호입니다. 암호는 일반 텍스트에 있거나 정적 메서드 com.ibm.micro.Password.obfuscate(char 암호)를 사용하여 난독 처리될 수 있습니다. 이렇게 하면 간단하고 안전하지 않은 XOR 및 Base64 인코딩 메커니즘을 사용하여 암호를 난독화합니다. 이는 일반 텍스트 암호를 난독화하는 간단한 scrambler입니다. com.ibm.ssl.trustStoreType 기본 TrustManager에서 사용할 KeyStore 오브젝트 유형입니다. keyStoreType. com.ibm.ssl.trustStoreProvider Trust 저장소 공급자(예: IBMJCEFIPS 또는 IBMJCEFIPS. com.ibm.ssl.enabledCipherSuites)와 동일한 가능한 값은 활성화된 암호 목록입니다. 값은 공급자에 따라 달라집니다. 예를 들어 SSL_RSA_WITH_AES_128_CBC_SHA;SSL_RSA_WITH_3DES_EDE_CBC_SHA. com.ibm.ssl.keyManager는 플랫폼에서 사용할 수 있는 기본 알고리즘을 사용하는 대신 KeyManagerFactory 오브젝트를 인스턴스화하는 데 사용되는 알고리즘을 설정합니다. 예제 값: IbmX509 또는 IBMJ9X509. com.ibm.ssl.trustManager는 플랫폼에서 사용 가능한 기본 알고리즘을 사용하는 대신 TrustManagerFactory 오브젝트를 인스턴스화하는 데 사용할 알고리즘을 설정합니다. PKIX 또는 IBMJ9X509의 예.

 

속성

sslHostnameVerifier (보안)

SSL 연결에 대한 HostnameVerifier를 설정합니다. 이는 연결에 핸드셰이크 후에 사용되며 호스트 이름이 확인된 경우 스스로 작업을 수행해야 합니다. 기본 HostnameVerifier는 없습니다.

 

HostnameVerifier

사용자 이름 (보안)

MQTT 브로커에 대한 인증에 사용되는 사용자 이름입니다.

 

문자열

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2026 Red Hat
맨 위로 이동