You are viewing a plain text version of this content. The canonical link for it is here.
Posted to soap-dev@xml.apache.org by du...@apache.org on 2001/05/22 17:06:20 UTC
cvs commit: xml-soap/java/docs/guide attachments.html deploy.html rpcclient.html
duftler 01/05/22 08:06:18
Modified: java/docs changes.html
java/docs/guide attachments.html deploy.html rpcclient.html
Log:
More doc updates from Bill, and removed 2 CSS references.
Submitted by: Bill Nagy (nagy@watson.ibm.com)
Reviewed by: Matthew J. Duftler (duftler@us.ibm.com)
Revision Changes Path
1.14 +3 -0 xml-soap/java/docs/changes.html
Index: changes.html
===================================================================
RCS file: /home/cvs/xml-soap/java/docs/changes.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- changes.html 2001/05/22 04:06:52 1.13
+++ changes.html 2001/05/22 15:04:43 1.14
@@ -85,6 +85,9 @@
the code that inserts escape sequences. The code
will now round trip Strings correctly, whether
they contain CDATA sections or not.</li>
+ <li>All the simple numeric types now use a serializer
+ that does not run its content through
+ Utils.cleanString(String).</li>
</ul>
</li>
<li><a name="v2.1"><strong>Version 2.1</strong></a> <ul>
1.3 +74 -8 xml-soap/java/docs/guide/attachments.html
Index: attachments.html
===================================================================
RCS file: /home/cvs/xml-soap/java/docs/guide/attachments.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- attachments.html 2001/02/05 18:25:31 1.2
+++ attachments.html 2001/05/22 15:05:02 1.3
@@ -1,11 +1,77 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
-
-<body>
-
-<p><em>Explain how to use attachments via RPC and Messaging on the client
-and server side, how to add and retrieve unreferenced attachments.
-Also, explain how to work with MIME Attachments and SOAPContext.</em></p>
-
+<HEAD>
+<META name="GENERATOR" content="IBM WebSphere Homepage Builder V4.0.0 for Linux">
+<TITLE>Using Attachments</TITLE>
+</HEAD>
+<BODY bgcolor="#ffffff">
+<H2 align="center">Using Attachments</H2>
+<P>Even though SOAP is an XML-based protocol,
+it's not always convenient to force all data
+which is passed as part of a SOAP message
+to be encoded in a way which can be embedded
+inside of an XML document. Sometimes it would
+be nicer just to allow data, such as JPEG
+images, WAV files, etc., to be passed along
+with the SOAP message, instead of inside
+of it. To address this issue, the SOAP with
+Attachments specification was created. The
+SOAP with Attachments specification allows
+for the embedding of a SOAP message inside
+of a MIME document, in a manner in which
+does not alter the processing rules of the
+message. The specification also describes
+how one refers to the attachments from inside
+the body of the SOAP message. Apache SOAP
+contains an implementation of this specification.</P>
+<H3>Using Attachments on the Client</H3>
+<P>If you are interacting with an RPC-based
+service, you may not need to do anything
+special to transmit an attachment. Pre-defined
+serializers/deserializers exist for interacting
+with javax.activation.DataSource objects
+and javax.activation.DataHandler objects.
+If your objects can be passed through one
+of these mechanisms, then the RPC-code will
+handle creating and/or removing the attachment
+for you.</P>
+<P>If you are using a message-oriented service,
+or need finer-grain control over the attachments,
+then you can use methods in the org.apache.soap.messaging.Message,
+org.apache.soap.rpc.Call, or org.apache.soap.rpc.Response
+classes. The addBodyPart(...) methods will
+allow you to add a javax.mail.internet.MimeBodyPart
+object to your messages, while the findBodyPart(...)
+and getBodyPart(...) methods will allow you
+to retrieve them via the Content-URI and
+location within the message, respectively.</P>
+<H3>Using Attachments on the Server</H3>
+<P>As in the client case, if you are implementing
+an RPC-based service you may be able to take
+advantage of the built-in serializers/deserializers
+for the DataSource and DataHandler objects.</P>
+<P>If you are implementing a message-oriented
+service, or need finer-grain control over
+the attachments, then you can use methods
+on the org.apache.soap.rpc.SOAPContext class
+to add or retrieve MimeBodyParts.</P>
+<H3>Referencing Attachments from within a SOAP
+Message</H3>
+<P>To make attachments really useful, you need
+to be able to refer to them from within the
+contents of a SOAP message body. To refer
+to an attachment from within a message, you
+simply add an element like the following:</P>
+<PRE><<B><I>elemName</I></B> href="cid:<B><I>cid-uri</I></B>"></PRE>
+<P>where <B><I>elemName</I></B> is the name of some element within the message,
+and <B><I>cid-uri</I></B> is the URL-encoded name of the Content-ID
+for the attachment which you are referring
+to, or alternatively, an absolute or relative
+URI referring to the Content-Location of
+the attachment. (The Content-ID is set as
+part of the javax.mail.internet.MimeBodyPart.)</P>
+<P>Last updated 5/22/2001 by Bill Nagy <<A href="mailto:nagy@watson.ibm.com">nagy@watson.ibm.com</A>>.</P>
</body>
-<html>
+
+</HTML>
1.6 +0 -1 xml-soap/java/docs/guide/deploy.html
Index: deploy.html
===================================================================
RCS file: /home/cvs/xml-soap/java/docs/guide/deploy.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- deploy.html 2001/05/21 20:19:08 1.5
+++ deploy.html 2001/05/22 15:05:08 1.6
@@ -3,7 +3,6 @@
<HEAD>
<META name="GENERATOR" content="IBM WebSphere Homepage Builder V4.0.0 for Linux">
<TITLE>The Apache SOAP Deployment Descriptor</TITLE>
-<LINK rel="stylesheet" href="ait.css">
</HEAD>
<BODY bgcolor="#ffffff">
<H2 align="center">Deployment Descriptors</H2>
1.4 +0 -1 xml-soap/java/docs/guide/rpcclient.html
Index: rpcclient.html
===================================================================
RCS file: /home/cvs/xml-soap/java/docs/guide/rpcclient.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- rpcclient.html 2001/05/21 20:19:13 1.3
+++ rpcclient.html 2001/05/22 15:05:15 1.4
@@ -3,7 +3,6 @@
<HEAD>
<META name="GENERATOR" content="IBM WebSphere Homepage Builder V4.0.0 for Linux">
<TITLE>Writing RPC Clients</TITLE>
-<LINK rel="stylesheet" href="ait.css">
</HEAD>
<BODY bgcolor="#ffffff">
<H2 align="center">Writing RPC Clients</H2>
unsubscribe me
Posted by Shahid Ahmad <sa...@conceptwave.com>.
--Shahid