11.3. Implement a Mime Decoder

Procedure 11.1. Task

  1. Create a class that activates the org.jboss.soa.esb.listeners.message.mime.MimeDecoder interface.
  2. Add the @MimeType annotation to the class, specifying the mime type as the annotation value.
  3. Define the newly created class in the META-INF/org/jboss/soa/esb/listeners/message/mime/decoders.lst file:
    public class TextPlainMimeDecoder implements MimeDecoder, Configurable {
        private Charset encodingCharset;
        public void setConfiguration(ConfigTree configTree) throws ConfigurationException {
            AssertArgument.isNotNull(configTree, "configTree");
            String encoding = configTree.getAttribute("encoding", "UTF-8");
            encodingCharset = Charset.forName(encoding);
        public Object decode(byte[] bytes) throws MimeDecodeException {
            try {
                return new String(bytes, encodingCharset.name());
            } catch (UnsupportedEncodingException e) {
                throw new MimeDecodeException("Unexpected character encoding error.", e);


    This file needs to be present on the classpath at runtime. If your module doesn't have this file, add it to your module source/resources and it will be located at runtime.
  4. Optionally, if the MimeDecoder implementation needs access to the listener configuration (for additional configuration information), have the class implement the org.jboss.soa.esb.Configurable interface.