Class IntegrationUtils

java.lang.Object
org.springframework.integration.support.utils.IntegrationUtils

public final class IntegrationUtils extends Object
General utility methods.
Since:
4.0
Author:
Gary Russell, Marius Bogoevici, Artem Bilan
  • Field Details

    • INTEGRATION_CONVERSION_SERVICE_BEAN_NAME

      public static final String INTEGRATION_CONVERSION_SERVICE_BEAN_NAME
      See Also:
    • INTEGRATION_MESSAGE_BUILDER_FACTORY_BEAN_NAME

      public static final String INTEGRATION_MESSAGE_BUILDER_FACTORY_BEAN_NAME
      See Also:
    • FATAL_WHEN_NO_BEANFACTORY

      public static final boolean FATAL_WHEN_NO_BEANFACTORY
      Should be set to TRUE on CI plans and framework developer systems.
  • Method Details

    • getConversionService

      public static ConversionService getConversionService(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(@Nullable 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(String value, 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:
      IllegalArgumentException - if the encoding is not supported
    • bytesToString

      public static String bytesToString(byte[] bytes, 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:
      IllegalArgumentException - if the encoding is not supported
    • wrapInDeliveryExceptionIfNecessary

      public static RuntimeException wrapInDeliveryExceptionIfNecessary(Message<?> message, Supplier<String> text, Throwable ex)
      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.
      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 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.
      ex - the exception.
      Returns:
      the wrapper, if necessary, or the original exception.
      Since:
      5.0.4
    • obtainComponentName

      public static String obtainComponentName(NamedComponent component)
      Obtain a component name from the provided NamedComponent.
      Parameters:
      component - the NamedComponent source for component name.
      Returns:
      the component name
      Since:
      5.3