All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.apache.qpid.jms.message.JmsMessagePropertyIntercepter Maven / Gradle / Ivy

There is a newer version: 2.6.1
Show newest version
/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.apache.qpid.jms.message;

import static org.apache.qpid.jms.message.JmsMessagePropertySupport.checkPropertyNameIsValid;
import static org.apache.qpid.jms.message.JmsMessagePropertySupport.checkValidObject;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMSX_DELIVERY_COUNT;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMSX_GROUPID;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMSX_GROUPSEQ;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMSX_USERID;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMS_AMQP_ACK_TYPE;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMS_CORRELATIONID;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMS_DELIVERYTIME;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMS_DELIVERY_MODE;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMS_DESTINATION;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMS_EXPIRATION;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMS_MESSAGEID;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMS_PRIORITY;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMS_REDELIVERED;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMS_REPLYTO;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMS_TIMESTAMP;
import static org.apache.qpid.jms.message.JmsMessageSupport.JMS_TYPE;

import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
import java.util.Map.Entry;
import java.util.Set;

import jakarta.jms.DeliveryMode;
import jakarta.jms.Destination;
import jakarta.jms.JMSException;
import jakarta.jms.Message;

import org.apache.qpid.jms.exceptions.JmsExceptionSupport;
import org.apache.qpid.jms.util.TypeConversionSupport;

/**
 * Utility class used to intercept calls to Message property gets and sets and map the
 * correct fields in the underlying JmsMessageFacade to the property name being operated on.
 */
public class JmsMessagePropertyIntercepter {

    private static final Map PROPERTY_INTERCEPTERS =
        new HashMap();
    private static final Set STANDARD_HEADERS = new HashSet();
    private static final Set VENDOR_PROPERTIES = new HashSet();

    /**
     * Interface for a Property intercepter object used to write JMS style
     * properties that are part of the JMS Message object members or perform
     * some needed conversion action before some named property is read or
     * written.  If a property is not writable then the intercepter should
     * throw an JMSException to indicate the error.
     */
    interface PropertyIntercepter {

        /**
         * Called when the names property is queried from an JMS Message object.
         *
         * @param message
         *        The message being acted upon.
         *
         * @return the correct property value from the given Message.
         *
         * @throws JMSException if an error occurs while accessing the property
         */
        Object getProperty(JmsMessage message) throws JMSException;

        /**
         * Called when the names property is assigned from an JMS Message object.
         *
         * @param message
         *        The message instance being acted upon.
         * @param value
         *        The value to assign to the intercepted property.
         *
         * @throws JMSException if an error occurs writing the property.
         */
        void setProperty(JmsMessage message, Object value) throws JMSException;

        /**
         * Indicates if the intercepted property has a value currently assigned.
         *
         * @param message
         *        The message instance being acted upon.
         *
         * @return true if the intercepted property has a value assigned to it.
         */
        boolean propertyExists(JmsMessage message);

        /**
         * Request that the intercepted property be cleared.  For properties that
         * cannot be cleared the value should be set to the default value for that
         * property.
         *
         * @param message
         *        the target message object whose property should be cleared.
         *
         * @throws JMSException if an error occurs clearing the property.
         */
        void clearProperty(JmsMessage message) throws JMSException;

        /**
         * Return true if the intercepter can bypass the read-only state of a Message
         * and its properties.
         *
         * @return true if the intercepter is immune to read-only state checks.
         */
        boolean isAlwaysWritable();

    }

    static {
        STANDARD_HEADERS.add(JMS_MESSAGEID);
        STANDARD_HEADERS.add(JMS_TIMESTAMP);
        STANDARD_HEADERS.add(JMS_CORRELATIONID);
        STANDARD_HEADERS.add(JMS_REPLYTO);
        STANDARD_HEADERS.add(JMS_DESTINATION);
        STANDARD_HEADERS.add(JMS_DELIVERY_MODE);
        STANDARD_HEADERS.add(JMS_REDELIVERED);
        STANDARD_HEADERS.add(JMS_TYPE);
        STANDARD_HEADERS.add(JMS_EXPIRATION);
        STANDARD_HEADERS.add(JMS_PRIORITY);
        STANDARD_HEADERS.add(JMS_DELIVERYTIME);

        VENDOR_PROPERTIES.add(JMS_AMQP_ACK_TYPE);

        PROPERTY_INTERCEPTERS.put(JMS_DESTINATION, new PropertyIntercepter() {
            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                throw new JMSException("Cannot set JMS Destination as a property, use setJMSDestination() instead");
            }

            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                Destination dest = message.getFacade().getDestination();
                if (dest == null) {
                    return null;
                }
                return dest.toString();
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return message.getFacade().getDestination() != null;
            }

            @Override
            public void clearProperty(JmsMessage message) {
                message.getFacade().setDestination(null);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMS_REPLYTO, new PropertyIntercepter() {
            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                throw new JMSException("Cannot set JMS ReplyTo as a property, use setJMSReplTo() instead");
            }

            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                if (message.getFacade().getReplyTo() == null) {
                    return null;
                }
                return message.getFacade().getReplyTo().toString();
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return message.getFacade().getReplyTo() != null;
            }

            @Override
            public void clearProperty(JmsMessage message) {
                message.getFacade().setReplyTo(null);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMS_TYPE, new PropertyIntercepter() {
            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                return message.getFacade().getType();
            }

            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                String rc = (String) TypeConversionSupport.convert(value, String.class);
                if (rc == null) {
                    throw new JMSException("Property JMSType cannot be set from a " + value.getClass().getName() + ".");
                }
                message.getFacade().setType(rc);
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return message.getFacade().getType() != null;
            }

            @Override
            public void clearProperty(JmsMessage message) {
                message.getFacade().setType(null);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMS_DELIVERY_MODE, new PropertyIntercepter() {
            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                return message.getFacade().isPersistent() ? "PERSISTENT" : "NON_PERSISTENT";
            }

            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                Integer rc = null;
                try {
                    rc = (Integer) TypeConversionSupport.convert(value, Integer.class);
                } catch (NumberFormatException nfe) {
                    if (value instanceof String) {
                        if (((String) value).equalsIgnoreCase("PERSISTENT")) {
                            rc = DeliveryMode.PERSISTENT;
                        } else if (((String) value).equalsIgnoreCase("NON_PERSISTENT")) {
                            rc = DeliveryMode.NON_PERSISTENT;
                        }
                    }

                    if (rc == null) {
                        throw nfe;
                    }
                }
                if (rc == null) {
                    Boolean bool = (Boolean) TypeConversionSupport.convert(value, Boolean.class);
                    if (bool == null) {
                        throw new JMSException("Property JMSDeliveryMode cannot be set from a " + value.getClass().getName() + ".");
                    } else {
                        message.getFacade().setPersistent(bool.booleanValue());
                    }
                } else {
                    message.getFacade().setPersistent(rc == DeliveryMode.PERSISTENT);
                }
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return true;
            }

            @Override
            public void clearProperty(JmsMessage message) {
                message.getFacade().setPersistent(true); // Default value
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMS_PRIORITY, new PropertyIntercepter() {
            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                return Integer.valueOf(message.getFacade().getPriority());
            }

            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                Integer rc = (Integer) TypeConversionSupport.convert(value, Integer.class);
                if (rc == null) {
                    throw new JMSException("Property JMSPriority cannot be set from a " + value.getClass().getName() + ".");
                }
                message.getFacade().setPriority(rc.byteValue());
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return true;
            }

            @Override
            public void clearProperty(JmsMessage message) {
                message.getFacade().setPriority(Message.DEFAULT_PRIORITY);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMS_MESSAGEID, new PropertyIntercepter() {
            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                if (message.getFacade().getMessageId() == null) {
                    return null;
                }
                return message.getFacade().getMessageId();
            }

            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                String rc = (String) TypeConversionSupport.convert(value, String.class);
                if (rc == null) {
                    throw new JMSException("Property JMSMessageID cannot be set from a " + value.getClass().getName() + ".");
                }
                message.getFacade().setMessageId(rc);
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return message.getFacade().getMessageId() != null;
            }

            @Override
            public void clearProperty(JmsMessage message) throws JMSException {
                message.getFacade().setMessageId(null);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMS_TIMESTAMP, new PropertyIntercepter() {
            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                return Long.valueOf(message.getFacade().getTimestamp());
            }

            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                Long rc = (Long) TypeConversionSupport.convert(value, Long.class);
                if (rc == null) {
                    throw new JMSException("Property JMSTimestamp cannot be set from a " + value.getClass().getName() + ".");
                }
                message.getFacade().setTimestamp(rc.longValue());
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return message.getFacade().getTimestamp() > 0;
            }

            @Override
            public void clearProperty(JmsMessage message) {
                message.getFacade().setTimestamp(0);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMS_CORRELATIONID, new PropertyIntercepter() {
            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                return message.getFacade().getCorrelationId();
            }

            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                String rc = (String) TypeConversionSupport.convert(value, String.class);
                if (rc == null) {
                    throw new JMSException("Property JMSCorrelationID cannot be set from a " + value.getClass().getName() + ".");
                }
                message.getFacade().setCorrelationId(rc);
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return message.getFacade().getCorrelationId() != null;
            }

            @Override
            public void clearProperty(JmsMessage message) throws JMSException {
                message.getFacade().setCorrelationId(null);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMS_EXPIRATION, new PropertyIntercepter() {
            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                return Long.valueOf(message.getFacade().getExpiration());
            }

            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                Long rc = (Long) TypeConversionSupport.convert(value, Long.class);
                if (rc == null) {
                    throw new JMSException("Property JMSExpiration cannot be set from a " + value.getClass().getName() + ".");
                }
                message.getFacade().setExpiration(rc.longValue());
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return message.getFacade().getExpiration() > 0;
            }

            @Override
            public void clearProperty(JmsMessage message) {
                message.getFacade().setExpiration(0);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMS_REDELIVERED, new PropertyIntercepter() {
            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                return Boolean.valueOf(message.getFacade().isRedelivered());
            }

            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                Boolean rc = (Boolean) TypeConversionSupport.convert(value, Boolean.class);
                if (rc == null) {
                    throw new JMSException("Property JMSRedelivered cannot be set from a " + value.getClass().getName() + ".");
                }
                message.getFacade().setRedelivered(rc.booleanValue());
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return message.getFacade().isRedelivered();
            }

            @Override
            public void clearProperty(JmsMessage message) {
                message.getFacade().setRedelivered(false);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMSX_DELIVERY_COUNT, new PropertyIntercepter() {
            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                Integer rc = (Integer) TypeConversionSupport.convert(value, Integer.class);
                if (rc == null) {
                    throw new JMSException("Property JMSXDeliveryCount cannot be set from a " + value.getClass().getName() + ".");
                }
                message.getFacade().setDeliveryCount(rc.intValue());
            }

            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                return Integer.valueOf(message.getFacade().getDeliveryCount());
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return true;
            }

            @Override
            public void clearProperty(JmsMessage message) {
                message.getFacade().setDeliveryCount(1);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMSX_GROUPID, new PropertyIntercepter() {
            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                return message.getFacade().getGroupId();
            }

            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                String rc = (String) TypeConversionSupport.convert(value, String.class);
                if (rc == null) {
                    throw new JMSException("Property JMSXGroupID cannot be set from a " + value.getClass().getName() + ".");
                }
                message.getFacade().setGroupId(rc);
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return message.getFacade().getGroupId() != null;
            }

            @Override
            public void clearProperty(JmsMessage message) {
                message.getFacade().setGroupId(null);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMSX_GROUPSEQ, new PropertyIntercepter() {
            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                return message.getFacade().getGroupSequence();
            }

            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                Integer rc = (Integer) TypeConversionSupport.convert(value, Integer.class);
                if (rc == null) {
                    throw new JMSException("Property JMSXGroupSeq cannot be set from a " + value.getClass().getName() + ".");
                }
                message.getFacade().setGroupSequence(rc.intValue());
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return message.getFacade().getGroupSequence() != 0;
            }

            @Override
            public void clearProperty(JmsMessage message) {
                message.getFacade().setGroupSequence(0);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMSX_USERID, new PropertyIntercepter() {
            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                Object userId = message.getFacade().getUserId();
                if (userId == null) {
                    try {
                        userId = message.getFacade().getProperty("JMSXUserID");
                    } catch (Exception e) {
                        throw JmsExceptionSupport.create(e);
                    }
                }

                return userId;
            }

            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                if (value != null && !(value instanceof String)) {
                    throw new JMSException("Property JMSXUserID cannot be set from a " + value.getClass().getName() + ".");
                }
                message.getFacade().setUserId((String) value);
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return message.getFacade().getUserId() != null;
            }

            @Override
            public void clearProperty(JmsMessage message) {
                message.getFacade().setUserId(null);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMS_AMQP_ACK_TYPE, new PropertyIntercepter() {
            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                Object ackType = null;

                if (message.getAcknowledgeCallback() != null &&
                    message.getAcknowledgeCallback().isAckTypeSet()) {

                    ackType = message.getAcknowledgeCallback().getAckType();
                }

                return ackType;
            }

            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                if (message.getAcknowledgeCallback() == null) {
                    throw new JMSException("Session Acknowledgement Mode does not allow setting: " + JMS_AMQP_ACK_TYPE);
                }

                Integer ackType = (Integer) TypeConversionSupport.convert(value, Integer.class);
                if (ackType == null) {
                    throw new JMSException("Property " + JMS_AMQP_ACK_TYPE + " cannot be set from a " + value.getClass().getName() + ".");
                }

                message.getAcknowledgeCallback().setAckType(ackType);
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                if (message.getAcknowledgeCallback() != null) {
                    return message.getAcknowledgeCallback().isAckTypeSet();
                }

                return false;
            }

            @Override
            public void clearProperty(JmsMessage message) throws JMSException {
                if (message.getAcknowledgeCallback() != null) {
                    message.getAcknowledgeCallback().clearAckType();
                }
            }

            @Override
            public boolean isAlwaysWritable() {
                return true;
            }
        });
        PROPERTY_INTERCEPTERS.put(JMS_DELIVERYTIME, new PropertyIntercepter() {
            @Override
            public Object getProperty(JmsMessage message) throws JMSException {
                return Long.valueOf(message.getFacade().getDeliveryTime());
            }

            @Override
            public void setProperty(JmsMessage message, Object value) throws JMSException {
                Long rc = (Long) TypeConversionSupport.convert(value, Long.class);
                if (rc == null) {
                    throw new JMSException("Property JMSDeliveryTime cannot be set from a " + value.getClass().getName() + ".");
                }
                message.getFacade().setDeliveryTime(rc.longValue(), true);
            }

            @Override
            public boolean propertyExists(JmsMessage message) {
                return message.getFacade().getDeliveryTime() > 0;
            }

            @Override
            public void clearProperty(JmsMessage message) {
                message.getFacade().setDeliveryTime(0, true);
            }

            @Override
            public boolean isAlwaysWritable() {
                return false;
            }
        });
    }

    /**
     * Static get method that takes a property name and gets the value either via
     * a registered property get object or through the JmsMessageFacade getProperty
     * method.
     *
     * @param message
     *        the JmsMessage instance to read from
     * @param name
     *        the property name that is being requested.
     *
     * @return the correct value either mapped to an Message attribute of a Message property.
     *
     * @throws JMSException if an error occurs while reading the defined property.
     */
    public static Object getProperty(JmsMessage message, String name) throws JMSException {
        Object value = null;

        checkPropertyNameIsValid(name, message.isValidatePropertyNames());

        PropertyIntercepter jmsPropertyExpression = PROPERTY_INTERCEPTERS.get(name);
        if (jmsPropertyExpression != null) {
            value = jmsPropertyExpression.getProperty(message);
        } else {
            value = message.getFacade().getProperty(name);
        }

        return value;
    }

    /**
     * Static set method that takes a property name and sets the value either via
     * a registered property set object or through the JmsMessageFacade setProperty
     * method.
     *
     * @param message
     *        the JmsMessage instance to write to.
     * @param name
     *        the property name that is being written.
     * @param value
     *        the new value to assign for the named property.
     *
     * @throws JMSException if an error occurs while writing the defined property.
     */
    public static void setProperty(JmsMessage message, String name, Object value) throws JMSException {
        PropertyIntercepter jmsPropertyExpression = PROPERTY_INTERCEPTERS.get(name);

        if (jmsPropertyExpression == null || !jmsPropertyExpression.isAlwaysWritable()) {
            message.checkReadOnlyProperties();
        }
        checkPropertyNameIsValid(name, message.isValidatePropertyNames());
        checkValidObject(value);

        if (jmsPropertyExpression != null) {
            jmsPropertyExpression.setProperty(message, value);
        } else {
            message.getFacade().setProperty(name, value);
        }
    }

    /**
     * Static inspection method to determine if a named property exists for a given message.
     *
     * @param message
     *        the JmsMessage instance to read from
     * @param name
     *        the property name that is being inspected.
     *
     * @return true if the message contains the given property.
     *
     * @throws JMSException if an error occurs while validating the defined property.
     */
    public static boolean propertyExists(JmsMessage message, String name) throws JMSException {
        try {
            checkPropertyNameIsValid(name, message.isValidatePropertyNames());
        } catch (IllegalArgumentException iae) {
            return false;
        }

        PropertyIntercepter jmsPropertyExpression = PROPERTY_INTERCEPTERS.get(name);
        if (jmsPropertyExpression != null) {
            return jmsPropertyExpression.propertyExists(message);
        } else {
            return message.getFacade().propertyExists(name);
        }
    }

    /**
     * For each of the currently configured message property intercepter instances clear or
     * reset the value to its default.  Once complete the method will direct the given provider
     * message facade to clear any message properties that might have been set.
     *
     * @param message
     *        the JmsMessage instance to read from
     * @param excludeStandardJMSHeaders
     *        whether the standard JMS header names should be excluded from the returned set
     *
     * @throws JMSException if an error occurs while validating the defined property.
     */
    public static void clearProperties(JmsMessage message, boolean excludeStandardJMSHeaders) throws JMSException {
        for (Entry entry : PROPERTY_INTERCEPTERS.entrySet()) {
            if (excludeStandardJMSHeaders && STANDARD_HEADERS.contains(entry.getKey())) {
                continue;
            }

            entry.getValue().clearProperty(message);
        }

        message.getFacade().clearProperties();
        message.setReadOnlyProperties(false);
    }

    /**
     * For each of the currently configured message property intercepter instance a
     * string key value is inserted into an Set and returned.
     *
     * @param message
     *        the JmsMessage instance to read property names from.
     *
     * @return a {@code Set} containing the names of all intercepted properties.
     *
     * @throws JMSException if an error occurs while gathering the message property names.
     */
    public static Set getAllPropertyNames(JmsMessage message) throws JMSException {
        Set names = new HashSet(PROPERTY_INTERCEPTERS.keySet());
        names.addAll(message.getFacade().getPropertyNames());
        return names;
    }

    /**
     * For each of the currently configured message property intercepter instance a
     * string key value is inserted into an Set and returned if the property has a
     * value and is available for a read operation. The Set returned may be
     * manipulated by the receiver without impacting the facade, and an empty set
     * will be returned if there are no matching properties.
     *
     * @param message
     *        the JmsMessage instance to read from
     * @param excludeStandardJMSHeaders
     *        whether the standard JMS header names should be excluded from the returned set
     *
     * @return a {@code Set} containing the names of all intercepted properties with a value.
     *
     * @throws JMSException if an error occurs while gathering the message property names.
     */
    public static Set getPropertyNames(JmsMessage message, boolean excludeStandardJMSHeaders) throws JMSException {
        Set names = new HashSet();
        for (Entry entry : PROPERTY_INTERCEPTERS.entrySet()) {
            if (excludeStandardJMSHeaders && STANDARD_HEADERS.contains(entry.getKey())) {
                continue;
            }

            if (entry.getValue().propertyExists(message)) {
                names.add(entry.getKey());
            }
        }

        for (String name : message.getFacade().getPropertyNames()) {
            try {
                checkPropertyNameIsValid(name, message.isValidatePropertyNames());
            } catch (IllegalArgumentException iae) {
                // Don't add the name
                continue;
            }

            names.add(name);
        }

        return names;
    }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy