org.eclipse.ditto.connectivity.service.messaging.amqp.JmsExceptionThrowingFunction Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of ditto-connectivity-service Show documentation

Eclipse Ditto is a framework for creating and managing digital twins in the IoT.

There is a newer version: 3.5.6

Show newest version

/*
 * Copyright (c) 2019 Contributors to the Eclipse Foundation
 *
 * See the NOTICE file(s) distributed with this work for additional
 * information regarding copyright ownership.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License 2.0 which is available at
 * http://www.eclipse.org/legal/epl-2.0
 *
 * SPDX-License-Identifier: EPL-2.0
 */
package org.eclipse.ditto.connectivity.service.messaging.amqp;

import java.util.function.Function;

import javax.annotation.Nullable;
import javax.jms.JMSException;
import javax.jms.JMSRuntimeException;
import javax.jms.Message;

/**
 * An interface similar to Function that accepts a JMS message and returns an optional string and throws a
 * {@link javax.jms.JMSException}.
 *
 * @param  type of results.
 */
@FunctionalInterface
public interface JmsExceptionThrowingFunction {

    /**
     * Performs this operation on the given argument of type JMS Message.
     *
     * @param message the JMS message argument.
     * @return the result.
     * @throws javax.jms.JMSException when the underlying JMS implementation raised a JMSException
     */
    @Nullable
    T apply(Message message) throws JMSException;

    /**
     * Wraps a {@link JmsExceptionThrowingFunction} returning
     * a function by converting thrown {@link javax.jms.JMSException} to {@link javax.jms.JMSRuntimeException}.
     *
     * @param throwingFunction the JmsExceptionThrowingBiConsumer that throws {@link javax.jms.JMSException}
     * @param  type of results.
     * @return a function that throws {@link javax.jms.JMSRuntimeException}
     */
    static  Function wrap(final JmsExceptionThrowingFunction throwingFunction) {
        return m -> {
            try {
                return throwingFunction.apply(m);
            } catch (final JMSException jmsException) {
                throw new JMSRuntimeException(jmsException.getMessage(), jmsException.getErrorCode(),
                        jmsException.getCause());
            }
        };
    }
}