Class IntegrationUtils
java.lang.Object
org.springframework.integration.support.utils.IntegrationUtils
General utility methods.
- Since:
- 4.0
- Author:
- Gary Russell, Marius Bogoevici, Artem Bilan
-
Field Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic String
bytesToString
(byte[] bytes, String encoding) Utility method for null-safe conversion from byte[] to String.static ConversionService
getConversionService
(BeanFactory beanFactory) static MessageBuilderFactory
getMessageBuilderFactory
(BeanFactory beanFactory) Returns the context-wide `messageBuilderFactory` bean from the beanFactory, or aDefaultMessageBuilderFactory
if not found or the beanFactory is null.static String
obtainComponentName
(NamedComponent component) Obtain a component name from the providedNamedComponent
.static byte[]
stringToBytes
(String value, String encoding) Utility method for null-safe conversion from String to byte[].static RuntimeException
wrapInDeliveryExceptionIfNecessary
(Message<?> message, Supplier<String> text, Throwable ex) If the exception is not aMessagingException
or does not have afailedMessage
, wrap it in a newMessageDeliveryException
with the message.static RuntimeException
wrapInHandlingExceptionIfNecessary
(Message<?> message, Supplier<String> text, Throwable ex) If the exception is not aMessagingException
or does not have afailedMessage
, wrap it in a newMessageHandlingException
with the message.
-
Field Details
-
INTEGRATION_CONVERSION_SERVICE_BEAN_NAME
- See Also:
-
INTEGRATION_MESSAGE_BUILDER_FACTORY_BEAN_NAME
- See Also:
-
FATAL_WHEN_NO_BEANFACTORY
public static final boolean FATAL_WHEN_NO_BEANFACTORYShould be set to TRUE on CI plans and framework developer systems.
-
-
Method Details
-
getConversionService
- Parameters:
beanFactory
- BeanFactory for lookup, must not be null.- Returns:
- The
ConversionService
bean whose name is "integrationConversionService" if available.
-
getMessageBuilderFactory
Returns the context-wide `messageBuilderFactory` bean from the beanFactory, or aDefaultMessageBuilderFactory
if not found or the beanFactory is null.- Parameters:
beanFactory
- The bean factory.- Returns:
- The message builder factory.
-
stringToBytes
Utility method for null-safe conversion from String to byte[].- Parameters:
value
- the String to be convertedencoding
- the encoding- Returns:
- the byte[] corresponding to the given String and encoding, null if provided String argument was null
- Throws:
IllegalArgumentException
- if the encoding is not supported
-
bytesToString
Utility method for null-safe conversion from byte[] to String.- Parameters:
bytes
- the byte[] to be convertedencoding
- the encoding- Returns:
- the String corresponding to the given byte[] and encoding, null if provided byte[] argument was null
- Throws:
IllegalArgumentException
- if the encoding is not supported
-
wrapInDeliveryExceptionIfNecessary
public static RuntimeException wrapInDeliveryExceptionIfNecessary(Message<?> message, Supplier<String> text, Throwable ex) If the exception is not aMessagingException
or does not have afailedMessage
, wrap it in a newMessageDeliveryException
with the message.- Parameters:
message
- the message.text
- a Supplier for the new exception's message text.ex
- the exception.- Returns:
- the wrapper, if necessary, or the original exception.
- Since:
- 5.0.4
-
wrapInHandlingExceptionIfNecessary
public static RuntimeException wrapInHandlingExceptionIfNecessary(Message<?> message, Supplier<String> text, Throwable ex) If the exception is not aMessagingException
or does not have afailedMessage
, wrap it in a newMessageHandlingException
with the message.- Parameters:
message
- the message.text
- a Supplier for the new exception's message text.ex
- the exception.- Returns:
- the wrapper, if necessary, or the original exception.
- Since:
- 5.0.4
-
obtainComponentName
Obtain a component name from the providedNamedComponent
.- Parameters:
component
- theNamedComponent
source for component name.- Returns:
- the component name
- Since:
- 5.3
-