You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by gd...@apache.org on 2005/07/11 17:49:55 UTC
svn commit: r210150 [10/35] - in /webservices/axis/trunk/java: ./ etc/
modules/addressing/
modules/addressing/src/org/apache/axis2/handlers/addressing/
modules/addressing/test-resources/
modules/addressing/test/org/apache/axis2/handlers/addressing/ mod...
Modified: webservices/axis/trunk/java/modules/core/test/org/apache/axis2/transport/http/HTTPTransportUtilTest.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/core/test/org/apache/axis2/transport/http/HTTPTransportUtilTest.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/core/test/org/apache/axis2/transport/http/HTTPTransportUtilTest.java (original)
+++ webservices/axis/trunk/java/modules/core/test/org/apache/axis2/transport/http/HTTPTransportUtilTest.java Mon Jul 11 08:49:30 2005
@@ -27,7 +27,7 @@
* author : Eran Chinthaka (chinthaka@apache.org)
*/
-public class HTTPTransportUtilTest extends TestCase{
+public class HTTPTransportUtilTest extends TestCase {
private HTTPTransportUtils httpTransportUtils;
private SOAPFactory factory;
@@ -37,7 +37,7 @@
factory = OMAbstractFactory.getSOAP11Factory();
}
- public void testOptimizedEnvelope(){
+ public void testOptimizedEnvelope() {
SOAPEnvelope soapEnvelope = factory.getDefaultEnvelope();
OMElement element = factory.createOMElement(new QName("MyFirstBodyElement"), soapEnvelope.getBody());
@@ -47,7 +47,7 @@
assertTrue("optmization check has not performed correctly in SOAPEnvelope", httpTransportUtils.checkEnvelopeForOptimise(soapEnvelope));
}
- public void testNonOptimizedEnvelope(){
+ public void testNonOptimizedEnvelope() {
SOAPEnvelope soapEnvelope = factory.getDefaultEnvelope();
OMElement element = factory.createOMElement(new QName("MyFirstBodyElement"), soapEnvelope.getBody());
@@ -56,7 +56,6 @@
element11.addChild(optimizedText);
assertFalse("optmization check has not performed correctly in SOAPEnvelope", httpTransportUtils.checkEnvelopeForOptimise(soapEnvelope));
}
-
}
Modified: webservices/axis/trunk/java/modules/core/test/org/apache/axis2/transport/tcp/TCPTransportTest.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/core/test/org/apache/axis2/transport/tcp/TCPTransportTest.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/core/test/org/apache/axis2/transport/tcp/TCPTransportTest.java (original)
+++ webservices/axis/trunk/java/modules/core/test/org/apache/axis2/transport/tcp/TCPTransportTest.java Mon Jul 11 08:49:30 2005
@@ -55,7 +55,7 @@
//
// msgctx.setEnvelope(createSOAPEnvelope(Thread.currentThread().getContextClassLoader().getResourceAsStream("org/apache/axis2/transport/sample.xml")));
// ts.invoke(msgctx);
-
+
}
@@ -70,7 +70,7 @@
public SOAPEnvelope createSOAPEnvelope(InputStream in) throws AxisFault {
try {
XMLStreamReader xmlreader =
- XMLInputFactory.newInstance().createXMLStreamReader(in);
+ XMLInputFactory.newInstance().createXMLStreamReader(in);
StAXBuilder builder = new StAXSOAPModelBuilder(xmlreader);
return (SOAPEnvelope) builder.getDocumentElement();
} catch (Exception e) {
Modified: webservices/axis/trunk/java/modules/saaj/project.xml
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/project.xml?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/project.xml (original)
+++ webservices/axis/trunk/java/modules/saaj/project.xml Mon Jul 11 08:49:30 2005
@@ -23,61 +23,61 @@
<id>saaj-impl</id>
<name>saaj-impl</name>
<description>Total SAAJ implementation</description>
-
- <build>
+
+ <build>
<nagEmailAddress>axis-dev@ws.apache.org</nagEmailAddress>
<sourceDirectory>src</sourceDirectory>
<unitTestSourceDirectory>test</unitTestSourceDirectory>
-
- <!--<sourceModifications>
- <sourceModification>
- <className>javax.activation.DataHandler</className>
- <excludes>
- <exclude>javax/xml/soap/**.java</exclude>
- <exclude>org/apache/axis2/saaj/**.java</exclude>
- </excludes>
- </sourceModification>
- </sourceModifications> -->
-
+
+ <!--<sourceModifications>
+ <sourceModification>
+ <className>javax.activation.DataHandler</className>
+ <excludes>
+ <exclude>javax/xml/soap/**.java</exclude>
+ <exclude>org/apache/axis2/saaj/**.java</exclude>
+ </excludes>
+ </sourceModification>
+ </sourceModifications> -->
+
<unitTest>
- <includes>
- <include>**/*Test.java</include>
- </includes>
-
- <resources>
- <resource>
- <directory>${basedir}/test-resources</directory>
- </resource>
- <resource>
- <directory>conf</directory>
- <includes>
- <include>**/*.properties</include>
- </includes>
- </resource>
- <resource>
- <directory>src</directory>
- <includes>
- <include>**/*.properties</include>
- <include>**/*.xml</include>
- </includes>
- </resource>
- </resources>
- </unitTest>
-
- <resources>
- <resource>
- <directory>conf</directory>
<includes>
- <include>**/*.properties</include>
+ <include>**/*Test.java</include>
</includes>
- </resource>
- <resource>
- <directory>src</directory>
- <includes>
- <include>**/*.properties</include>
- <include>**/*.xml</include>
- </includes>
- </resource>
+
+ <resources>
+ <resource>
+ <directory>${basedir}/test-resources</directory>
+ </resource>
+ <resource>
+ <directory>conf</directory>
+ <includes>
+ <include>**/*.properties</include>
+ </includes>
+ </resource>
+ <resource>
+ <directory>src</directory>
+ <includes>
+ <include>**/*.properties</include>
+ <include>**/*.xml</include>
+ </includes>
+ </resource>
+ </resources>
+ </unitTest>
+
+ <resources>
+ <resource>
+ <directory>conf</directory>
+ <includes>
+ <include>**/*.properties</include>
+ </includes>
+ </resource>
+ <resource>
+ <directory>src</directory>
+ <includes>
+ <include>**/*.properties</include>
+ <include>**/*.xml</include>
+ </includes>
+ </resource>
</resources>
</build>
@@ -86,63 +86,63 @@
<groupId>axis</groupId>
<artifactId>axis2-xml</artifactId>
<version>${pom.currentVersion}</version>
- </dependency>
-
+ </dependency>
+
<dependency>
<groupId>axis</groupId>
<artifactId>axis2-core</artifactId>
<version>${pom.currentVersion}</version>
</dependency>
<!-- external JARs -->
-
+
<dependency>
- <groupId>commons-logging</groupId>
- <artifactId>commons-logging</artifactId>
- <version>1.0.3</version>
- <properties>
- <module>true</module>
- </properties>
+ <groupId>commons-logging</groupId>
+ <artifactId>commons-logging</artifactId>
+ <version>1.0.3</version>
+ <properties>
+ <module>true</module>
+ </properties>
</dependency>
- <dependency>
+ <dependency>
<groupId>stax</groupId>
<artifactId>stax</artifactId>
<version>1.1.1-dev</version>
<properties>
<module>true</module>
</properties>
- <url>http://dist.codehaus.org/stax/jars/</url>
+ <url>http://dist.codehaus.org/stax/jars/</url>
</dependency>
-
+
<dependency>
- <groupId>stax</groupId>
- <artifactId>stax-api</artifactId>
- <version>1.0</version>
- <properties>
- <module>true</module>
- </properties>
- <url>http://dist.codehaus.org/stax/jars/</url>
- </dependency>
-
- <dependency>
- <groupId>geronimo-spec</groupId>
- <artifactId>geronimo-spec-activation</artifactId>
- <version>1.0.2-rc3</version>
- <properties>
- <module>true</module>
- </properties>
- </dependency>
- <dependency>
- <groupId>log4j</groupId>
- <artifactId>log4j</artifactId>
- <version>1.2.8</version>
- <properties>
- <module>true</module>
- </properties>
- <url>http://dist.codehaus.org/stax/jars/</url>
- </dependency>
-
- </dependencies>
-
- <reports/>
+ <groupId>stax</groupId>
+ <artifactId>stax-api</artifactId>
+ <version>1.0</version>
+ <properties>
+ <module>true</module>
+ </properties>
+ <url>http://dist.codehaus.org/stax/jars/</url>
+ </dependency>
+
+ <dependency>
+ <groupId>geronimo-spec</groupId>
+ <artifactId>geronimo-spec-activation</artifactId>
+ <version>1.0.2-rc3</version>
+ <properties>
+ <module>true</module>
+ </properties>
+ </dependency>
+ <dependency>
+ <groupId>log4j</groupId>
+ <artifactId>log4j</artifactId>
+ <version>1.2.8</version>
+ <properties>
+ <module>true</module>
+ </properties>
+ <url>http://dist.codehaus.org/stax/jars/</url>
+ </dependency>
+
+ </dependencies>
+
+ <reports/>
</project>
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/namespace/QName.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/namespace/QName.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/namespace/QName.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/namespace/QName.java Mon Jul 11 08:49:30 2005
@@ -23,7 +23,7 @@
* <code>QName</code> class represents the value of a qualified name
* as specified in <a href="http://www.w3.org/TR/xmlschema-2/#QName">XML
* Schema Part2: Datatypes specification</a>.
- * <p>
+ * <p/>
* The value of a QName contains a <b>namespaceURI</b>, a <b>localPart</b> and a
* <b>prefix</b>. The localPart provides the local part of the qualified name.
* The namespaceURI is a URI reference identifying the namespace.
@@ -32,7 +32,9 @@
*/
public class QName implements Serializable {
- /** Comment/shared empty <code>String</code>. */
+ /**
+ * Comment/shared empty <code>String</code>.
+ */
private static final String emptyString = "".intern();
private String namespaceURI;
@@ -54,7 +56,7 @@
* Constructor for the QName.
*
* @param namespaceURI namespace URI for the QName
- * @param localPart local part of the QName.
+ * @param localPart local part of the QName.
*/
public QName(String namespaceURI, String localPart) {
this(namespaceURI, localPart, emptyString);
@@ -64,8 +66,8 @@
* Constructor for the QName.
*
* @param namespaceURI Namespace URI for the QName
- * @param localPart Local part of the QName.
- * @param prefix Prefix of the QName.
+ * @param localPart Local part of the QName.
+ * @param prefix Prefix of the QName.
*/
public QName(String namespaceURI, String localPart, String prefix) {
this.namespaceURI = (namespaceURI == null)
@@ -114,7 +116,7 @@
/**
* Returns a string representation of this QName.
*
- * @return a string representation of the QName
+ * @return a string representation of the QName
*/
public String toString() {
@@ -125,22 +127,21 @@
/**
* Tests this QName for equality with another object.
- * <p>
+ * <p/>
* If the given object is not a QName or is null then this method
* returns <tt>false</tt>.
- * <p>
+ * <p/>
* For two QNames to be considered equal requires that both
* localPart and namespaceURI must be equal. This method uses
* <code>String.equals</code> to check equality of localPart
* and namespaceURI. Any class that extends QName is required
* to satisfy this equality contract.
- * <p>
+ * <p/>
* This method satisfies the general contract of the <code>Object.equals</code> method.
*
* @param obj the reference object with which to compare
- *
* @return <code>true</code> if the given object is identical to this
- * QName: <code>false</code> otherwise.
+ * QName: <code>false</code> otherwise.
*/
public boolean equals(Object obj) {
@@ -162,19 +163,20 @@
/**
* Returns a QName holding the value of the specified String.
- * <p>
+ * <p/>
* The string must be in the form returned by the QName.toString()
* method, i.e. "{namespaceURI}localPart", with the "{namespaceURI}"
* part being optional.
- * <p>
+ * <p/>
* This method doesn't do a full validation of the resulting QName.
* In particular, it doesn't check that the resulting namespace URI
* is a legal URI (per RFC 2396 and RFC 2732), nor that the resulting
* local part is a legal NCName per the XML Namespaces specification.
*
* @param s the string to be parsed
- * @throws java.lang.IllegalArgumentException If the specified String cannot be parsed as a QName
* @return QName corresponding to the given String
+ * @throws java.lang.IllegalArgumentException
+ * If the specified String cannot be parsed as a QName
*/
public static QName valueOf(String s) {
@@ -213,10 +215,11 @@
/**
* Ensure that deserialization properly interns the results.
+ *
* @param in the ObjectInputStream to be read
- * @throws IOException if there was a failure in the object input stream
- * @throws ClassNotFoundException if the class of any sub-objects could
- * not be found
+ * @throws IOException if there was a failure in the object input stream
+ * @throws ClassNotFoundException if the class of any sub-objects could
+ * not be found
*/
private void readObject(ObjectInputStream in) throws
IOException, ClassNotFoundException {
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/AttachmentPart.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/AttachmentPart.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/AttachmentPart.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/AttachmentPart.java Mon Jul 11 08:49:30 2005
@@ -20,118 +20,122 @@
/**
* <P>A single attachment to a <CODE>SOAPMessage</CODE> object. A
- * <CODE>SOAPMessage</CODE> object may contain zero, one, or many
- * <CODE>AttachmentPart</CODE> objects. Each <CODE>
- * AttachmentPart</CODE> object consists of two parts,
- * application-specific content and associated MIME headers. The
- * MIME headers consists of name/value pairs that can be used to
- * identify and describe the content.</P>
- *
- * <P>An <CODE>AttachmentPart</CODE> object must conform to
- * certain standards.</P>
- *
- * <OL>
- * <LI>It must conform to <A href=
- * "http://www.ietf.org/rfc/rfc2045.txt">MIME [RFC2045]
- * standards</A></LI>
- *
- * <LI>It MUST contain content</LI>
- *
- * <LI>
- * The header portion MUST include the following header:
- *
- * <UL>
- * <LI>
- * <CODE>Content-Type</CODE><BR>
- * This header identifies the type of data in the content
- * of an <CODE>AttachmentPart</CODE> object and MUST
- * conform to [RFC2045]. The following is an example of a
- * Content-Type header:
+ * <CODE>SOAPMessage</CODE> object may contain zero, one, or many
+ * <CODE>AttachmentPart</CODE> objects. Each <CODE>
+ * AttachmentPart</CODE> object consists of two parts,
+ * application-specific content and associated MIME headers. The
+ * MIME headers consists of name/value pairs that can be used to
+ * identify and describe the content.</P>
+ * <p/>
+ * <P>An <CODE>AttachmentPart</CODE> object must conform to
+ * certain standards.</P>
+ * <p/>
+ * <OL>
+ * <LI>It must conform to <A href=
+ * "http://www.ietf.org/rfc/rfc2045.txt">MIME [RFC2045]
+ * standards</A></LI>
+ * <p/>
+ * <LI>It MUST contain content</LI>
+ * <p/>
+ * <LI>
+ * The header portion MUST include the following header:
+ * <p/>
+ * <UL>
+ * <LI>
+ * <CODE>Content-Type</CODE><BR>
+ * This header identifies the type of data in the content
+ * of an <CODE>AttachmentPart</CODE> object and MUST
+ * conform to [RFC2045]. The following is an example of a
+ * Content-Type header:
* <PRE>
- * Content-Type: application/xml
- *
+ * Content-Type: application/xml
+ * <p/>
* </PRE>
- * The following line of code, in which <CODE>ap</CODE> is
- * an <CODE>AttachmentPart</CODE> object, sets the header
- * shown in the previous example.
+ * The following line of code, in which <CODE>ap</CODE> is
+ * an <CODE>AttachmentPart</CODE> object, sets the header
+ * shown in the previous example.
* <PRE>
- * ap.setMimeHeader("Content-Type", "application/xml");
- *
+ * ap.setMimeHeader("Content-Type", "application/xml");
+ * <p/>
* </PRE>
- *
- * <P></P>
- * </LI>
- * </UL>
- * </LI>
- * </OL>
- *
- * <P>There are no restrictions on the content portion of an
- * <CODE>AttachmentPart</CODE> object. The content may be anything
- * from a simple plain text object to a complex XML document or
- * image file.</P>
- *
- * <P>An <CODE>AttachmentPart</CODE> object is created with the
- * method <CODE>SOAPMessage.createAttachmentPart</CODE>. After
- * setting its MIME headers, the <CODE>AttachmentPart</CODE>
- * object is added to the message that created it with the method
- * <CODE>SOAPMessage.addAttachmentPart</CODE>.</P>
- *
- * <P>The following code fragment, in which <CODE>m</CODE> is a
- * <CODE>SOAPMessage</CODE> object and <CODE>contentStringl</CODE>
- * is a <CODE>String</CODE>, creates an instance of <CODE>
- * AttachmentPart</CODE>, sets the <CODE>AttachmentPart</CODE>
- * object with some content and header information, and adds the
- * <CODE>AttachmentPart</CODE> object to the <CODE>
- * SOAPMessage</CODE> object.</P>
+ * <p/>
+ * <P></P>
+ * </LI>
+ * </UL>
+ * </LI>
+ * </OL>
+ * <p/>
+ * <P>There are no restrictions on the content portion of an
+ * <CODE>AttachmentPart</CODE> object. The content may be anything
+ * from a simple plain text object to a complex XML document or
+ * image file.</P>
+ * <p/>
+ * <P>An <CODE>AttachmentPart</CODE> object is created with the
+ * method <CODE>SOAPMessage.createAttachmentPart</CODE>. After
+ * setting its MIME headers, the <CODE>AttachmentPart</CODE>
+ * object is added to the message that created it with the method
+ * <CODE>SOAPMessage.addAttachmentPart</CODE>.</P>
+ * <p/>
+ * <P>The following code fragment, in which <CODE>m</CODE> is a
+ * <CODE>SOAPMessage</CODE> object and <CODE>contentStringl</CODE>
+ * is a <CODE>String</CODE>, creates an instance of <CODE>
+ * AttachmentPart</CODE>, sets the <CODE>AttachmentPart</CODE>
+ * object with some content and header information, and adds the
+ * <CODE>AttachmentPart</CODE> object to the <CODE>
+ * SOAPMessage</CODE> object.</P>
* <PRE>
- * AttachmentPart ap1 = m.createAttachmentPart();
- * ap1.setContent(contentString1, "text/plain");
- * m.addAttachmentPart(ap1);
+ * AttachmentPart ap1 = m.createAttachmentPart();
+ * ap1.setContent(contentString1, "text/plain");
+ * m.addAttachmentPart(ap1);
* </PRE>
- *
- * <P>The following code fragment creates and adds a second <CODE>
- * AttachmentPart</CODE> instance to the same message. <CODE>
- * jpegData</CODE> is a binary byte buffer representing the jpeg
- * file.</P>
+ * <p/>
+ * <P>The following code fragment creates and adds a second <CODE>
+ * AttachmentPart</CODE> instance to the same message. <CODE>
+ * jpegData</CODE> is a binary byte buffer representing the jpeg
+ * file.</P>
* <PRE>
- * AttachmentPart ap2 = m.createAttachmentPart();
- * byte[] jpegData = ...;
- * ap2.setContent(new ByteArrayInputStream(jpegData), "image/jpeg");
- * m.addAttachmentPart(ap2);
+ * AttachmentPart ap2 = m.createAttachmentPart();
+ * byte[] jpegData = ...;
+ * ap2.setContent(new ByteArrayInputStream(jpegData), "image/jpeg");
+ * m.addAttachmentPart(ap2);
* </PRE>
- *
- * <P>The <CODE>getContent</CODE> method retrieves the contents
- * and header from an <CODE>AttachmentPart</CODE> object.
- * Depending on the <CODE>DataContentHandler</CODE> objects
- * present, the returned <CODE>Object</CODE> can either be a typed
- * Java object corresponding to the MIME type or an <CODE>
- * InputStream</CODE> object that contains the content as
- * bytes.</P>
+ * <p/>
+ * <P>The <CODE>getContent</CODE> method retrieves the contents
+ * and header from an <CODE>AttachmentPart</CODE> object.
+ * Depending on the <CODE>DataContentHandler</CODE> objects
+ * present, the returned <CODE>Object</CODE> can either be a typed
+ * Java object corresponding to the MIME type or an <CODE>
+ * InputStream</CODE> object that contains the content as
+ * bytes.</P>
* <PRE>
- * String content1 = ap1.getContent();
- * java.io.InputStream content2 = ap2.getContent();
+ * String content1 = ap1.getContent();
+ * java.io.InputStream content2 = ap2.getContent();
* </PRE>
- * The method <CODE>clearContent</CODE> removes all the content
- * from an <CODE>AttachmentPart</CODE> object but does not affect
- * its header information.
+ * The method <CODE>clearContent</CODE> removes all the content
+ * from an <CODE>AttachmentPart</CODE> object but does not affect
+ * its header information.
* <PRE>
- * ap1.clearContent();
+ * ap1.clearContent();
* </PRE>
*/
public abstract class AttachmentPart {
// fixme: should this constructor be protected?
- /** Create a new AttachmentPart. */
- public AttachmentPart() {}
+ /**
+ * Create a new AttachmentPart.
+ */
+ public AttachmentPart() {
+ }
/**
* Returns the number of bytes in this <CODE>
* AttachmentPart</CODE> object.
+ *
* @return the size of this <CODE>AttachmentPart</CODE> object
- * in bytes or -1 if the size cannot be determined
- * @throws SOAPException if the content of this
- * attachment is corrupted of if there was an exception
- * while trying to determine the size.
+ * in bytes or -1 if the size cannot be determined
+ * @throws SOAPException if the content of this
+ * attachment is corrupted of if there was an exception
+ * while trying to determine the size.
*/
public abstract int getSize() throws SOAPException;
@@ -147,14 +151,14 @@
* object. The type of the returned Java object depends on (1) the
* <code>DataContentHandler</code> object that is used to interpret the bytes
* and (2) the <code>Content-Type</code> given in the header.
- * <p>
+ * <p/>
* For the MIME content types "text/plain", "text/html" and "text/xml", the
* <code>DataContentHandler</code> object does the conversions to and
* from the Java types corresponding to the MIME types.
* For other MIME types,the <code>DataContentHandler</code> object
* can return an <code>InputStream</code> object that contains the content data
* as raw bytes.
- * <p>
+ * <p/>
* A JAXM-compliant implementation must, as a minimum, return a
* <code>java.lang.String</code> object corresponding to any content
* stream with a <code>Content-Type</code> value of
@@ -170,10 +174,10 @@
* <code>java.io.InputStream</code> object with the raw bytes.
*
* @return a Java object with the content of this <CODE>
- * AttachmentPart</CODE> object
- * @throws SOAPException if there is no content set
- * into this <CODE>AttachmentPart</CODE> object or if there
- * was a data transformation error
+ * AttachmentPart</CODE> object
+ * @throws SOAPException if there is no content set
+ * into this <CODE>AttachmentPart</CODE> object or if there
+ * was a data transformation error
*/
public abstract Object getContent() throws SOAPException;
@@ -184,15 +188,17 @@
* <CODE>Object</CODE> should correspond to the value given for
* the <CODE>Content-Type</CODE>. This depends on the particular
* set of <CODE>DataContentHandler</CODE> objects in use.
- * @param object the Java object that makes up
- * the content for this attachment part
- * @param contentType the MIME string that
- * specifies the type of the content
- * @throws java.lang.IllegalArgumentException if
- * the contentType does not match the type of the content
- * object, or if there was no <CODE>
- * DataContentHandler</CODE> object for this content
- * object
+ *
+ * @param object the Java object that makes up
+ * the content for this attachment part
+ * @param contentType the MIME string that
+ * specifies the type of the content
+ * @throws java.lang.IllegalArgumentException
+ * if
+ * the contentType does not match the type of the content
+ * object, or if there was no <CODE>
+ * DataContentHandler</CODE> object for this content
+ * object
* @see #getContent() getContent()
*/
public abstract void setContent(Object object, String contentType);
@@ -200,10 +206,11 @@
/**
* Gets the <CODE>DataHandler</CODE> object for this <CODE>
* AttachmentPart</CODE> object.
+ *
* @return the <CODE>DataHandler</CODE> object associated with
- * this <CODE>AttachmentPart</CODE> object
- * @throws SOAPException if there is
- * no data in this <CODE>AttachmentPart</CODE> object
+ * this <CODE>AttachmentPart</CODE> object
+ * @throws SOAPException if there is
+ * no data in this <CODE>AttachmentPart</CODE> object
*/
public abstract DataHandler getDataHandler() throws SOAPException;
@@ -215,20 +222,23 @@
* populated with content, the <CODE>setDataHandler</CODE>
* method can be used to get data from various data sources into
* the message.
- * @param datahandler <CODE>DataHandler</CODE> object to
- * be set
- * @throws java.lang.IllegalArgumentException if
- * there was a problem with the specified <CODE>
- * DataHandler</CODE> object
+ *
+ * @param datahandler <CODE>DataHandler</CODE> object to
+ * be set
+ * @throws java.lang.IllegalArgumentException
+ * if
+ * there was a problem with the specified <CODE>
+ * DataHandler</CODE> object
*/
public abstract void setDataHandler(DataHandler datahandler);
/**
* Gets the value of the MIME header whose name is
* "Content-Id".
- * @return a <CODE>String</CODE> giving the value of the
- * "Content-Id" header or <CODE>null</CODE> if there is
- * none
+ *
+ * @return a <CODE>String</CODE> giving the value of the
+ * "Content-Id" header or <CODE>null</CODE> if there is
+ * none
* @see #setContentId(java.lang.String) setContentId(java.lang.String)
*/
public String getContentId() {
@@ -245,9 +255,10 @@
/**
* Gets the value of the MIME header
* "Content-Location".
- * @return a <CODE>String</CODE> giving the value of the
- * "Content-Location" header or <CODE>null</CODE> if there
- * is none
+ *
+ * @return a <CODE>String</CODE> giving the value of the
+ * "Content-Location" header or <CODE>null</CODE> if there
+ * is none
*/
public String getContentLocation() {
@@ -262,9 +273,10 @@
/**
* Gets the value of the MIME header "Content-Type".
- * @return a <CODE>String</CODE> giving the value of the
- * "Content-Type" header or <CODE>null</CODE> if there is
- * none
+ *
+ * @return a <CODE>String</CODE> giving the value of the
+ * "Content-Type" header or <CODE>null</CODE> if there is
+ * none
*/
public String getContentType() {
@@ -280,11 +292,13 @@
/**
* Sets the MIME header "Content-Id" with the given
* value.
- * @param contentId a <CODE>String</CODE> giving
- * the value of the "Content-Id" header
- * @throws java.lang.IllegalArgumentException if
- * there was a problem with the specified <CODE>
- * contentId</CODE> value
+ *
+ * @param contentId a <CODE>String</CODE> giving
+ * the value of the "Content-Id" header
+ * @throws java.lang.IllegalArgumentException
+ * if
+ * there was a problem with the specified <CODE>
+ * contentId</CODE> value
* @see #getContentId() getContentId()
*/
public void setContentId(String contentId) {
@@ -294,11 +308,13 @@
/**
* Sets the MIME header "Content-Location" with the given
* value.
- * @param contentLocation a <CODE>String</CODE>
- * giving the value of the "Content-Location" header
- * @throws java.lang.IllegalArgumentException if
- * there was a problem with the specified content
- * location
+ *
+ * @param contentLocation a <CODE>String</CODE>
+ * giving the value of the "Content-Location" header
+ * @throws java.lang.IllegalArgumentException
+ * if
+ * there was a problem with the specified content
+ * location
*/
public void setContentLocation(String contentLocation) {
setMimeHeader("Content-Location", contentLocation);
@@ -307,10 +323,12 @@
/**
* Sets the MIME header "Content-Type" with the given
* value.
- * @param contentType a <CODE>String</CODE>
- * giving the value of the "Content-Type" header
- * @throws java.lang.IllegalArgumentException if
- * there was a problem with the specified content type
+ *
+ * @param contentType a <CODE>String</CODE>
+ * giving the value of the "Content-Type" header
+ * @throws java.lang.IllegalArgumentException
+ * if
+ * there was a problem with the specified content type
*/
public void setContentType(String contentType) {
setMimeHeader("Content-Type", contentType);
@@ -318,57 +336,65 @@
/**
* Removes all MIME headers that match the given name.
- * @param header - the string name of the MIME
- * header/s to be removed
+ *
+ * @param header - the string name of the MIME
+ * header/s to be removed
*/
public abstract void removeMimeHeader(String header);
- /** Removes all the MIME header entries. */
+ /**
+ * Removes all the MIME header entries.
+ */
public abstract void removeAllMimeHeaders();
/**
* Gets all the values of the header identified by the given
* <CODE>String</CODE>.
- * @param name the name of the header; example:
- * "Content-Type"
+ *
+ * @param name the name of the header; example:
+ * "Content-Type"
* @return a <CODE>String</CODE> array giving the value for the
- * specified header
+ * specified header
* @see #setMimeHeader(java.lang.String, java.lang.String) setMimeHeader(java.lang.String, java.lang.String)
*/
public abstract String[] getMimeHeader(String name);
/**
* Changes the first header entry that matches the given name
- * to the given value, adding a new header if no existing
- * header matches. This method also removes all matching
- * headers but the first.
- *
- * <P>Note that RFC822 headers can only contain US-ASCII
- * characters.</P>
- * @param name a <CODE>String</CODE> giving the
- * name of the header for which to search
- * @param value a <CODE>String</CODE> giving the
- * value to be set for the header whose name matches the
- * given name
- * @throws java.lang.IllegalArgumentException if
- * there was a problem with the specified mime header name
- * or value
+ * to the given value, adding a new header if no existing
+ * header matches. This method also removes all matching
+ * headers but the first.
+ * <p/>
+ * <P>Note that RFC822 headers can only contain US-ASCII
+ * characters.</P>
+ *
+ * @param name a <CODE>String</CODE> giving the
+ * name of the header for which to search
+ * @param value a <CODE>String</CODE> giving the
+ * value to be set for the header whose name matches the
+ * given name
+ * @throws java.lang.IllegalArgumentException
+ * if
+ * there was a problem with the specified mime header name
+ * or value
*/
public abstract void setMimeHeader(String name, String value);
/**
* Adds a MIME header with the specified name and value to
- * this <CODE>AttachmentPart</CODE> object.
+ * this <CODE>AttachmentPart</CODE> object.
+ * <p/>
+ * <P>Note that RFC822 headers can contain only US-ASCII
+ * characters.</P>
*
- * <P>Note that RFC822 headers can contain only US-ASCII
- * characters.</P>
- * @param name a <CODE>String</CODE> giving the
- * name of the header to be added
- * @param value a <CODE>String</CODE> giving the
- * value of the header to be added
- * @throws java.lang.IllegalArgumentException if
- * there was a problem with the specified mime header name
- * or value
+ * @param name a <CODE>String</CODE> giving the
+ * name of the header to be added
+ * @param value a <CODE>String</CODE> giving the
+ * value of the header to be added
+ * @throws java.lang.IllegalArgumentException
+ * if
+ * there was a problem with the specified mime header name
+ * or value
*/
public abstract void addMimeHeader(String name, String value);
@@ -376,32 +402,35 @@
* Retrieves all the headers for this <CODE>
* AttachmentPart</CODE> object as an iterator over the <CODE>
* MimeHeader</CODE> objects.
- * @return an <CODE>Iterator</CODE> object with all of the Mime
- * headers for this <CODE>AttachmentPart</CODE> object
+ *
+ * @return an <CODE>Iterator</CODE> object with all of the Mime
+ * headers for this <CODE>AttachmentPart</CODE> object
*/
public abstract Iterator getAllMimeHeaders();
/**
* Retrieves all <CODE>MimeHeader</CODE> objects that match
* a name in the given array.
- * @param names a <CODE>String</CODE> array with
- * the name(s) of the MIME headers to be returned
+ *
+ * @param names a <CODE>String</CODE> array with
+ * the name(s) of the MIME headers to be returned
* @return all of the MIME headers that match one of the names
- * in the given array as an <CODE>Iterator</CODE>
- * object
+ * in the given array as an <CODE>Iterator</CODE>
+ * object
*/
public abstract Iterator getMatchingMimeHeaders(String names[]);
/**
* Retrieves all <CODE>MimeHeader</CODE> objects whose name
* does not match a name in the given array.
- * @param names a <CODE>String</CODE> array with
- * the name(s) of the MIME headers not to be returned
+ *
+ * @param names a <CODE>String</CODE> array with
+ * the name(s) of the MIME headers not to be returned
* @return all of the MIME headers in this <CODE>
- * AttachmentPart</CODE> object except those that match one
- * of the names in the given array. The nonmatching MIME
- * headers are returned as an <CODE>Iterator</CODE>
- * object.
+ * AttachmentPart</CODE> object except those that match one
+ * of the names in the given array. The nonmatching MIME
+ * headers are returned as an <CODE>Iterator</CODE>
+ * object.
*/
public abstract Iterator getNonMatchingMimeHeaders(String names[]);
}
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/Detail.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/Detail.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/Detail.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/Detail.java Mon Jul 11 08:49:30 2005
@@ -38,11 +38,11 @@
* The variable <i>se</i>, used to create the <code>Name</code> object,
* is a <code>SOAPEnvelope</code> object.
* <PRE>
- * Detail d = sf.getDetail();
- * Name name = se.createName("GetLastTradePrice", "WOMBAT",
- * "http://www.wombat.org/trader");
- * d.addDetailEntry(name);
- * Iterator it = d.getDetailEntries();
+ * Detail d = sf.getDetail();
+ * Name name = se.createName("GetLastTradePrice", "WOMBAT",
+ * "http://www.wombat.org/trader");
+ * d.addDetailEntry(name);
+ * Iterator it = d.getDetailEntries();
* </PRE>
*/
public interface Detail extends SOAPFaultElement {
@@ -50,16 +50,18 @@
/**
* Creates a new <code>DetailEntry</code> object with the given
* name and adds it to this <code>Detail</code> object.
- * @param name a <code>Name</code> object identifying the new <code>DetailEntry</code> object
+ *
+ * @param name a <code>Name</code> object identifying the new <code>DetailEntry</code> object
* @return DetailEntry.
- * @throws SOAPException thrown when there is a problem in adding a DetailEntry object to this Detail object.
+ * @throws SOAPException thrown when there is a problem in adding a DetailEntry object to this Detail object.
*/
public abstract DetailEntry addDetailEntry(Name name) throws SOAPException;
/**
* Gets a list of the detail entries in this <code>Detail</code> object.
- * @return an <code>Iterator</code> object over the <code>DetailEntry</code>
- * objects in this <code>Detail</code> object
+ *
+ * @return an <code>Iterator</code> object over the <code>DetailEntry</code>
+ * objects in this <code>Detail</code> object
*/
public abstract Iterator getDetailEntries();
}
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/DetailEntry.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/DetailEntry.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/DetailEntry.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/DetailEntry.java Mon Jul 11 08:49:30 2005
@@ -22,4 +22,5 @@
* object that contains it, is application-specific.
* <P>
*/
-public interface DetailEntry extends SOAPElement {}
+public interface DetailEntry extends SOAPElement {
+}
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/FactoryFinder.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/FactoryFinder.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/FactoryFinder.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/FactoryFinder.java Mon Jul 11 08:49:30 2005
@@ -15,12 +15,7 @@
*/
package javax.xml.soap;
-import java.io.BufferedReader;
-import java.io.File;
-import java.io.FileInputStream;
-import java.io.InputStream;
-import java.io.InputStreamReader;
-
+import java.io.*;
import java.util.Properties;
/**
@@ -51,7 +46,8 @@
} else {
try {
factory = classloader.loadClass(factoryClassName);
- } catch (ClassNotFoundException cnfe) {}
+ } catch (ClassNotFoundException cnfe) {
+ }
}
if (factory == null) {
classloader = FactoryFinder.class.getClassLoader();
@@ -80,12 +76,13 @@
if (factoryClassName != null) {
return newInstance(factoryClassName);
}
- } catch (SecurityException securityexception) {}
+ } catch (SecurityException securityexception) {
+ }
try {
String propertiesFileName = System.getProperty("java.home")
- + File.separator + "lib"
- + File.separator + "jaxm.properties";
+ + File.separator + "lib"
+ + File.separator + "jaxm.properties";
File file = new File(propertiesFileName);
if (file.exists()) {
FileInputStream fileInput = new FileInputStream(file);
@@ -95,7 +92,8 @@
String factoryClassName = properties.getProperty(factoryPropertyName);
return newInstance(factoryClassName);
}
- } catch (Exception exception1) {}
+ } catch (Exception exception1) {
+ }
String factoryResource = "META-INF/services/" + factoryPropertyName;
@@ -109,7 +107,8 @@
return newInstance(factoryClassName);
}
}
- } catch (Exception exception2) {}
+ } catch (Exception exception2) {
+ }
if (defaultFactoryClassName == null) {
throw new SOAPException("Provider for " + factoryPropertyName + " cannot be found", null);
@@ -120,7 +119,7 @@
/**
* Returns an input stream for the specified resource.
- *
+ * <p/>
* <p>This method will firstly try
* <code>ClassLoader.getSystemResourceAsStream()</code> then
* the class loader of the current thread with
@@ -128,15 +127,16 @@
* <code>getResourceAsStream()</code> on
* <code>FactoryFinder.class.getClassLoader()</code>.
*
- * @param factoryResource the resource name
- * @return an InputStream that can be used to read that resource, or
- * <code>null</code> if the resource could not be resolved
+ * @param factoryResource the resource name
+ * @return an InputStream that can be used to read that resource, or
+ * <code>null</code> if the resource could not be resolved
*/
private static InputStream getResource(String factoryResource) {
ClassLoader classloader = null;
try {
classloader = Thread.currentThread().getContextClassLoader();
- } catch (SecurityException securityexception) {}
+ } catch (SecurityException securityexception) {
+ }
InputStream inputstream;
if (classloader == null) {
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/MessageFactory.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/MessageFactory.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/MessageFactory.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/MessageFactory.java Mon Jul 11 08:49:30 2005
@@ -20,95 +20,99 @@
/**
* <P>A factory for creating <CODE>SOAPMessage</CODE> objects.</P>
- *
- * <P>A JAXM client performs the following steps to create a
- * message.</P>
- *
- * <UL>
- * <LI>
- * Creates a <CODE>MessageFactory</CODE> object from a <CODE>
- * ProviderConnection</CODE> object (<CODE>con</CODE> in the
- * following line of code). The <CODE>String</CODE> passed to
- * the <CODE>createMessageFactory</CODE> method is the name of
- * of a messaging profile, which must be the URL for the
- * schema.
+ * <p/>
+ * <P>A JAXM client performs the following steps to create a
+ * message.</P>
+ * <p/>
+ * <UL>
+ * <LI>
+ * Creates a <CODE>MessageFactory</CODE> object from a <CODE>
+ * ProviderConnection</CODE> object (<CODE>con</CODE> in the
+ * following line of code). The <CODE>String</CODE> passed to
+ * the <CODE>createMessageFactory</CODE> method is the name of
+ * of a messaging profile, which must be the URL for the
+ * schema.
* <PRE>
- * MessageFactory mf = con.createMessageFactory(schemaURL);
+ * MessageFactory mf = con.createMessageFactory(schemaURL);
* </PRE>
- * </LI>
- *
- * <LI>
- * Calls the method <CODE>createMessage</CODE> on the <CODE>
- * MessageFactory</CODE> object. All messages produced by this
- * <CODE>MessageFactory</CODE> object will have the header
- * information appropriate for the messaging profile that was
- * specified when the <CODE>MessageFactory</CODE> object was
- * created.
+ * </LI>
+ * <p/>
+ * <LI>
+ * Calls the method <CODE>createMessage</CODE> on the <CODE>
+ * MessageFactory</CODE> object. All messages produced by this
+ * <CODE>MessageFactory</CODE> object will have the header
+ * information appropriate for the messaging profile that was
+ * specified when the <CODE>MessageFactory</CODE> object was
+ * created.
* <PRE>
- * SOAPMessage m = mf.createMessage();
+ * SOAPMessage m = mf.createMessage();
* </PRE>
- * </LI>
- * </UL>
- * It is also possible to create a <CODE>MessageFactory</CODE>
- * object using the method <CODE>newInstance</CODE>, as shown in
- * the following line of code.
+ * </LI>
+ * </UL>
+ * It is also possible to create a <CODE>MessageFactory</CODE>
+ * object using the method <CODE>newInstance</CODE>, as shown in
+ * the following line of code.
* <PRE>
- * MessageFactory mf = MessageFactory.newInstance();
+ * MessageFactory mf = MessageFactory.newInstance();
* </PRE>
- * A standalone client (a client that is not running in a
- * container) can use the <CODE>newInstance</CODE> method to
- * create a <CODE>MessageFactory</CODE> object.
- *
- * <P>All <CODE>MessageFactory</CODE> objects, regardless of how
- * they are created, will produce <CODE>SOAPMessage</CODE> objects
- * that have the following elements by default:</P>
- *
- * <UL>
- * <LI>A <CODE>SOAPPart</CODE> object</LI>
- *
- * <LI>A <CODE>SOAPEnvelope</CODE> object</LI>
- *
- * <LI>A <CODE>SOAPBody</CODE> object</LI>
- *
- * <LI>A <CODE>SOAPHeader</CODE> object</LI>
- * </UL>
- * If a <CODE>MessageFactory</CODE> object was created using a
- * <CODE>ProviderConnection</CODE> object, which means that it was
- * initialized with a specified profile, it will produce messages
- * that also come prepopulated with additional entries in the
- * <CODE>SOAPHeader</CODE> object and the <CODE>SOAPBody</CODE>
- * object. The content of a new <CODE>SOAPMessage</CODE> object
- * depends on which of the two <CODE>MessageFactory</CODE> methods
- * is used to create it.
- *
- * <UL>
- * <LI><CODE>createMessage()</CODE> -- message has no
- * content<BR>
- * This is the method clients would normally use to create a
- * request message.</LI>
- *
- * <LI><CODE>createMessage(MimeHeaders,
- * java.io.InputStream)</CODE> -- message has content from the
- * <CODE>InputStream</CODE> object and headers from the <CODE>
- * MimeHeaders</CODE> object<BR>
- * This method can be used internally by a service
- * implementation to create a message that is a response to a
- * request.</LI>
- * </UL>
+ * A standalone client (a client that is not running in a
+ * container) can use the <CODE>newInstance</CODE> method to
+ * create a <CODE>MessageFactory</CODE> object.
+ * <p/>
+ * <P>All <CODE>MessageFactory</CODE> objects, regardless of how
+ * they are created, will produce <CODE>SOAPMessage</CODE> objects
+ * that have the following elements by default:</P>
+ * <p/>
+ * <UL>
+ * <LI>A <CODE>SOAPPart</CODE> object</LI>
+ * <p/>
+ * <LI>A <CODE>SOAPEnvelope</CODE> object</LI>
+ * <p/>
+ * <LI>A <CODE>SOAPBody</CODE> object</LI>
+ * <p/>
+ * <LI>A <CODE>SOAPHeader</CODE> object</LI>
+ * </UL>
+ * If a <CODE>MessageFactory</CODE> object was created using a
+ * <CODE>ProviderConnection</CODE> object, which means that it was
+ * initialized with a specified profile, it will produce messages
+ * that also come prepopulated with additional entries in the
+ * <CODE>SOAPHeader</CODE> object and the <CODE>SOAPBody</CODE>
+ * object. The content of a new <CODE>SOAPMessage</CODE> object
+ * depends on which of the two <CODE>MessageFactory</CODE> methods
+ * is used to create it.
+ * <p/>
+ * <UL>
+ * <LI><CODE>createMessage()</CODE> -- message has no
+ * content<BR>
+ * This is the method clients would normally use to create a
+ * request message.</LI>
+ * <p/>
+ * <LI><CODE>createMessage(MimeHeaders,
+ * java.io.InputStream)</CODE> -- message has content from the
+ * <CODE>InputStream</CODE> object and headers from the <CODE>
+ * MimeHeaders</CODE> object<BR>
+ * This method can be used internally by a service
+ * implementation to create a message that is a response to a
+ * request.</LI>
+ * </UL>
*/
public abstract class MessageFactory {
// fixme: this should be protected as the class is abstract.
- /** Create a new MessageFactory. */
- public MessageFactory() {}
+ /**
+ * Create a new MessageFactory.
+ */
+ public MessageFactory() {
+ }
/**
* Creates a new <CODE>MessageFactory</CODE> object that is
* an instance of the default implementation.
+ *
* @return a new <CODE>MessageFactory</CODE> object
- * @throws SOAPException if there was an error in
- * creating the default implementation of the <CODE>
- * MessageFactory</CODE>
+ * @throws SOAPException if there was an error in
+ * creating the default implementation of the <CODE>
+ * MessageFactory</CODE>
*/
public static MessageFactory newInstance() throws SOAPException {
@@ -116,29 +120,29 @@
return (MessageFactory) FactoryFinder.find(MESSAGE_FACTORY_PROPERTY,
DEFAULT_MESSAGE_FACTORY);
} catch (Exception exception) {
- throw new SOAPException(
- "Unable to create message factory for SOAP: "
- + exception.getMessage());
+ throw new SOAPException("Unable to create message factory for SOAP: "
+ + exception.getMessage());
}
}
/**
* Creates a new <CODE>SOAPMessage</CODE> object with the
- * default <CODE>SOAPPart</CODE>, <CODE>SOAPEnvelope</CODE>,
- * <CODE>SOAPBody</CODE>, and <CODE>SOAPHeader</CODE> objects.
- * Profile-specific message factories can choose to
- * prepopulate the <CODE>SOAPMessage</CODE> object with
- * profile-specific headers.
+ * default <CODE>SOAPPart</CODE>, <CODE>SOAPEnvelope</CODE>,
+ * <CODE>SOAPBody</CODE>, and <CODE>SOAPHeader</CODE> objects.
+ * Profile-specific message factories can choose to
+ * prepopulate the <CODE>SOAPMessage</CODE> object with
+ * profile-specific headers.
+ * <p/>
+ * <P>Content can be added to this message's <CODE>
+ * SOAPPart</CODE> object, and the message can be sent "as is"
+ * when a message containing only a SOAP part is sufficient.
+ * Otherwise, the <CODE>SOAPMessage</CODE> object needs to
+ * create one or more <CODE>AttachmentPart</CODE> objects and
+ * add them to itself. Any content that is not in XML format
+ * must be in an <CODE>AttachmentPart</CODE> object.</P>
*
- * <P>Content can be added to this message's <CODE>
- * SOAPPart</CODE> object, and the message can be sent "as is"
- * when a message containing only a SOAP part is sufficient.
- * Otherwise, the <CODE>SOAPMessage</CODE> object needs to
- * create one or more <CODE>AttachmentPart</CODE> objects and
- * add them to itself. Any content that is not in XML format
- * must be in an <CODE>AttachmentPart</CODE> object.</P>
- * @return a new <CODE>SOAPMessage</CODE> object
- * @throws SOAPException if a SOAP error occurs
+ * @return a new <CODE>SOAPMessage</CODE> object
+ * @throws SOAPException if a SOAP error occurs
*/
public abstract SOAPMessage createMessage() throws SOAPException;
@@ -146,24 +150,24 @@
* Internalizes the contents of the given <CODE>
* InputStream</CODE> object into a new <CODE>SOAPMessage</CODE>
* object and returns the <CODE>SOAPMessage</CODE> object.
- * @param mimeheaders the transport-specific headers
- * passed to the message in a transport-independent fashion
- * for creation of the message
- * @param inputstream the <CODE>InputStream</CODE> object
- * that contains the data for a message
+ *
+ * @param mimeheaders the transport-specific headers
+ * passed to the message in a transport-independent fashion
+ * for creation of the message
+ * @param inputstream the <CODE>InputStream</CODE> object
+ * that contains the data for a message
* @return a new <CODE>SOAPMessage</CODE> object containing the
- * data from the given <CODE>InputStream</CODE> object
- * @throws IOException if there is a
- * problem in reading data from the input stream
- * @throws SOAPException if the message is invalid
+ * data from the given <CODE>InputStream</CODE> object
+ * @throws IOException if there is a
+ * problem in reading data from the input stream
+ * @throws SOAPException if the message is invalid
*/
- public abstract SOAPMessage createMessage(
- MimeHeaders mimeheaders, InputStream inputstream)
+ public abstract SOAPMessage createMessage(MimeHeaders mimeheaders, InputStream inputstream)
throws IOException, SOAPException;
private static final String DEFAULT_MESSAGE_FACTORY =
- "org.apache.axis2.saaj.MessageFactoryImpl";
+ "org.apache.axis2.saaj.MessageFactoryImpl";
private static final String MESSAGE_FACTORY_PROPERTY =
- "javax.xml.soap.MessageFactory";
+ "javax.xml.soap.MessageFactory";
}
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/MimeHeader.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/MimeHeader.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/MimeHeader.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/MimeHeader.java Mon Jul 11 08:49:30 2005
@@ -17,8 +17,9 @@
/**
* An object that stores a MIME header name and its value. One
- * or more <CODE>MimeHeader</CODE> objects may be contained in a
- * <CODE>MimeHeaders</CODE> object.
+ * or more <CODE>MimeHeader</CODE> objects may be contained in a
+ * <CODE>MimeHeaders</CODE> object.
+ *
* @see MimeHeaders MimeHeaders
*/
public class MimeHeader {
@@ -26,20 +27,22 @@
/**
* Constructs a <CODE>MimeHeader</CODE> object initialized
* with the given name and value.
- * @param name a <CODE>String</CODE> giving the
- * name of the header
- * @param value a <CODE>String</CODE> giving the
- * value of the header
+ *
+ * @param name a <CODE>String</CODE> giving the
+ * name of the header
+ * @param value a <CODE>String</CODE> giving the
+ * value of the header
*/
public MimeHeader(String name, String value) {
- this.name = name;
+ this.name = name;
this.value = value;
}
/**
* Returns the name of this <CODE>MimeHeader</CODE>
* object.
- * @return the name of the header as a <CODE>String</CODE>
+ *
+ * @return the name of the header as a <CODE>String</CODE>
*/
public String getName() {
return name;
@@ -48,6 +51,7 @@
/**
* Returns the value of this <CODE>MimeHeader</CODE>
* object.
+ *
* @return the value of the header as a <CODE>String</CODE>
*/
public String getValue() {
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/MimeHeaders.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/MimeHeaders.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/MimeHeaders.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/MimeHeaders.java Mon Jul 11 08:49:30 2005
@@ -20,14 +20,15 @@
/**
* A container for <CODE>MimeHeader</CODE> objects, which
- * represent the MIME headers present in a MIME part of a
- * message.</P>
+ * represent the MIME headers present in a MIME part of a
+ * message.</P>
+ * <p/>
+ * <P>This class is used primarily when an application wants to
+ * retrieve specific attachments based on certain MIME headers and
+ * values. This class will most likely be used by implementations
+ * of <CODE>AttachmentPart</CODE> and other MIME dependent parts
+ * of the JAXM API.
*
- * <P>This class is used primarily when an application wants to
- * retrieve specific attachments based on certain MIME headers and
- * values. This class will most likely be used by implementations
- * of <CODE>AttachmentPart</CODE> and other MIME dependent parts
- * of the JAXM API.
* @see SOAPMessage#getAttachments() SOAPMessage.getAttachments()
* @see AttachmentPart AttachmentPart
*/
@@ -43,8 +44,8 @@
if (names == null) {
return match
- ? null
- : mimeheader;
+ ? null
+ : mimeheader;
}
for (int i = 0; i < names.length; i++) {
@@ -107,16 +108,16 @@
MatchingIterator(String as[], boolean flag) {
- match = flag;
- names = as;
+ match = flag;
+ names = as;
iterator = headers.iterator();
}
}
/**
* Constructs
- * a default <CODE>MimeHeaders</CODE> object initialized with
- * an empty <CODE>Vector</CODE> object.
+ * a default <CODE>MimeHeaders</CODE> object initialized with
+ * an empty <CODE>Vector</CODE> object.
*/
public MimeHeaders() {
headers = new Vector();
@@ -125,10 +126,11 @@
/**
* Returns all of the values for the specified header as an
* array of <CODE>String</CODE> objects.
- * @param name the name of the header for which
- * values will be returned
+ *
+ * @param name the name of the header for which
+ * values will be returned
* @return a <CODE>String</CODE> array with all of the values
- * for the specified header
+ * for the specified header
* @see #setHeader(java.lang.String, java.lang.String) setHeader(java.lang.String, java.lang.String)
*/
public String[] getHeader(String name) {
@@ -157,19 +159,21 @@
/**
* Replaces the current value of the first header entry whose
- * name matches the given name with the given value, adding a
- * new header if no existing header name matches. This method
- * also removes all matching headers after the first one.
+ * name matches the given name with the given value, adding a
+ * new header if no existing header name matches. This method
+ * also removes all matching headers after the first one.
+ * <p/>
+ * <P>Note that RFC822 headers can contain only US-ASCII
+ * characters.</P>
*
- * <P>Note that RFC822 headers can contain only US-ASCII
- * characters.</P>
- * @param name a <CODE>String</CODE> with the
- * name of the header for which to search
- * @param value a <CODE>String</CODE> with the
- * value that will replace the current value of the
- * specified header
- * @throws java.lang.IllegalArgumentException if there was a
- * problem in the mime header name or the value being set
+ * @param name a <CODE>String</CODE> with the
+ * name of the header for which to search
+ * @param value a <CODE>String</CODE> with the
+ * value that will replace the current value of the
+ * specified header
+ * @throws java.lang.IllegalArgumentException
+ * if there was a
+ * problem in the mime header name or the value being set
* @see #getHeader(java.lang.String) getHeader(java.lang.String)
*/
public void setHeader(String name, String value) {
@@ -177,8 +181,7 @@
boolean flag = false;
if ((name == null) || name.equals("")) {
- throw new IllegalArgumentException(
- "Illegal MimeHeader name");
+ throw new IllegalArgumentException("Illegal MimeHeader name");
}
for (int i = 0; i < headers.size(); i++) {
@@ -187,7 +190,7 @@
if (mimeheader.getName().equalsIgnoreCase(name)) {
if (!flag) {
headers.setElementAt(new MimeHeader(mimeheader
- .getName(), value), i);
+ .getName(), value), i);
flag = true;
} else {
@@ -203,24 +206,25 @@
/**
* Adds a <CODE>MimeHeader</CODE> object with the specified
- * name and value to this <CODE>MimeHeaders</CODE> object's
- * list of headers.
+ * name and value to this <CODE>MimeHeaders</CODE> object's
+ * list of headers.
+ * <p/>
+ * <P>Note that RFC822 headers can contain only US-ASCII
+ * characters.</P>
*
- * <P>Note that RFC822 headers can contain only US-ASCII
- * characters.</P>
- * @param name a <CODE>String</CODE> with the
- * name of the header to be added
- * @param value a <CODE>String</CODE> with the
- * value of the header to be added
- * @throws java.lang.IllegalArgumentException if
- * there was a problem in the mime header name or value
- * being added
+ * @param name a <CODE>String</CODE> with the
+ * name of the header to be added
+ * @param value a <CODE>String</CODE> with the
+ * value of the header to be added
+ * @throws java.lang.IllegalArgumentException
+ * if
+ * there was a problem in the mime header name or value
+ * being added
*/
public void addHeader(String name, String value) {
if ((name == null) || name.equals("")) {
- throw new IllegalArgumentException(
- "Illegal MimeHeader name");
+ throw new IllegalArgumentException("Illegal MimeHeader name");
}
int i = headers.size();
@@ -241,8 +245,9 @@
/**
* Remove all <CODE>MimeHeader</CODE> objects whose name
* matches the the given name.
- * @param name a <CODE>String</CODE> with the
- * name of the header for which to search
+ *
+ * @param name a <CODE>String</CODE> with the
+ * name of the header for which to search
*/
public void removeHeader(String name) {
@@ -266,9 +271,10 @@
/**
* Returns all the headers in this <CODE>MimeHeaders</CODE>
* object.
- * @return an <CODE>Iterator</CODE> object over this <CODE>
- * MimeHeaders</CODE> object's list of <CODE>
- * MimeHeader</CODE> objects
+ *
+ * @return an <CODE>Iterator</CODE> object over this <CODE>
+ * MimeHeaders</CODE> object's list of <CODE>
+ * MimeHeader</CODE> objects
*/
public Iterator getAllHeaders() {
return headers.iterator();
@@ -277,11 +283,12 @@
/**
* Returns all the <CODE>MimeHeader</CODE> objects whose
* name matches a name in the given array of names.
- * @param names an array of <CODE>String</CODE>
- * objects with the names for which to search
- * @return an <CODE>Iterator</CODE> object over the <CODE>
- * MimeHeader</CODE> objects whose name matches one of the
- * names in the given list
+ *
+ * @param names an array of <CODE>String</CODE>
+ * objects with the names for which to search
+ * @return an <CODE>Iterator</CODE> object over the <CODE>
+ * MimeHeader</CODE> objects whose name matches one of the
+ * names in the given list
*/
public Iterator getMatchingHeaders(String names[]) {
return new MatchingIterator(names, true);
@@ -290,11 +297,12 @@
/**
* Returns all of the <CODE>MimeHeader</CODE> objects whose
* name does not match a name in the given array of names.
- * @param names an array of <CODE>String</CODE>
- * objects with the names for which to search
+ *
+ * @param names an array of <CODE>String</CODE>
+ * objects with the names for which to search
* @return an <CODE>Iterator</CODE> object over the <CODE>
- * MimeHeader</CODE> objects whose name does not match one
- * of the names in the given list
+ * MimeHeader</CODE> objects whose name does not match one
+ * of the names in the given list
*/
public Iterator getNonMatchingHeaders(String names[]) {
return new MatchingIterator(names, false);
@@ -304,7 +312,7 @@
// List do?
/**
* A <code>Vector</code> containing the headers as <code>MimeHeader</code>
- * instances.
+ * instances.
*/
private Vector headers;
}
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/Name.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/Name.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/Name.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/Name.java Mon Jul 11 08:49:30 2005
@@ -23,14 +23,14 @@
* <P>
* The following is an example of a namespace declaration in an element.
* <PRE>
- * <wombat:GetLastTradePrice xmlns:wombat="http://www.wombat.org/trader">
+ * <wombat:GetLastTradePrice xmlns:wombat="http://www.wombat.org/trader">
* </PRE>
* ("xmlns" stands for "XML namespace".)
* The following
* shows what the methods in the <code>Name</code> interface will return.
* <UL>
* <LI><code>getQualifiedName</code> will return "prefix:LocalName" =
- * "WOMBAT:GetLastTradePrice"
+ * "WOMBAT:GetLastTradePrice"
* <LI><code>getURI</code> will return "http://www.wombat.org/trader"
* <LI><code>getLocalName</code> will return "GetLastTracePrice"
* <LI><code>getPrefix</code> will return "WOMBAT"
@@ -48,15 +48,15 @@
* code, in which <i>se</i> is a <code>SOAPEnvelope</code> object, creates a new
* <code>Name</code> object with all three.
* <PRE>
- * Name name = se.createName("GetLastTradePrice", "WOMBAT",
- * "http://www.wombat.org/trader");
+ * Name name = se.createName("GetLastTradePrice", "WOMBAT",
+ * "http://www.wombat.org/trader");
* </PRE>
* The following line of code gives an example of how a <code>Name</code> object
* can be used. The variable <i>element</i> is a <code>SOAPElement</code> object.
* This code creates a new <code>SOAPElement</code> object with the given name and
* adds it to <i>element</i>.
* <PRE>
- * element.addChildElement(name);
+ * element.addChildElement(name);
* </PRE>
*/
public interface Name {
@@ -64,28 +64,32 @@
/**
* Gets the local name part of the XML name that this <code>Name</code>
* object represents.
- * @return a string giving the local name
+ *
+ * @return a string giving the local name
*/
public abstract String getLocalName();
/**
* Gets the namespace-qualified name of the XML name that this
* <code>Name</code> object represents.
- * @return the namespace-qualified name as a string
+ *
+ * @return the namespace-qualified name as a string
*/
public abstract String getQualifiedName();
/**
* Returns the prefix associated with the namespace for the XML
* name that this <code>Name</code> object represents.
- * @return the prefix as a string
+ *
+ * @return the prefix as a string
*/
public abstract String getPrefix();
/**
* Returns the URI of the namespace for the XML
* name that this <code>Name</code> object represents.
- * @return the URI as a string
+ *
+ * @return the URI as a string
*/
public abstract String getURI();
}
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/Node.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/Node.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/Node.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/Node.java Mon Jul 11 08:49:30 2005
@@ -26,33 +26,37 @@
/**
* Returns the the value of the immediate child of this <code>Node</code>
* object if a child exists and its value is text.
- * @return a <code>String</code> with the text of the immediate child of
- * this <code>Node</code> object if (1) there is a child and
- * (2) the child is a <code>Text</code> object;
- * <code>null</code> otherwise
+ *
+ * @return a <code>String</code> with the text of the immediate child of
+ * this <code>Node</code> object if (1) there is a child and
+ * (2) the child is a <code>Text</code> object;
+ * <code>null</code> otherwise
*/
public abstract String getValue();
/**
* Sets the parent of this <code>Node</code> object to the given
* <code>SOAPElement</code> object.
+ *
* @param parent the <code>SOAPElement</code> object to be set as
- * the parent of this <code>Node</code> object
+ * the parent of this <code>Node</code> object
* @throws SOAPException if there is a problem in setting the
- * parent to the given element
+ * parent to the given element
* @see #getParentElement() getParentElement()
*/
public abstract void setParentElement(SOAPElement parent)
- throws SOAPException;
+ throws SOAPException;
/**
* Returns the parent element of this <code>Node</code> object.
* This method can throw an <code>UnsupportedOperationException</code>
* if the tree is not kept in memory.
- * @return the <code>SOAPElement</code> object that is the parent of
- * this <code>Node</code> object or <code>null</code> if this
- * <code>Node</code> object is root
- * @throws java.lang.UnsupportedOperationException if the whole tree is not kept in memory
+ *
+ * @return the <code>SOAPElement</code> object that is the parent of
+ * this <code>Node</code> object or <code>null</code> if this
+ * <code>Node</code> object is root
+ * @throws java.lang.UnsupportedOperationException
+ * if the whole tree is not kept in memory
* @see #setParentElement(javax.xml.soap.SOAPElement) setParentElement(javax.xml.soap.SOAPElement)
*/
public abstract SOAPElement getParentElement();
@@ -83,9 +87,9 @@
* case a child Text node will be created.
*
* @param value the text to set
- * @throws IllegalStateException if the node is not a Text node and
- * either has more than one child node or has a child node that
- * is not a Text node
+ * @throws IllegalStateException if the node is not a Text node and
+ * either has more than one child node or has a child node that
+ * is not a Text node
*/
public abstract void setValue(String value);
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPBody.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPBody.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPBody.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPBody.java Mon Jul 11 08:49:30 2005
@@ -28,6 +28,7 @@
* objects, which have the content for the SOAP body.
* A <code>SOAPFault</code> object, which carries status and/or
* error information, is an example of a <code>SOAPBodyElement</code> object.
+ *
* @see SOAPFault SOAPFault
*/
public interface SOAPBody extends SOAPElement {
@@ -35,38 +36,42 @@
/**
* Creates a new <code>SOAPFault</code> object and adds it to
* this <code>SOAPBody</code> object.
+ *
* @return the new <code>SOAPFault</code> object
- * @throws SOAPException if there is a SOAP error
+ * @throws SOAPException if there is a SOAP error
*/
public abstract SOAPFault addFault() throws SOAPException;
/**
* Indicates whether a <code>SOAPFault</code> object exists in
* this <code>SOAPBody</code> object.
+ *
* @return <code>true</code> if a <code>SOAPFault</code> object exists in
- * this <code>SOAPBody</code> object; <code>false</code>
- * otherwise
+ * this <code>SOAPBody</code> object; <code>false</code>
+ * otherwise
*/
public abstract boolean hasFault();
/**
* Returns the <code>SOAPFault</code> object in this <code>SOAPBody</code>
* object.
+ *
* @return the <code>SOAPFault</code> object in this <code>SOAPBody</code>
- * object
+ * object
*/
public abstract SOAPFault getFault();
/**
* Creates a new <code>SOAPBodyElement</code> object with the
* specified name and adds it to this <code>SOAPBody</code> object.
+ *
* @param name a <code>Name</code> object with the name for the new
- * <code>SOAPBodyElement</code> object
+ * <code>SOAPBodyElement</code> object
* @return the new <code>SOAPBodyElement</code> object
- * @throws SOAPException if a SOAP error occurs
+ * @throws SOAPException if a SOAP error occurs
*/
public abstract SOAPBodyElement addBodyElement(Name name)
- throws SOAPException;
+ throws SOAPException;
/**
* Creates a new <code>SOAPFault</code> object and adds it to this
@@ -75,15 +80,15 @@
* parameter and a <code>faultstring</code> set to <code>faultstring</code>
* and localized to <code>locale</code>.
*
- * @param faultCode a <code>Name</code> object giving the fault code to be
- * set; must be one of the fault codes defined in the SOAP 1.1
- * specification and of type QName
+ * @param faultCode a <code>Name</code> object giving the fault code to be
+ * set; must be one of the fault codes defined in the SOAP 1.1
+ * specification and of type QName
* @param faultString a <code>String</code> giving an explanation of the
- * fault
- * @param locale a <code>Locale</code> object indicating the native language
- * of the <ocde>faultString</code>
+ * fault
+ * @param locale a <code>Locale</code> object indicating the native language
+ * of the <ocde>faultString</code>
* @return the new <code>SOAPFault</code> object
- * @throws SOAPException if there is a SOAP error
+ * @throws SOAPException if there is a SOAP error
*/
public abstract SOAPFault addFault(Name faultCode,
String faultString,
@@ -95,20 +100,20 @@
* <code>faultcode</code> element that is set to the <code>faultCode</code>
* parameter and a <code>faultstring</code> set to <code>faultstring</code>.
*
- * @param faultCode a <code>Name</code> object giving the fault code to be
- * set; must be one of the fault codes defined in the SOAP 1.1
- * specification and of type QName
+ * @param faultCode a <code>Name</code> object giving the fault code to be
+ * set; must be one of the fault codes defined in the SOAP 1.1
+ * specification and of type QName
* @param faultString a <code>String</code> giving an explanation of the
- * fault
+ * fault
* @return the new <code>SOAPFault</code> object
- * @throws SOAPException if there is a SOAP error
+ * @throws SOAPException if there is a SOAP error
*/
public abstract SOAPFault addFault(Name faultCode, String faultString) throws SOAPException;
/**
* Adds the root node of the DOM <code>Document</code> to this
* <code>SOAPBody</code> object.
- * <p>
+ * <p/>
* Calling this method invalidates the <code>document</code> parameter. The
* client application should discard all references to this
* <code>Document</code> and its contents upon calling
@@ -116,10 +121,10 @@
* to use such references is undefined.
*
* @param document the <code>Document</code> object whose root node will be
- * added to this <code>SOAPBody</code>
+ * added to this <code>SOAPBody</code>
* @return the <code>SOAPBodyElement</code> that represents the root node
- * that was added
+ * that was added
* @throws SOAPException if the <code>Document</code> cannot be added
*/
public abstract SOAPBodyElement addDocument(Document document) throws SOAPException;
- }
+}
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPBodyElement.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPBodyElement.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPBodyElement.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPBodyElement.java Mon Jul 11 08:49:30 2005
@@ -26,7 +26,8 @@
* <code>sb</code> is a <code>SOAPBody</code> object, and
* <code>myName</code> is a <code>Name</code> object.
* <PRE>
- * SOAPBodyElement sbe = sb.addBodyElement(myName);
+ * SOAPBodyElement sbe = sb.addBodyElement(myName);
* </PRE>
*/
-public interface SOAPBodyElement extends SOAPElement {}
+public interface SOAPBodyElement extends SOAPElement {
+}
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPConnection.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPConnection.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPConnection.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPConnection.java Mon Jul 11 08:49:30 2005
@@ -18,11 +18,11 @@
/**
* A point-to-point connection that a client can use for sending messages
* directly to a remote party (represented by a URL, for instance).
- * <p>
+ * <p/>
* A client can obtain a <code>SOAPConnection</code> object simply by
* calling the following static method.
* <pre>
- *
+ * <p/>
* SOAPConnection con = SOAPConnection.newInstance();
* </pre>
* A <code>SOAPConnection</code> object can be used to send messages
@@ -32,29 +32,32 @@
*/
public abstract class SOAPConnection {
- public SOAPConnection() {}
+ public SOAPConnection() {
+ }
/**
* Sends the given message to the specified endpoint and
* blocks until it has returned the response.
- * @param request the <CODE>SOAPMessage</CODE>
- * object to be sent
+ *
+ * @param request the <CODE>SOAPMessage</CODE>
+ * object to be sent
* @param endpoint an <code>Object</code> that identifies
- * where the message should be sent. It is required to
- * support Objects of type
- * <code>java.lang.String</code>,
- * <code>java.net.URL</code>, and when JAXM is present
- * <code>javax.xml.messaging.URLEndpoint</code>
+ * where the message should be sent. It is required to
+ * support Objects of type
+ * <code>java.lang.String</code>,
+ * <code>java.net.URL</code>, and when JAXM is present
+ * <code>javax.xml.messaging.URLEndpoint</code>
* @return the <CODE>SOAPMessage</CODE> object that is the
- * response to the message that was sent
- * @throws SOAPException if there is a SOAP error
+ * response to the message that was sent
+ * @throws SOAPException if there is a SOAP error
*/
public abstract SOAPMessage call(SOAPMessage request, Object endpoint)
- throws SOAPException;
+ throws SOAPException;
/**
* Closes this <CODE>SOAPConnection</CODE> object.
- * @throws SOAPException if there is a SOAP error
+ *
+ * @throws SOAPException if there is a SOAP error
*/
public abstract void close() throws SOAPException;
}
Modified: webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPConnectionFactory.java
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPConnectionFactory.java?rev=210150&r1=210149&r2=210150&view=diff
==============================================================================
--- webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPConnectionFactory.java (original)
+++ webservices/axis/trunk/java/modules/saaj/src/javax/xml/soap/SOAPConnectionFactory.java Mon Jul 11 08:49:30 2005
@@ -26,23 +26,25 @@
*/
public abstract class SOAPConnectionFactory {
- public SOAPConnectionFactory() {}
+ public SOAPConnectionFactory() {
+ }
/**
* Creates an instance of the default <CODE>
* SOAPConnectionFactory</CODE> object.
+ *
* @return a new instance of a default <CODE>
- * SOAPConnectionFactory</CODE> object
- * @throws SOAPException if there was an error creating
- * the <CODE>SOAPConnectionFactory
- * @throws UnsupportedOperationException if newInstance is not supported.
+ * SOAPConnectionFactory</CODE> object
+ * @throws SOAPException if there was an error creating
+ * the <CODE>SOAPConnectionFactory
+ * @throws UnsupportedOperationException if newInstance is not supported.
*/
public static SOAPConnectionFactory newInstance()
throws SOAPException, UnsupportedOperationException {
try {
return (SOAPConnectionFactory) FactoryFinder.find(SF_PROPERTY,
- DEFAULT_SOAP_CONNECTION_FACTORY);
+ DEFAULT_SOAP_CONNECTION_FACTORY);
} catch (Exception exception) {
throw new SOAPException("Unable to create SOAP connection factory: "
+ exception.getMessage());
@@ -51,15 +53,16 @@
/**
* Create a new <CODE>SOAPConnection</CODE>.
+ *
* @return the new <CODE>SOAPConnection</CODE> object.
- * @throws SOAPException if there was an exception
- * creating the <CODE>SOAPConnection</CODE> object.
+ * @throws SOAPException if there was an exception
+ * creating the <CODE>SOAPConnection</CODE> object.
*/
public abstract SOAPConnection createConnection() throws SOAPException;
private static final String DEFAULT_SOAP_CONNECTION_FACTORY =
- "org.apache.axis2.saaj.SOAPConnectionFactoryImpl";
+ "org.apache.axis2.saaj.SOAPConnectionFactoryImpl";
private static final String SF_PROPERTY =
- "javax.xml.soap.SOAPConnectionFactory";
+ "javax.xml.soap.SOAPConnectionFactory";
}