remotejmsserversessionifc.java

实现了Jms的服务器源码,支持多种适配器,DB,FTP,支持多种数据库

    /**
     * Delete the queue browser associated with the specified queue from
     * the session.
     * If the corresponding queue does not exist or it cannot be deleted,
     * then throw a JMSException.
     *
     * @param       clientId - the client identity
     * @exception   JMSException
     * @exception   RemoteException
     */
    public void deleteBrowser(long clientId)
        throws JMSException, RemoteException;

    /**
     * Create a subscriber endpoint for this session. A subscriber is a message
     * consumer specific to the topic message model. The subscriber is
     * associated with a topic. The consumer name is used to identify an
     * endpoint for persistent delivery. If we are using non-persistent
     * delivery then this can be set to null
     * <p>
     * You cannot create more than one subscriber for the same destination
     *
     * @param       topic               subscriber destination
     * @param       name                consumer name
     * @param       clientId            the session allocated identifier of
     *                                  this consumer
     * @param       selector            the selector to filter messages.
     *                                  This may be null.
     * @param       noLocal             inhibit consuming messages on same
     *                                  connection.
     * @exception   JMSException.
     * @exception   RemoteException
     */
    public void createSubscriber(JmsTopic topic, String name, long clientId,
                                 String selector, boolean noLocal)
        throws JMSException, RemoteException;

    /**
     * Create a publisher endpoint for this session. A publisher is a message
     * publisher specific to the topic message model. The publisher is
     * associated with a topic. Return the unique identity of the publisher
     * <p>
     * You cannot create more than one publisher for the same destination
     *
     * @param       topic               receiver destination
     * @exception   JMSException.
     * @exception   RemoteException
     */
    public void createPublisher(JmsTopic topic)
        throws JMSException, RemoteException;

    /**
     * Delete the subscriber for the specified topic. If this subscriber
     * does not exist or the cannot be deleted then throw JMSException.
     *
     * @param       clientId            the client identity
     * @exception   JMSException.
     */
    public void deleteSubscriber(long clientId)
        throws JMSException, RemoteException;

    /**
     * Delete the publisher for the specified topic. If the publisher does
     * not exist or cannot be deleted then throw JMSException
     *
     * @param       topic               topic name
     * @exception   JMSException.
     * @exception   RemoteException.
     */
    public void deletePublisher(JmsTopic topic)
        throws JMSException, RemoteException;

    /**
     * Unsubscribe a durable subscription
     *
     * @param       name                the name used to identify the
     *                                  subscription
     * @exception   JMSException        if the subscription cannot be removed
     * @exception   RemoteException
     */
    public void unsubscribe(String name)
        throws JMSException, RemoteException;

    /**
     * Stop message delivery to this session. If there are any problems
     * completing the request then throw the JMSException exception
     *
     * @exception   JMSException
     * @exception   RemoteException.
     */
    public void stopMessageDelivery()
        throws JMSException, RemoteException;

    /**
     * Start message delivery to this session. If there are any problems
     * completing this request then throw the JMSException exception
     *
     * @exception   JMSException
     * @exception   RemoteException.
     */
    public void startMessageDelivery()
        throws JMSException, RemoteException;

    /**
     * Recover the session. If there are any problems completing the request
     * then throw the JMSException exception
     *
     * @exception   JMSException
     * @exception   RemoteException.
     */
    public void recover()
        throws JMSException, RemoteException;

    /**
     * Commit the session. If there are any problems completing the request
     * then throw the JMSException exception
     *
     * @exception   JMSException
     * @exception   RemoteException.
     */
    public void commit()
        throws JMSException, RemoteException;

    /**
     * Rollback the session. If there are any problems completing the request
     * then throw the JMSException exception
     *
     * @exception   JMSException
     * @exception   RemoteException.
     */
    public void rollback()
        throws JMSException, RemoteException;

    /**
     * Commits an XA transaction that is in progress.
     *
     * @param xid - the xa transaction identity
     * @param onePhase - treu if it is a one phase commit
     * @throws XAException - if there is a problem completing the call
     * @throws RemoteException - communication related error
     */
    public void commit(Xid xid, boolean onePhase)
        throws XAException, RemoteException;

    /**
     * Ends the work performed on behalf of a transaction branch. The resource
     * manager disassociates the XA resource from the transaction branch
     * specified and let the transaction be completedCommits an XA transaction
     * that is in progress.
     *
     * @param xid - the xa transaction identity
     * @param flags - one of TMSUCCESS, TMFAIL, or TMSUSPEND
     * @throws XAException - if there is a problem completing the call
     * @throws RemoteException - communication related error
     */
    public void end(Xid xid, int flags)
        throws XAException, RemoteException;

    /**
     * Tell the resource manager to forget about a heuristically completed
     * transaction branch.
     *
     * @param xid - the xa transaction identity
     * @throws XAException - if there is a problem completing the call
     * @throws RemoteException - communication related error
     */
    public void forget(Xid xid)
        throws XAException, RemoteException;

    /**
     * Return the transaction timeout for this instance of the resource
     * manager.
     *
     * @return int - the timeout in seconds
     * @throws XAException - if there is a problem completing the call
     * @throws RemoteException - communication related error
     */
    public int getTransactionTimeout()
        throws XAException, RemoteException;

    /**
     * Ask the resource manager to prepare for a transaction commit of the
     * transaction specified in xid
     *
     * @param xid - the xa transaction identity
     * @return int - XA_RDONLY or XA_OK
     * @throws XAException - if there is a problem completing the call
     * @throws RemoteException - communication related error
     */
    public int prepare(Xid xid)
        throws XAException, RemoteException;

    /**
     * Obtain a list of prepared transaction branches from a resource manager.
     * The transaction manager calls this method during recovery to obtain the
     * list of transaction branches that are currently in prepared or
     * heuristically completed states.
     *
     * @param flag - One of TMSTARTRSCAN, TMENDRSCAN, TMNOFLAGS. TMNOFLAGS
     * @param Xid[] - the set of Xids to recover
     * @throws XAException - if there is a problem completing the call
     * @throws RemoteException - communication related error
     */
    public Xid[] recover(int flag)
        throws XAException, RemoteException;

    /**
     * Inform the resource manager to roll back work done on behalf of a
     * transaction branch
     *
     * @param xid - the xa transaction identity
     * @throws XAException - if there is a problem completing the call
     * @throws RemoteException - communication related error
     */
    public void rollback(Xid xid)
        throws XAException, RemoteException;

    /**
     * Set the current transaction timeout value for this XAResource instance.
     *
     * @param seconds - timeout in seconds
     * @return boolean - true if the new transaction timeout was accepted
     * @throws XAException - if there is a problem completing the call
     * @throws RemoteException - communication related error
     */
    public boolean setTransactionTimeout(int seconds)
        throws XAException, RemoteException;

    /**
     * Start work on behalf of a transaction branch specified in xid If TMJOIN
     * is specified, the start is for joining a transaction previously seen by
     * the resource manager
     *
     * @param xid - the xa transaction identity
     * @param flags - One of TMNOFLAGS, TMJOIN, or TMRESUME
     * @throws XAException - if there is a problem completing the call
     * @throws RemoteException - communication related error
     */
    public void start(Xid xid, int flags)
        throws XAException, RemoteException;

    /**
     * Return the resource manager identity
     *
     * @return the resource manager identity
     * @throws XAException - if there is a problem completing the call
     * @throws RemoteException - communication related error
     */
    public String getResourceManagerId() throws XAException, RemoteException;

    /**
     * All server side sessions register with the consumer manager for
     * message consumption (i.e push-model). When a message arrives this
     * server-side instance will send it down to the client side stub for
     * further processing.
     * <p>
     * If the listener is null then throw JMSException
     *
     * @param       listener            listener to delivery messages too.
     * @exception   JMSException
     * @exception   RemoteException.
     */
    public void setMessageListener(RemoteJmsMessageListenerIfc listener)
        throws JMSException, RemoteException;

    /**
     * Enable or disable asynchronous message delivery for a particular
     * consumer
     *
     * @param clientId - the id of the client to check
     * @param id - the last message asynchronously delivered
     * @param enable - true to enable; false to disable
     */
    public void enableAsynchronousDelivery(long clientId, String id,
                                           boolean enable)
        throws JMSException, RemoteException;
}