Return-Path: Delivered-To: apmail-ws-axis-cvs-archive@www.apache.org Received: (qmail 7007 invoked from network); 21 Feb 2005 10:54:33 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur-2.apache.org with SMTP; 21 Feb 2005 10:54:33 -0000 Received: (qmail 14596 invoked by uid 500); 21 Feb 2005 10:54:33 -0000 Delivered-To: apmail-ws-axis-cvs-archive@ws.apache.org Received: (qmail 14264 invoked by uid 500); 21 Feb 2005 10:54:31 -0000 Mailing-List: contact axis-cvs-help@ws.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Delivered-To: mailing list axis-cvs@ws.apache.org Received: (qmail 14248 invoked by uid 99); 21 Feb 2005 10:54:31 -0000 X-ASF-Spam-Status: No, hits=-9.8 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from minotaur.apache.org (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.28) with SMTP; Mon, 21 Feb 2005 02:54:30 -0800 Received: (qmail 6909 invoked by uid 65534); 21 Feb 2005 10:54:29 -0000 Message-ID: <20050221105429.6906.qmail@minotaur.apache.org> Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Mailer: svnmailer-1.0.0-dev Date: Mon, 21 Feb 2005 10:54:28 -0000 Subject: svn commit: r154666 - in webservices/axis/trunk/java/xdocs: OMTutorial.html images/axis.jpg images/image005.gif To: axis-cvs@ws.apache.org From: ajith@apache.org X-Virus-Checked: Checked X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N Author: ajith Date: Mon Feb 21 02:54:26 2005 New Revision: 154666 URL: http://svn.apache.org/viewcvs?view=3Drev&rev=3D154666 Log: Added some more sections to the OMtutorial. Added: webservices/axis/trunk/java/xdocs/images/axis.jpg (with props) webservices/axis/trunk/java/xdocs/images/image005.gif (with props) Modified: webservices/axis/trunk/java/xdocs/OMTutorial.html Modified: webservices/axis/trunk/java/xdocs/OMTutorial.html URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/OMTuto= rial.html?view=3Ddiff&r1=3D154665&r2=3D154666 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D --- webservices/axis/trunk/java/xdocs/OMTutorial.html (original) +++ webservices/axis/trunk/java/xdocs/OMTutorial.html Mon Feb 21 02:54:26 2= 005 @@ -20,6 +20,13 @@

For whom is this Tutorial?

This tutorial can be used by anybody who is interested in OM and needs = to go deeper in it. However it is assumed that the reader has a basic under= standing of the concepts of XML (such as Namespaces) and a working knowledg= e of tools such as Ant. Knowledge in similar object models such as DOM wil= l be quite helpful in understanding but such knowledge is not assumed. Several Links are listed in the appendix/ links section that will help any= body who lacks the basic understanding of XML.

+

What is pull parsing ?

+Pull parsing is a recent trend in XML processing. The previously popular X= ML processing frameworks such as SAX and DOM were "push-based" which means +the control of the parsing was with the parser itself. This approach is fi= ne and easy to use but it was not efficient in=20 +handling large XML documents since a complete memory model will be generat= ed in the memory. Pull parsing inverts the control +and hence the parser only proceeds at the users command. The user can deci= de to store or discard events generated from the +parser. +OM is based on pull parsing. To learn more about XML pull parsing see the = XML pull= parsing introduction. =20

A Bit of History

The original OM was proposed as a store for the pull parser events for = later processing, at the Axis summit held at Colombo during September 2004.= However this approach was soon improved and OM was pursued as a complete i= nfo set model due to its flexibility. Several implementation techniques were attempted during the initial phases= . The two most promising techniques were the table based technique and the = link list based technique. During the intermediate performance tests the li= nk list based technique proved to be much more memory efficient for smaller= and mid sized XML documents (the advantage of the table based OM was only = visible for the large and very large XML documents) and hence the link list= based technique was chosen as the most suitable.=20 @@ -60,8 +67,14 @@ The reason why this is so important is because caching can be turned off i= n certain situations. In this situation the parser proceeds without building the object structure. User can extra= ct the raw pull stream from OM and use=20 that instead of the OM and in this case it is sometimes beneficial to swit= ch off caching. -The advanced operations section explains more on accessing the raw pull st= ream. +The advanced operations section explains more on accessing the raw pull st= ream and switching the caching on and off.

=20 +

Where does SOAP come into play?

+

In a nutshell SOAP is a information exchange protocol based on XML. SOA= P has a defined set of +XML elements that should be used in messages. Since Axis is a "SOAP Engine= " and OM is built for Axis, A set of SOAP +specific objects were also defined along with OM. These SOAP Objects are e= xtensions of the general OM objects. +To learn more on = SOAP

+ =20 Added: webservices/axis/trunk/java/xdocs/images/axis.jpg URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/images= /axis.jpg?view=3Dauto&rev=3D154666 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D Binary file - no diff available. Propchange: webservices/axis/trunk/java/xdocs/images/axis.jpg ---------------------------------------------------------------------------= --- svn:mime-type =3D application/octet-stream Added: webservices/axis/trunk/java/xdocs/images/image005.gif URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/images= /image005.gif?view=3Dauto&rev=3D154666 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D Binary file - no diff available. Propchange: webservices/axis/trunk/java/xdocs/images/image005.gif ---------------------------------------------------------------------------= --- svn:mime-type =3D application/octet-stream