diff options
| author | Eike Stepper | 2016-10-06 10:25:06 +0000 |
|---|---|---|
| committer | Eike Stepper | 2016-10-06 10:25:06 +0000 |
| commit | 2ffd84347afa6f75edf142245c2ca618750b6889 (patch) | |
| tree | ff9080cdcae918b351042cab14de4c1481680cca /plugins/org.eclipse.net4j.examples.installer | |
| parent | f4016b630a3ce191d51ed4cd1bf5fe93b5027864 (diff) | |
| download | cdo-2ffd84347afa6f75edf142245c2ca618750b6889.tar.gz cdo-2ffd84347afa6f75edf142245c2ca618750b6889.tar.xz cdo-2ffd84347afa6f75edf142245c2ca618750b6889.zip | |
[Releng] Source Clean-Up for all projects
Diffstat (limited to 'plugins/org.eclipse.net4j.examples.installer')
51 files changed, 1121 insertions, 1121 deletions
diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.buddies.ui/META-INF/MANIFEST.MF b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.buddies.ui/META-INF/MANIFEST.MF index 9859bed4c2..a05584eaca 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.buddies.ui/META-INF/MANIFEST.MF +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.buddies.ui/META-INF/MANIFEST.MF @@ -2,7 +2,7 @@ Manifest-Version: 1.0 Bundle-ManifestVersion: 2 Bundle-Name: %pluginName Bundle-SymbolicName: org.eclipse.net4j.buddies.ui;singleton:=true -Bundle-Version: 4.0.400.qualifier +Bundle-Version: 4.0.500.qualifier Bundle-Activator: org.eclipse.net4j.buddies.internal.ui.bundle.OM$Activator Bundle-Vendor: %providerName Bundle-ClassPath: . @@ -16,12 +16,12 @@ Require-Bundle: org.eclipse.core.runtime;bundle-version="[3.5.0,4.0.0)", org.eclipse.net4j.buddies;bundle-version="[4.0.0,5.0.0)";visibility:=reexport, org.eclipse.net4j.buddies.chat;bundle-version="[4.0.0,5.0.0)";resolution:=optional, org.eclipse.net4j.ui.shared;bundle-version="[4.0.0,5.0.0)" -Export-Package: org.eclipse.net4j.buddies.internal.ui;version="4.0.400", - org.eclipse.net4j.buddies.internal.ui.actions;version="4.0.400", - org.eclipse.net4j.buddies.internal.ui.bundle;version="4.0.400";x-internal:=true, - org.eclipse.net4j.buddies.internal.ui.dnd;version="4.0.400", - org.eclipse.net4j.buddies.internal.ui.messages;version="4.0.400";x-internal:=true, - org.eclipse.net4j.buddies.internal.ui.preferences;version="4.0.400", - org.eclipse.net4j.buddies.internal.ui.views;version="4.0.400", - org.eclipse.net4j.buddies.ui;version="4.0.400" +Export-Package: org.eclipse.net4j.buddies.internal.ui;version="4.0.500", + org.eclipse.net4j.buddies.internal.ui.actions;version="4.0.500", + org.eclipse.net4j.buddies.internal.ui.bundle;version="4.0.500";x-internal:=true, + org.eclipse.net4j.buddies.internal.ui.dnd;version="4.0.500", + org.eclipse.net4j.buddies.internal.ui.messages;version="4.0.500";x-internal:=true, + org.eclipse.net4j.buddies.internal.ui.preferences;version="4.0.500", + org.eclipse.net4j.buddies.internal.ui.views;version="4.0.500", + org.eclipse.net4j.buddies.ui;version="4.0.500" Bundle-ActivationPolicy: lazy diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.buddies.ui/src/org/eclipse/net4j/buddies/internal/ui/AbstractItemProvider.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.buddies.ui/src/org/eclipse/net4j/buddies/internal/ui/AbstractItemProvider.java index 833ae6790f..e091c17d7b 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.buddies.ui/src/org/eclipse/net4j/buddies/internal/ui/AbstractItemProvider.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.buddies.ui/src/org/eclipse/net4j/buddies/internal/ui/AbstractItemProvider.java @@ -193,11 +193,11 @@ public abstract class AbstractItemProvider extends ContainerItemProvider<IContai manager.add( new SafeAction(Messages.getString("AbstractItemProvider.0"), Messages.getString("AbstractItemProvider.1")) //$NON-NLS-1$ //$NON-NLS-2$ { - @Override - protected void safeRun() throws Exception - { - collaboration.leave(); - } + @Override + protected void safeRun() throws Exception + { + collaboration.leave(); + } }); } } diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/META-INF/MANIFEST.MF b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/META-INF/MANIFEST.MF index bd9d798a60..5f693af3f3 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/META-INF/MANIFEST.MF +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/META-INF/MANIFEST.MF @@ -1,7 +1,7 @@ Manifest-Version: 1.0 Bundle-ManifestVersion: 2 Bundle-SymbolicName: org.eclipse.net4j.jms.api -Bundle-Version: 3.1.200.qualifier +Bundle-Version: 3.1.300.qualifier Bundle-Name: %pluginName Bundle-Vendor: %providerName Bundle-Localization: plugin diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/BytesMessage.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/BytesMessage.java index 139d5a2da3..d4d532336b 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/BytesMessage.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/BytesMessage.java @@ -85,17 +85,17 @@ public interface BytesMessage extends Message { /** Gets the number of bytes of the message body when the message - * is in read-only mode. The value returned can be used to allocate + * is in read-only mode. The value returned can be used to allocate * a byte array. The value returned is the entire length of the message - * body, regardless of where the pointer for reading the message + * body, regardless of where the pointer for reading the message * is currently located. - * - * @return number of bytes in the message - * @exception JMSException if the JMS provider fails to read the message + * + * @return number of bytes in the message + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. * @exception MessageNotReadableException if the message is in write-only * mode. - * @since 1.1 + * @since 1.1 */ long getBodyLength() throws JMSException; @@ -104,11 +104,11 @@ public interface BytesMessage extends Message * * @return the <code>boolean</code> value read * - * @exception JMSException if the JMS provider fails to read the message + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageEOFException if unexpected end of bytes stream has + * @exception MessageEOFException if unexpected end of bytes stream has * been reached. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -119,26 +119,26 @@ public interface BytesMessage extends Message * @return the next byte from the bytes message stream as a signed 8-bit * <code>byte</code> * - * @exception JMSException if the JMS provider fails to read the message + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageEOFException if unexpected end of bytes stream has + * @exception MessageEOFException if unexpected end of bytes stream has * been reached. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ byte readByte() throws JMSException; /** Reads an unsigned 8-bit number from the bytes message stream. - * + * * @return the next byte from the bytes message stream, interpreted as an * unsigned 8-bit number * - * @exception JMSException if the JMS provider fails to read the message + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageEOFException if unexpected end of bytes stream has + * @exception MessageEOFException if unexpected end of bytes stream has * been reached. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -149,26 +149,26 @@ public interface BytesMessage extends Message * @return the next two bytes from the bytes message stream, interpreted as * a signed 16-bit number * - * @exception JMSException if the JMS provider fails to read the message + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageEOFException if unexpected end of bytes stream has + * @exception MessageEOFException if unexpected end of bytes stream has * been reached. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ short readShort() throws JMSException; /** Reads an unsigned 16-bit number from the bytes message stream. - * + * * @return the next two bytes from the bytes message stream, interpreted as * an unsigned 16-bit integer * - * @exception JMSException if the JMS provider fails to read the message + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageEOFException if unexpected end of bytes stream has + * @exception MessageEOFException if unexpected end of bytes stream has * been reached. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -179,11 +179,11 @@ public interface BytesMessage extends Message * @return the next two bytes from the bytes message stream as a Unicode * character * - * @exception JMSException if the JMS provider fails to read the message + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageEOFException if unexpected end of bytes stream has + * @exception MessageEOFException if unexpected end of bytes stream has * been reached. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -194,11 +194,11 @@ public interface BytesMessage extends Message * @return the next four bytes from the bytes message stream, interpreted * as an <code>int</code> * - * @exception JMSException if the JMS provider fails to read the message + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageEOFException if unexpected end of bytes stream has + * @exception MessageEOFException if unexpected end of bytes stream has * been reached. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -209,11 +209,11 @@ public interface BytesMessage extends Message * @return the next eight bytes from the bytes message stream, interpreted * as a <code>long</code> * - * @exception JMSException if the JMS provider fails to read the message + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageEOFException if unexpected end of bytes stream has + * @exception MessageEOFException if unexpected end of bytes stream has * been reached. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -224,11 +224,11 @@ public interface BytesMessage extends Message * @return the next four bytes from the bytes message stream, interpreted * as a <code>float</code> * - * @exception JMSException if the JMS provider fails to read the message + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageEOFException if unexpected end of bytes stream has + * @exception MessageEOFException if unexpected end of bytes stream has * been reached. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -239,11 +239,11 @@ public interface BytesMessage extends Message * @return the next eight bytes from the bytes message stream, interpreted * as a <code>double</code> * - * @exception JMSException if the JMS provider fails to read the message + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageEOFException if unexpected end of bytes stream has + * @exception MessageEOFException if unexpected end of bytes stream has * been reached. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -259,11 +259,11 @@ public interface BytesMessage extends Message * * @return a Unicode string from the bytes message stream * - * @exception JMSException if the JMS provider fails to read the message + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageEOFException if unexpected end of bytes stream has + * @exception MessageEOFException if unexpected end of bytes stream has * been reached. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -271,25 +271,25 @@ public interface BytesMessage extends Message /** Reads a byte array from the bytes message stream. * - * <P>If the length of array <code>value</code> is less than the number of - * bytes remaining to be read from the stream, the array should + * <P>If the length of array <code>value</code> is less than the number of + * bytes remaining to be read from the stream, the array should * be filled. A subsequent call reads the next increment, and so on. - * - * <P>If the number of bytes remaining in the stream is less than the - * length of - * array <code>value</code>, the bytes should be read into the array. + * + * <P>If the number of bytes remaining in the stream is less than the + * length of + * array <code>value</code>, the bytes should be read into the array. * The return value of the total number of bytes read will be less than - * the length of the array, indicating that there are no more bytes left + * the length of the array, indicating that there are no more bytes left * to be read from the stream. The next read of the stream returns -1. * * @param value the buffer into which the data is read * - * @return the total number of bytes read into the buffer, or -1 if + * @return the total number of bytes read into the buffer, or -1 if * there is no more data because the end of the stream has been reached * - * @exception JMSException if the JMS provider fails to read the message + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -298,60 +298,60 @@ public interface BytesMessage extends Message /** Reads a portion of the bytes message stream. * * <P>If the length of array <code>value</code> is less than the number of - * bytes remaining to be read from the stream, the array should + * bytes remaining to be read from the stream, the array should * be filled. A subsequent call reads the next increment, and so on. - * - * <P>If the number of bytes remaining in the stream is less than the - * length of - * array <code>value</code>, the bytes should be read into the array. + * + * <P>If the number of bytes remaining in the stream is less than the + * length of + * array <code>value</code>, the bytes should be read into the array. * The return value of the total number of bytes read will be less than - * the length of the array, indicating that there are no more bytes left + * the length of the array, indicating that there are no more bytes left * to be read from the stream. The next read of the stream returns -1. * * <p> If <code>length</code> is negative, or * <code>length</code> is greater than the length of the array * <code>value</code>, then an <code>IndexOutOfBoundsException</code> is * thrown. No bytes will be read from the stream for this exception case. - * + * * @param value the buffer into which the data is read * @param length the number of bytes to read; must be less than or equal to * <code>value.length</code> - * + * * @return the total number of bytes read into the buffer, or -1 if * there is no more data because the end of the stream has been reached - * - * @exception JMSException if the JMS provider fails to read the message + * + * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ int readBytes(byte[] value, int length) throws JMSException; - /** Writes a <code>boolean</code> to the bytes message stream as a 1-byte + /** Writes a <code>boolean</code> to the bytes message stream as a 1-byte * value. - * The value <code>true</code> is written as the value - * <code>(byte)1</code>; the value <code>false</code> is written as + * The value <code>true</code> is written as the value + * <code>(byte)1</code>; the value <code>false</code> is written as * the value <code>(byte)0</code>. * * @param value the <code>boolean</code> value to be written * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ void writeBoolean(boolean value) throws JMSException; - /** Writes a <code>byte</code> to the bytes message stream as a 1-byte + /** Writes a <code>byte</code> to the bytes message stream as a 1-byte * value. * * @param value the <code>byte</code> value to be written * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -364,7 +364,7 @@ public interface BytesMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -377,39 +377,39 @@ public interface BytesMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ void writeChar(char value) throws JMSException; - /** Writes an <code>int</code> to the bytes message stream as four bytes, + /** Writes an <code>int</code> to the bytes message stream as four bytes, * high byte first. * * @param value the <code>int</code> to be written * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ void writeInt(int value) throws JMSException; - /** Writes a <code>long</code> to the bytes message stream as eight bytes, + /** Writes a <code>long</code> to the bytes message stream as eight bytes, * high byte first. * * @param value the <code>long</code> to be written * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ void writeLong(long value) throws JMSException; - /** Converts the <code>float</code> argument to an <code>int</code> using + /** Converts the <code>float</code> argument to an <code>int</code> using * the * <code>floatToIntBits</code> method in class <code>Float</code>, * and then writes that <code>int</code> value to the bytes message @@ -419,13 +419,13 @@ public interface BytesMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ void writeFloat(float value) throws JMSException; - /** Converts the <code>double</code> argument to a <code>long</code> using + /** Converts the <code>double</code> argument to a <code>long</code> using * the * <code>doubleToLongBits</code> method in class <code>Double</code>, * and then writes that <code>long</code> value to the bytes message @@ -435,25 +435,25 @@ public interface BytesMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ void writeDouble(double value) throws JMSException; - /** Writes a string to the bytes message stream using UTF-8 encoding in a + /** Writes a string to the bytes message stream using UTF-8 encoding in a * machine-independent manner. * - * <P>For more information on the UTF-8 format, see "File System Safe - * UCS Transformation Format (FSS_UTF)", X/Open Preliminary Specification, - * X/Open Company Ltd., Document Number: P316. This information also - * appears in ISO/IEC 10646, Annex P. + * <P>For more information on the UTF-8 format, see "File System Safe + * UCS Transformation Format (FSS_UTF)", X/Open Preliminary Specification, + * X/Open Company Ltd., Document Number: P316. This information also + * appears in ISO/IEC 10646, Annex P. * * @param value the <code>String</code> value to be written * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -465,21 +465,21 @@ public interface BytesMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ void writeBytes(byte[] value) throws JMSException; /** Writes a portion of a byte array to the bytes message stream. - * + * * @param value the byte array value to be written * @param offset the initial offset within the byte array * @param length the number of bytes to use * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -488,27 +488,27 @@ public interface BytesMessage extends Message /** Writes an object to the bytes message stream. * * <P>This method works only for the objectified primitive - * object types (<code>Integer</code>, <code>Double</code>, - * <code>Long</code> ...), <code>String</code> objects, and byte + * object types (<code>Integer</code>, <code>Double</code>, + * <code>Long</code> ...), <code>String</code> objects, and byte * arrays. * - * @param value the object in the Java programming language ("Java + * @param value the object in the Java programming language ("Java * object") to be written; it must not be null * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. * @exception MessageFormatException if the object is of an invalid type. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. - * @exception java.lang.NullPointerException if the parameter + * @exception java.lang.NullPointerException if the parameter * <code>value</code> is null. */ void writeObject(Object value) throws JMSException; - /** Puts the message body in read-only mode and repositions the stream of + /** Puts the message body in read-only mode and repositions the stream of * bytes to the beginning. - * + * * @exception JMSException if the JMS provider fails to reset the message * due to some internal error. * @exception MessageFormatException if the message has an invalid diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Connection.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Connection.java index 690d89bf72..f85663d824 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Connection.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Connection.java @@ -102,21 +102,21 @@ public interface Connection * @see Session#AUTO_ACKNOWLEDGE * @see Session#CLIENT_ACKNOWLEDGE * @see Session#DUPS_OK_ACKNOWLEDGE - + */ Session createSession(boolean transacted, int acknowledgeMode) throws JMSException; /** Gets the client identifier for this connection. - * - * <P>This value is specific to the JMS provider. It is either preconfigured + * + * <P>This value is specific to the JMS provider. It is either preconfigured * by an administrator in a <CODE>ConnectionFactory</CODE> object * or assigned dynamically by the application by calling the * <code>setClientID</code> method. - * - * + * + * * @return the unique client identifier - * + * * @exception JMSException if the JMS provider fails to return * the client ID for this connection due * to some internal error. @@ -125,12 +125,12 @@ public interface Connection String getClientID() throws JMSException; /** Sets the client identifier for this connection. - * + * * <P>The preferred way to assign a JMS client's client identifier is for * it to be configured in a client-specific <CODE>ConnectionFactory</CODE> * object and transparently assigned to the <CODE>Connection</CODE> object * it creates. - * + * * <P>Alternatively, a client can set a connection's client identifier * using a provider-specific value. The facility to set a connection's * client identifier explicitly is not a mechanism for overriding the @@ -138,14 +138,14 @@ public interface Connection * for the case where no administratively specified identifier exists. * If one does exist, an attempt to change it by setting it must throw an * <CODE>IllegalStateException</CODE>. If a client sets the client identifier - * explicitly, it must do so immediately after it creates the connection + * explicitly, it must do so immediately after it creates the connection * and before any other * action on the connection is taken. After this point, setting the * client identifier is a programming error that should throw an * <CODE>IllegalStateException</CODE>. * * <P>The purpose of the client identifier is to associate a connection and - * its objects with a state maintained on behalf of the client by a + * its objects with a state maintained on behalf of the client by a * provider. The only such state identified by the JMS API is that required * to support durable subscriptions. * @@ -154,7 +154,7 @@ public interface Connection * an <CODE>InvalidClientIDException</CODE>. * * @param clientID the unique client identifier - * + * * @exception JMSException if the JMS provider fails to * set the client ID for this connection due * to some internal error. @@ -169,9 +169,9 @@ public interface Connection void setClientID(String clientID) throws JMSException; /** Gets the metadata for this connection. - * + * * @return the connection metadata - * + * * @exception JMSException if the JMS provider fails to * get the connection metadata for this connection. * @@ -181,17 +181,17 @@ public interface Connection ConnectionMetaData getMetaData() throws JMSException; /** - * Gets the <CODE>ExceptionListener</CODE> object for this connection. + * Gets the <CODE>ExceptionListener</CODE> object for this connection. * Not every <CODE>Connection</CODE> has an <CODE>ExceptionListener</CODE> * associated with it. * - * @return the <CODE>ExceptionListener</CODE> for this connection, or null. + * @return the <CODE>ExceptionListener</CODE> for this connection, or null. * if no <CODE>ExceptionListener</CODE> is associated * with this connection. * * @exception JMSException if the JMS provider fails to - * get the <CODE>ExceptionListener</CODE> for this - * connection. + * get the <CODE>ExceptionListener</CODE> for this + * connection. * @see javax.jms.Connection#setExceptionListener */ @@ -207,13 +207,13 @@ public interface Connection * * <P>An exception listener allows a client to be notified of a problem * asynchronously. - * Some connections only consume messages, so they would have no other + * Some connections only consume messages, so they would have no other * way to learn their connection has failed. * * <P>A connection serializes execution of its * <CODE>ExceptionListener</CODE>. * - * <P>A JMS provider should attempt to resolve connection problems + * <P>A JMS provider should attempt to resolve connection problems * itself before it notifies the client of them. * * @param listener the exception listener @@ -228,7 +228,7 @@ public interface Connection /** Starts (or restarts) a connection's delivery of incoming messages. * A call to <CODE>start</CODE> on a connection that has already been * started is ignored. - * + * * @exception JMSException if the JMS provider fails to start * message delivery due to some internal error. * @@ -252,20 +252,20 @@ public interface Connection * stopped is ignored. * * <P>A call to <CODE>stop</CODE> must not return until delivery of messages - * has paused. This means that a client can rely on the fact that none of - * its message listeners will be called and that all threads of control - * waiting for <CODE>receive</CODE> calls to return will not return with a + * has paused. This means that a client can rely on the fact that none of + * its message listeners will be called and that all threads of control + * waiting for <CODE>receive</CODE> calls to return will not return with a * message until the * connection is restarted. The receive timers for a stopped connection * continue to advance, so receives may time out while the connection is * stopped. - * - * <P>If message listeners are running when <CODE>stop</CODE> is invoked, + * + * <P>If message listeners are running when <CODE>stop</CODE> is invoked, * the <CODE>stop</CODE> call must * wait until all of them have returned before it may return. While these * message listeners are completing, they must have the full services of the * connection available to them. - * + * * @exception JMSException if the JMS provider fails to stop * message delivery due to some internal error. * @@ -276,9 +276,9 @@ public interface Connection /** Closes the connection. * - * <P>Since a provider typically allocates significant resources outside + * <P>Since a provider typically allocates significant resources outside * the JVM on behalf of a connection, clients should close these resources - * when they are not needed. Relying on garbage collection to eventually + * when they are not needed. Relying on garbage collection to eventually * reclaim these resources may not be timely enough. * * <P>There is no need to close the sessions, producers, and consumers @@ -289,34 +289,34 @@ public interface Connection * * <P>When this method is invoked, it should not return until message * processing has been shut down in an orderly fashion. This means that all - * message - * listeners that may have been running have returned, and that all pending - * receives have returned. A close terminates all pending message receives - * on the connection's sessions' consumers. The receives may return with a - * message or with null, depending on whether there was a message available - * at the time of the close. If one or more of the connection's sessions' - * message listeners is processing a message at the time when connection - * <CODE>close</CODE> is invoked, all the facilities of the connection and - * its sessions must remain available to those listeners until they return - * control to the JMS provider. + * message + * listeners that may have been running have returned, and that all pending + * receives have returned. A close terminates all pending message receives + * on the connection's sessions' consumers. The receives may return with a + * message or with null, depending on whether there was a message available + * at the time of the close. If one or more of the connection's sessions' + * message listeners is processing a message at the time when connection + * <CODE>close</CODE> is invoked, all the facilities of the connection and + * its sessions must remain available to those listeners until they return + * control to the JMS provider. * * <P>Closing a connection causes any of its sessions' transactions * in progress to be rolled back. In the case where a session's - * work is coordinated by an external transaction manager, a session's + * work is coordinated by an external transaction manager, a session's * <CODE>commit</CODE> and <CODE>rollback</CODE> methods are * not used and the result of a closed session's work is determined * later by the transaction manager. * - * Closing a connection does NOT force an - * acknowledgment of client-acknowledged sessions. - * - * <P>Invoking the <CODE>acknowledge</CODE> method of a received message - * from a closed connection's session must throw an - * <CODE>IllegalStateException</CODE>. Closing a closed connection must + * Closing a connection does NOT force an + * acknowledgment of client-acknowledged sessions. + * + * <P>Invoking the <CODE>acknowledge</CODE> method of a received message + * from a closed connection's session must throw an + * <CODE>IllegalStateException</CODE>. Closing a closed connection must * NOT throw an exception. - * + * * @exception JMSException if the JMS provider fails to close the - * connection due to some internal error. For + * connection due to some internal error. For * example, a failure to release resources * or to close a socket connection can cause * this exception to be thrown. @@ -327,13 +327,13 @@ public interface Connection /** Creates a connection consumer for this connection (optional operation). * This is an expert facility not used by regular JMS clients. - * + * * @param destination the destination to access * @param messageSelector only messages with properties matching the * message selector expression are delivered. A value of null or - * an empty string indicates that there is no message selector + * an empty string indicates that there is no message selector * for the message consumer. - * @param sessionPool the server session pool to associate with this + * @param sessionPool the server session pool to associate with this * connection consumer * @param maxMessages the maximum number of messages that can be * assigned to a server session at one time @@ -342,8 +342,8 @@ public interface Connection * * @exception JMSException if the <CODE>Connection</CODE> object fails * to create a connection consumer due to some - * internal error or invalid arguments for - * <CODE>sessionPool</CODE> and + * internal error or invalid arguments for + * <CODE>sessionPool</CODE> and * <CODE>messageSelector</CODE>. * @exception InvalidDestinationException if an invalid destination is specified. * @exception InvalidSelectorException if the message selector is invalid. @@ -355,26 +355,26 @@ public interface Connection ConnectionConsumer createConnectionConsumer(Destination destination, String messageSelector, ServerSessionPool sessionPool, int maxMessages) throws JMSException; - /** Create a durable connection consumer for this connection (optional operation). + /** Create a durable connection consumer for this connection (optional operation). * This is an expert facility not used by regular JMS clients. - * + * * @param topic topic to access * @param subscriptionName durable subscription name * @param messageSelector only messages with properties matching the * message selector expression are delivered. A value of null or - * an empty string indicates that there is no message selector + * an empty string indicates that there is no message selector * for the message consumer. - * @param sessionPool the server session pool to associate with this + * @param sessionPool the server session pool to associate with this * durable connection consumer * @param maxMessages the maximum number of messages that can be * assigned to a server session at one time * * @return the durable connection consumer - * + * * @exception JMSException if the <CODE>Connection</CODE> object fails * to create a connection consumer due to some - * internal error or invalid arguments for - * <CODE>sessionPool</CODE> and + * internal error or invalid arguments for + * <CODE>sessionPool</CODE> and * <CODE>messageSelector</CODE>. * @exception InvalidDestinationException if an invalid destination * is specified. diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ConnectionConsumer.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ConnectionConsumer.java index 1c09a0f4f8..b60cf5d69f 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ConnectionConsumer.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ConnectionConsumer.java @@ -55,10 +55,10 @@ public interface ConnectionConsumer { /** Gets the server session pool associated with this connection consumer. - * + * * @return the server session pool used by this connection consumer - * - * @exception JMSException if the JMS provider fails to get the server + * + * @exception JMSException if the JMS provider fails to get the server * session pool associated with this consumer due * to some internal error. */ @@ -67,13 +67,13 @@ public interface ConnectionConsumer /** Closes the connection consumer. * - * <P>Since a provider may allocate some resources on behalf of a - * connection consumer outside the Java virtual machine, clients should + * <P>Since a provider may allocate some resources on behalf of a + * connection consumer outside the Java virtual machine, clients should * close these resources when - * they are not needed. Relying on garbage collection to eventually + * they are not needed. Relying on garbage collection to eventually * reclaim these resources may not be timely enough. - * - * @exception JMSException if the JMS provider fails to release resources + * + * @exception JMSException if the JMS provider fails to release resources * on behalf of the connection consumer or fails * to close the connection consumer. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ConnectionFactory.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ConnectionFactory.java index 8936d5e705..b0fabc1310 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ConnectionFactory.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ConnectionFactory.java @@ -87,7 +87,7 @@ package javax.jms; public interface ConnectionFactory { /** Creates a connection with the default user identity. - * The connection is created in stopped mode. No messages + * The connection is created in stopped mode. No messages * will be delivered until the <code>Connection.start</code> method * is explicitly called. * @@ -95,28 +95,28 @@ public interface ConnectionFactory * * @exception JMSException if the JMS provider fails to create the * connection due to some internal error. - * @exception JMSSecurityException if client authentication fails due to + * @exception JMSSecurityException if client authentication fails due to * an invalid user name or password. - * @since 1.1 + * @since 1.1 */ Connection createConnection() throws JMSException; /** Creates a connection with the specified user identity. - * The connection is created in stopped mode. No messages + * The connection is created in stopped mode. No messages * will be delivered until the <code>Connection.start</code> method * is explicitly called. - * + * * @param userName the caller's user name * @param password the caller's password - * + * * @return a newly created connection * - * @exception JMSException if the JMS provider fails to create the + * @exception JMSException if the JMS provider fails to create the * connection due to some internal error. - * @exception JMSSecurityException if client authentication fails due to + * @exception JMSSecurityException if client authentication fails due to * an invalid user name or password. - * @since 1.1 + * @since 1.1 */ Connection createConnection(String userName, String password) throws JMSException; diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ConnectionMetaData.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ConnectionMetaData.java index 183c2e0801..06cf850121 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ConnectionMetaData.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ConnectionMetaData.java @@ -39,7 +39,7 @@ public interface ConnectionMetaData /** Gets the JMS API version. * * @return the JMS API version - * + * * @exception JMSException if the JMS provider fails to retrieve the * metadata due to some internal error. */ @@ -47,9 +47,9 @@ public interface ConnectionMetaData String getJMSVersion() throws JMSException; /** Gets the JMS major version number. - * + * * @return the JMS API major version number - * + * * @exception JMSException if the JMS provider fails to retrieve the * metadata due to some internal error. */ @@ -57,9 +57,9 @@ public interface ConnectionMetaData int getJMSMajorVersion() throws JMSException; /** Gets the JMS minor version number. - * + * * @return the JMS API minor version number - * + * * @exception JMSException if the JMS provider fails to retrieve the * metadata due to some internal error. */ @@ -69,7 +69,7 @@ public interface ConnectionMetaData /** Gets the JMS provider name. * * @return the JMS provider name - * + * * @exception JMSException if the JMS provider fails to retrieve the * metadata due to some internal error. */ @@ -79,7 +79,7 @@ public interface ConnectionMetaData /** Gets the JMS provider version. * * @return the JMS provider version - * + * * @exception JMSException if the JMS provider fails to retrieve the * metadata due to some internal error. */ @@ -87,9 +87,9 @@ public interface ConnectionMetaData String getProviderVersion() throws JMSException; /** Gets the JMS provider major version number. - * + * * @return the JMS provider major version number - * + * * @exception JMSException if the JMS provider fails to retrieve the * metadata due to some internal error. */ @@ -97,9 +97,9 @@ public interface ConnectionMetaData int getProviderMajorVersion() throws JMSException; /** Gets the JMS provider minor version number. - * + * * @return the JMS provider minor version number - * + * * @exception JMSException if the JMS provider fails to retrieve the * metadata due to some internal error. */ @@ -107,9 +107,9 @@ public interface ConnectionMetaData int getProviderMinorVersion() throws JMSException; /** Gets an enumeration of the JMSX property names. - * + * * @return an Enumeration of JMSX property names - * + * * @exception JMSException if the JMS provider fails to retrieve the * metadata due to some internal error. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/DeliveryMode.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/DeliveryMode.java index a110311baa..35b1c49ef7 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/DeliveryMode.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/DeliveryMode.java @@ -57,21 +57,21 @@ package javax.jms; public interface DeliveryMode { - /** This is the lowest-overhead delivery mode because it does not require + /** This is the lowest-overhead delivery mode because it does not require * that the message be logged to stable storage. The level of JMS provider - * failure that causes a <CODE>NON_PERSISTENT</CODE> message to be lost is + * failure that causes a <CODE>NON_PERSISTENT</CODE> message to be lost is * not defined. * - * <P>A JMS provider must deliver a <CODE>NON_PERSISTENT</CODE> message - * with an - * at-most-once guarantee. This means that it may lose the message, but it + * <P>A JMS provider must deliver a <CODE>NON_PERSISTENT</CODE> message + * with an + * at-most-once guarantee. This means that it may lose the message, but it * must not deliver it twice. */ static final int NON_PERSISTENT = 1; - /** This delivery mode instructs the JMS provider to log the message to stable - * storage as part of the client's send operation. Only a hard media + /** This delivery mode instructs the JMS provider to log the message to stable + * storage as part of the client's send operation. Only a hard media * failure should cause a <CODE>PERSISTENT</CODE> message to be lost. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/MapMessage.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/MapMessage.java index defd0a5bce..15c78ca400 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/MapMessage.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/MapMessage.java @@ -101,7 +101,7 @@ public interface MapMessage extends Message * * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageFormatException if this type conversion is invalid. + * @exception MessageFormatException if this type conversion is invalid. */ boolean getBoolean(String name) throws JMSException; @@ -127,7 +127,7 @@ public interface MapMessage extends Message * * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageFormatException if this type conversion is invalid. + * @exception MessageFormatException if this type conversion is invalid. */ short getShort(String name) throws JMSException; @@ -140,7 +140,7 @@ public interface MapMessage extends Message * * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageFormatException if this type conversion is invalid. + * @exception MessageFormatException if this type conversion is invalid. */ char getChar(String name) throws JMSException; @@ -153,7 +153,7 @@ public interface MapMessage extends Message * * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageFormatException if this type conversion is invalid. + * @exception MessageFormatException if this type conversion is invalid. */ int getInt(String name) throws JMSException; @@ -166,7 +166,7 @@ public interface MapMessage extends Message * * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageFormatException if this type conversion is invalid. + * @exception MessageFormatException if this type conversion is invalid. */ long getLong(String name) throws JMSException; @@ -179,7 +179,7 @@ public interface MapMessage extends Message * * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageFormatException if this type conversion is invalid. + * @exception MessageFormatException if this type conversion is invalid. */ float getFloat(String name) throws JMSException; @@ -192,7 +192,7 @@ public interface MapMessage extends Message * * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageFormatException if this type conversion is invalid. + * @exception MessageFormatException if this type conversion is invalid. */ double getDouble(String name) throws JMSException; @@ -201,12 +201,12 @@ public interface MapMessage extends Message * * @param name the name of the <CODE>String</CODE> * - * @return the <CODE>String</CODE> value with the specified name; if there + * @return the <CODE>String</CODE> value with the specified name; if there * is no item by this name, a null value is returned * * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageFormatException if this type conversion is invalid. + * @exception MessageFormatException if this type conversion is invalid. */ String getString(String name) throws JMSException; @@ -221,7 +221,7 @@ public interface MapMessage extends Message * * @exception JMSException if the JMS provider fails to read the message * due to some internal error. - * @exception MessageFormatException if this type conversion is invalid. + * @exception MessageFormatException if this type conversion is invalid. */ byte[] getBytes(String name) throws JMSException; @@ -229,19 +229,19 @@ public interface MapMessage extends Message /** Returns the value of the object with the specified name. * * <P>This method can be used to return, in objectified format, - * an object in the Java programming language ("Java object") that had + * an object in the Java programming language ("Java object") that had * been stored in the Map with the equivalent * <CODE>setObject</CODE> method call, or its equivalent primitive * <CODE>set<I>type</I></CODE> method. * - * <P>Note that byte values are returned as <CODE>byte[]</CODE>, not + * <P>Note that byte values are returned as <CODE>byte[]</CODE>, not * <CODE>Byte[]</CODE>. * * @param name the name of the Java object * - * @return a copy of the Java object value with the specified name, in - * objectified format (for example, if the object was set as an - * <CODE>int</CODE>, an <CODE>Integer</CODE> is returned); if there is no + * @return a copy of the Java object value with the specified name, in + * objectified format (for example, if the object was set as an + * <CODE>int</CODE>, an <CODE>Integer</CODE> is returned); if there is no * item by this name, a null value is returned * * @exception JMSException if the JMS provider fails to read the message @@ -250,7 +250,7 @@ public interface MapMessage extends Message Object getObject(String name) throws JMSException; - /** Returns an <CODE>Enumeration</CODE> of all the names in the + /** Returns an <CODE>Enumeration</CODE> of all the names in the * <CODE>MapMessage</CODE> object. * * @return an enumeration of all the names in this <CODE>MapMessage</CODE> @@ -270,7 +270,7 @@ public interface MapMessage extends Message * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is * an empty string. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -285,7 +285,7 @@ public interface MapMessage extends Message * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is * an empty string. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -300,7 +300,7 @@ public interface MapMessage extends Message * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is * an empty string. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -315,7 +315,7 @@ public interface MapMessage extends Message * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is * an empty string. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -330,7 +330,7 @@ public interface MapMessage extends Message * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is * an empty string. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -345,7 +345,7 @@ public interface MapMessage extends Message * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is * an empty string. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -360,7 +360,7 @@ public interface MapMessage extends Message * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is * an empty string. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -375,7 +375,7 @@ public interface MapMessage extends Message * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is * an empty string. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -390,7 +390,7 @@ public interface MapMessage extends Message * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is * an empty string. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -407,15 +407,15 @@ public interface MapMessage extends Message * due to some internal error. * @exception NullPointerException if the name is null, or if the name is * an empty string. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ void setBytes(String name, byte[] value) throws JMSException; - /** Sets a portion of the byte array value with the specified name into the + /** Sets a portion of the byte array value with the specified name into the * Map. - * + * * @param name the name of the byte array * @param value the byte array value to set in the Map * @param offset the initial offset within the byte array @@ -425,7 +425,7 @@ public interface MapMessage extends Message * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is * an empty string. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -434,8 +434,8 @@ public interface MapMessage extends Message /** Sets an object value with the specified name into the Map. * * <P>This method works only for the objectified primitive - * object types (<code>Integer</code>, <code>Double</code>, - * <code>Long</code> ...), <code>String</code> objects, and byte + * object types (<code>Integer</code>, <code>Double</code>, + * <code>Long</code> ...), <code>String</code> objects, and byte * arrays. * * @param name the name of the Java object @@ -446,7 +446,7 @@ public interface MapMessage extends Message * @exception IllegalArgumentException if the name is null or if the name is * an empty string. * @exception MessageFormatException if the object is invalid. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -458,7 +458,7 @@ public interface MapMessage extends Message * * @return true if the item exists * - * @exception JMSException if the JMS provider fails to determine if the + * @exception JMSException if the JMS provider fails to determine if the * item exists due to some internal error. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Message.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Message.java index 06f496571d..b9ddbaec89 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Message.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Message.java @@ -551,51 +551,51 @@ public interface Message */ static final int DEFAULT_DELIVERY_MODE = DeliveryMode.PERSISTENT; - /** The message producer's default priority is 4. + /** The message producer's default priority is 4. */ static final int DEFAULT_PRIORITY = 4; - /** The message producer's default time to live is unlimited; the message - * never expires. + /** The message producer's default time to live is unlimited; the message + * never expires. */ static final long DEFAULT_TIME_TO_LIVE = 0; /** Gets the message ID. * - * <P>The <CODE>JMSMessageID</CODE> header field contains a value that + * <P>The <CODE>JMSMessageID</CODE> header field contains a value that * uniquely identifies each message sent by a provider. - * - * <P>When a message is sent, <CODE>JMSMessageID</CODE> can be ignored. - * When the <CODE>send</CODE> or <CODE>publish</CODE> method returns, it + * + * <P>When a message is sent, <CODE>JMSMessageID</CODE> can be ignored. + * When the <CODE>send</CODE> or <CODE>publish</CODE> method returns, it * contains a provider-assigned value. * - * <P>A <CODE>JMSMessageID</CODE> is a <CODE>String</CODE> value that - * should function as a - * unique key for identifying messages in a historical repository. - * The exact scope of uniqueness is provider-defined. It should at - * least cover all messages for a specific installation of a - * provider, where an installation is some connected set of message + * <P>A <CODE>JMSMessageID</CODE> is a <CODE>String</CODE> value that + * should function as a + * unique key for identifying messages in a historical repository. + * The exact scope of uniqueness is provider-defined. It should at + * least cover all messages for a specific installation of a + * provider, where an installation is some connected set of message * routers. * - * <P>All <CODE>JMSMessageID</CODE> values must start with the prefix - * <CODE>'ID:'</CODE>. - * Uniqueness of message ID values across different providers is + * <P>All <CODE>JMSMessageID</CODE> values must start with the prefix + * <CODE>'ID:'</CODE>. + * Uniqueness of message ID values across different providers is * not required. * * <P>Since message IDs take some effort to create and increase a * message's size, some JMS providers may be able to optimize message * overhead if they are given a hint that the message ID is not used by - * an application. By calling the - * <CODE>MessageProducer.setDisableMessageID</CODE> method, a JMS client - * enables this potential optimization for all messages sent by that + * an application. By calling the + * <CODE>MessageProducer.setDisableMessageID</CODE> method, a JMS client + * enables this potential optimization for all messages sent by that * message producer. If the JMS provider accepts this - * hint, these messages must have the message ID set to null; if the - * provider ignores the hint, the message ID must be set to its normal + * hint, these messages must have the message ID set to null; if the + * provider ignores the hint, the message ID must be set to its normal * unique value. * * @return the message ID * - * @exception JMSException if the JMS provider fails to get the message ID + * @exception JMSException if the JMS provider fails to get the message ID * due to some internal error. * @see javax.jms.Message#setJMSMessageID(String) * @see javax.jms.MessageProducer#setDisableMessageID(boolean) @@ -604,13 +604,13 @@ public interface Message String getJMSMessageID() throws JMSException; /** Sets the message ID. - * + * * <P>JMS providers set this field when a message is sent. This method * can be used to change the value for a message that has been received. * * @param id the ID of the message * - * @exception JMSException if the JMS provider fails to set the message ID + * @exception JMSException if the JMS provider fails to set the message ID * due to some internal error. * * @see javax.jms.Message#getJMSMessageID() @@ -619,28 +619,28 @@ public interface Message void setJMSMessageID(String id) throws JMSException; /** Gets the message timestamp. - * - * <P>The <CODE>JMSTimestamp</CODE> header field contains the time a - * message was - * handed off to a provider to be sent. It is not the time the - * message was actually transmitted, because the actual send may occur + * + * <P>The <CODE>JMSTimestamp</CODE> header field contains the time a + * message was + * handed off to a provider to be sent. It is not the time the + * message was actually transmitted, because the actual send may occur * later due to transactions or other client-side queueing of messages. * - * <P>When a message is sent, <CODE>JMSTimestamp</CODE> is ignored. When + * <P>When a message is sent, <CODE>JMSTimestamp</CODE> is ignored. When * the <CODE>send</CODE> or <CODE>publish</CODE> - * method returns, it contains a time value somewhere in the interval - * between the call and the return. The value is in the format of a normal + * method returns, it contains a time value somewhere in the interval + * between the call and the return. The value is in the format of a normal * millis time value in the Java programming language. * - * <P>Since timestamps take some effort to create and increase a - * message's size, some JMS providers may be able to optimize message - * overhead if they are given a hint that the timestamp is not used by an + * <P>Since timestamps take some effort to create and increase a + * message's size, some JMS providers may be able to optimize message + * overhead if they are given a hint that the timestamp is not used by an * application. By calling the - * <CODE>MessageProducer.setDisableMessageTimestamp</CODE> method, a JMS - * client enables this potential optimization for all messages sent by + * <CODE>MessageProducer.setDisableMessageTimestamp</CODE> method, a JMS + * client enables this potential optimization for all messages sent by * that message producer. If the JMS provider accepts this - * hint, these messages must have the timestamp set to zero; if the - * provider ignores the hint, the timestamp must be set to its normal + * hint, these messages must have the timestamp set to zero; if the + * provider ignores the hint, the timestamp must be set to its normal * value. * * @return the message timestamp @@ -655,12 +655,12 @@ public interface Message long getJMSTimestamp() throws JMSException; /** Sets the message timestamp. - * + * * <P>JMS providers set this field when a message is sent. This method * can be used to change the value for a message that has been received. * * @param timestamp the timestamp for this message - * + * * @exception JMSException if the JMS provider fails to set the timestamp * due to some internal error. * @@ -670,15 +670,15 @@ public interface Message void setJMSTimestamp(long timestamp) throws JMSException; /** Gets the correlation ID as an array of bytes for the message. - * - * <P>The use of a <CODE>byte[]</CODE> value for + * + * <P>The use of a <CODE>byte[]</CODE> value for * <CODE>JMSCorrelationID</CODE> is non-portable. * * @return the correlation ID of a message as an array of bytes * * @exception JMSException if the JMS provider fails to get the correlation * ID due to some internal error. - * + * * @see javax.jms.Message#setJMSCorrelationID(String) * @see javax.jms.Message#getJMSCorrelationID() * @see javax.jms.Message#setJMSCorrelationIDAsBytes(byte[]) @@ -687,26 +687,26 @@ public interface Message byte[] getJMSCorrelationIDAsBytes() throws JMSException; /** Sets the correlation ID as an array of bytes for the message. - * + * * <P>The array is copied before the method returns, so * future modifications to the array will not alter this message header. - * - * <P>If a provider supports the native concept of correlation ID, a - * JMS client may need to assign specific <CODE>JMSCorrelationID</CODE> - * values to match those expected by native messaging clients. - * JMS providers without native correlation ID values are not required to - * support this method and its corresponding get method; their + * + * <P>If a provider supports the native concept of correlation ID, a + * JMS client may need to assign specific <CODE>JMSCorrelationID</CODE> + * values to match those expected by native messaging clients. + * JMS providers without native correlation ID values are not required to + * support this method and its corresponding get method; their * implementation may throw a - * <CODE>java.lang.UnsupportedOperationException</CODE>. + * <CODE>java.lang.UnsupportedOperationException</CODE>. * - * <P>The use of a <CODE>byte[]</CODE> value for + * <P>The use of a <CODE>byte[]</CODE> value for * <CODE>JMSCorrelationID</CODE> is non-portable. * * @param correlationID the correlation ID value as an array of bytes - * + * * @exception JMSException if the JMS provider fails to set the correlation * ID due to some internal error. - * + * * @see javax.jms.Message#setJMSCorrelationID(String) * @see javax.jms.Message#getJMSCorrelationID() * @see javax.jms.Message#getJMSCorrelationIDAsBytes() @@ -715,43 +715,43 @@ public interface Message void setJMSCorrelationIDAsBytes(byte[] correlationID) throws JMSException; /** Sets the correlation ID for the message. - * - * <P>A client can use the <CODE>JMSCorrelationID</CODE> header field to - * link one message with another. A typical use is to link a response + * + * <P>A client can use the <CODE>JMSCorrelationID</CODE> header field to + * link one message with another. A typical use is to link a response * message with its request message. - * + * * <P><CODE>JMSCorrelationID</CODE> can hold one of the following: * <UL> * <LI>A provider-specific message ID * <LI>An application-specific <CODE>String</CODE> * <LI>A provider-native <CODE>byte[]</CODE> value * </UL> - * + * * <P>Since each message sent by a JMS provider is assigned a message ID * value, it is convenient to link messages via message ID. All message ID * values must start with the <CODE>'ID:'</CODE> prefix. - * + * * <P>In some cases, an application (made up of several clients) needs to * use an application-specific value for linking messages. For instance, - * an application may use <CODE>JMSCorrelationID</CODE> to hold a value - * referencing some external information. Application-specified values - * must not start with the <CODE>'ID:'</CODE> prefix; this is reserved for + * an application may use <CODE>JMSCorrelationID</CODE> to hold a value + * referencing some external information. Application-specified values + * must not start with the <CODE>'ID:'</CODE> prefix; this is reserved for * provider-generated message ID values. - * + * * <P>If a provider supports the native concept of correlation ID, a JMS - * client may need to assign specific <CODE>JMSCorrelationID</CODE> values - * to match those expected by clients that do not use the JMS API. A + * client may need to assign specific <CODE>JMSCorrelationID</CODE> values + * to match those expected by clients that do not use the JMS API. A * <CODE>byte[]</CODE> value is used for this * purpose. JMS providers without native correlation ID values are not - * required to support <CODE>byte[]</CODE> values. The use of a - * <CODE>byte[]</CODE> value for <CODE>JMSCorrelationID</CODE> is + * required to support <CODE>byte[]</CODE> values. The use of a + * <CODE>byte[]</CODE> value for <CODE>JMSCorrelationID</CODE> is * non-portable. - * + * * @param correlationID the message ID of a message being referred to - * + * * @exception JMSException if the JMS provider fails to set the correlation * ID due to some internal error. - * + * * @see javax.jms.Message#getJMSCorrelationID() * @see javax.jms.Message#getJMSCorrelationIDAsBytes() * @see javax.jms.Message#setJMSCorrelationIDAsBytes(byte[]) @@ -760,9 +760,9 @@ public interface Message void setJMSCorrelationID(String correlationID) throws JMSException; /** Gets the correlation ID for the message. - * - * <P>This method is used to return correlation ID values that are - * either provider-specific message IDs or application-specific + * + * <P>This method is used to return correlation ID values that are + * either provider-specific message IDs or application-specific * <CODE>String</CODE> values. * * @return the correlation ID of a message as a <CODE>String</CODE> @@ -777,14 +777,14 @@ public interface Message String getJMSCorrelationID() throws JMSException; - /** Gets the <CODE>Destination</CODE> object to which a reply to this + /** Gets the <CODE>Destination</CODE> object to which a reply to this * message should be sent. - * - * @return <CODE>Destination</CODE> to which to send a response to this + * + * @return <CODE>Destination</CODE> to which to send a response to this * message * - * @exception JMSException if the JMS provider fails to get the - * <CODE>JMSReplyTo</CODE> destination due to some + * @exception JMSException if the JMS provider fails to get the + * <CODE>JMSReplyTo</CODE> destination due to some * internal error. * * @see javax.jms.Message#setJMSReplyTo(Destination) @@ -792,33 +792,33 @@ public interface Message Destination getJMSReplyTo() throws JMSException; - /** Sets the <CODE>Destination</CODE> object to which a reply to this + /** Sets the <CODE>Destination</CODE> object to which a reply to this * message should be sent. - * - * <P>The <CODE>JMSReplyTo</CODE> header field contains the destination - * where a reply - * to the current message should be sent. If it is null, no reply is + * + * <P>The <CODE>JMSReplyTo</CODE> header field contains the destination + * where a reply + * to the current message should be sent. If it is null, no reply is * expected. The destination may be either a <CODE>Queue</CODE> object or * a <CODE>Topic</CODE> object. * - * <P>Messages sent with a null <CODE>JMSReplyTo</CODE> value may be a - * notification of some event, or they may just be some data the sender + * <P>Messages sent with a null <CODE>JMSReplyTo</CODE> value may be a + * notification of some event, or they may just be some data the sender * thinks is of interest. * - * <P>Messages with a <CODE>JMSReplyTo</CODE> value typically expect a - * response. A response is optional; it is up to the client to decide. - * These messages are called requests. A message sent in response to a + * <P>Messages with a <CODE>JMSReplyTo</CODE> value typically expect a + * response. A response is optional; it is up to the client to decide. + * These messages are called requests. A message sent in response to a * request is called a reply. * - * <P>In some cases a client may wish to match a request it sent earlier - * with a reply it has just received. The client can use the + * <P>In some cases a client may wish to match a request it sent earlier + * with a reply it has just received. The client can use the * <CODE>JMSCorrelationID</CODE> header field for this purpose. * - * @param replyTo <CODE>Destination</CODE> to which to send a response to + * @param replyTo <CODE>Destination</CODE> to which to send a response to * this message * - * @exception JMSException if the JMS provider fails to set the - * <CODE>JMSReplyTo</CODE> destination due to some + * @exception JMSException if the JMS provider fails to set the + * <CODE>JMSReplyTo</CODE> destination due to some * internal error. * * @see javax.jms.Message#getJMSReplyTo() @@ -827,49 +827,49 @@ public interface Message void setJMSReplyTo(Destination replyTo) throws JMSException; /** Gets the <CODE>Destination</CODE> object for this message. - * - * <P>The <CODE>JMSDestination</CODE> header field contains the + * + * <P>The <CODE>JMSDestination</CODE> header field contains the * destination to which the message is being sent. - * + * * <P>When a message is sent, this field is ignored. After completion - * of the <CODE>send</CODE> or <CODE>publish</CODE> method, the field + * of the <CODE>send</CODE> or <CODE>publish</CODE> method, the field * holds the destination specified by the method. - * - * <P>When a message is received, its <CODE>JMSDestination</CODE> value + * + * <P>When a message is received, its <CODE>JMSDestination</CODE> value * must be equivalent to the value assigned when it was sent. * * @return the destination of this message - * + * * @exception JMSException if the JMS provider fails to get the destination * due to some internal error. - * + * * @see javax.jms.Message#setJMSDestination(Destination) */ Destination getJMSDestination() throws JMSException; /** Sets the <CODE>Destination</CODE> object for this message. - * - * <P>JMS providers set this field when a message is sent. This method + * + * <P>JMS providers set this field when a message is sent. This method * can be used to change the value for a message that has been received. * * @param destination the destination for this message - * + * * @exception JMSException if the JMS provider fails to set the destination * due to some internal error. - * + * * @see javax.jms.Message#getJMSDestination() */ void setJMSDestination(Destination destination) throws JMSException; /** Gets the <CODE>DeliveryMode</CODE> value specified for this message. - * + * * @return the delivery mode for this message - * - * @exception JMSException if the JMS provider fails to get the + * + * @exception JMSException if the JMS provider fails to get the * delivery mode due to some internal error. - * + * * @see javax.jms.Message#setJMSDeliveryMode(int) * @see javax.jms.DeliveryMode */ @@ -877,15 +877,15 @@ public interface Message int getJMSDeliveryMode() throws JMSException; /** Sets the <CODE>DeliveryMode</CODE> value for this message. - * - * <P>JMS providers set this field when a message is sent. This method + * + * <P>JMS providers set this field when a message is sent. This method * can be used to change the value for a message that has been received. * * @param deliveryMode the delivery mode for this message - * - * @exception JMSException if the JMS provider fails to set the + * + * @exception JMSException if the JMS provider fails to set the * delivery mode due to some internal error. - * + * * @see javax.jms.Message#getJMSDeliveryMode() * @see javax.jms.DeliveryMode */ @@ -894,14 +894,14 @@ public interface Message /** Gets an indication of whether this message is being redelivered. * - * <P>If a client receives a message with the <CODE>JMSRedelivered</CODE> + * <P>If a client receives a message with the <CODE>JMSRedelivered</CODE> * field set, * it is likely, but not guaranteed, that this message was delivered * earlier but that its receipt was not acknowledged * at that time. * * @return true if this message is being redelivered - * + * * @exception JMSException if the JMS provider fails to get the redelivered * state due to some internal error. * @@ -911,14 +911,14 @@ public interface Message boolean getJMSRedelivered() throws JMSException; /** Specifies whether this message is being redelivered. - * + * * <P>This field is set at the time the message is delivered. This * method can be used to change the value for a message that has * been received. * * @param redelivered an indication of whether this message is being * redelivered - * + * * @exception JMSException if the JMS provider fails to set the redelivered * state due to some internal error. * @@ -931,8 +931,8 @@ public interface Message * message was sent. * * @return the message type - * - * @exception JMSException if the JMS provider fails to get the message + * + * @exception JMSException if the JMS provider fails to get the message * type due to some internal error. * * @see javax.jms.Message#setJMSType(String) @@ -942,30 +942,30 @@ public interface Message /** Sets the message type. * - * <P>Some JMS providers use a message repository that contains the - * definitions of messages sent by applications. The <CODE>JMSType</CODE> + * <P>Some JMS providers use a message repository that contains the + * definitions of messages sent by applications. The <CODE>JMSType</CODE> * header field may reference a message's definition in the provider's * repository. * * <P>The JMS API does not define a standard message definition repository, - * nor does it define a naming policy for the definitions it contains. + * nor does it define a naming policy for the definitions it contains. * - * <P>Some messaging systems require that a message type definition for - * each application message be created and that each message specify its - * type. In order to work with such JMS providers, JMS clients should - * assign a value to <CODE>JMSType</CODE>, whether the application makes - * use of it or not. This ensures that the field is properly set for those + * <P>Some messaging systems require that a message type definition for + * each application message be created and that each message specify its + * type. In order to work with such JMS providers, JMS clients should + * assign a value to <CODE>JMSType</CODE>, whether the application makes + * use of it or not. This ensures that the field is properly set for those * providers that require it. * - * <P>To ensure portability, JMS clients should use symbolic values for - * <CODE>JMSType</CODE> that can be configured at installation time to the - * values defined in the current provider's message repository. If string - * literals are used, they may not be valid type names for some JMS + * <P>To ensure portability, JMS clients should use symbolic values for + * <CODE>JMSType</CODE> that can be configured at installation time to the + * values defined in the current provider's message repository. If string + * literals are used, they may not be valid type names for some JMS * providers. * * @param type the message type - * - * @exception JMSException if the JMS provider fails to set the message + * + * @exception JMSException if the JMS provider fails to set the message * type due to some internal error. * * @see javax.jms.Message#getJMSType() @@ -974,19 +974,19 @@ public interface Message void setJMSType(String type) throws JMSException; /** Gets the message's expiration value. - * - * <P>When a message is sent, the <CODE>JMSExpiration</CODE> header field - * is left unassigned. After completion of the <CODE>send</CODE> or + * + * <P>When a message is sent, the <CODE>JMSExpiration</CODE> header field + * is left unassigned. After completion of the <CODE>send</CODE> or * <CODE>publish</CODE> method, it holds the expiration time of the * message. This is the sum of the time-to-live value specified by the - * client and the GMT at the time of the <CODE>send</CODE> or + * client and the GMT at the time of the <CODE>send</CODE> or * <CODE>publish</CODE>. * - * <P>If the time-to-live is specified as zero, <CODE>JMSExpiration</CODE> + * <P>If the time-to-live is specified as zero, <CODE>JMSExpiration</CODE> * is set to zero to indicate that the message does not expire. * * <P>When a message's expiration time is reached, a provider should - * discard it. The JMS API does not define any form of notification of + * discard it. The JMS API does not define any form of notification of * message expiration. * * <P>Clients should not receive messages that have expired; however, @@ -995,8 +995,8 @@ public interface Message * @return the time the message expires, which is the sum of the * time-to-live value specified by the client and the GMT at the * time of the send - * - * @exception JMSException if the JMS provider fails to get the message + * + * @exception JMSException if the JMS provider fails to get the message * expiration due to some internal error. * * @see javax.jms.Message#setJMSExpiration(long) @@ -1006,53 +1006,53 @@ public interface Message /** Sets the message's expiration value. * - * <P>JMS providers set this field when a message is sent. This method + * <P>JMS providers set this field when a message is sent. This method * can be used to change the value for a message that has been received. - * + * * @param expiration the message's expiration time - * - * @exception JMSException if the JMS provider fails to set the message + * + * @exception JMSException if the JMS provider fails to set the message * expiration due to some internal error. * - * @see javax.jms.Message#getJMSExpiration() + * @see javax.jms.Message#getJMSExpiration() */ void setJMSExpiration(long expiration) throws JMSException; /** Gets the message priority level. - * - * <P>The JMS API defines ten levels of priority value, with 0 as the + * + * <P>The JMS API defines ten levels of priority value, with 0 as the * lowest * priority and 9 as the highest. In addition, clients should consider * priorities 0-4 as gradations of normal priority and priorities 5-9 * as gradations of expedited priority. - * - * <P>The JMS API does not require that a provider strictly implement - * priority - * ordering of messages; however, it should do its best to deliver + * + * <P>The JMS API does not require that a provider strictly implement + * priority + * ordering of messages; however, it should do its best to deliver * expedited messages ahead of normal messages. - * + * * @return the default message priority - * - * @exception JMSException if the JMS provider fails to get the message + * + * @exception JMSException if the JMS provider fails to get the message * priority due to some internal error. * - * @see javax.jms.Message#setJMSPriority(int) + * @see javax.jms.Message#setJMSPriority(int) */ int getJMSPriority() throws JMSException; /** Sets the priority level for this message. - * - * <P>JMS providers set this field when a message is sent. This method + * + * <P>JMS providers set this field when a message is sent. This method * can be used to change the value for a message that has been received. * * @param priority the priority of this message - * - * @exception JMSException if the JMS provider fails to set the message + * + * @exception JMSException if the JMS provider fails to set the message * priority due to some internal error. * - * @see javax.jms.Message#getJMSPriority() + * @see javax.jms.Message#getJMSPriority() */ void setJMSPriority(int priority) throws JMSException; @@ -1061,7 +1061,7 @@ public interface Message * * <P>The message's header fields and body are not cleared. * - * @exception JMSException if the JMS provider fails to clear the message + * @exception JMSException if the JMS provider fails to clear the message * properties due to some internal error. */ @@ -1072,42 +1072,42 @@ public interface Message * @param name the name of the property to test * * @return true if the property exists - * - * @exception JMSException if the JMS provider fails to determine if the + * + * @exception JMSException if the JMS provider fails to determine if the * property exists due to some internal error. */ boolean propertyExists(String name) throws JMSException; - /** Returns the value of the <CODE>boolean</CODE> property with the + /** Returns the value of the <CODE>boolean</CODE> property with the * specified name. - * + * * @param name the name of the <CODE>boolean</CODE> property - * + * * @return the <CODE>boolean</CODE> property value for the specified name - * + * * @exception JMSException if the JMS provider fails to get the property * value due to some internal error. - * @exception MessageFormatException if this type conversion is invalid. + * @exception MessageFormatException if this type conversion is invalid. */ boolean getBooleanProperty(String name) throws JMSException; - /** Returns the value of the <CODE>byte</CODE> property with the specified + /** Returns the value of the <CODE>byte</CODE> property with the specified * name. - * + * * @param name the name of the <CODE>byte</CODE> property - * + * * @return the <CODE>byte</CODE> property value for the specified name - * + * * @exception JMSException if the JMS provider fails to get the property * value due to some internal error. - * @exception MessageFormatException if this type conversion is invalid. + * @exception MessageFormatException if this type conversion is invalid. */ byte getByteProperty(String name) throws JMSException; - /** Returns the value of the <CODE>short</CODE> property with the specified + /** Returns the value of the <CODE>short</CODE> property with the specified * name. * * @param name the name of the <CODE>short</CODE> property @@ -1121,13 +1121,13 @@ public interface Message short getShortProperty(String name) throws JMSException; - /** Returns the value of the <CODE>int</CODE> property with the specified + /** Returns the value of the <CODE>int</CODE> property with the specified * name. - * + * * @param name the name of the <CODE>int</CODE> property - * + * * @return the <CODE>int</CODE> property value for the specified name - * + * * @exception JMSException if the JMS provider fails to get the property * value due to some internal error. * @exception MessageFormatException if this type conversion is invalid. @@ -1135,13 +1135,13 @@ public interface Message int getIntProperty(String name) throws JMSException; - /** Returns the value of the <CODE>long</CODE> property with the specified + /** Returns the value of the <CODE>long</CODE> property with the specified * name. - * + * * @param name the name of the <CODE>long</CODE> property - * + * * @return the <CODE>long</CODE> property value for the specified name - * + * * @exception JMSException if the JMS provider fails to get the property * value due to some internal error. * @exception MessageFormatException if this type conversion is invalid. @@ -1149,13 +1149,13 @@ public interface Message long getLongProperty(String name) throws JMSException; - /** Returns the value of the <CODE>float</CODE> property with the specified + /** Returns the value of the <CODE>float</CODE> property with the specified * name. - * + * * @param name the name of the <CODE>float</CODE> property - * + * * @return the <CODE>float</CODE> property value for the specified name - * + * * @exception JMSException if the JMS provider fails to get the property * value due to some internal error. * @exception MessageFormatException if this type conversion is invalid. @@ -1165,11 +1165,11 @@ public interface Message /** Returns the value of the <CODE>double</CODE> property with the specified * name. - * + * * @param name the name of the <CODE>double</CODE> property - * + * * @return the <CODE>double</CODE> property value for the specified name - * + * * @exception JMSException if the JMS provider fails to get the property * value due to some internal error. * @exception MessageFormatException if this type conversion is invalid. @@ -1179,12 +1179,12 @@ public interface Message /** Returns the value of the <CODE>String</CODE> property with the specified * name. - * + * * @param name the name of the <CODE>String</CODE> property - * + * * @return the <CODE>String</CODE> property value for the specified name; * if there is no property by this name, a null value is returned - * + * * @exception JMSException if the JMS provider fails to get the property * value due to some internal error. * @exception MessageFormatException if this type conversion is invalid. @@ -1193,20 +1193,20 @@ public interface Message String getStringProperty(String name) throws JMSException; /** Returns the value of the Java object property with the specified name. - * + * * <P>This method can be used to return, in objectified format, - * an object that has been stored as a property in the message with the + * an object that has been stored as a property in the message with the * equivalent <CODE>setObjectProperty</CODE> method call, or its equivalent * primitive <CODE>set<I>type</I>Property</CODE> method. - * + * * @param name the name of the Java object property - * - * @return the Java object property value with the specified name, in - * objectified format (for example, if the property was set as an - * <CODE>int</CODE>, an <CODE>Integer</CODE> is - * returned); if there is no property by this name, a null value + * + * @return the Java object property value with the specified name, in + * objectified format (for example, if the property was set as an + * <CODE>int</CODE>, an <CODE>Integer</CODE> is + * returned); if there is no property by this name, a null value * is returned - * + * * @exception JMSException if the JMS provider fails to get the property * value due to some internal error. */ @@ -1217,21 +1217,21 @@ public interface Message * * <P>Note that JMS standard header fields are not considered * properties and are not returned in this enumeration. - * + * * @return an enumeration of all the names of property values - * + * * @exception JMSException if the JMS provider fails to get the property * names due to some internal error. */ Enumeration getPropertyNames() throws JMSException; - /** Sets a <CODE>boolean</CODE> property value with the specified name into + /** Sets a <CODE>boolean</CODE> property value with the specified name into * the message. * * @param name the name of the <CODE>boolean</CODE> property * @param value the <CODE>boolean</CODE> property value to set - * + * * @exception JMSException if the JMS provider fails to set the property * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is @@ -1241,12 +1241,12 @@ public interface Message void setBooleanProperty(String name, boolean value) throws JMSException; - /** Sets a <CODE>byte</CODE> property value with the specified name into + /** Sets a <CODE>byte</CODE> property value with the specified name into * the message. - * + * * @param name the name of the <CODE>byte</CODE> property * @param value the <CODE>byte</CODE> property value to set - * + * * @exception JMSException if the JMS provider fails to set the property * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is @@ -1258,10 +1258,10 @@ public interface Message /** Sets a <CODE>short</CODE> property value with the specified name into * the message. - * + * * @param name the name of the <CODE>short</CODE> property * @param value the <CODE>short</CODE> property value to set - * + * * @exception JMSException if the JMS provider fails to set the property * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is @@ -1273,10 +1273,10 @@ public interface Message /** Sets an <CODE>int</CODE> property value with the specified name into * the message. - * + * * @param name the name of the <CODE>int</CODE> property * @param value the <CODE>int</CODE> property value to set - * + * * @exception JMSException if the JMS provider fails to set the property * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is @@ -1286,12 +1286,12 @@ public interface Message void setIntProperty(String name, int value) throws JMSException; - /** Sets a <CODE>long</CODE> property value with the specified name into + /** Sets a <CODE>long</CODE> property value with the specified name into * the message. - * + * * @param name the name of the <CODE>long</CODE> property * @param value the <CODE>long</CODE> property value to set - * + * * @exception JMSException if the JMS provider fails to set the property * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is @@ -1301,12 +1301,12 @@ public interface Message void setLongProperty(String name, long value) throws JMSException; - /** Sets a <CODE>float</CODE> property value with the specified name into + /** Sets a <CODE>float</CODE> property value with the specified name into * the message. - * + * * @param name the name of the <CODE>float</CODE> property * @param value the <CODE>float</CODE> property value to set - * + * * @exception JMSException if the JMS provider fails to set the property * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is @@ -1316,12 +1316,12 @@ public interface Message void setFloatProperty(String name, float value) throws JMSException; - /** Sets a <CODE>double</CODE> property value with the specified name into + /** Sets a <CODE>double</CODE> property value with the specified name into * the message. - * + * * @param name the name of the <CODE>double</CODE> property * @param value the <CODE>double</CODE> property value to set - * + * * @exception JMSException if the JMS provider fails to set the property * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is @@ -1331,12 +1331,12 @@ public interface Message void setDoubleProperty(String name, double value) throws JMSException; - /** Sets a <CODE>String</CODE> property value with the specified name into + /** Sets a <CODE>String</CODE> property value with the specified name into * the message. * * @param name the name of the <CODE>String</CODE> property * @param value the <CODE>String</CODE> property value to set - * + * * @exception JMSException if the JMS provider fails to set the property * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is @@ -1346,16 +1346,16 @@ public interface Message void setStringProperty(String name, String value) throws JMSException; - /** Sets a Java object property value with the specified name into the + /** Sets a Java object property value with the specified name into the * message. - * + * * <P>Note that this method works only for the objectified primitive - * object types (<CODE>Integer</CODE>, <CODE>Double</CODE>, + * object types (<CODE>Integer</CODE>, <CODE>Double</CODE>, * <CODE>Long</CODE> ...) and <CODE>String</CODE> objects. - * + * * @param name the name of the Java object property * @param value the Java object property value to set - * + * * @exception JMSException if the JMS provider fails to set the property * due to some internal error. * @exception IllegalArgumentException if the name is null or if the name is @@ -1366,24 +1366,24 @@ public interface Message void setObjectProperty(String name, Object value) throws JMSException; - /** Acknowledges all consumed messages of the session of this consumed + /** Acknowledges all consumed messages of the session of this consumed * message. - * - * <P>All consumed JMS messages support the <CODE>acknowledge</CODE> - * method for use when a client has specified that its JMS session's - * consumed messages are to be explicitly acknowledged. By invoking - * <CODE>acknowledge</CODE> on a consumed message, a client acknowledges + * + * <P>All consumed JMS messages support the <CODE>acknowledge</CODE> + * method for use when a client has specified that its JMS session's + * consumed messages are to be explicitly acknowledged. By invoking + * <CODE>acknowledge</CODE> on a consumed message, a client acknowledges * all messages consumed by the session that the message was delivered to. - * - * <P>Calls to <CODE>acknowledge</CODE> are ignored for both transacted + * + * <P>Calls to <CODE>acknowledge</CODE> are ignored for both transacted * sessions and sessions specified to use implicit acknowledgement modes. * * <P>A client may individually acknowledge each message as it is consumed, - * or it may choose to acknowledge messages as an application-defined group + * or it may choose to acknowledge messages as an application-defined group * (which is done by calling acknowledge on the last received message of the group, * thereby acknowledging all messages consumed by the session.) * - * <P>Messages that have been received but not acknowledged may be + * <P>Messages that have been received but not acknowledged may be * redelivered. * * @exception JMSException if the JMS provider fails to acknowledge the @@ -1396,7 +1396,7 @@ public interface Message void acknowledge() throws JMSException; - /** Clears out the message body. Clearing a message's body does not clear + /** Clears out the message body. Clearing a message's body does not clear * its header values or property entries. * * <P>If this message body was read-only, calling this method leaves diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/MessageConsumer.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/MessageConsumer.java index 9dec6829b4..932dddc4e2 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/MessageConsumer.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/MessageConsumer.java @@ -65,12 +65,12 @@ public interface MessageConsumer { /** Gets this message consumer's message selector expression. - * + * * @return this message consumer's message selector, or null if no - * message selector exists for the message consumer (that is, if - * the message selector was not set or was set to null or the + * message selector exists for the message consumer (that is, if + * the message selector was not set or was set to null or the * empty string) - * + * * @exception JMSException if the JMS provider fails to get the message * selector due to some internal error. */ @@ -78,10 +78,10 @@ public interface MessageConsumer String getMessageSelector() throws JMSException; /** Gets the message consumer's <CODE>MessageListener</CODE>. - * + * * @return the listener for the message consumer, or null if no listener * is set - * + * * @exception JMSException if the JMS provider fails to get the message * listener due to some internal error. * @see javax.jms.MessageConsumer#setMessageListener @@ -90,18 +90,18 @@ public interface MessageConsumer MessageListener getMessageListener() throws JMSException; /** Sets the message consumer's <CODE>MessageListener</CODE>. - * - * <P>Setting the message listener to null is the equivalent of + * + * <P>Setting the message listener to null is the equivalent of * unsetting the message listener for the message consumer. * * <P>The effect of calling <CODE>MessageConsumer.setMessageListener</CODE> * while messages are being consumed by an existing listener * or the consumer is being used to consume messages synchronously * is undefined. - * - * @param listener the listener to which the messages are to be + * + * @param listener the listener to which the messages are to be * delivered - * + * * @exception JMSException if the JMS provider fails to set the message * listener due to some internal error. * @see javax.jms.MessageConsumer#getMessageListener @@ -110,35 +110,35 @@ public interface MessageConsumer void setMessageListener(MessageListener listener) throws JMSException; /** Receives the next message produced for this message consumer. - * + * * <P>This call blocks indefinitely until a message is produced * or until this message consumer is closed. * - * <P>If this <CODE>receive</CODE> is done within a transaction, the + * <P>If this <CODE>receive</CODE> is done within a transaction, the * consumer retains the message until the transaction commits. - * - * @return the next message produced for this message consumer, or + * + * @return the next message produced for this message consumer, or * null if this message consumer is concurrently closed - * + * * @exception JMSException if the JMS provider fails to receive the next * message due to some internal error. - * + * */ Message receive() throws JMSException; /** Receives the next message that arrives within the specified * timeout interval. - * + * * <P>This call blocks until a message arrives, the * timeout expires, or this message consumer is closed. - * A <CODE>timeout</CODE> of zero never expires, and the call blocks + * A <CODE>timeout</CODE> of zero never expires, and the call blocks * indefinitely. * * @param timeout the timeout value (in milliseconds) * - * @return the next message produced for this message consumer, or - * null if the timeout expires or this message consumer is concurrently + * @return the next message produced for this message consumer, or + * null if the timeout expires or this message consumer is concurrently * closed * * @exception JMSException if the JMS provider fails to receive the next @@ -149,9 +149,9 @@ public interface MessageConsumer /** Receives the next message if one is immediately available. * - * @return the next message produced for this message consumer, or + * @return the next message produced for this message consumer, or * null if one is not available - * + * * @exception JMSException if the JMS provider fails to receive the next * message due to some internal error. */ @@ -161,16 +161,16 @@ public interface MessageConsumer /** Closes the message consumer. * * <P>Since a provider may allocate some resources on behalf of a - * <CODE>MessageConsumer</CODE> outside the Java virtual machine, clients + * <CODE>MessageConsumer</CODE> outside the Java virtual machine, clients * should close them when they * are not needed. Relying on garbage collection to eventually reclaim * these resources may not be timely enough. * - * <P>This call blocks until a <CODE>receive</CODE> or message listener in - * progress has completed. A blocked message consumer <CODE>receive</CODE> - * call + * <P>This call blocks until a <CODE>receive</CODE> or message listener in + * progress has completed. A blocked message consumer <CODE>receive</CODE> + * call * returns null when this message consumer is closed. - * + * * @exception JMSException if the JMS provider fails to close the consumer * due to some internal error. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/MessageProducer.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/MessageProducer.java index 0e1f68dcd8..0ec75ad2e3 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/MessageProducer.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/MessageProducer.java @@ -64,21 +64,21 @@ public interface MessageProducer { /** Sets whether message IDs are disabled. - * + * * <P>Since message IDs take some effort to create and increase a * message's size, some JMS providers may be able to optimize message * overhead if they are given a hint that the message ID is not used by - * an application. By calling the <CODE>setDisableMessageID</CODE> - * method on this message producer, a JMS client enables this potential - * optimization for all messages sent by this message producer. If the JMS - * provider accepts this hint, - * these messages must have the message ID set to null; if the provider + * an application. By calling the <CODE>setDisableMessageID</CODE> + * method on this message producer, a JMS client enables this potential + * optimization for all messages sent by this message producer. If the JMS + * provider accepts this hint, + * these messages must have the message ID set to null; if the provider * ignores the hint, the message ID must be set to its normal unique value. * * <P>Message IDs are enabled by default. * * @param value indicates if message IDs are disabled - * + * * @exception JMSException if the JMS provider fails to set message ID to * disabled due to some internal error. */ @@ -86,32 +86,32 @@ public interface MessageProducer void setDisableMessageID(boolean value) throws JMSException; /** Gets an indication of whether message IDs are disabled. - * + * * @return an indication of whether message IDs are disabled - * - * @exception JMSException if the JMS provider fails to determine if - * message IDs are disabled due to some internal + * + * @exception JMSException if the JMS provider fails to determine if + * message IDs are disabled due to some internal * error. */ boolean getDisableMessageID() throws JMSException; /** Sets whether message timestamps are disabled. - * - * <P>Since timestamps take some effort to create and increase a - * message's size, some JMS providers may be able to optimize message - * overhead if they are given a hint that the timestamp is not used by an - * application. By calling the <CODE>setDisableMessageTimestamp</CODE> - * method on this message producer, a JMS client enables this potential - * optimization for all messages sent by this message producer. If the - * JMS provider accepts this hint, - * these messages must have the timestamp set to zero; if the provider + * + * <P>Since timestamps take some effort to create and increase a + * message's size, some JMS providers may be able to optimize message + * overhead if they are given a hint that the timestamp is not used by an + * application. By calling the <CODE>setDisableMessageTimestamp</CODE> + * method on this message producer, a JMS client enables this potential + * optimization for all messages sent by this message producer. If the + * JMS provider accepts this hint, + * these messages must have the timestamp set to zero; if the provider * ignores the hint, the timestamp must be set to its normal value. - * + * * <P>Message timestamps are enabled by default. * * @param value indicates if message timestamps are disabled - * + * * @exception JMSException if the JMS provider fails to set timestamps to * disabled due to some internal error. */ @@ -119,26 +119,26 @@ public interface MessageProducer void setDisableMessageTimestamp(boolean value) throws JMSException; /** Gets an indication of whether message timestamps are disabled. - * + * * @return an indication of whether message timestamps are disabled - * - * @exception JMSException if the JMS provider fails to determine if - * timestamps are disabled due to some internal + * + * @exception JMSException if the JMS provider fails to determine if + * timestamps are disabled due to some internal * error. */ boolean getDisableMessageTimestamp() throws JMSException; /** Sets the producer's default delivery mode. - * + * * <P>Delivery mode is set to <CODE>PERSISTENT</CODE> by default. * * @param deliveryMode the message delivery mode for this message * producer; legal values are <code>DeliveryMode.NON_PERSISTENT</code> * and <code>DeliveryMode.PERSISTENT</code> - * - * @exception JMSException if the JMS provider fails to set the delivery - * mode due to some internal error. + * + * @exception JMSException if the JMS provider fails to set the delivery + * mode due to some internal error. * * @see javax.jms.MessageProducer#getDeliveryMode * @see javax.jms.DeliveryMode#NON_PERSISTENT @@ -149,10 +149,10 @@ public interface MessageProducer void setDeliveryMode(int deliveryMode) throws JMSException; /** Gets the producer's default delivery mode. - * + * * @return the message delivery mode for this message producer - * - * @exception JMSException if the JMS provider fails to get the delivery + * + * @exception JMSException if the JMS provider fails to get the delivery * mode due to some internal error. * * @see javax.jms.MessageProducer#setDeliveryMode @@ -161,16 +161,16 @@ public interface MessageProducer int getDeliveryMode() throws JMSException; /** Sets the producer's default priority. - * - * <P>The JMS API defines ten levels of priority value, with 0 as the + * + * <P>The JMS API defines ten levels of priority value, with 0 as the * lowest priority and 9 as the highest. Clients should consider priorities - * 0-4 as gradations of normal priority and priorities 5-9 as gradations + * 0-4 as gradations of normal priority and priorities 5-9 as gradations * of expedited priority. Priority is set to 4 by default. * * @param defaultPriority the message priority for this message producer; * must be a value between 0 and 9 - * - * + * + * * @exception JMSException if the JMS provider fails to set the priority * due to some internal error. * @@ -181,9 +181,9 @@ public interface MessageProducer void setPriority(int defaultPriority) throws JMSException; /** Gets the producer's default priority. - * + * * @return the message priority for this message producer - * + * * @exception JMSException if the JMS provider fails to get the priority * due to some internal error. * @@ -200,7 +200,7 @@ public interface MessageProducer * @param timeToLive the message time to live in milliseconds; zero is * unlimited * - * @exception JMSException if the JMS provider fails to set the time to + * @exception JMSException if the JMS provider fails to set the time to * live due to some internal error. * * @see javax.jms.MessageProducer#getTimeToLive @@ -214,7 +214,7 @@ public interface MessageProducer * * @return the message time to live in milliseconds; zero is unlimited * - * @exception JMSException if the JMS provider fails to get the time to + * @exception JMSException if the JMS provider fails to get the time to * live due to some internal error. * * @see javax.jms.MessageProducer#setTimeToLive @@ -223,13 +223,13 @@ public interface MessageProducer long getTimeToLive() throws JMSException; /** Gets the destination associated with this <CODE>MessageProducer</CODE>. - * + * * @return this producer's <CODE>Destination/<CODE> - * + * * @exception JMSException if the JMS provider fails to get the destination for * this <CODE>MessageProducer</CODE> * due to some internal error. - *@since 1.1 + *@since 1.1 */ Destination getDestination() throws JMSException; @@ -237,23 +237,23 @@ public interface MessageProducer /** Closes the message producer. * * <P>Since a provider may allocate some resources on behalf of a - * <CODE>MessageProducer</CODE> outside the Java virtual machine, clients + * <CODE>MessageProducer</CODE> outside the Java virtual machine, clients * should close them when they * are not needed. Relying on garbage collection to eventually reclaim * these resources may not be timely enough. - * + * * @exception JMSException if the JMS provider fails to close the producer * due to some internal error. */ void close() throws JMSException; - /** Sends a message using the <CODE>MessageProducer</CODE>'s + /** Sends a message using the <CODE>MessageProducer</CODE>'s * default delivery mode, priority, and time to live. * - * @param message the message to send - * - * @exception JMSException if the JMS provider fails to send the message + * @param message the message to send + * + * @exception JMSException if the JMS provider fails to send the message * due to some internal error. * @exception MessageFormatException if an invalid message is specified. * @exception InvalidDestinationException if a client uses @@ -262,24 +262,24 @@ public interface MessageProducer * @exception java.lang.UnsupportedOperationException if a client uses this * method with a <CODE>MessageProducer</CODE> that did * not specify a destination at creation time. - * - * @see javax.jms.Session#createProducer - * @see javax.jms.MessageProducer * - * @since 1.1 + * @see javax.jms.Session#createProducer + * @see javax.jms.MessageProducer + * + * @since 1.1 */ void send(Message message) throws JMSException; - /** Sends a message to the destination, specifying delivery mode, priority, and + /** Sends a message to the destination, specifying delivery mode, priority, and * time to live. * * @param message the message to send * @param deliveryMode the delivery mode to use * @param priority the priority for this message * @param timeToLive the message's lifetime (in milliseconds) - * - * @exception JMSException if the JMS provider fails to send the message + * + * @exception JMSException if the JMS provider fails to send the message * due to some internal error. * @exception MessageFormatException if an invalid message is specified. * @exception InvalidDestinationException if a client uses @@ -290,7 +290,7 @@ public interface MessageProducer * not specify a destination at creation time. * * @see javax.jms.Session#createProducer - * @since 1.1 + * @since 1.1 */ void send(Message message, int deliveryMode, int priority, long timeToLive) throws JMSException; @@ -299,52 +299,52 @@ public interface MessageProducer * Uses the <CODE>MessageProducer</CODE>'s default delivery mode, priority, * and time to live. * - * <P>Typically, a message producer is assigned a destination at creation + * <P>Typically, a message producer is assigned a destination at creation * time; however, the JMS API also supports unidentified message producers, * which require that the destination be supplied every time a message is - * sent. - * + * sent. + * * @param destination the destination to send this message to * @param message the message to send - * - * @exception JMSException if the JMS provider fails to send the message + * + * @exception JMSException if the JMS provider fails to send the message * due to some internal error. * @exception MessageFormatException if an invalid message is specified. * @exception InvalidDestinationException if a client uses * this method with an invalid destination. * @exception java.lang.UnsupportedOperationException if a client uses this - * method with a <CODE>MessageProducer</CODE> that + * method with a <CODE>MessageProducer</CODE> that * specified a destination at creation time. - * + * * @see javax.jms.Session#createProducer * @see javax.jms.MessageProducer - * @since 1.1 + * @since 1.1 */ void send(Destination destination, Message message) throws JMSException; - /** Sends a message to a destination for an unidentified message producer, + /** Sends a message to a destination for an unidentified message producer, * specifying delivery mode, priority and time to live. - * - * <P>Typically, a message producer is assigned a destination at creation + * + * <P>Typically, a message producer is assigned a destination at creation * time; however, the JMS API also supports unidentified message producers, * which require that the destination be supplied every time a message is - * sent. - * + * sent. + * * @param destination the destination to send this message to * @param message the message to send * @param deliveryMode the delivery mode to use * @param priority the priority for this message * @param timeToLive the message's lifetime (in milliseconds) - * - * @exception JMSException if the JMS provider fails to send the message + * + * @exception JMSException if the JMS provider fails to send the message * due to some internal error. * @exception MessageFormatException if an invalid message is specified. * @exception InvalidDestinationException if a client uses * this method with an invalid destination. * * @see javax.jms.Session#createProducer - * @since 1.1 + * @since 1.1 */ void send(Destination destination, Message message, int deliveryMode, int priority, long timeToLive) diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ObjectMessage.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ObjectMessage.java index acc91ca7dc..8598c1e52f 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ObjectMessage.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ObjectMessage.java @@ -59,11 +59,11 @@ public interface ObjectMessage extends Message /** Sets the serializable object containing this message's data. * It is important to note that an <CODE>ObjectMessage</CODE> * contains a snapshot of the object at the time <CODE>setObject()</CODE> - * is called; subsequent modifications of the object will have no + * is called; subsequent modifications of the object will have no * effect on the <CODE>ObjectMessage</CODE> body. * * @param object the message's data - * + * * @exception JMSException if the JMS provider fails to set the object * due to some internal error. * @exception MessageFormatException if object serialization fails. @@ -73,11 +73,11 @@ public interface ObjectMessage extends Message void setObject(Serializable object) throws JMSException; - /** Gets the serializable object containing this message's data. The + /** Gets the serializable object containing this message's data. The * default value is null. * * @return the serializable object containing this message's data - * + * * @exception JMSException if the JMS provider fails to get the object * due to some internal error. * @exception MessageFormatException if object deserialization fails. diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Queue.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Queue.java index a2ad1b3c01..954963c307 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Queue.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Queue.java @@ -55,12 +55,12 @@ public interface Queue extends Destination { /** Gets the name of this queue. - * + * * <P>Clients that depend upon the name are not portable. - * + * * @return the queue name - * - * @exception JMSException if the JMS provider implementation of + * + * @exception JMSException if the JMS provider implementation of * <CODE>Queue</CODE> fails to return the queue * name due to some internal * error. diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueBrowser.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueBrowser.java index bc4ae52065..eae85e90e3 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueBrowser.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueBrowser.java @@ -56,9 +56,9 @@ public interface QueueBrowser { /** Gets the queue associated with this queue browser. - * + * * @return the queue - * + * * @exception JMSException if the JMS provider fails to get the * queue associated with this browser * due to some internal error. @@ -67,10 +67,10 @@ public interface QueueBrowser Queue getQueue() throws JMSException; /** Gets this queue browser's message selector expression. - * + * * @return this queue browser's message selector, or null if no - * message selector exists for the message consumer (that is, if - * the message selector was not set or was set to null or the + * message selector exists for the message consumer (that is, if + * the message selector was not set or was set to null or the * empty string) * * @exception JMSException if the JMS provider fails to get the @@ -84,7 +84,7 @@ public interface QueueBrowser * order they would be received. * * @return an enumeration for browsing the messages - * + * * @exception JMSException if the JMS provider fails to get the * enumeration for this browser * due to some internal error. @@ -94,10 +94,10 @@ public interface QueueBrowser /** Closes the <CODE>QueueBrowser</CODE>. * - * <P>Since a provider may allocate some resources on behalf of a + * <P>Since a provider may allocate some resources on behalf of a * QueueBrowser outside the Java virtual machine, clients should close them - * when they - * are not needed. Relying on garbage collection to eventually reclaim + * when they + * are not needed. Relying on garbage collection to eventually reclaim * these resources may not be timely enough. * * @exception JMSException if the JMS provider fails to close this diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueConnection.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueConnection.java index 56cc35040f..a76414254f 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueConnection.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueConnection.java @@ -59,24 +59,24 @@ public interface QueueConnection extends Connection { /** Creates a <CODE>QueueSession</CODE> object. - * + * * @param transacted indicates whether the session is transacted * @param acknowledgeMode indicates whether the consumer or the * client will acknowledge any messages it receives; ignored if the session - * is transacted. Legal values are <code>Session.AUTO_ACKNOWLEDGE</code>, - * <code>Session.CLIENT_ACKNOWLEDGE</code>, and + * is transacted. Legal values are <code>Session.AUTO_ACKNOWLEDGE</code>, + * <code>Session.CLIENT_ACKNOWLEDGE</code>, and * <code>Session.DUPS_OK_ACKNOWLEDGE</code>. - * + * * @return a newly created queue session - * + * * @exception JMSException if the <CODE>QueueConnection</CODE> object fails * to create a session due to some internal error or * lack of support for the specific transaction * and acknowledgement mode. * - * @see Session#AUTO_ACKNOWLEDGE - * @see Session#CLIENT_ACKNOWLEDGE - * @see Session#DUPS_OK_ACKNOWLEDGE + * @see Session#AUTO_ACKNOWLEDGE + * @see Session#CLIENT_ACKNOWLEDGE + * @see Session#DUPS_OK_ACKNOWLEDGE */ QueueSession createQueueSession(boolean transacted, int acknowledgeMode) throws JMSException; @@ -87,19 +87,19 @@ public interface QueueConnection extends Connection * @param queue the queue to access * @param messageSelector only messages with properties matching the * message selector expression are delivered. A value of null or - * an empty string indicates that there is no message selector + * an empty string indicates that there is no message selector * for the message consumer. - * @param sessionPool the server session pool to associate with this + * @param sessionPool the server session pool to associate with this * connection consumer * @param maxMessages the maximum number of messages that can be * assigned to a server session at one time * * @return the connection consumer - * + * * @exception JMSException if the <CODE>QueueConnection</CODE> object fails * to create a connection consumer due to some - * internal error or invalid arguments for - * <CODE>sessionPool</CODE> and + * internal error or invalid arguments for + * <CODE>sessionPool</CODE> and * <CODE>messageSelector</CODE>. * @exception InvalidDestinationException if an invalid queue is specified. * @exception InvalidSelectorException if the message selector is invalid. diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueConnectionFactory.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueConnectionFactory.java index b2ebdee017..f18a56dec8 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueConnectionFactory.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueConnectionFactory.java @@ -46,7 +46,7 @@ public interface QueueConnectionFactory extends ConnectionFactory { /** Creates a queue connection with the default user identity. - * The connection is created in stopped mode. No messages + * The connection is created in stopped mode. No messages * will be delivered until the <code>Connection.start</code> method * is explicitly called. * @@ -54,27 +54,27 @@ public interface QueueConnectionFactory extends ConnectionFactory * * @return a newly created queue connection * - * @exception JMSException if the JMS provider fails to create the queue + * @exception JMSException if the JMS provider fails to create the queue * connection due to some internal error. - * @exception JMSSecurityException if client authentication fails due to + * @exception JMSSecurityException if client authentication fails due to * an invalid user name or password. */ QueueConnection createQueueConnection() throws JMSException; /** Creates a queue connection with the specified user identity. - * The connection is created in stopped mode. No messages + * The connection is created in stopped mode. No messages * will be delivered until the <code>Connection.start</code> method * is explicitly called. - * + * * @param userName the caller's user name * @param password the caller's password - * + * * @return a newly created queue connection * - * @exception JMSException if the JMS provider fails to create the queue + * @exception JMSException if the JMS provider fails to create the queue * connection due to some internal error. - * @exception JMSSecurityException if client authentication fails due to + * @exception JMSSecurityException if client authentication fails due to * an invalid user name or password. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueReceiver.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueReceiver.java index 2ced18ba87..60caaafcf3 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueReceiver.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueReceiver.java @@ -59,9 +59,9 @@ public interface QueueReceiver extends MessageConsumer { /** Gets the <CODE>Queue</CODE> associated with this queue receiver. - * - * @return this receiver's <CODE>Queue</CODE> - * + * + * @return this receiver's <CODE>Queue</CODE> + * * @exception JMSException if the JMS provider fails to get the queue for * this queue receiver * due to some internal error. diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueRequestor.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueRequestor.java index e0b13ff396..f6bdbf33d0 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueRequestor.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueRequestor.java @@ -57,14 +57,14 @@ public class QueueRequestor QueueReceiver receiver; /** Constructor for the <CODE>QueueRequestor</CODE> class. - * + * * <P>This implementation assumes the session parameter to be non-transacted, - * with a delivery mode of either <CODE>AUTO_ACKNOWLEDGE</CODE> or + * with a delivery mode of either <CODE>AUTO_ACKNOWLEDGE</CODE> or * <CODE>DUPS_OK_ACKNOWLEDGE</CODE>. * * @param session the <CODE>QueueSession</CODE> the queue belongs to * @param queue the queue to perform the request/reply call on - * + * * @exception JMSException if the JMS provider fails to create the * <CODE>QueueRequestor</CODE> due to some internal * error. @@ -81,13 +81,13 @@ public class QueueRequestor } /** Sends a request and waits for a reply. The temporary queue is used for - * the <CODE>JMSReplyTo</CODE> destination, and only one reply per request + * the <CODE>JMSReplyTo</CODE> destination, and only one reply per request * is expected. - * + * * @param message the message to send - * + * * @return the reply message - * + * * @exception JMSException if the JMS provider fails to complete the * request due to some internal error. */ @@ -101,13 +101,13 @@ public class QueueRequestor /** Closes the <CODE>QueueRequestor</CODE> and its session. * - * <P>Since a provider may allocate some resources on behalf of a - * <CODE>QueueRequestor</CODE> outside the Java virtual machine, clients - * should close them when they - * are not needed. Relying on garbage collection to eventually reclaim + * <P>Since a provider may allocate some resources on behalf of a + * <CODE>QueueRequestor</CODE> outside the Java virtual machine, clients + * should close them when they + * are not needed. Relying on garbage collection to eventually reclaim * these resources may not be timely enough. - * - * <P>Note that this method closes the <CODE>QueueSession</CODE> object + * + * <P>Note that this method closes the <CODE>QueueSession</CODE> object * passed to the <CODE>QueueRequestor</CODE> constructor. * * @exception JMSException if the JMS provider fails to close the diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueSender.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueSender.java index 267a4e4e63..49d9ac051c 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueSender.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueSender.java @@ -78,9 +78,9 @@ public interface QueueSender extends MessageProducer { /** Gets the queue associated with this <CODE>QueueSender</CODE>. - * - * @return this sender's queue - * + * + * @return this sender's queue + * * @exception JMSException if the JMS provider fails to get the queue for * this <CODE>QueueSender</CODE> * due to some internal error. @@ -88,12 +88,12 @@ public interface QueueSender extends MessageProducer Queue getQueue() throws JMSException; - /** Sends a message to the queue. Uses the <CODE>QueueSender</CODE>'s + /** Sends a message to the queue. Uses the <CODE>QueueSender</CODE>'s * default delivery mode, priority, and time to live. * - * @param message the message to send - * - * @exception JMSException if the JMS provider fails to send the message + * @param message the message to send + * + * @exception JMSException if the JMS provider fails to send the message * due to some internal error. * @exception MessageFormatException if an invalid message is specified. * @exception InvalidDestinationException if a client uses @@ -102,7 +102,7 @@ public interface QueueSender extends MessageProducer * @exception java.lang.UnsupportedOperationException if a client uses this * method with a <CODE>QueueSender</CODE> that did * not specify a queue at creation time. - * + * * @see javax.jms.MessageProducer#getDeliveryMode() * @see javax.jms.MessageProducer#getTimeToLive() * @see javax.jms.MessageProducer#getPriority() @@ -110,15 +110,15 @@ public interface QueueSender extends MessageProducer void send(Message message) throws JMSException; - /** Sends a message to the queue, specifying delivery mode, priority, and + /** Sends a message to the queue, specifying delivery mode, priority, and * time to live. * * @param message the message to send * @param deliveryMode the delivery mode to use * @param priority the priority for this message * @param timeToLive the message's lifetime (in milliseconds) - * - * @exception JMSException if the JMS provider fails to send the message + * + * @exception JMSException if the JMS provider fails to send the message * due to some internal error. * @exception MessageFormatException if an invalid message is specified. * @exception InvalidDestinationException if a client uses @@ -135,20 +135,20 @@ public interface QueueSender extends MessageProducer * Uses the <CODE>QueueSender</CODE>'s default delivery mode, priority, * and time to live. * - * <P>Typically, a message producer is assigned a queue at creation + * <P>Typically, a message producer is assigned a queue at creation * time; however, the JMS API also supports unidentified message producers, * which require that the queue be supplied every time a message is * sent. - * + * * @param queue the queue to send this message to * @param message the message to send - * - * @exception JMSException if the JMS provider fails to send the message + * + * @exception JMSException if the JMS provider fails to send the message * due to some internal error. * @exception MessageFormatException if an invalid message is specified. * @exception InvalidDestinationException if a client uses * this method with an invalid queue. - * + * * @see javax.jms.MessageProducer#getDeliveryMode() * @see javax.jms.MessageProducer#getTimeToLive() * @see javax.jms.MessageProducer#getPriority() @@ -156,21 +156,21 @@ public interface QueueSender extends MessageProducer void send(Queue queue, Message message) throws JMSException; - /** Sends a message to a queue for an unidentified message producer, + /** Sends a message to a queue for an unidentified message producer, * specifying delivery mode, priority and time to live. - * - * <P>Typically, a message producer is assigned a queue at creation + * + * <P>Typically, a message producer is assigned a queue at creation * time; however, the JMS API also supports unidentified message producers, * which require that the queue be supplied every time a message is * sent. - * + * * @param queue the queue to send this message to * @param message the message to send * @param deliveryMode the delivery mode to use * @param priority the priority for this message * @param timeToLive the message's lifetime (in milliseconds) - * - * @exception JMSException if the JMS provider fails to send the message + * + * @exception JMSException if the JMS provider fails to send the message * due to some internal error. * @exception MessageFormatException if an invalid message is specified. * @exception InvalidDestinationException if a client uses diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueSession.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueSession.java index d722bc3402..8af546f189 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueSession.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/QueueSession.java @@ -67,13 +67,13 @@ public interface QueueSession extends Session * * <P>This facility is provided for the rare cases where clients need to * dynamically manipulate queue identity. It allows the creation of a - * queue identity with a provider-specific name. Clients that depend + * queue identity with a provider-specific name. Clients that depend * on this ability are not portable. * - * <P>Note that this method is not for creating the physical queue. + * <P>Note that this method is not for creating the physical queue. * The physical creation of queues is an administrative task and is not * to be initiated by the JMS API. The one exception is the - * creation of temporary queues, which is accomplished with the + * creation of temporary queues, which is accomplished with the * <CODE>createTemporaryQueue</CODE> method. * * @param queueName the name of this <CODE>Queue</CODE> @@ -98,15 +98,15 @@ public interface QueueSession extends Session QueueReceiver createReceiver(Queue queue) throws JMSException; - /** Creates a <CODE>QueueReceiver</CODE> object to receive messages from the + /** Creates a <CODE>QueueReceiver</CODE> object to receive messages from the * specified queue using a message selector. - * + * * @param queue the <CODE>Queue</CODE> to access * @param messageSelector only messages with properties matching the * message selector expression are delivered. A value of null or - * an empty string indicates that there is no message selector + * an empty string indicates that there is no message selector * for the message consumer. - * + * * @exception JMSException if the session fails to create a receiver * due to some internal error. * @exception InvalidDestinationException if an invalid queue is specified. @@ -116,10 +116,10 @@ public interface QueueSession extends Session QueueReceiver createReceiver(Queue queue, String messageSelector) throws JMSException; - /** Creates a <CODE>QueueSender</CODE> object to send messages to the + /** Creates a <CODE>QueueSender</CODE> object to send messages to the * specified queue. * - * @param queue the <CODE>Queue</CODE> to access, or null if this is an + * @param queue the <CODE>Queue</CODE> to access, or null if this is an * unidentified producer * * @exception JMSException if the session fails to create a sender @@ -129,7 +129,7 @@ public interface QueueSession extends Session QueueSender createSender(Queue queue) throws JMSException; - /** Creates a <CODE>QueueBrowser</CODE> object to peek at the messages on + /** Creates a <CODE>QueueBrowser</CODE> object to peek at the messages on * the specified queue. * * @param queue the <CODE>Queue</CODE> to access @@ -141,15 +141,15 @@ public interface QueueSession extends Session QueueBrowser createBrowser(Queue queue) throws JMSException; - /** Creates a <CODE>QueueBrowser</CODE> object to peek at the messages on + /** Creates a <CODE>QueueBrowser</CODE> object to peek at the messages on * the specified queue using a message selector. - * + * * @param queue the <CODE>Queue</CODE> to access * @param messageSelector only messages with properties matching the * message selector expression are delivered. A value of null or - * an empty string indicates that there is no message selector + * an empty string indicates that there is no message selector * for the message consumer. - * + * * @exception JMSException if the session fails to create a browser * due to some internal error. * @exception InvalidDestinationException if an invalid queue is specified. @@ -158,7 +158,7 @@ public interface QueueSession extends Session QueueBrowser createBrowser(Queue queue, String messageSelector) throws JMSException; - /** Creates a <CODE>TemporaryQueue</CODE> object. Its lifetime will be that + /** Creates a <CODE>TemporaryQueue</CODE> object. Its lifetime will be that * of the <CODE>QueueConnection</CODE> unless it is deleted earlier. * * @return a temporary queue identity diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ServerSession.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ServerSession.java index d666104dc2..c5eb645a95 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ServerSession.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ServerSession.java @@ -72,14 +72,14 @@ package javax.jms; public interface ServerSession { - /** Return the <CODE>ServerSession</CODE>'s <CODE>Session</CODE>. This must - * be a <CODE>Session</CODE> created by the same <CODE>Connection</CODE> + /** Return the <CODE>ServerSession</CODE>'s <CODE>Session</CODE>. This must + * be a <CODE>Session</CODE> created by the same <CODE>Connection</CODE> * that will be dispatching messages to it. The provider will assign one or - * more messages to the <CODE>Session</CODE> + * more messages to the <CODE>Session</CODE> * and then call <CODE>start</CODE> on the <CODE>ServerSession</CODE>. * * @return the server session's session - * + * * @exception JMSException if the JMS provider fails to get the associated * session for this <CODE>ServerSession</CODE> due * to some internal error. @@ -87,9 +87,9 @@ public interface ServerSession Session getSession() throws JMSException; - /** Cause the <CODE>Session</CODE>'s <CODE>run</CODE> method to be called + /** Cause the <CODE>Session</CODE>'s <CODE>run</CODE> method to be called * to process messages that were just assigned to it. - * + * * @exception JMSException if the JMS provider fails to start the server * session to process messages due to some internal * error. diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ServerSessionPool.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ServerSessionPool.java index b0f826dc6c..7d7fb5627a 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ServerSessionPool.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/ServerSessionPool.java @@ -52,7 +52,7 @@ public interface ServerSessionPool /** Return a server session from the pool. * * @return a server session from the pool - * + * * @exception JMSException if an application server fails to * return a <CODE>ServerSession</CODE> out of its * server session pool. diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Session.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Session.java index 443c05dcc9..922011ac7f 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Session.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Session.java @@ -124,24 +124,24 @@ public interface Session extends Runnable { /** 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 + * 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. */ static final int AUTO_ACKNOWLEDGE = 1; - /** 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 + /** 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 + * <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. * * @see javax.jms.Message#acknowledge() @@ -149,70 +149,70 @@ public interface Session extends Runnable static final int CLIENT_ACKNOWLEDGE = 2; - /** 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 + /** 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. */ static final int DUPS_OK_ACKNOWLEDGE = 3; - /** This value is returned from the method + /** 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. */ static final int SESSION_TRANSACTED = 0; - /** Creates a <CODE>BytesMessage</CODE> object. A <CODE>BytesMessage</CODE> - * object is used to send a message containing a stream of uninterpreted + /** Creates a <CODE>BytesMessage</CODE> object. A <CODE>BytesMessage</CODE> + * object is used to send a message containing a stream of uninterpreted * bytes. - * + * * @exception JMSException if the JMS provider fails to create this message * due to some internal error. */ BytesMessage createBytesMessage() throws JMSException; - /** 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 + /** 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. - * + * * @exception JMSException if the JMS provider fails to create this message * due to some internal error. */ MapMessage createMapMessage() throws JMSException; - /** 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 + /** 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. - * + * * @exception JMSException if the JMS provider fails to create this message * due to some internal error. */ Message createMessage() throws JMSException; - /** Creates an <CODE>ObjectMessage</CODE> object. An - * <CODE>ObjectMessage</CODE> object is used to send a message + /** Creates an <CODE>ObjectMessage</CODE> object. An + * <CODE>ObjectMessage</CODE> object is used to send a message * that contains a serializable Java object. - * + * * @exception JMSException if the JMS provider fails to create this message * due to some internal error. */ ObjectMessage createObjectMessage() throws JMSException; - /** Creates an initialized <CODE>ObjectMessage</CODE> object. An - * <CODE>ObjectMessage</CODE> object is used + /** Creates an initialized <CODE>ObjectMessage</CODE> object. An + * <CODE>ObjectMessage</CODE> object is used * to send a message that contains a serializable Java object. - * + * * @param object the object to use to initialize this message * * @exception JMSException if the JMS provider fails to create this message @@ -221,29 +221,29 @@ public interface Session extends Runnable ObjectMessage createObjectMessage(Serializable object) throws JMSException; - /** 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 + /** 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. - * + * * @exception JMSException if the JMS provider fails to create this message * due to some internal error. */ StreamMessage createStreamMessage() throws JMSException; - /** Creates a <CODE>TextMessage</CODE> object. A <CODE>TextMessage</CODE> + /** Creates a <CODE>TextMessage</CODE> object. A <CODE>TextMessage</CODE> * object is used to send a message containing a <CODE>String</CODE> * object. - * + * * @exception JMSException if the JMS provider fails to create this message * due to some internal error. */ TextMessage createTextMessage() throws JMSException; - /** Creates an initialized <CODE>TextMessage</CODE> object. A - * <CODE>TextMessage</CODE> object is used to send + /** Creates an initialized <CODE>TextMessage</CODE> object. A + * <CODE>TextMessage</CODE> object is used to send * a message containing a <CODE>String</CODE>. * * @param text the string used to initialize this message @@ -255,10 +255,10 @@ public interface Session extends Runnable TextMessage createTextMessage(String text) throws JMSException; /** Indicates whether the session is in transacted mode. - * + * * @return true if the session is in transacted mode - * - * @exception JMSException if the JMS provider fails to return the + * + * @exception JMSException if the JMS provider fails to return the * transaction mode due to some internal error. */ @@ -268,12 +268,12 @@ public interface Session extends Runnable * mode is set at the time that the session is created. If the session is * transacted, the acknowledgement mode is ignored. * - *@return If the session is not transacted, returns the + *@return If the session is not transacted, returns the * current acknowledgement mode for the session. * If the session * is transacted, returns SESSION_TRANSACTED. * - *@exception JMSException if the JMS provider fails to return the + *@exception JMSException if the JMS provider fails to return the * acknowledgment mode due to some internal error. * *@see Connection#createSession @@ -289,50 +289,50 @@ public interface Session extends Runnable * @exception TransactionRolledBackException if the transaction * is rolled back due to some internal error * during commit. - * @exception IllegalStateException if the method is not called by a + * @exception IllegalStateException if the method is not called by a * transacted session. */ void commit() throws JMSException; - /** Rolls back any messages done in this transaction and releases any locks + /** Rolls back any messages done in this transaction and releases any locks * currently held. * * @exception JMSException if the JMS provider fails to roll back the * transaction due to some internal error. - * @exception IllegalStateException if the method is not called by a + * @exception IllegalStateException if the method is not called by a * transacted session. - * + * */ void rollback() throws JMSException; /** Closes the session. * - * <P>Since a provider may allocate some resources on behalf of a session - * outside the JVM, clients should close the resources when they are not - * needed. - * Relying on garbage collection to eventually reclaim these resources + * <P>Since a provider may allocate some resources on behalf of a session + * outside the JVM, clients should close the resources when they are not + * needed. + * Relying on garbage collection to eventually reclaim these resources * may not be timely enough. * * <P>There is no need to close the producers and consumers - * of a closed session. + * of a closed session. * - * <P> This call will block until a <CODE>receive</CODE> call or message + * <P> This call will block until a <CODE>receive</CODE> call or message * listener in progress has completed. A blocked message consumer - * <CODE>receive</CODE> call returns <CODE>null</CODE> when this session + * <CODE>receive</CODE> call returns <CODE>null</CODE> when this session * is closed. * * <P>Closing a transacted session must roll back the transaction * in progress. - * - * <P>This method is the only <CODE>Session</CODE> method that can - * be called concurrently. * - * <P>Invoking any other <CODE>Session</CODE> method on a closed session - * must throw a <CODE>JMSException.IllegalStateException</CODE>. Closing a + * <P>This method is the only <CODE>Session</CODE> method that can + * be called concurrently. + * + * <P>Invoking any other <CODE>Session</CODE> method on a closed session + * must throw a <CODE>JMSException.IllegalStateException</CODE>. Closing a * closed session must <I>not</I> throw an exception. - * + * * @exception JMSException if the JMS provider fails to close the * session due to some internal error. */ @@ -341,26 +341,26 @@ public interface Session extends Runnable /** Stops message delivery in this session, and restarts message delivery * with the oldest unacknowledged message. - * + * * <P>All consumers deliver messages in a serial order. - * Acknowledging a received message automatically acknowledges all + * Acknowledging a received message automatically acknowledges all * messages that have been delivered to the client. * * <P>Restarting a session causes it to take the following actions: * * <UL> * <LI>Stop message delivery - * <LI>Mark all messages that might have been delivered but not + * <LI>Mark all messages that might have been delivered but not * acknowledged as "redelivered" - * <LI>Restart the delivery sequence including all unacknowledged + * <LI>Restart the delivery sequence including all unacknowledged * messages that had been previously delivered. Redelivered messages - * do not have to be delivered in + * do not have to be delivered in * exactly their original delivery order. * </UL> * * @exception JMSException if the JMS provider fails to stop and restart * message delivery due to some internal error. - * @exception IllegalStateException if the method is called by a + * @exception IllegalStateException if the method is called by a * transacted session. */ @@ -370,7 +370,7 @@ public interface Session extends Runnable * * @return the message listener associated with this session * - * @exception JMSException if the JMS provider fails to get the message + * @exception JMSException if the JMS provider fails to get the message * listener due to an internal error. * * @see javax.jms.Session#setMessageListener @@ -382,15 +382,15 @@ public interface Session extends Runnable /** Sets the session's distinguished message listener (optional). * - * <P>When the distinguished message listener is set, no other form of - * message receipt in the session can + * <P>When the distinguished message listener is set, no other form of + * message receipt in the session can * be used; however, all forms of sending messages are still supported. - * + * * <P>This is an expert facility not used by regular JMS clients. * * @param listener the message listener to associate with this session * - * @exception JMSException if the JMS provider fails to set the message + * @exception JMSException if the JMS provider fails to set the message * listener due to an internal error. * * @see javax.jms.Session#getMessageListener @@ -408,16 +408,16 @@ public interface Session extends Runnable */ public void run(); - /** Creates a <CODE>MessageProducer</CODE> to send messages to the specified + /** Creates a <CODE>MessageProducer</CODE> to send messages to the specified * destination. * - * <P>A client uses a <CODE>MessageProducer</CODE> object to send - * messages to a destination. Since <CODE>Queue</CODE> and <CODE>Topic</CODE> + * <P>A client uses a <CODE>MessageProducer</CODE> object to send + * messages to a destination. Since <CODE>Queue</CODE> and <CODE>Topic</CODE> * both inherit from <CODE>Destination</CODE>, they can be used in * the destination parameter to create a <CODE>MessageProducer</CODE> object. - * - * @param destination the <CODE>Destination</CODE> to send to, - * or null if this is a producer which does not have a specified + * + * @param destination the <CODE>Destination</CODE> to send to, + * or null if this is a producer which does not have a specified * destination. * * @exception JMSException if the session fails to create a MessageProducer @@ -425,92 +425,92 @@ public interface Session extends Runnable * @exception InvalidDestinationException if an invalid destination * is specified. * - * @since 1.1 - * + * @since 1.1 + * */ MessageProducer createProducer(Destination destination) throws JMSException; /** Creates a <CODE>MessageConsumer</CODE> for the specified destination. - * Since <CODE>Queue</CODE> and <CODE>Topic</CODE> + * Since <CODE>Queue</CODE> and <CODE>Topic</CODE> * both inherit from <CODE>Destination</CODE>, they can be used in * the destination parameter to create a <CODE>MessageConsumer</CODE>. * - * @param destination the <CODE>Destination</CODE> to access. + * @param destination the <CODE>Destination</CODE> to access. * * @exception JMSException if the session fails to create a consumer * due to some internal error. - * @exception InvalidDestinationException if an invalid destination + * @exception InvalidDestinationException if an invalid destination * is specified. * - * @since 1.1 + * @since 1.1 */ MessageConsumer createConsumer(Destination destination) throws JMSException; - /** Creates a <CODE>MessageConsumer</CODE> for the specified destination, - * using a message selector. - * Since <CODE>Queue</CODE> and <CODE>Topic</CODE> + /** Creates a <CODE>MessageConsumer</CODE> for the specified destination, + * using a message selector. + * Since <CODE>Queue</CODE> and <CODE>Topic</CODE> * both inherit from <CODE>Destination</CODE>, they can be used in * the destination parameter to create a <CODE>MessageConsumer</CODE>. * - * <P>A client uses a <CODE>MessageConsumer</CODE> object to receive + * <P>A client uses a <CODE>MessageConsumer</CODE> object to receive * messages that have been sent to a destination. - * - * + * + * * @param destination the <CODE>Destination</CODE> to access * @param messageSelector only messages with properties matching the * message selector expression are delivered. A value of null or - * an empty string indicates that there is no message selector - * for the message consumer. - * - * + * an empty string indicates that there is no message selector + * for the message consumer. + * + * * @exception JMSException if the session fails to create a MessageConsumer * due to some internal error. * @exception InvalidDestinationException if an invalid destination * is specified. - + * @exception InvalidSelectorException if the message selector is invalid. * - * @since 1.1 + * @since 1.1 */ MessageConsumer createConsumer(Destination destination, java.lang.String messageSelector) throws JMSException; /** Creates <CODE>MessageConsumer</CODE> for the specified destination, using a - * message selector. This method can specify whether messages published by - * its own connection should be delivered to it, if the destination is a - * topic. - *<P> Since <CODE>Queue</CODE> and <CODE>Topic</CODE> + * message selector. This method can specify whether messages published by + * its own connection should be delivered to it, if the destination is a + * topic. + *<P> Since <CODE>Queue</CODE> and <CODE>Topic</CODE> * both inherit from <CODE>Destination</CODE>, they can be used in * the destination parameter to create a <CODE>MessageConsumer</CODE>. - * <P>A client uses a <CODE>MessageConsumer</CODE> object to receive - * messages that have been published to a destination. - * - * <P>In some cases, a connection may both publish and subscribe to a + * <P>A client uses a <CODE>MessageConsumer</CODE> object to receive + * messages that have been published to a destination. + * + * <P>In some cases, a connection may both publish and subscribe to a * topic. The consumer <CODE>NoLocal</CODE> attribute allows a consumer * to inhibit the delivery of messages published by its own connection. - * The default value for this attribute is False. The <CODE>noLocal</CODE> - * value must be supported by destinations that are topics. + * The default value for this attribute is False. The <CODE>noLocal</CODE> + * value must be supported by destinations that are topics. * - * @param destination the <CODE>Destination</CODE> to access + * @param destination the <CODE>Destination</CODE> to access * @param messageSelector only messages with properties matching the * message selector expression are delivered. A value of null or - * an empty string indicates that there is no message selector + * an empty string indicates that there is no message selector * for the message consumer. * @param NoLocal - if true, and the destination is a topic, * inhibits the delivery of messages published * by its own connection. The behavior for - * <CODE>NoLocal</CODE> is + * <CODE>NoLocal</CODE> is * not specified if the destination is a queue. - * + * * @exception JMSException if the session fails to create a MessageConsumer * due to some internal error. * @exception InvalidDestinationException if an invalid destination * is specified. - + * @exception InvalidSelectorException if the message selector is invalid. * - * @since 1.1 + * @since 1.1 * */ MessageConsumer createConsumer(Destination destination, java.lang.String messageSelector, boolean NoLocal) @@ -520,13 +520,13 @@ public interface Session extends Runnable * * <P>This facility is provided for the rare cases where clients need to * dynamically manipulate queue identity. It allows the creation of a - * queue identity with a provider-specific name. Clients that depend + * queue identity with a provider-specific name. Clients that depend * on this ability are not portable. * - * <P>Note that this method is not for creating the physical queue. + * <P>Note that this method is not for creating the physical queue. * The physical creation of queues is an administrative task and is not * to be initiated by the JMS API. The one exception is the - * creation of temporary queues, which is accomplished with the + * creation of temporary queues, which is accomplished with the * <CODE>createTemporaryQueue</CODE> method. * * @param queueName the name of this <CODE>Queue</CODE> @@ -544,15 +544,15 @@ public interface Session extends Runnable * * <P>This facility is provided for the rare cases where clients need to * dynamically manipulate topic identity. This allows the creation of a - * topic identity with a provider-specific name. Clients that depend + * topic identity with a provider-specific name. Clients that depend * on this ability are not portable. * - * <P>Note that this method is not for creating the physical topic. + * <P>Note that this method is not for creating the physical topic. * The physical creation of topics is an administrative task and is not * to be initiated by the JMS API. The one exception is the - * creation of temporary topics, which is accomplished with the + * creation of temporary topics, which is accomplished with the * <CODE>createTemporaryTopic</CODE> method. - * + * * @param topicName the name of this <CODE>Topic</CODE> * * @return a <CODE>Topic</CODE> with the given name @@ -564,47 +564,47 @@ public interface Session extends Runnable Topic createTopic(String topicName) throws JMSException; - /** Creates a <CODE>QueueBrowser</CODE> object to peek at the messages on + /** Creates a <CODE>QueueBrowser</CODE> object to peek at the messages on * the specified queue. * * @param queue the <CODE>queue</CODE> to access * * @exception InvalidDestinationException if an invalid destination - * is specified + * is specified * - * @since 1.1 + * @since 1.1 */ /** Creates a durable subscriber to the specified topic. - * - * <P>If a client needs to receive all the messages published on a + * + * <P>If a client needs to receive all the messages published on a * topic, including the ones published while the subscriber is inactive, * it uses a durable <CODE>TopicSubscriber</CODE>. The JMS provider - * retains a record of this - * durable subscription and insures that all messages from the topic's - * publishers are retained until they are acknowledged by this + * retains a record of this + * durable subscription and insures that all messages from the topic's + * publishers are retained until they are acknowledged by this * durable subscriber or they have expired. * - * <P>Sessions with durable subscribers must always provide the same - * client identifier. In addition, each client must specify a name that - * uniquely identifies (within client identifier) each durable - * subscription it creates. Only one session at a time can have a + * <P>Sessions with durable subscribers must always provide the same + * client identifier. In addition, each client must specify a name that + * uniquely identifies (within client identifier) each durable + * subscription it creates. Only one session at a time can have a * <CODE>TopicSubscriber</CODE> for a particular durable subscription. * - * <P>A client can change an existing durable subscription by creating - * a durable <CODE>TopicSubscriber</CODE> with the same name and a new - * topic and/or - * message selector. Changing a durable subscriber is equivalent to + * <P>A client can change an existing durable subscription by creating + * a durable <CODE>TopicSubscriber</CODE> with the same name and a new + * topic and/or + * message selector. Changing a durable subscriber is equivalent to * unsubscribing (deleting) the old one and creating a new one. * - * <P>In some cases, a connection may both publish and subscribe to a + * <P>In some cases, a connection may both publish and subscribe to a * topic. The subscriber <CODE>NoLocal</CODE> attribute allows a subscriber * to inhibit the delivery of messages published by its own connection. * The default value for this attribute is false. * * @param topic the non-temporary <CODE>Topic</CODE> to subscribe to * @param name the name used to identify this subscription - * + * * @exception JMSException if the session fails to create a subscriber * due to some internal error. * @exception InvalidDestinationException if an invalid topic is specified. @@ -617,13 +617,13 @@ public interface Session extends Runnable /** Creates a durable subscriber to the specified topic, using a * message selector and specifying whether messages published by its * own connection should be delivered to it. - * - * <P>If a client needs to receive all the messages published on a + * + * <P>If a client needs to receive all the messages published on a * topic, including the ones published while the subscriber is inactive, * it uses a durable <CODE>TopicSubscriber</CODE>. The JMS provider - * retains a record of this - * durable subscription and insures that all messages from the topic's - * publishers are retained until they are acknowledged by this + * retains a record of this + * durable subscription and insures that all messages from the topic's + * publishers are retained until they are acknowledged by this * durable subscriber or they have expired. * * <P>Sessions with durable subscribers must always provide the same @@ -634,21 +634,21 @@ public interface Session extends Runnable * An inactive durable subscriber is one that exists but * does not currently have a message consumer associated with it. * - * <P>A client can change an existing durable subscription by creating - * a durable <CODE>TopicSubscriber</CODE> with the same name and a new - * topic and/or - * message selector. Changing a durable subscriber is equivalent to + * <P>A client can change an existing durable subscription by creating + * a durable <CODE>TopicSubscriber</CODE> with the same name and a new + * topic and/or + * message selector. Changing a durable subscriber is equivalent to * unsubscribing (deleting) the old one and creating a new one. * * @param topic the non-temporary <CODE>Topic</CODE> to subscribe to * @param name the name used to identify this subscription * @param messageSelector only messages with properties matching the * message selector expression are delivered. A value of null or - * an empty string indicates that there is no message selector + * an empty string indicates that there is no message selector * for the message consumer. * @param noLocal if set, inhibits the delivery of messages published * by its own connection - * + * * @exception JMSException if the session fails to create a subscriber * due to some internal error. * @exception InvalidDestinationException if an invalid topic is specified. @@ -675,28 +675,28 @@ public interface Session extends Runnable */ QueueBrowser createBrowser(Queue queue) throws JMSException; - /** Creates a <CODE>QueueBrowser</CODE> object to peek at the messages on + /** Creates a <CODE>QueueBrowser</CODE> object to peek at the messages on * the specified queue using a message selector. - * + * * @param queue the <CODE>queue</CODE> to access * * @param messageSelector only messages with properties matching the * message selector expression are delivered. A value of null or - * an empty string indicates that there is no message selector + * an empty string indicates that there is no message selector * for the message consumer. - * + * * @exception JMSException if the session fails to create a browser * due to some internal error. * @exception InvalidDestinationException if an invalid destination - * is specified + * is specified * @exception InvalidSelectorException if the message selector is invalid. * - * @since 1.1 + * @since 1.1 */ QueueBrowser createBrowser(Queue queue, String messageSelector) throws JMSException; - /** Creates a <CODE>TemporaryQueue</CODE> object. Its lifetime will be that + /** Creates a <CODE>TemporaryQueue</CODE> object. Its lifetime will be that * of the <CODE>Connection</CODE> unless it is deleted earlier. * * @return a temporary queue identity @@ -709,7 +709,7 @@ public interface Session extends Runnable TemporaryQueue createTemporaryQueue() throws JMSException; - /** Creates a <CODE>TemporaryTopic</CODE> object. Its lifetime will be that + /** Creates a <CODE>TemporaryTopic</CODE> object. Its lifetime will be that * of the <CODE>Connection</CODE> unless it is deleted earlier. * * @return a temporary topic identity @@ -717,25 +717,25 @@ public interface Session extends Runnable * @exception JMSException if the session fails to create a temporary * topic due to some internal error. * - * @since 1.1 + * @since 1.1 */ TemporaryTopic createTemporaryTopic() throws JMSException; /** Unsubscribes a durable subscription that has been created by a client. - * - * <P>This method deletes the state being maintained on behalf of the + * + * <P>This method deletes the state being maintained on behalf of the * subscriber by its provider. * * <P>It is erroneous for a client to delete a durable subscription * while there is an active <CODE>MessageConsumer</CODE> - * or <CODE>TopicSubscriber</CODE> for the - * subscription, or while a consumed message is part of a pending + * or <CODE>TopicSubscriber</CODE> for the + * subscription, or while a consumed message is part of a pending * transaction or has not been acknowledged in the session. * * @param name the name used to identify this subscription - * - * @exception JMSException if the session fails to unsubscribe to the + * + * @exception JMSException if the session fails to unsubscribe to the * durable subscription due to some internal error. * @exception InvalidDestinationException if an invalid subscription name * is specified. diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/StreamMessage.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/StreamMessage.java index b295f1137e..5f92b3924a 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/StreamMessage.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/StreamMessage.java @@ -110,9 +110,9 @@ public interface StreamMessage extends Message * @exception JMSException if the JMS provider fails to read the message * due to some internal error. * @exception MessageEOFException if unexpected end of message stream has - * been reached. + * been reached. * @exception MessageFormatException if this type conversion is invalid. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -126,9 +126,9 @@ public interface StreamMessage extends Message * @exception JMSException if the JMS provider fails to read the message * due to some internal error. * @exception MessageEOFException if unexpected end of message stream has - * been reached. + * been reached. * @exception MessageFormatException if this type conversion is invalid. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -141,9 +141,9 @@ public interface StreamMessage extends Message * @exception JMSException if the JMS provider fails to read the message * due to some internal error. * @exception MessageEOFException if unexpected end of message stream has - * been reached. + * been reached. * @exception MessageFormatException if this type conversion is invalid. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -156,9 +156,9 @@ public interface StreamMessage extends Message * @exception JMSException if the JMS provider fails to read the message * due to some internal error. * @exception MessageEOFException if unexpected end of message stream has - * been reached. - * @exception MessageFormatException if this type conversion is invalid - * @exception MessageNotReadableException if the message is in write-only + * been reached. + * @exception MessageFormatException if this type conversion is invalid + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -172,9 +172,9 @@ public interface StreamMessage extends Message * @exception JMSException if the JMS provider fails to read the message * due to some internal error. * @exception MessageEOFException if unexpected end of message stream has - * been reached. + * been reached. * @exception MessageFormatException if this type conversion is invalid. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -188,9 +188,9 @@ public interface StreamMessage extends Message * @exception JMSException if the JMS provider fails to read the message * due to some internal error. * @exception MessageEOFException if unexpected end of message stream has - * been reached. + * been reached. * @exception MessageFormatException if this type conversion is invalid. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -203,9 +203,9 @@ public interface StreamMessage extends Message * @exception JMSException if the JMS provider fails to read the message * due to some internal error. * @exception MessageEOFException if unexpected end of message stream has - * been reached. + * been reached. * @exception MessageFormatException if this type conversion is invalid. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -218,9 +218,9 @@ public interface StreamMessage extends Message * @exception JMSException if the JMS provider fails to read the message * due to some internal error. * @exception MessageEOFException if unexpected end of message stream has - * been reached. + * been reached. * @exception MessageFormatException if this type conversion is invalid. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ @@ -233,56 +233,56 @@ public interface StreamMessage extends Message * @exception JMSException if the JMS provider fails to read the message * due to some internal error. * @exception MessageEOFException if unexpected end of message stream has - * been reached. + * been reached. * @exception MessageFormatException if this type conversion is invalid. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. */ String readString() throws JMSException; - /** Reads a byte array field from the stream message into the - * specified <CODE>byte[]</CODE> object (the read buffer). - * - * <P>To read the field value, <CODE>readBytes</CODE> should be - * successively called + /** Reads a byte array field from the stream message into the + * specified <CODE>byte[]</CODE> object (the read buffer). + * + * <P>To read the field value, <CODE>readBytes</CODE> should be + * successively called * until it returns a value less than the length of the read buffer. - * The value of the bytes in the buffer following the last byte + * The value of the bytes in the buffer following the last byte * read is undefined. - * - * <P>If <CODE>readBytes</CODE> returns a value equal to the length of the - * buffer, a subsequent <CODE>readBytes</CODE> call must be made. If there + * + * <P>If <CODE>readBytes</CODE> returns a value equal to the length of the + * buffer, a subsequent <CODE>readBytes</CODE> call must be made. If there * are no more bytes to be read, this call returns -1. - * - * <P>If the byte array field value is null, <CODE>readBytes</CODE> + * + * <P>If the byte array field value is null, <CODE>readBytes</CODE> * returns -1. * - * <P>If the byte array field value is empty, <CODE>readBytes</CODE> + * <P>If the byte array field value is empty, <CODE>readBytes</CODE> * returns 0. - * + * * <P>Once the first <CODE>readBytes</CODE> call on a <CODE>byte[]</CODE> * field value has been made, - * the full value of the field must be read before it is valid to read - * the next field. An attempt to read the next field before that has + * the full value of the field must be read before it is valid to read + * the next field. An attempt to read the next field before that has * been done will throw a <CODE>MessageFormatException</CODE>. - * - * <P>To read the byte field value into a new <CODE>byte[]</CODE> object, + * + * <P>To read the byte field value into a new <CODE>byte[]</CODE> object, * use the <CODE>readObject</CODE> method. * * @param value the buffer into which the data is read * - * @return the total number of bytes read into the buffer, or -1 if - * there is no more data because the end of the byte field has been + * @return the total number of bytes read into the buffer, or -1 if + * there is no more data because the end of the byte field has been * reached * * @exception JMSException if the JMS provider fails to read the message * due to some internal error. * @exception MessageEOFException if unexpected end of message stream has - * been reached. + * been reached. * @exception MessageFormatException if this type conversion is invalid. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. - * + * * @see #readObject() */ @@ -291,46 +291,46 @@ public interface StreamMessage extends Message /** Reads an object from the stream message. * * <P>This method can be used to return, in objectified format, - * an object in the Java programming language ("Java object") that has + * an object in the Java programming language ("Java object") that has * been written to the stream with the equivalent * <CODE>writeObject</CODE> method call, or its equivalent primitive * <CODE>write<I>type</I></CODE> method. - * - * <P>Note that byte values are returned as <CODE>byte[]</CODE>, not + * + * <P>Note that byte values are returned as <CODE>byte[]</CODE>, not * <CODE>Byte[]</CODE>. * - * <P>An attempt to call <CODE>readObject</CODE> to read a byte field + * <P>An attempt to call <CODE>readObject</CODE> to read a byte field * value into a new <CODE>byte[]</CODE> object before the full value of the - * byte field has been read will throw a + * byte field has been read will throw a * <CODE>MessageFormatException</CODE>. * * @return a Java object from the stream message, in objectified - * format (for example, if the object was written as an <CODE>int</CODE>, + * format (for example, if the object was written as an <CODE>int</CODE>, * an <CODE>Integer</CODE> is returned) * * @exception JMSException if the JMS provider fails to read the message * due to some internal error. * @exception MessageEOFException if unexpected end of message stream has - * been reached. + * been reached. * @exception MessageFormatException if this type conversion is invalid. - * @exception MessageNotReadableException if the message is in write-only + * @exception MessageNotReadableException if the message is in write-only * mode. - * + * * @see #readBytes(byte[] value) */ Object readObject() throws JMSException; /** Writes a <code>boolean</code> to the stream message. - * The value <code>true</code> is written as the value - * <code>(byte)1</code>; the value <code>false</code> is written as + * The value <code>true</code> is written as the value + * <code>(byte)1</code>; the value <code>false</code> is written as * the value <code>(byte)0</code>. * * @param value the <code>boolean</code> value to be written * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -342,7 +342,7 @@ public interface StreamMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -354,7 +354,7 @@ public interface StreamMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -366,7 +366,7 @@ public interface StreamMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -378,7 +378,7 @@ public interface StreamMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -390,7 +390,7 @@ public interface StreamMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -402,7 +402,7 @@ public interface StreamMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -414,7 +414,7 @@ public interface StreamMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -426,7 +426,7 @@ public interface StreamMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -435,25 +435,25 @@ public interface StreamMessage extends Message /** Writes a byte array field to the stream message. * * <P>The byte array <code>value</code> is written to the message - * as a byte array field. Consecutively written byte array fields are + * as a byte array field. Consecutively written byte array fields are * treated as two distinct fields when the fields are read. - * + * * @param value the byte array value to be written * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ void writeBytes(byte[] value) throws JMSException; - /** Writes a portion of a byte array as a byte array field to the stream + /** Writes a portion of a byte array as a byte array field to the stream * message. - * + * * <P>The a portion of the byte array <code>value</code> is written to the - * message as a byte array field. Consecutively written byte - * array fields are treated as two distinct fields when the fields are + * message as a byte array field. Consecutively written byte + * array fields are treated as two distinct fields when the fields are * read. * * @param value the byte array value to be written @@ -462,7 +462,7 @@ public interface StreamMessage extends Message * * @exception JMSException if the JMS provider fails to write the message * due to some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -471,8 +471,8 @@ public interface StreamMessage extends Message /** Writes an object to the stream message. * * <P>This method works only for the objectified primitive - * object types (<code>Integer</code>, <code>Double</code>, - * <code>Long</code> ...), <code>String</code> objects, and byte + * object types (<code>Integer</code>, <code>Double</code>, + * <code>Long</code> ...), <code>String</code> objects, and byte * arrays. * * @param value the Java object to be written @@ -480,7 +480,7 @@ public interface StreamMessage extends Message * @exception JMSException if the JMS provider fails to write the message * due to some internal error. * @exception MessageFormatException if the object is invalid. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -488,7 +488,7 @@ public interface StreamMessage extends Message /** Puts the message body in read-only mode and repositions the stream * to the beginning. - * + * * @exception JMSException if the JMS provider fails to reset the message * due to some internal error. * @exception MessageFormatException if the message has an invalid diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TemporaryQueue.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TemporaryQueue.java index 82a9af87bf..19e73a42cd 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TemporaryQueue.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TemporaryQueue.java @@ -49,8 +49,8 @@ public interface TemporaryQueue extends Queue /** Deletes this temporary queue. If there are existing receivers * still using it, a <CODE>JMSException</CODE> will be thrown. - * - * @exception JMSException if the JMS provider fails to delete the + * + * @exception JMSException if the JMS provider fails to delete the * temporary queue due to some internal error. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TemporaryTopic.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TemporaryTopic.java index 4d9c9506e7..7e7950990e 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TemporaryTopic.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TemporaryTopic.java @@ -50,7 +50,7 @@ public interface TemporaryTopic extends Topic /** Deletes this temporary topic. If there are existing subscribers * still using it, a <CODE>JMSException</CODE> will be thrown. - * + * * @exception JMSException if the JMS provider fails to delete the * temporary topic due to some internal error. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TextMessage.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TextMessage.java index bbca08286e..5270ab653a 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TextMessage.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TextMessage.java @@ -56,12 +56,12 @@ public interface TextMessage extends Message { /** Sets the string containing this message's data. - * + * * @param string the <CODE>String</CODE> containing the message's data - * + * * @exception JMSException if the JMS provider fails to set the text due to * some internal error. - * @exception MessageNotWriteableException if the message is in read-only + * @exception MessageNotWriteableException if the message is in read-only * mode. */ @@ -69,9 +69,9 @@ public interface TextMessage extends Message /** Gets the string containing this message's data. The default * value is null. - * + * * @return the <CODE>String</CODE> containing the message's data - * + * * @exception JMSException if the JMS provider fails to get the text due to * some internal error. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Topic.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Topic.java index 2886dadead..ea98032f04 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Topic.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/Topic.java @@ -65,12 +65,12 @@ public interface Topic extends Destination { /** Gets the name of this topic. - * + * * <P>Clients that depend upon the name are not portable. - * + * * @return the topic name - * - * @exception JMSException if the JMS provider implementation of + * + * @exception JMSException if the JMS provider implementation of * <CODE>Topic</CODE> fails to return the topic * name due to some internal * error. diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicConnection.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicConnection.java index 2f8cdf6fc7..79530ac620 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicConnection.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicConnection.java @@ -56,33 +56,33 @@ public interface TopicConnection extends Connection * @param transacted indicates whether the session is transacted * @param acknowledgeMode indicates whether the consumer or the * client will acknowledge any messages it receives; ignored if the session - * is transacted. Legal values are <code>Session.AUTO_ACKNOWLEDGE</code>, - * <code>Session.CLIENT_ACKNOWLEDGE</code>, and - * <code>Session.DUPS_OK_ACKNOWLEDGE</code>. - * + * is transacted. Legal values are <code>Session.AUTO_ACKNOWLEDGE</code>, + * <code>Session.CLIENT_ACKNOWLEDGE</code>, and + * <code>Session.DUPS_OK_ACKNOWLEDGE</code>. + * * @return a newly created topic session - * + * * @exception JMSException if the <CODE>TopicConnection</CODE> object fails * to create a session due to some internal error or * lack of support for the specific transaction * and acknowledgement mode. * - * @see Session#AUTO_ACKNOWLEDGE - * @see Session#CLIENT_ACKNOWLEDGE - * @see Session#DUPS_OK_ACKNOWLEDGE + * @see Session#AUTO_ACKNOWLEDGE + * @see Session#CLIENT_ACKNOWLEDGE + * @see Session#DUPS_OK_ACKNOWLEDGE */ TopicSession createTopicSession(boolean transacted, int acknowledgeMode) throws JMSException; /** Creates a connection consumer for this connection (optional operation). * This is an expert facility not used by regular JMS clients. - * + * * @param topic the topic to access * @param messageSelector only messages with properties matching the * message selector expression are delivered. A value of null or - * an empty string indicates that there is no message selector + * an empty string indicates that there is no message selector * for the message consumer. - * @param sessionPool the server session pool to associate with this + * @param sessionPool the server session pool to associate with this * connection consumer * @param maxMessages the maximum number of messages that can be * assigned to a server session at one time @@ -91,8 +91,8 @@ public interface TopicConnection extends Connection * * @exception JMSException if the <CODE>TopicConnection</CODE> object fails * to create a connection consumer due to some - * internal error or invalid arguments for - * <CODE>sessionPool</CODE> and + * internal error or invalid arguments for + * <CODE>sessionPool</CODE> and * <CODE>messageSelector</CODE>. * @exception InvalidDestinationException if an invalid topic is specified. * @exception InvalidSelectorException if the message selector is invalid. @@ -102,26 +102,26 @@ public interface TopicConnection extends Connection ConnectionConsumer createConnectionConsumer(Topic topic, String messageSelector, ServerSessionPool sessionPool, int maxMessages) throws JMSException; - /** Create a durable connection consumer for this connection (optional operation). + /** Create a durable connection consumer for this connection (optional operation). * This is an expert facility not used by regular JMS clients. - * + * * @param topic the topic to access * @param subscriptionName durable subscription name * @param messageSelector only messages with properties matching the * message selector expression are delivered. A value of null or - * an empty string indicates that there is no message selector + * an empty string indicates that there is no message selector * for the message consumer. - * @param sessionPool the server session pool to associate with this + * @param sessionPool the server session pool to associate with this * durable connection consumer * @param maxMessages the maximum number of messages that can be * assigned to a server session at one time * * @return the durable connection consumer - * + * * @exception JMSException if the <CODE>TopicConnection</CODE> object fails * to create a connection consumer due to some - * internal error or invalid arguments for - * <CODE>sessionPool</CODE> and + * internal error or invalid arguments for + * <CODE>sessionPool</CODE> and * <CODE>messageSelector</CODE>. * @exception InvalidDestinationException if an invalid topic is specified. * @exception InvalidSelectorException if the message selector is invalid. diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicConnectionFactory.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicConnectionFactory.java index e518665d31..ed9e54a71a 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicConnectionFactory.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicConnectionFactory.java @@ -46,33 +46,33 @@ public interface TopicConnectionFactory extends ConnectionFactory { /** Creates a topic connection with the default user identity. - * The connection is created in stopped mode. No messages + * The connection is created in stopped mode. No messages * will be delivered until the <code>Connection.start</code> method * is explicitly called. * * @return a newly created topic connection * - * @exception JMSException if the JMS provider fails to create a topic + * @exception JMSException if the JMS provider fails to create a topic * connection due to some internal error. - * @exception JMSSecurityException if client authentication fails due to + * @exception JMSSecurityException if client authentication fails due to * an invalid user name or password. */ TopicConnection createTopicConnection() throws JMSException; /** Creates a topic connection with the specified user identity. - * The connection is created in stopped mode. No messages + * The connection is created in stopped mode. No messages * will be delivered until the <code>Connection.start</code> method * is explicitly called. - * + * * @param userName the caller's user name * @param password the caller's password - * + * * @return a newly created topic connection * - * @exception JMSException if the JMS provider fails to create a topic + * @exception JMSException if the JMS provider fails to create a topic * connection due to some internal error. - * @exception JMSSecurityException if client authentication fails due to + * @exception JMSSecurityException if client authentication fails due to * an invalid user name or password. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicPublisher.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicPublisher.java index 5019bef7b7..8d04bed2d1 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicPublisher.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicPublisher.java @@ -89,7 +89,7 @@ public interface TopicPublisher extends MessageProducer /** Gets the topic associated with this <CODE>TopicPublisher</CODE>. * * @return this publisher's topic - * + * * @exception JMSException if the JMS provider fails to get the topic for * this <CODE>TopicPublisher</CODE> * due to some internal error. @@ -112,7 +112,7 @@ public interface TopicPublisher extends MessageProducer * @exception java.lang.UnsupportedOperationException if a client uses this * method with a <CODE>TopicPublisher</CODE> that * did not specify a topic at creation time. - * + * * @see javax.jms.MessageProducer#getDeliveryMode() * @see javax.jms.MessageProducer#getTimeToLive() * @see javax.jms.MessageProducer#getPriority() @@ -141,24 +141,24 @@ public interface TopicPublisher extends MessageProducer void publish(Message message, int deliveryMode, int priority, long timeToLive) throws JMSException; - /** Publishes a message to a topic for an unidentified message producer. - * Uses the <CODE>TopicPublisher</CODE>'s default delivery mode, + /** Publishes a message to a topic for an unidentified message producer. + * Uses the <CODE>TopicPublisher</CODE>'s default delivery mode, * priority, and time to live. - * - * <P>Typically, a message producer is assigned a topic at creation + * + * <P>Typically, a message producer is assigned a topic at creation * time; however, the JMS API also supports unidentified message producers, * which require that the topic be supplied every time a message is * published. * * @param topic the topic to publish this message to * @param message the message to publish - * + * * @exception JMSException if the JMS provider fails to publish the message * due to some internal error. * @exception MessageFormatException if an invalid message is specified. * @exception InvalidDestinationException if a client uses * this method with an invalid topic. - * + * * @see javax.jms.MessageProducer#getDeliveryMode() * @see javax.jms.MessageProducer#getTimeToLive() * @see javax.jms.MessageProducer#getPriority() @@ -166,9 +166,9 @@ public interface TopicPublisher extends MessageProducer void publish(Topic topic, Message message) throws JMSException; - /** Publishes a message to a topic for an unidentified message + /** Publishes a message to a topic for an unidentified message * producer, specifying delivery mode, priority and time to live. - * + * * <P>Typically, a message producer is assigned a topic at creation * time; however, the JMS API also supports unidentified message producers, * which require that the topic be supplied every time a message is @@ -179,7 +179,7 @@ public interface TopicPublisher extends MessageProducer * @param deliveryMode the delivery mode to use * @param priority the priority for this message * @param timeToLive the message's lifetime (in milliseconds) - * + * * @exception JMSException if the JMS provider fails to publish the message * due to some internal error. * @exception MessageFormatException if an invalid message is specified. diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicRequestor.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicRequestor.java index 8424e94f5a..329a69fa9c 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicRequestor.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicRequestor.java @@ -57,9 +57,9 @@ public class TopicRequestor TopicSubscriber subscriber; /** Constructor for the <CODE>TopicRequestor</CODE> class. - * + * * <P>This implementation assumes the session parameter to be non-transacted, - * with a delivery mode of either <CODE>AUTO_ACKNOWLEDGE</CODE> or + * with a delivery mode of either <CODE>AUTO_ACKNOWLEDGE</CODE> or * <CODE>DUPS_OK_ACKNOWLEDGE</CODE>. * * @param session the <CODE>TopicSession</CODE> the topic belongs to @@ -81,13 +81,13 @@ public class TopicRequestor } /** Sends a request and waits for a reply. The temporary topic is used for - * the <CODE>JMSReplyTo</CODE> destination; the first reply is returned, + * the <CODE>JMSReplyTo</CODE> destination; the first reply is returned, * and any following replies are discarded. * * @param message the message to send - * + * * @return the reply message - * + * * @exception JMSException if the JMS provider fails to complete the * request due to some internal error. */ @@ -101,15 +101,15 @@ public class TopicRequestor /** Closes the <CODE>TopicRequestor</CODE> and its session. * - * <P>Since a provider may allocate some resources on behalf of a - * <CODE>TopicRequestor</CODE> outside the Java virtual machine, clients - * should close them when they - * are not needed. Relying on garbage collection to eventually reclaim + * <P>Since a provider may allocate some resources on behalf of a + * <CODE>TopicRequestor</CODE> outside the Java virtual machine, clients + * should close them when they + * are not needed. Relying on garbage collection to eventually reclaim * these resources may not be timely enough. * - * <P>Note that this method closes the <CODE>TopicSession</CODE> object + * <P>Note that this method closes the <CODE>TopicSession</CODE> object * passed to the <CODE>TopicRequestor</CODE> constructor. - * + * * @exception JMSException if the JMS provider fails to close the * <CODE>TopicRequestor</CODE> due to some internal * error. diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicSession.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicSession.java index ca6cbb51b3..435d6f7442 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicSession.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicSession.java @@ -64,15 +64,15 @@ public interface TopicSession extends Session * * <P>This facility is provided for the rare cases where clients need to * dynamically manipulate topic identity. This allows the creation of a - * topic identity with a provider-specific name. Clients that depend + * topic identity with a provider-specific name. Clients that depend * on this ability are not portable. * - * <P>Note that this method is not for creating the physical topic. + * <P>Note that this method is not for creating the physical topic. * The physical creation of topics is an administrative task and is not * to be initiated by the JMS API. The one exception is the - * creation of temporary topics, which is accomplished with the + * creation of temporary topics, which is accomplished with the * <CODE>createTemporaryTopic</CODE> method. - * + * * @param topicName the name of this <CODE>Topic</CODE> * * @return a <CODE>Topic</CODE> with the given name @@ -84,20 +84,20 @@ public interface TopicSession extends Session Topic createTopic(String topicName) throws JMSException; /** Creates a nondurable subscriber to the specified topic. - * - * <P>A client uses a <CODE>TopicSubscriber</CODE> object to receive + * + * <P>A client uses a <CODE>TopicSubscriber</CODE> object to receive * messages that have been published to a topic. * - * <P>Regular <CODE>TopicSubscriber</CODE> objects are not durable. + * <P>Regular <CODE>TopicSubscriber</CODE> objects are not durable. * They receive only messages that are published while they are active. * - * <P>In some cases, a connection may both publish and subscribe to a + * <P>In some cases, a connection may both publish and subscribe to a * topic. The subscriber <CODE>NoLocal</CODE> attribute allows a subscriber * to inhibit the delivery of messages published by its own connection. * The default value for this attribute is false. * * @param topic the <CODE>Topic</CODE> to subscribe to - * + * * @exception JMSException if the session fails to create a subscriber * due to some internal error. * @exception InvalidDestinationException if an invalid topic is specified. @@ -109,17 +109,17 @@ public interface TopicSession extends Session * message selector or specifying whether messages published by its * own connection should be delivered to it. * - * <P>A client uses a <CODE>TopicSubscriber</CODE> object to receive + * <P>A client uses a <CODE>TopicSubscriber</CODE> object to receive * messages that have been published to a topic. - * - * <P>Regular <CODE>TopicSubscriber</CODE> objects are not durable. + * + * <P>Regular <CODE>TopicSubscriber</CODE> objects are not durable. * They receive only messages that are published while they are active. * - * <P>Messages filtered out by a subscriber's message selector will - * never be delivered to the subscriber. From the subscriber's + * <P>Messages filtered out by a subscriber's message selector will + * never be delivered to the subscriber. From the subscriber's * perspective, they do not exist. * - * <P>In some cases, a connection may both publish and subscribe to a + * <P>In some cases, a connection may both publish and subscribe to a * topic. The subscriber <CODE>NoLocal</CODE> attribute allows a subscriber * to inhibit the delivery of messages published by its own connection. * The default value for this attribute is false. @@ -127,11 +127,11 @@ public interface TopicSession extends Session * @param topic the <CODE>Topic</CODE> to subscribe to * @param messageSelector only messages with properties matching the * message selector expression are delivered. A value of null or - * an empty string indicates that there is no message selector + * an empty string indicates that there is no message selector * for the message consumer. * @param noLocal if set, inhibits the delivery of messages published * by its own connection - * + * * @exception JMSException if the session fails to create a subscriber * due to some internal error. * @exception InvalidDestinationException if an invalid topic is specified. @@ -141,35 +141,35 @@ public interface TopicSession extends Session TopicSubscriber createSubscriber(Topic topic, String messageSelector, boolean noLocal) throws JMSException; /** Creates a durable subscriber to the specified topic. - * - * <P>If a client needs to receive all the messages published on a + * + * <P>If a client needs to receive all the messages published on a * topic, including the ones published while the subscriber is inactive, * it uses a durable <CODE>TopicSubscriber</CODE>. The JMS provider - * retains a record of this - * durable subscription and insures that all messages from the topic's - * publishers are retained until they are acknowledged by this + * retains a record of this + * durable subscription and insures that all messages from the topic's + * publishers are retained until they are acknowledged by this * durable subscriber or they have expired. * - * <P>Sessions with durable subscribers must always provide the same - * client identifier. In addition, each client must specify a name that - * uniquely identifies (within client identifier) each durable - * subscription it creates. Only one session at a time can have a + * <P>Sessions with durable subscribers must always provide the same + * client identifier. In addition, each client must specify a name that + * uniquely identifies (within client identifier) each durable + * subscription it creates. Only one session at a time can have a * <CODE>TopicSubscriber</CODE> for a particular durable subscription. * - * <P>A client can change an existing durable subscription by creating - * a durable <CODE>TopicSubscriber</CODE> with the same name and a new - * topic and/or - * message selector. Changing a durable subscriber is equivalent to + * <P>A client can change an existing durable subscription by creating + * a durable <CODE>TopicSubscriber</CODE> with the same name and a new + * topic and/or + * message selector. Changing a durable subscriber is equivalent to * unsubscribing (deleting) the old one and creating a new one. * - * <P>In some cases, a connection may both publish and subscribe to a + * <P>In some cases, a connection may both publish and subscribe to a * topic. The subscriber <CODE>NoLocal</CODE> attribute allows a subscriber * to inhibit the delivery of messages published by its own connection. * The default value for this attribute is false. * * @param topic the non-temporary <CODE>Topic</CODE> to subscribe to * @param name the name used to identify this subscription - * + * * @exception JMSException if the session fails to create a subscriber * due to some internal error. * @exception InvalidDestinationException if an invalid topic is specified. @@ -180,13 +180,13 @@ public interface TopicSession extends Session /** Creates a durable subscriber to the specified topic, using a * message selector or specifying whether messages published by its * own connection should be delivered to it. - * - * <P>If a client needs to receive all the messages published on a + * + * <P>If a client needs to receive all the messages published on a * topic, including the ones published while the subscriber is inactive, * it uses a durable <CODE>TopicSubscriber</CODE>. The JMS provider - * retains a record of this - * durable subscription and insures that all messages from the topic's - * publishers are retained until they are acknowledged by this + * retains a record of this + * durable subscription and insures that all messages from the topic's + * publishers are retained until they are acknowledged by this * durable subscriber or they have expired. * * <P>Sessions with durable subscribers must always provide the same @@ -197,21 +197,21 @@ public interface TopicSession extends Session * An inactive durable subscriber is one that exists but * does not currently have a message consumer associated with it. * - * <P>A client can change an existing durable subscription by creating - * a durable <CODE>TopicSubscriber</CODE> with the same name and a new - * topic and/or - * message selector. Changing a durable subscriber is equivalent to + * <P>A client can change an existing durable subscription by creating + * a durable <CODE>TopicSubscriber</CODE> with the same name and a new + * topic and/or + * message selector. Changing a durable subscriber is equivalent to * unsubscribing (deleting) the old one and creating a new one. * * @param topic the non-temporary <CODE>Topic</CODE> to subscribe to * @param name the name used to identify this subscription * @param messageSelector only messages with properties matching the * message selector expression are delivered. A value of null or - * an empty string indicates that there is no message selector + * an empty string indicates that there is no message selector * for the message consumer. * @param noLocal if set, inhibits the delivery of messages published * by its own connection - * + * * @exception JMSException if the session fails to create a subscriber * due to some internal error. * @exception InvalidDestinationException if an invalid topic is specified. @@ -223,11 +223,11 @@ public interface TopicSession extends Session /** Creates a publisher for the specified topic. * - * <P>A client uses a <CODE>TopicPublisher</CODE> object to publish + * <P>A client uses a <CODE>TopicPublisher</CODE> object to publish * messages on a topic. * Each time a client creates a <CODE>TopicPublisher</CODE> on a topic, it - * defines a - * new sequence of messages that have no ordering relationship with the + * defines a + * new sequence of messages that have no ordering relationship with the * messages it has previously sent. * * @param topic the <CODE>Topic</CODE> to publish to, or null if this is an @@ -240,7 +240,7 @@ public interface TopicSession extends Session TopicPublisher createPublisher(Topic topic) throws JMSException; - /** Creates a <CODE>TemporaryTopic</CODE> object. Its lifetime will be that + /** Creates a <CODE>TemporaryTopic</CODE> object. Its lifetime will be that * of the <CODE>TopicConnection</CODE> unless it is deleted earlier. * * @return a temporary topic identity @@ -252,18 +252,18 @@ public interface TopicSession extends Session TemporaryTopic createTemporaryTopic() throws JMSException; /** Unsubscribes a durable subscription that has been created by a client. - * - * <P>This method deletes the state being maintained on behalf of the + * + * <P>This method deletes the state being maintained on behalf of the * subscriber by its provider. * * <P>It is erroneous for a client to delete a durable subscription - * while there is an active <CODE>TopicSubscriber</CODE> for the - * subscription, or while a consumed message is part of a pending + * while there is an active <CODE>TopicSubscriber</CODE> for the + * subscription, or while a consumed message is part of a pending * transaction or has not been acknowledged in the session. * * @param name the name used to identify this subscription - * - * @exception JMSException if the session fails to unsubscribe to the + * + * @exception JMSException if the session fails to unsubscribe to the * durable subscription due to some internal error. * @exception InvalidDestinationException if an invalid subscription name * is specified. diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicSubscriber.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicSubscriber.java index 034df82ff7..c5f5c9a02f 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicSubscriber.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/TopicSubscriber.java @@ -97,9 +97,9 @@ public interface TopicSubscriber extends MessageConsumer { /** Gets the <CODE>Topic</CODE> associated with this subscriber. - * + * * @return this subscriber's <CODE>Topic</CODE> - * + * * @exception JMSException if the JMS provider fails to get the topic for * this topic subscriber * due to some internal error. @@ -107,11 +107,11 @@ public interface TopicSubscriber extends MessageConsumer Topic getTopic() throws JMSException; - /** Gets the <CODE>NoLocal</CODE> attribute for this subscriber. + /** Gets the <CODE>NoLocal</CODE> attribute for this subscriber. * The default value for this attribute is false. - * + * * @return true if locally published messages are being inhibited - * + * * @exception JMSException if the JMS provider fails to get the * <CODE>NoLocal</CODE> attribute for * this topic subscriber diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAConnection.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAConnection.java index 34a4019a2d..4a70c34aff 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAConnection.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAConnection.java @@ -46,10 +46,10 @@ public interface XAConnection extends Connection { /** Creates an <CODE>XASession</CODE> object. - * + * * @return a newly created <CODE>XASession</CODE> - * - * @exception JMSException if the <CODE>XAConnection</CODE> object + * + * @exception JMSException if the <CODE>XAConnection</CODE> object * fails to create an <CODE>XASession</CODE> due to * some internal error. * @@ -62,10 +62,10 @@ public interface XAConnection extends Connection * * @param transacted usage undefined * @param acknowledgeMode usage undefined - * + * * @return a <CODE>Session</CODE> object - * - * @exception JMSException if the <CODE>XAConnection</CODE> object + * + * @exception JMSException if the <CODE>XAConnection</CODE> object * fails to create an <CODE>Session</CODE> due to * some internal error. * diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAConnectionFactory.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAConnectionFactory.java index ec332ef6af..448c74c67a 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAConnectionFactory.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAConnectionFactory.java @@ -59,38 +59,38 @@ public interface XAConnectionFactory { /** Creates an <CODE>XAConnection</CODE> with the default user identity. - * The connection is created in stopped mode. No messages + * The connection is created in stopped mode. No messages * will be delivered until the <code>Connection.start</code> method * is explicitly called. * * @return a newly created <CODE>XAConnection</CODE> * - * @exception JMSException if the JMS provider fails to create an XA + * @exception JMSException if the JMS provider fails to create an XA * connection due to some internal error. - * @exception JMSSecurityException if client authentication fails due to + * @exception JMSSecurityException if client authentication fails due to * an invalid user name or password. - * - * @since 1.1 + * + * @since 1.1 */ XAConnection createXAConnection() throws JMSException; /** Creates an XA connection with the specified user identity. - * The connection is created in stopped mode. No messages + * The connection is created in stopped mode. No messages * will be delivered until the <code>Connection.start</code> method * is explicitly called. - * + * * @param userName the caller's user name * @param password the caller's password - * + * * @return a newly created XA connection * - * @exception JMSException if the JMS provider fails to create an XA + * @exception JMSException if the JMS provider fails to create an XA * connection due to some internal error. - * @exception JMSSecurityException if client authentication fails due to + * @exception JMSSecurityException if client authentication fails due to * an invalid user name or password. * - * @since 1.1 + * @since 1.1 */ XAConnection createXAConnection(String userName, String password) throws JMSException; diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAQueueConnection.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAQueueConnection.java index b6e485272d..51e36be5e8 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAQueueConnection.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAQueueConnection.java @@ -47,10 +47,10 @@ public interface XAQueueConnection extends XAConnection, QueueConnection { /** Creates an <CODE>XAQueueSession</CODE> object. - * + * * @return a newly created <CODE>XAQueueSession</CODE> - * - * @exception JMSException if the <CODE>XAQueueConnection</CODE> object + * + * @exception JMSException if the <CODE>XAQueueConnection</CODE> object * fails to create an XA queue session due to some * internal error. */ @@ -61,10 +61,10 @@ public interface XAQueueConnection extends XAConnection, QueueConnection * * @param transacted usage undefined * @param acknowledgeMode usage undefined - * + * * @return a newly created <CODE>XAQueueSession</CODE> - * - * @exception JMSException if the <CODE>XAQueueConnection</CODE> object + * + * @exception JMSException if the <CODE>XAQueueConnection</CODE> object * fails to create an XA queue session due to some * internal error. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAQueueConnectionFactory.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAQueueConnectionFactory.java index d7fe335724..4bdbadc59c 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAQueueConnectionFactory.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAQueueConnectionFactory.java @@ -46,33 +46,33 @@ public interface XAQueueConnectionFactory extends XAConnectionFactory, QueueConn { /** Creates an XA queue connection with the default user identity. - * The connection is created in stopped mode. No messages + * The connection is created in stopped mode. No messages * will be delivered until the <code>Connection.start</code> method * is explicitly called. * * @return a newly created XA queue connection * - * @exception JMSException if the JMS provider fails to create an XA queue + * @exception JMSException if the JMS provider fails to create an XA queue * connection due to some internal error. - * @exception JMSSecurityException if client authentication fails due to + * @exception JMSSecurityException if client authentication fails due to * an invalid user name or password. */ XAQueueConnection createXAQueueConnection() throws JMSException; /** Creates an XA queue connection with the specified user identity. - * The connection is created in stopped mode. No messages + * The connection is created in stopped mode. No messages * will be delivered until the <code>Connection.start</code> method * is explicitly called. - * + * * @param userName the caller's user name * @param password the caller's password - * + * * @return a newly created XA queue connection * - * @exception JMSException if the JMS provider fails to create an XA queue + * @exception JMSException if the JMS provider fails to create an XA queue * connection due to some internal error. - * @exception JMSSecurityException if client authentication fails due to + * @exception JMSSecurityException if client authentication fails due to * an invalid user name or password. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAQueueSession.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAQueueSession.java index e35dbf679d..13a6ee889e 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAQueueSession.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XAQueueSession.java @@ -47,9 +47,9 @@ public interface XAQueueSession extends XASession { /** Gets the queue session associated with this <CODE>XAQueueSession</CODE>. - * + * * @return the queue session object - * + * * @exception JMSException if an internal error occurs. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XASession.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XASession.java index 38679b627e..3e317cb635 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XASession.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XASession.java @@ -68,9 +68,9 @@ public interface XASession extends Session { /** Gets the session associated with this <CODE>XASession</CODE>. - * + * * @return the session object - * + * * @exception JMSException if an internal error occurs. * * @since 1.1 @@ -86,31 +86,31 @@ public interface XASession extends Session XAResource getXAResource(); /** Indicates whether the session is in transacted mode. - * + * * @return true - * - * @exception JMSException if the JMS provider fails to return the + * + * @exception JMSException if the JMS provider fails to return the * transaction mode due to some internal error. */ boolean getTransacted() throws JMSException; - /** Throws a <CODE>TransactionInProgressException</CODE>, since it should + /** Throws a <CODE>TransactionInProgressException</CODE>, since it should * not be called for an <CODE>XASession</CODE> object. * - * @exception TransactionInProgressException if the method is called on + * @exception TransactionInProgressException if the method is called on * an <CODE>XASession</CODE>. - * + * */ void commit() throws JMSException; - /** Throws a <CODE>TransactionInProgressException</CODE>, since it should + /** Throws a <CODE>TransactionInProgressException</CODE>, since it should * not be called for an <CODE>XASession</CODE> object. * - * @exception TransactionInProgressException if the method is called on + * @exception TransactionInProgressException if the method is called on * an <CODE>XASession</CODE>. - * + * */ void rollback() throws JMSException; diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XATopicConnection.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XATopicConnection.java index e05efb13f7..63753bd8fc 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XATopicConnection.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XATopicConnection.java @@ -46,11 +46,11 @@ public interface XATopicConnection extends XAConnection, TopicConnection { /** Creates an <CODE>XATopicSession</CODE> object. - * + * * @return a newly created XA topic session - * + * * @exception JMSException if the <CODE>XATopicConnection</CODE> object - * fails to create an XA topic session due to some + * fails to create an XA topic session due to some * internal error. */ @@ -60,11 +60,11 @@ public interface XATopicConnection extends XAConnection, TopicConnection * * @param transacted usage undefined * @param acknowledgeMode usage undefined - * + * * @return a newly created XA topic session - * + * * @exception JMSException if the <CODE>XATopicConnection</CODE> object - * fails to create an XA topic session due to some + * fails to create an XA topic session due to some * internal error. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XATopicConnectionFactory.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XATopicConnectionFactory.java index 3259498fb0..ba6d5c1c3e 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XATopicConnectionFactory.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XATopicConnectionFactory.java @@ -46,33 +46,33 @@ public interface XATopicConnectionFactory extends XAConnectionFactory, TopicConn { /** Creates an XA topic connection with the default user identity. - * The connection is created in stopped mode. No messages + * The connection is created in stopped mode. No messages * will be delivered until the <code>Connection.start</code> method * is explicitly called. * * @return a newly created XA topic connection * - * @exception JMSException if the JMS provider fails to create an XA topic + * @exception JMSException if the JMS provider fails to create an XA topic * connection due to some internal error. - * @exception JMSSecurityException if client authentication fails due to + * @exception JMSSecurityException if client authentication fails due to * an invalid user name or password. */ XATopicConnection createXATopicConnection() throws JMSException; /** Creates an XA topic connection with the specified user identity. - * The connection is created in stopped mode. No messages + * The connection is created in stopped mode. No messages * will be delivered until the <code>Connection.start</code> method * is explicitly called. - * + * * @param userName the caller's user name * @param password the caller's password - * + * * @return a newly created XA topic connection * - * @exception JMSException if the JMS provider fails to create an XA topic + * @exception JMSException if the JMS provider fails to create an XA topic * connection due to some internal error. - * @exception JMSSecurityException if client authentication fails due to + * @exception JMSSecurityException if client authentication fails due to * an invalid user name or password. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XATopicSession.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XATopicSession.java index c395d56d57..0377aed7f3 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XATopicSession.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.api/src/javax/jms/XATopicSession.java @@ -47,9 +47,9 @@ public interface XATopicSession extends XASession { /** Gets the topic session associated with this <CODE>XATopicSession</CODE>. - * + * * @return the topic session object - * + * * @exception JMSException if an internal error occurs. */ diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.server/META-INF/MANIFEST.MF b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.server/META-INF/MANIFEST.MF index 33844b8959..2d6d9a501f 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.server/META-INF/MANIFEST.MF +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.server/META-INF/MANIFEST.MF @@ -1,7 +1,7 @@ Manifest-Version: 1.0 Bundle-ManifestVersion: 2 Bundle-SymbolicName: org.eclipse.net4j.jms.server -Bundle-Version: 4.0.400.qualifier +Bundle-Version: 4.0.500.qualifier Bundle-Name: %pluginName Bundle-Vendor: %providerName Bundle-Localization: plugin @@ -12,10 +12,10 @@ Bundle-ClassPath: . Require-Bundle: org.eclipse.core.runtime;bundle-version="[3.5.0,4.0.0)", org.eclipse.net4j.jms;bundle-version="[4.0.0,5.0.0)";visibility:=reexport Import-Package: javax.jms;version="[1.1.0,2.0.0)" -Export-Package: org.eclipse.net4j.jms.internal.server;version="4.0.400";x-friends:="org.eclipse.net4j.jms.server.jdbc,org.eclipse.net4j.jms.tests", - org.eclipse.net4j.jms.internal.server.bundle;version="4.0.400";x-internal:=true, - org.eclipse.net4j.jms.internal.server.messages;version="4.0.400";x-internal:=true, - org.eclipse.net4j.jms.internal.server.protocol;version="4.0.400";x-friends:="org.eclipse.net4j.jms.server.jdbc,org.eclipse.net4j.jms.tests", - org.eclipse.net4j.jms.internal.server.protocol.admin;version="4.0.400";x-friends:="org.eclipse.net4j.jms.server.jdbc,org.eclipse.net4j.jms.tests", - org.eclipse.net4j.jms.internal.server.store;version="4.0.400";x-friends:="org.eclipse.net4j.jms.server.jdbc,org.eclipse.net4j.jms.tests", - org.eclipse.net4j.jms.server;version="4.0.400" +Export-Package: org.eclipse.net4j.jms.internal.server;version="4.0.500";x-friends:="org.eclipse.net4j.jms.server.jdbc,org.eclipse.net4j.jms.tests", + org.eclipse.net4j.jms.internal.server.bundle;version="4.0.500";x-internal:=true, + org.eclipse.net4j.jms.internal.server.messages;version="4.0.500";x-internal:=true, + org.eclipse.net4j.jms.internal.server.protocol;version="4.0.500";x-friends:="org.eclipse.net4j.jms.server.jdbc,org.eclipse.net4j.jms.tests", + org.eclipse.net4j.jms.internal.server.protocol.admin;version="4.0.500";x-friends:="org.eclipse.net4j.jms.server.jdbc,org.eclipse.net4j.jms.tests", + org.eclipse.net4j.jms.internal.server.store;version="4.0.500";x-friends:="org.eclipse.net4j.jms.server.jdbc,org.eclipse.net4j.jms.tests", + org.eclipse.net4j.jms.server;version="4.0.500" diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.server/src/org/eclipse/net4j/jms/internal/server/Server.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.server/src/org/eclipse/net4j/jms/internal/server/Server.java index 187bdcfd2b..7c9743e513 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.server/src/org/eclipse/net4j/jms/internal/server/Server.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms.server/src/org/eclipse/net4j/jms/internal/server/Server.java @@ -37,7 +37,7 @@ import java.util.concurrent.ConcurrentMap; /** * @author Eike Stepper */ -public class Server extends QueueWorker<MessageImpl>implements IServer +public class Server extends QueueWorker<MessageImpl> implements IServer { public static final Server INSTANCE = new Server(); diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/META-INF/MANIFEST.MF b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/META-INF/MANIFEST.MF index 5fd77371d5..c34c009d2d 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/META-INF/MANIFEST.MF +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/META-INF/MANIFEST.MF @@ -1,7 +1,7 @@ Manifest-Version: 1.0 Bundle-ManifestVersion: 2 Bundle-SymbolicName: org.eclipse.net4j.jms -Bundle-Version: 4.0.400.qualifier +Bundle-Version: 4.0.500.qualifier Bundle-Name: %pluginName Bundle-Vendor: %providerName Bundle-Localization: plugin @@ -12,9 +12,9 @@ Bundle-ClassPath: . Require-Bundle: org.eclipse.core.runtime;bundle-version="[3.5.0,4.0.0)", org.eclipse.net4j;bundle-version="[4.0.0,5.0.0)";visibility:=reexport Import-Package: javax.jms;version="[1.1.0,2.0.0)" -Export-Package: org.eclipse.net4j.internal.jms;version="4.0.400", - org.eclipse.net4j.internal.jms.bundle;version="4.0.400";x-internal:=true, - org.eclipse.net4j.internal.jms.messages;version="4.0.400";x-internal:=true, - org.eclipse.net4j.internal.jms.protocol;version="4.0.400", - org.eclipse.net4j.internal.jms.util;version="4.0.400", - org.eclipse.net4j.jms;version="4.0.400" +Export-Package: org.eclipse.net4j.internal.jms;version="4.0.500", + org.eclipse.net4j.internal.jms.bundle;version="4.0.500";x-internal:=true, + org.eclipse.net4j.internal.jms.messages;version="4.0.500";x-internal:=true, + org.eclipse.net4j.internal.jms.protocol;version="4.0.500", + org.eclipse.net4j.internal.jms.util;version="4.0.500", + org.eclipse.net4j.jms;version="4.0.500" diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/src/org/eclipse/net4j/internal/jms/ConnectionImpl.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/src/org/eclipse/net4j/internal/jms/ConnectionImpl.java index cf1b2d7037..721d09a021 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/src/org/eclipse/net4j/internal/jms/ConnectionImpl.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/src/org/eclipse/net4j/internal/jms/ConnectionImpl.java @@ -44,7 +44,7 @@ import javax.jms.Topic; import java.util.ArrayList; import java.util.List; -public class ConnectionImpl extends Container<Session>implements Connection +public class ConnectionImpl extends Container<Session> implements Connection { private String connectorType; diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/src/org/eclipse/net4j/internal/jms/MessageImpl.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/src/org/eclipse/net4j/internal/jms/MessageImpl.java index ea6017cf88..30db6227bc 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/src/org/eclipse/net4j/internal/jms/MessageImpl.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/src/org/eclipse/net4j/internal/jms/MessageImpl.java @@ -33,7 +33,7 @@ import java.util.Map.Entry; public class MessageImpl implements Message, Comparable<MessageImpl> { private static final String[] KEYWORDS = { "and", "between", "escape", "in", "is", "like", "false", "null", "or", //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$ //$NON-NLS-4$ //$NON-NLS-5$ //$NON-NLS-6$ //$NON-NLS-7$ //$NON-NLS-8$ //$NON-NLS-9$ - "not", "true" }; //$NON-NLS-1$ //$NON-NLS-2$ + "not", "true" }; //$NON-NLS-1$ //$NON-NLS-2$ private Map<String, Object> properties = new HashMap<String, Object>(); diff --git a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/src/org/eclipse/net4j/internal/jms/SessionImpl.java b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/src/org/eclipse/net4j/internal/jms/SessionImpl.java index c307afd452..e3e4bd0509 100644 --- a/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/src/org/eclipse/net4j/internal/jms/SessionImpl.java +++ b/plugins/org.eclipse.net4j.examples.installer/examples/org.eclipse.net4j.jms/src/org/eclipse/net4j/internal/jms/SessionImpl.java @@ -54,7 +54,7 @@ import java.util.List; import java.util.Map; import java.util.Set; -public class SessionImpl extends QueueWorker<MessageConsumerImpl>implements Session +public class SessionImpl extends QueueWorker<MessageConsumerImpl> implements Session { private ConnectionImpl connection; |