session.html

j2ee api,很好的api。我这现在有

AUTO_ACKNOWLEDGE</H3>
<PRE>
public static final int <B>AUTO_ACKNOWLEDGE</B></PRE>
<DL>
<DD>With this acknowledgment mode, the session automatically acknowledges
 a client's receipt of a message either when the session has successfully 
 returned from a call to <CODE>receive</CODE> or when the message 
 listener the session has called to process the message successfully 
 returns.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../constant-values.html#javax.jms.Session.AUTO_ACKNOWLEDGE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="CLIENT_ACKNOWLEDGE"><!-- --></A><H3>
CLIENT_ACKNOWLEDGE</H3>
<PRE>
public static final int <B>CLIENT_ACKNOWLEDGE</B></PRE>
<DL>
<DD>With this acknowledgment mode, the client acknowledges a consumed 
 message by calling the message's <CODE>acknowledge</CODE> method. 
 Acknowledging a consumed message acknowledges all messages that the 
 session has consumed.

 <P>When client acknowledgment mode is used, a client may build up a 
 large number of unacknowledged messages while attempting to process 
 them. A JMS provider should provide administrators with a way to 
 limit client overrun so that clients are not driven to resource 
 exhaustion and ensuing failure when some resource they are using 
 is temporarily blocked.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../javax/jms/Message.html#acknowledge()"><CODE>Message.acknowledge()</CODE></A>, 
<A HREF="../../constant-values.html#javax.jms.Session.CLIENT_ACKNOWLEDGE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="DUPS_OK_ACKNOWLEDGE"><!-- --></A><H3>
DUPS_OK_ACKNOWLEDGE</H3>
<PRE>
public static final int <B>DUPS_OK_ACKNOWLEDGE</B></PRE>
<DL>
<DD>This acknowledgment mode instructs the session to lazily acknowledge 
 the delivery of messages. This is likely to result in the delivery of 
 some duplicate messages if the JMS provider fails, so it should only be 
 used by consumers that can tolerate duplicate messages. Use of this  
 mode can reduce session overhead by minimizing the work the 
 session does to prevent duplicates.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../constant-values.html#javax.jms.Session.DUPS_OK_ACKNOWLEDGE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="SESSION_TRANSACTED"><!-- --></A><H3>
SESSION_TRANSACTED</H3>
<PRE>
public static final int <B>SESSION_TRANSACTED</B></PRE>
<DL>
<DD>This value is returned from the method 
 <CODE>getAcknowledgeMode</CODE> if the session is transacted.
 If a <CODE>Session</CODE> is transacted, the acknowledgement mode
 is ignored.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../constant-values.html#javax.jms.Session.SESSION_TRANSACTED">Constant Field Values</A></DL>
</DL>

<!-- ========= CONSTRUCTOR DETAIL ======== -->


<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="createBytesMessage()"><!-- --></A><H3>
createBytesMessage</H3>
<PRE>
public <A HREF="../../javax/jms/BytesMessage.html" title="interface in javax.jms">BytesMessage</A> <B>createBytesMessage</B>()
                                throws <A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></PRE>
<DL>
<DD>Creates a <CODE>BytesMessage</CODE> object. A <CODE>BytesMessage</CODE> 
 object is used to send a message containing a stream of uninterpreted 
 bytes.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></CODE> - if the JMS provider fails to create this message
                         due to some internal error.</DL>
</DD>
</DL>
<HR>

<A NAME="createMapMessage()"><!-- --></A><H3>
createMapMessage</H3>
<PRE>
public <A HREF="../../javax/jms/MapMessage.html" title="interface in javax.jms">MapMessage</A> <B>createMapMessage</B>()
                            throws <A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></PRE>
<DL>
<DD>Creates a <CODE>MapMessage</CODE> object. A <CODE>MapMessage</CODE> 
 object is used to send a self-defining set of name-value pairs, where 
 names are <CODE>String</CODE> objects and values are primitive values 
 in the Java programming language.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></CODE> - if the JMS provider fails to create this message
                         due to some internal error.</DL>
</DD>
</DL>
<HR>

<A NAME="createMessage()"><!-- --></A><H3>
createMessage</H3>
<PRE>
public <A HREF="../../javax/jms/Message.html" title="interface in javax.jms">Message</A> <B>createMessage</B>()
                      throws <A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></PRE>
<DL>
<DD>Creates a <CODE>Message</CODE> object. The <CODE>Message</CODE> 
 interface is the root interface of all JMS messages. A 
 <CODE>Message</CODE> object holds all the 
 standard message header information. It can be sent when a message 
 containing only header information is sufficient.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></CODE> - if the JMS provider fails to create this message
                         due to some internal error.</DL>
</DD>
</DL>
<HR>

<A NAME="createObjectMessage()"><!-- --></A><H3>
createObjectMessage</H3>
<PRE>
public <A HREF="../../javax/jms/ObjectMessage.html" title="interface in javax.jms">ObjectMessage</A> <B>createObjectMessage</B>()
                                  throws <A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></PRE>
<DL>
<DD>Creates an <CODE>ObjectMessage</CODE> object. An 
 <CODE>ObjectMessage</CODE> object is used to send a message 
 that contains a serializable Java object.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></CODE> - if the JMS provider fails to create this message
                         due to some internal error.</DL>
</DD>
</DL>
<HR>

<A NAME="createObjectMessage(java.io.Serializable)"><!-- --></A><H3>
createObjectMessage</H3>
<PRE>
public <A HREF="../../javax/jms/ObjectMessage.html" title="interface in javax.jms">ObjectMessage</A> <B>createObjectMessage</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/Serializable.html" title="class or interface in java.io">Serializable</A>&nbsp;object)
                                  throws <A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></PRE>
<DL>
<DD>Creates an initialized <CODE>ObjectMessage</CODE> object. An 
 <CODE>ObjectMessage</CODE> object is used 
 to send a message that contains a serializable Java object.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>object</CODE> - the object to use to initialize this message
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></CODE> - if the JMS provider fails to create this message
                         due to some internal error.</DL>
</DD>
</DL>
<HR>

<A NAME="createStreamMessage()"><!-- --></A><H3>
createStreamMessage</H3>
<PRE>
public <A HREF="../../javax/jms/StreamMessage.html" title="interface in javax.jms">StreamMessage</A> <B>createStreamMessage</B>()
                                  throws <A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></PRE>
<DL>
<DD>Creates a <CODE>StreamMessage</CODE> object. A 
 <CODE>StreamMessage</CODE> object is used to send a 
 self-defining stream of primitive values in the Java programming 
 language.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></CODE> - if the JMS provider fails to create this message
                         due to some internal error.</DL>
</DD>
</DL>
<HR>

<A NAME="createTextMessage()"><!-- --></A><H3>
createTextMessage</H3>
<PRE>
public <A HREF="../../javax/jms/TextMessage.html" title="interface in javax.jms">TextMessage</A> <B>createTextMessage</B>()
                              throws <A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></PRE>
<DL>
<DD>Creates a <CODE>TextMessage</CODE> object. A <CODE>TextMessage</CODE> 
 object is used to send a message containing a <CODE>String</CODE>
 object.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></CODE> - if the JMS provider fails to create this message
                         due to some internal error.</DL>
</DD>
</DL>
<HR>

<A NAME="createTextMessage(java.lang.String)"><!-- --></A><H3>
createTextMessage</H3>
<PRE>
public <A HREF="../../javax/jms/TextMessage.html" title="interface in javax.jms">TextMessage</A> <B>createTextMessage</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;text)
                              throws <A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></PRE>
<DL>
<DD>Creates an initialized <CODE>TextMessage</CODE> object. A 
 <CODE>TextMessage</CODE> object is used to send 
 a message containing a <CODE>String</CODE>.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>text</CODE> - the string used to initialize this message
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></CODE> - if the JMS provider fails to create this message
                         due to some internal error.</DL>
</DD>
</DL>
<HR>

<A NAME="getTransacted()"><!-- --></A><H3>
getTransacted</H3>
<PRE>
public boolean <B>getTransacted</B>()
                      throws <A HREF="../../javax/jms/JMSException.html" title="class in javax.jms">JMSException</A></PRE>
<DL>
<DD>Indicates whether the session is in transacted mode.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>true if the session is in transacted mode
<DT><B>Throws:</B>