org.springframework.cloud.stream.function

Class StreamBridge

java.lang.Object

org.springframework.cloud.stream.function.StreamBridge

All Implemented Interfaces:

org.springframework.beans.factory.SmartInitializingSingleton

public final class StreamBridge
extends Object
implements org.springframework.beans.factory.SmartInitializingSingleton

A class which allows user to send data to an output binding. While in a common scenario of a typical spring-cloud-stream application user rarely has to manually send data, there are times when the sources of data are outside of spring-cloud-stream context and therefore we need to bridge such foreign sources with spring-cloud-stream.

This utility class allows user to do just that - bridge non-spring-cloud-stream applications with spring-cloud-stream by providing a mechanism (bridge) to send data to an output binding while maintaining the same invocation contract (i.e., type conversion, partitioning etc) as if it was done through a declared function.

Since:

3.0.3

Author:

Oleg Zhurakousky

Method Summary

Modifier and Type	Method and Description
void	afterSingletonsInstantiated()
boolean	send(String bindingName, Object data) Sends 'data' to an output binding specified by 'bindingName' argument while using default content type to deal with output type conversion (if necessary).
boolean	send(String bindingName, Object data, org.springframework.util.MimeType outputContentType) Sends 'data' to an output binding specified by 'bindingName' argument while using the content type specified by the 'outputContentType' argument to deal with output type conversion (if necessary).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

send

public boolean send(String bindingName,
                    Object data)

Sends 'data' to an output binding specified by 'bindingName' argument while using default content type to deal with output type conversion (if necessary).

Parameters:

bindingName - the name of the output binding. That said it requires a bit of clarification. When using bridge.send("foo"...), the 'foo' typically represents the binding name. However if such binding does not exist, the new binding will be created to support dynamic destinations.

data - the data to send

Returns:

true if data was sent successfully, otherwise false or throws an exception.

send

public boolean send(String bindingName,
                    Object data,
                    org.springframework.util.MimeType outputContentType)

Sends 'data' to an output binding specified by 'bindingName' argument while using the content type specified by the 'outputContentType' argument to deal with output type conversion (if necessary). For typical cases `bindingName` is configured using 'spring.cloud.stream.source' property. However, this operation also supports sending to truly dynamic destinations. This means if the name provided via 'bindingName' does not have a corresponding binding such name will be treated as dynamic destination.

Parameters:

bindingName - the name of the output binding. That said it requires a bit of clarification. When using bridge.send("foo"...), the 'foo' typically represents the binding name. However if such binding does not exist, the new binding will be created to support dynamic destinations.

data - the data to send

outputContentType - content type to be used to deal with output type conversion

Returns:

true if data was sent successfully, otherwise false or throws an exception.

afterSingletonsInstantiated

public void afterSingletonsInstantiated()

Specified by:

afterSingletonsInstantiated in interface org.springframework.beans.factory.SmartInitializingSingleton