クラス MessagingGatewaySupport
java.lang.ObjectSE
org.springframework.integration.context.IntegrationObjectSupport
org.springframework.integration.endpoint.AbstractEndpoint
org.springframework.integration.gateway.MessagingGatewaySupport
- 実装済みのインターフェース一覧:
Aware, BeanFactoryAware, BeanNameAware, DisposableBean, InitializingBean, ApplicationContextAware, Lifecycle, Phased, SmartLifecycle, ComponentSourceAware, ExpressionCapable, IntegrationPattern, NamedComponent, IntegrationInboundManagement, IntegrationManagement, ManageableLifecycle, ManageableSmartLifecycle, TrackableComponent
- 既知の直属サブクラス
AbstractWebServiceInboundGateway, AmqpClientInboundGateway, AmqpInboundGateway, BaseHttpInboundEndpoint, GrpcInboundGateway, JmsInboundGateway, KafkaInboundGateway, RedisQueueInboundGateway, RSocketInboundGateway, TcpInboundGateway
@IntegrationManagedResource
public abstract class MessagingGatewaySupport
extends AbstractEndpoint
implements TrackableComponent, IntegrationInboundManagement, IntegrationPattern
送信、受信、リクエスト / 応答操作のためにアプリケーションコードを
MessageChannel に接続するための便利な基本クラス。リクエストと応答の MessageChannel を構成するための setter と、メッセージを送受信するためのタイムアウト値を公開します。- 作成者:
- Mark Fisher, Gary Russell, Artem Bilan, Trung Pham, Christian Tzolov, Glenn Renfro
ネストされたクラスの概要
ネストされたクラス修飾子と型クラス説明protected static class監視コンテキストからリクエストメッセージにアクセスできるようにMessagingGatewaySupport.ConvertingMessagingTemplate.doConvert(Object, Map, MessagePostProcessor)の可視性を高めるMessagingTemplate拡張機能。インターフェース IntegrationManagement から継承されたネストクラス / インターフェース
IntegrationManagement.ManagementOverridesフィールド概要
フィールドクラス AbstractEndpoint から継承されたフィールド
lifecycleLockクラス IntegrationObjectSupport から継承されたフィールド
EXPRESSION_PARSER, loggerインターフェース IntegrationManagement から継承されたフィールド
METER_PREFIX, RECEIVE_COUNTER_NAME, SEND_TIMER_NAMEインターフェース SmartLifecycle から継承されたフィールド
DEFAULT_PHASEコンストラクター概要
コンストラクターコンストラクター説明応答がない場合に null を返すインスタンスを作成します。MessagingGatewaySupport(boolean errorOnTimeout) errorOnTimeout が true の場合、応答が期待されても何も受信されない場合に、MessageTimeoutExceptionペイロードを含むErrorMessageをエラーチャネルに送信するインスタンスを作成します。方法の概要
修飾子と型メソッド説明protected final ErrorMessagebuildErrorMessage(@Nullable Message<?> requestMessage, ThrowableSE throwable) メッセージのエラーメッセージを作成し、構成済みのErrorMessageStrategyを使用してスロー可能にします。protected TimerFacadebuildSendTimer(boolean success, StringSE exception) voiddestroy()protected voiddoStart()サブクラスは、開始動作でこのメソッドを実装する必要があります。protected voiddoStop()サブクラスは、停止動作でこのメソッドを実装する必要があります。@Nullable MessageChannelエラーメッセージがルーティングされるエラーチャネル(提供されている場合)を返します。protected AttributeAccessorgetErrorMessageAttributes(@Nullable Message<?> message) errorMessageStrategyでエラーメッセージを作成するときに使用するAttributeAccessorを設定します。protected ErrorMessageStrategy例外が発生したときにエラーメッセージを作成するために使用するErrorMessageStrategyを取得します。このコンポーネントが実装するパターン型を返します。@Nullable StringSE@Nullable StringSEオーバーライドを返します。@Nullable MessageChannelこのゲートウェイの応答チャネルがある場合はそれを返します。@Nullable MessageChannelこのゲートウェイのリクエストチャネルを返します。@Nullable StringSEこのゲートウェイのリクエストチャネル名を返します。booleanロギングが有効かどうかを返します。booleanこの実装がObservationRegistry.NOOPインスタンス以外のレジストリを処理する場合は true。protected voidonInit()サブクラスは、初期化ロジック用にこれを実装できます。protected @Nullable ObjectSEreceive()protected @Nullable ObjectSEreceive(long timeout) protected @Nullable Message<?> protected @Nullable Message<?> receiveMessage(long timeout) voidregisterMetricsCaptor(MetricsCaptor metricsCaptorToRegister) MetricsCaptorを注入します。voidregisterObservationRegistry(io.micrometer.observation.ObservationRegistry observationRegistry) ObservationRegistryを注入します。protected voidprotected voidprotected @Nullable ObjectSEsendAndReceive(ObjectSE object) protected @Nullable Message<?> sendAndReceiveMessage(ObjectSE object) protected reactor.core.publisher.Mono<Message<?>> protected TimerFacadevoidsetErrorChannel(MessageChannel errorChannel) エラーチャンネルを設定します。voidsetErrorChannelName(StringSE errorChannelName) エラーチャネル名を設定します。final voidsetErrorMessageStrategy(ErrorMessageStrategy errorMessageStrategy) 例外が発生したときにエラーメッセージを作成するために使用するErrorMessageStrategyを設定します。voidsetErrorOnTimeout(boolean errorOnTimeout) errorOnTimeout が true の場合、応答が期待されても何も受信されない場合に、MessageTimeoutExceptionペイロードを含むErrorMessageをエラーチャネルに送信するインスタンスを作成します。voidsetLoggingEnabled(boolean enabled) ロギングを有効にするかどうか。voidsetManagedName(StringSE managedName) voidsetManagedType(StringSE managedType) voidsetObservationConvention(@Nullable MessageRequestReplyReceiverObservationConvention observationConvention) voidsetReceiverObservationConvention(@Nullable MessageReceiverObservationConvention receiverObservationConvention) voidsetReplyChannel(MessageChannel replyChannel) 返信チャンネルを設定します。voidsetReplyChannelName(StringSE replyChannelName) 返信チャンネル名を設定します。voidsetReplyMapper(OutboundMessageMapper<?> replyMapper) 受信または sendAndReceive 操作で受信した応答メッセージからオブジェクトにマッピングするためのOutboundMessageMapperを提供します。voidsetReplyTimeout(long replyTimeout) 応答メッセージを受信するためのタイムアウト値を設定します。voidsetRequestChannel(MessageChannel requestChannel) リクエストチャネルを設定します。voidsetRequestChannelName(StringSE requestChannelName) リクエストチャンネル名を設定します。voidsetRequestMapper(@Nullable InboundMessageMapper<?> requestMapper) voidsetRequestTimeout(long requestTimeout) リクエストメッセージを送信するためのタイムアウト値を設定します。voidsetShouldTrack(boolean shouldTrack) このゲートウェイを、送信または sendAndReceive 操作から生成されたメッセージのメッセージ履歴で追跡するかどうかを指定します。クラス AbstractEndpoint から継承されたメソッド
doStop, getPhase, getRole, isActive, isAutoStartup, isRunning, setAutoStartup, setPhase, setRole, start, stop, stopクラス IntegrationObjectSupport から継承されたメソッド
afterPropertiesSet, extractTypeIfPossible, generateId, getApplicationContext, getApplicationContextId, getBeanDescription, getBeanFactory, getBeanName, getChannelResolver, getComponentDescription, getComponentName, getComponentSource, getConversionService, getExpression, getIntegrationProperties, getMessageBuilderFactory, getTaskScheduler, isInitialized, setApplicationContext, setBeanFactory, setBeanName, setChannelResolver, setComponentDescription, setComponentName, setComponentSource, setConversionService, setMessageBuilderFactory, setPrimaryExpression, setTaskScheduler, toStringクラス ObjectSE から継承されたメソッド
clone, equalsSE, finalize, getClass, hashCode, notify, notifyAll, wait, waitSE, waitSEインターフェース IntegrationManagement から継承されたメソッド
getThisAsインターフェース NamedComponent から継承されたメソッド
getBeanName, getComponentNameインターフェース SmartLifecycle から継承されたメソッド
isPauseable
フィールドの詳細
messagingTemplate
コンストラクターの詳細
MessagingGatewaySupport
public MessagingGatewaySupport()応答がない場合に null を返すインスタンスを作成します。MessagingGatewaySupport
public MessagingGatewaySupport(boolean errorOnTimeout) errorOnTimeout が true の場合、応答が期待されても何も受信されない場合に、MessageTimeoutExceptionペイロードを含むErrorMessageをエラーチャネルに送信するインスタンスを作成します。エラーチャネルが設定されていない場合、MessageTimeoutExceptionがスローされます。- パラメーター:
errorOnTimeout- エラーメッセージを作成するには true。- 導入:
- 4.2
- 関連事項:
方法の詳細
setErrorOnTimeout
public void setErrorOnTimeout(boolean errorOnTimeout) errorOnTimeout が true の場合、応答が期待されても何も受信されない場合に、MessageTimeoutExceptionペイロードを含むErrorMessageをエラーチャネルに送信するインスタンスを作成します。エラーチャネルが設定されていない場合、MessageTimeoutExceptionがスローされます。- パラメーター:
errorOnTimeout- true の場合、応答タイムアウト時にエラーメッセージを作成します。- 導入:
- 5.2.2
setRequestChannel
リクエストチャネルを設定します。- パラメーター:
requestChannel- リクエストメッセージの送信先のチャネル
setRequestChannelName
リクエストチャンネル名を設定します。- パラメーター:
requestChannelName- リクエストメッセージの送信先となるチャネル Bean 名- 導入:
- 4.1
getRequestChannelName
このゲートウェイのリクエストチャネル名を返します。- 戻り値:
- チャンネル名。指定しない場合は null。
- 導入:
- 6.5.10
setReplyChannel
返信チャンネルを設定します。応答チャネルが提供されていない場合、このゲートウェイは常に匿名の一時チャネルを使用して応答を処理します。- パラメーター:
replyChannel- 返信メッセージの受信元のチャネル
setReplyChannelName
返信チャンネル名を設定します。応答チャネルが提供されていない場合、このゲートウェイは常に匿名の一時チャネルを使用して応答を処理します。- パラメーター:
replyChannelName- 応答メッセージの受信元となるチャネル Bean 名- 導入:
- 4.1
setErrorChannel
エラーチャネルを設定します。エラーチャネルが指定されていない場合、このゲートウェイは呼び出し元に例外を伝播します。例外を完全に抑制するには、ここで "nullChannel" への参照を指定します。- パラメーター:
errorChannel- エラーチャネル。
setErrorChannelName
エラーチャネル名を設定します。エラーチャネルが指定されていない場合、このゲートウェイは呼び出し元に例外を伝播します。例外を完全に抑制するには、ここで "nullChannel" への参照を指定します。- パラメーター:
errorChannelName- エラーチャネル Bean 名。- 導入:
- 4.1
setRequestTimeout
public void setRequestTimeout(long requestTimeout) リクエストメッセージを送信するためのタイムアウト値を設定します。明示的に設定されていない場合、デフォルトは 1 秒です。- パラメーター:
requestTimeout- ミリ秒単位のタイムアウト値
setReplyTimeout
public void setReplyTimeout(long replyTimeout) 応答メッセージを受信するためのタイムアウト値を設定します。明示的に設定されていない場合、デフォルトは 1 秒です。- パラメーター:
replyTimeout- ミリ秒単位のタイムアウト値
setRequestMapper
- パラメーター:
requestMapper- リクエストマッパー。
setReplyMapper
受信または sendAndReceive 操作で受信した応答メッセージからオブジェクトにマッピングするためのOutboundMessageMapperを提供します。- パラメーター:
replyMapper- 返信マッパー。
setShouldTrack
public void setShouldTrack(boolean shouldTrack) このゲートウェイを、送信または sendAndReceive 操作から生成されたメッセージのメッセージ履歴で追跡するかどうかを指定します。- 次で指定:
- インターフェース
TrackableComponent内のsetShouldTrack
getComponentType
- 次で指定:
- インターフェース
NamedComponent内のgetComponentType
setLoggingEnabled
public void setLoggingEnabled(boolean enabled) インターフェースからコピーされた説明:IntegrationManagementロギングを有効にするかどうか。- 次で指定:
- インターフェース
IntegrationManagement内のsetLoggingEnabled - パラメーター:
enabled- 無効にする場合は false。
isLoggingEnabled
public boolean isLoggingEnabled()インターフェースからコピーされた説明:IntegrationManagementロギングが有効かどうかを返します。- 次で指定:
- インターフェース
IntegrationManagement内のisLoggingEnabled - 戻り値:
- 有効な場合は true。
setErrorMessageStrategy
例外が発生したときにエラーメッセージを作成するために使用するErrorMessageStrategyを設定します。デフォルトはDefaultErrorMessageStrategyです。- パラメーター:
errorMessageStrategy-ErrorMessageStrategy- 導入:
- 4.3.10
getErrorMessageStrategy
例外が発生したときにエラーメッセージを作成するために使用するErrorMessageStrategyを取得します。デフォルトはDefaultErrorMessageStrategyです。- 戻り値:
- errorMessageStrategy。
- 導入:
- 6.0
getOverrides
インターフェースからコピーされた説明:IntegrationManagementオーバーライドを返します。- 次で指定:
- インターフェース
IntegrationManagement内のgetOverrides - 戻り値:
- オーバーライド。
setManagedType
- 次で指定:
- インターフェース
IntegrationManagement内のsetManagedType
getManagedType
- 次で指定:
- インターフェース
IntegrationManagement内のgetManagedType
setManagedName
- 次で指定:
- インターフェース
IntegrationManagement内のsetManagedName
getManagedName
- 次で指定:
- インターフェース
IntegrationManagement内のgetManagedName
getIntegrationPatternType
インターフェースからコピーされた説明:IntegrationPatternこのコンポーネントが実装するパターン型を返します。- 次で指定:
- インターフェース
IntegrationPattern内のgetIntegrationPatternType - 戻り値:
- このコンポーネントが実装する
IntegrationPatternType
registerMetricsCaptor
インターフェースからコピーされた説明:IntegrationManagementMetricsCaptorを注入します。ObservationRegistryが指定されている場合は無視されます。- 次で指定:
- インターフェース
IntegrationManagement内のregisterMetricsCaptor - パラメーター:
metricsCaptorToRegister- キャプター。- 関連事項:
registerObservationRegistry
public void registerObservationRegistry(io.micrometer.observation.ObservationRegistry observationRegistry) インターフェースからコピーされた説明:IntegrationManagementObservationRegistryを注入します。指定された場合、MetricsCaptorは無視されます。メーターのキャプチャーは、提供されたObservationRegistryでObservationHandlerとして構成する必要があります。- 次で指定:
- インターフェース
IntegrationManagement内のregisterObservationRegistry - パラメーター:
observationRegistry- コンポーネントからの観測結果を公開するObservationRegistry。- 関連事項:
isObserved
public boolean isObserved()インターフェースからコピーされた説明:IntegrationManagementこの実装がObservationRegistry.NOOPインスタンス以外のレジストリを処理する場合は true。- 次で指定:
- インターフェース
IntegrationManagement内のisObserved - 戻り値:
- この実装が
ObservationRegistry.NOOPインスタンス以外のレジストリを処理する場合は true。
setObservationConvention
public void setObservationConvention(@Nullable MessageRequestReplyReceiverObservationConvention observationConvention) setReceiverObservationConvention
public void setReceiverObservationConvention(@Nullable MessageReceiverObservationConvention receiverObservationConvention) onInit
protected void onInit()クラスからコピーされた説明:IntegrationObjectSupportサブクラスは、初期化ロジック用にこれを実装できます。- オーバーライド:
- クラス
AbstractEndpointのonInit
getRequestChannel
getReplyChannel
このゲートウェイの応答チャネルがある場合はそれを返します。- 戻り値:
- 応答チャネルインスタンス
- 導入:
- 5.1
getErrorChannel
エラーメッセージがルーティングされるエラーチャネル(提供されている場合)を返します。- 戻り値:
- チャネルまたは null。
- 導入:
- 4.3
send
receive
receiveMessage
receive
receiveMessage
sendAndReceive
sendAndReceiveMessage
sendAndReceiveMessageReactive
sendTimer
buildSendTimer
buildErrorMessage
protected final ErrorMessage buildErrorMessage(@Nullable Message<?> requestMessage, ThrowableSE throwable) メッセージのエラーメッセージを作成し、構成済みのErrorMessageStrategyを使用してスロー可能にします。- パラメーター:
requestMessage- requestMessage。throwable- スローアブル。- 戻り値:
- エラーメッセージ。
- 導入:
- 4.3.10
getErrorMessageAttributes
errorMessageStrategyでエラーメッセージを作成するときに使用するAttributeAccessorを設定します。- パラメーター:
message- メッセージ。- 戻り値:
- 属性。
- 導入:
- 4.3.10
registerReplyMessageCorrelatorIfNecessary
protected void registerReplyMessageCorrelatorIfNecessary()doStart
protected void doStart()クラスからコピーされた説明:AbstractEndpointサブクラスは、開始動作でこのメソッドを実装する必要があります。このメソッドは、AbstractEndpoint.lifecycleLockを保持しているときに呼び出されます。- 次で指定:
- クラス
AbstractEndpointのdoStart
doStop
protected void doStop()クラスからコピーされた説明:AbstractEndpointサブクラスは、停止動作でこのメソッドを実装する必要があります。このメソッドは、AbstractEndpoint.lifecycleLockを保持しているときに呼び出されます。- 次で指定:
- クラス
AbstractEndpointのdoStop
destroy
public void destroy()- 次で指定:
- インターフェース
DisposableBean内のdestroy - 次で指定:
- インターフェース
IntegrationManagement内のdestroy - オーバーライド:
- クラス
AbstractEndpointのdestroy