org.springframework.integration.support.utils

Class IntegrationUtils

java.lang.Object

org.springframework.integration.support.utils.IntegrationUtils

public final class IntegrationUtils
extends java.lang.Object

General utility methods.

Since:

4.0

Author:

Gary Russell, Marius Bogoevici

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	fatalWhenNoBeanFactory Should be set to TRUE on CI plans and framework developer systems.
static java.lang.String	INTEGRATION_CONVERSION_SERVICE_BEAN_NAME
static java.lang.String	INTEGRATION_MESSAGE_BUILDER_FACTORY_BEAN_NAME

Method Summary

Modifier and Type	Method and Description
static java.lang.String	bytesToString(byte[] bytes, java.lang.String encoding) Utility method for null-safe conversion from byte[] to String
static org.springframework.core.convert.ConversionService	getConversionService(org.springframework.beans.factory.BeanFactory beanFactory)
static MessageBuilderFactory	getMessageBuilderFactory(org.springframework.beans.factory.BeanFactory beanFactory) Returns the context-wide `messageBuilderFactory` bean from the beanFactory, or a DefaultMessageBuilderFactory if not found or the beanFactory is null.
static byte[]	stringToBytes(java.lang.String value, java.lang.String encoding) Utility method for null-safe conversion from String to byte[]
static java.lang.RuntimeException	wrapInDeliveryExceptionIfNecessary(org.springframework.messaging.Message<?> message, java.util.function.Supplier<java.lang.String> text, java.lang.Exception e) If the exception is not a MessagingException or does not have a failedMessage, wrap it in a new MessageDeliveryException with the message.
static java.lang.RuntimeException	wrapInHandlingExceptionIfNecessary(org.springframework.messaging.Message<?> message, java.util.function.Supplier<java.lang.String> text, java.lang.Exception e) If the exception is not a MessagingException or does not have a failedMessage, wrap it in a new MessageHandlingException with the message.

Methods inherited from class java.lang.Object

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

Field Detail

INTEGRATION_CONVERSION_SERVICE_BEAN_NAME

public static final java.lang.String INTEGRATION_CONVERSION_SERVICE_BEAN_NAME

See Also:

Constant Field Values

INTEGRATION_MESSAGE_BUILDER_FACTORY_BEAN_NAME

public static final java.lang.String INTEGRATION_MESSAGE_BUILDER_FACTORY_BEAN_NAME

See Also:

Constant Field Values

fatalWhenNoBeanFactory

public static final boolean fatalWhenNoBeanFactory

Should be set to TRUE on CI plans and framework developer systems.

Method Detail

getConversionService

public static org.springframework.core.convert.ConversionService getConversionService(org.springframework.beans.factory.BeanFactory beanFactory)

Parameters:

beanFactory - BeanFactory for lookup, must not be null.

Returns:

The ConversionService bean whose name is "integrationConversionService" if available.

getMessageBuilderFactory

public static MessageBuilderFactory getMessageBuilderFactory(org.springframework.beans.factory.BeanFactory beanFactory)

Returns the context-wide `messageBuilderFactory` bean from the beanFactory, or a DefaultMessageBuilderFactory if not found or the beanFactory is null.

Parameters:

beanFactory - The bean factory.

Returns:

The message builder factory.

stringToBytes

public static byte[] stringToBytes(java.lang.String value,
                                   java.lang.String encoding)

Utility method for null-safe conversion from String to byte[]

Parameters:

value - the String to be converted

encoding - the encoding

Returns:

the byte[] corresponding to the given String and encoding, null if provided String argument was null

Throws:

java.lang.IllegalArgumentException - if the encoding is not supported

bytesToString

public static java.lang.String bytesToString(byte[] bytes,
                                             java.lang.String encoding)

Utility method for null-safe conversion from byte[] to String

Parameters:

bytes - the byte[] to be converted

encoding - the encoding

Returns:

the String corresponding to the given byte[] and encoding, null if provided byte[] argument was null

Throws:

java.lang.IllegalArgumentException - if the encoding is not supported

wrapInDeliveryExceptionIfNecessary

public static java.lang.RuntimeException wrapInDeliveryExceptionIfNecessary(org.springframework.messaging.Message<?> message,
                                                                            java.util.function.Supplier<java.lang.String> text,
                                                                            java.lang.Exception e)

If the exception is not a MessagingException or does not have a failedMessage, wrap it in a new MessageDeliveryException with the message.

Parameters:

message - the message.

text - a Supplier for the new exception's message text.

e - the exception.

Returns:

the wrapper, if necessary, or the original exception.

Since:

5.0.4

wrapInHandlingExceptionIfNecessary

public static java.lang.RuntimeException wrapInHandlingExceptionIfNecessary(org.springframework.messaging.Message<?> message,
                                                                            java.util.function.Supplier<java.lang.String> text,
                                                                            java.lang.Exception e)

If the exception is not a MessagingException or does not have a failedMessage, wrap it in a new MessageHandlingException with the message.

Parameters:

message - the message.

text - a Supplier for the new exception's message text.

e - the exception.

Returns:

the wrapper, if necessary, or the original exception.

Since:

5.0.4