jmssessionstubifc.java

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

    /**
     * Delete the receiver with the corresponding client id.
     *
     * @param clientId the identity of the receiver to delete
     * @throws JMSException for any JMS error
     */
    void deleteReceiver(long clientId) throws JMSException;

    /**
     * Delete the queue browser associated with the corresponding client id.
     *
     * @param clientId the id of the browser
     * @throws JMSException for any JMS error
     */
    void deleteBrowser(long clientId) throws JMSException;

    /**
     * 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 name is used to identify the consumer and 
     * can be set to null
     * <p>
     * You cannot create more than one subscriber for the same destination
     *
     * @param topic subscriber destination
     * @param name name of the consumer associated with the subscriber. 
     * This may be null.
     * @param clientId the session allocated identifier of this consumer
     * @param selector message selector. This may be null.
     * @param noLocal inhibit consuming messages on same connection.
     * @throws JMSException for any JMS error
     */
    void createSubscriber(JmsTopic topic, String name, long clientId,
                          String selector, boolean noLocal)
        throws JMSException;

    /**
     * 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.
     * <p>
     * You cannot create more than one publisher for the same destination
     *
     * @param topic receiver destination
     * @throws JMSException for any JMS error
     */
    void createPublisher(JmsTopic topic) throws JMSException;

    /**
     * Delete the subscriber associated with the sepcified identity.
     *
     * @param clientid the client identity
     * @throws JMSException for any JMS error
     */
    void deleteSubscriber(long clientId) throws JMSException;

    /**
     * Unsubscribe a durable subscription
     *
     * @param name the name used to identify the subscription
     * @throws JMSException for any JMS error
     */
    void unsubscribe(String name) throws JMSException;

    /**
     * Stop message delivery to this session
     *
     * @throws JMSException for any JMS error
     */
    void stopMessageDelivery() throws JMSException;

    /**
     * Start message delivery to this session
     *
     * @throws JMSException for any JMS error
     */
    void startMessageDelivery() throws JMSException;

    /**
     * Set the listener for this session. The listener is an object that
     * implements MessageListener and is called back whenever a message
     * for the session is present
     *
     * @param listener the message listener
     */
    void setMessageListener(JmsMessageListener listener);

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

    /**
     * Recover the session. This means all unacknowledged messages are
     * resent with the redelivery flag set
     *
     * @throws JMSException if the session cannot be recovered
     */
    void recover() throws JMSException;

    /**
     * Commit the session which will send all the published messages and
     * acknowledge all received messages
     *
     * @throws JMSException if the session cannot be committed
     */
    void commit() throws JMSException;

    /**
     * Rollback the session, which will not acknowledge any of the sent
     * messages
     *
     * @throws JMSException if the session cannot be rolled back
     */
    void rollback() throws JMSException;

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

    /**
     * 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
     */
    void end(Xid xid, int flags) throws XAException;

    /**
     * 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
     */
    void forget(Xid xid) throws XAException;

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

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

    /**
     * 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
     * @return the set of Xids to recover
     * @throws XAException - if there is a problem completing the call
     */
    Xid[] recover(int flag) throws XAException;

    /**
     * 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
     */
    void rollback(Xid xid) throws XAException;

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

    /**
     * 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
     */
    void start(Xid xid, int flags) throws XAException;

    /**
     * Return the identity of the associated resource manager.
     *
     * @return the identity of the resource manager
     * @throws XAException if there is a problem completing the call
     */
    String getResourceManagerId() throws XAException;
}