[Ubermq-commits] jms/src/com/ubermq/jms/client DeliveryMode.java,NONE,1.1 JMSUndeliverableException.java,NONE,1.1

[<ji...@us...>]

Update of /cvsroot/ubermq/jms/src/com/ubermq/jms/client
In directory usw-pr-cvs1:/tmp/cvs-serv21195/src/com/ubermq/jms/client

Added Files:
	DeliveryMode.java JMSUndeliverableException.java 
Log Message:
Add a new delivery mode, GUARANTEED_PROCESSING, that indicates
a publish() call should fail if a registered durable subscription
is disconnected.

Allows the creation of fail-fast, guaranteed messaging in addition
to the normal JMS modus operandi.



--- NEW FILE: DeliveryMode.java ---
package com.ubermq.jms.client;

/**
 * Additional constants for UberMQ specific delivery modes.
 */
public interface DeliveryMode
    extends javax.jms.DeliveryMode
{
    /**
     * Indicates that the message requires a guarantee of
     * being processed.  Using this delivery mode will cause
     * a client-side publish call to fail with an JMSUndeliverableException
     * if a durable subscriber registered on the published destination
     * is disconnected. <P>
     *
     * Appropriate use of this delivery mode can be useful to create
     * guaranteed, fail-fast delivery within a messaging infrastructure.
     * Delivery is always guaranteed with durable subscriptions, but
     * timely processing is not guaranteed. Using this mode will
     * allow your applications to handle service outages (if your durable
     * subscriptions represent services) gracefully and retry the
     * operation later, if necessary. The message will not be delivered
     * to the durable subscriber unless it is republished with another
     * delivery mode.<P>
     *
     * This delivery mode is only significant
     * in conjunction with durable subscribers, due to their
     * transactional implementation. <P>
     *
     * @see com.ubermq.jms.client.JMSUndeliverableException
     */
    public static final int GUARANTEED_PROCESSING = 6;
}

--- NEW FILE: JMSUndeliverableException.java ---
package com.ubermq.jms.client;

/**
 * Indicates that a message publish operation has failed
 * because one of the recipients actively rejected it.<P>
 *
 * This exception is used in conjunction with the UberMQ
 * specific <code>GUARANTEED_PROCESSING</code> delivery mode.<P>
 *
 * @see com.ubermq.jms.client.DeliveryMode
 */
public class JMSUndeliverableException
    extends javax.jms.JMSException
{
    /**
     * Constructs an undeliverable exception.
     *
     * @param sz  some text
     */
    public JMSUndeliverableException(String sz)
    {
        super(sz);
    }
}