cvs: phpdoc /en/reference/sdo_das_xml book.xml constants.xml examples.xml reference.xml setup.xml

From: Date: Mon, 24 Dec 2007 14:04:54 +0000
Subject: cvs: phpdoc /en/reference/sdo_das_xml book.xml constants.xml examples.xml reference.xml setup.xml
Groups: php.doc.cvs 
Request: Send a blank email to doc-cvs+get-806@lists.php.net to get a copy of this message
bjori Mon Dec 24 14:04:54 2007 UTC Modified files: /phpdoc/en/reference/sdo_das_xml book.xml constants.xml examples.xml setup.xml reference.xml Log: MFB: Upgrade to the new-reference-structure - (Created missing setup sections in setup.xml, if any) - Moved the intro to book.xml - Changed the intro ID from <extname>.intro to intro.<extname> - Created empty constants.xml appendix - Moved the examples into its own chapter - Moved the requirements and installation sections to setup.xml

http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sdo_das_xml/book.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/sdo_das_xml/book.xml diff -u /dev/null phpdoc/en/reference/sdo_das_xml/book.xml:1.2 --- /dev/null Mon Dec 24 14:04:54 2007 +++ phpdoc/en/reference/sdo_das_xml/book.xml Mon Dec 24 14:04:54 2007 @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.2 $ --> +<!-- Purpose: xml --> +<!-- Membership: pecl --> + +<book xml:id="book.sdo-das-xml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <title>SDO XML Data Access Service</title> + + <!-- {{{ preface --> + <preface xml:id="intro.sdo-das-xml"> + &reftitle.intro; + <para> + In order to use the XML Data Access Service for Service Data Objects, + you will need to understand some of the concepts behind SDO: + the data graph, the data object, XPath and property expressions, + and so on. + If you are not familiar with these ideas, you might want to look first at + <link linkend='ref.sdo'>the section on SDO</link>. + </para> + <para> + The job of the XML DAS is to move data between the + application and an XML data source, which can be either a file or + a URL. SDOs are always created and maintained according to a model + which defines type names and what property names each type may have. + For data which is from XML, this SDO model is built from a schema file + written in XML schema language (an xsd file). This schema file is + usually passed to the create method when the XMLDAS is initialised. + The + <link xlink:href='&url.ibm.sdo;'>SDO 2.0 specification</link> + defines the mapping between XML types and SDO types. + There are a number of small limitations in the PHP support - + not everything which is in the specification can be done - and + these limitations are summarised in a later section. + </para> + </preface> + <!-- }}} --> + + &reference.sdo-das-xml.setup; + &reference.sdo-das-xml.constants; + &reference.sdo-das-xml.examples; + &reference.sdo-das-xml.reference; + +</book> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sdo_das_xml/constants.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/sdo_das_xml/constants.xml diff -u /dev/null phpdoc/en/reference/sdo_das_xml/constants.xml:1.2 --- /dev/null Mon Dec 24 14:04:54 2007 +++ phpdoc/en/reference/sdo_das_xml/constants.xml Mon Dec 24 14:04:54 2007 @@ -0,0 +1,29 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.2 $ --> + +<appendix xml:id="sdo-das-xml.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + &reftitle.constants; + &no.constants; +</appendix> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sdo_das_xml/examples.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/sdo_das_xml/examples.xml diff -u /dev/null phpdoc/en/reference/sdo_das_xml/examples.xml:1.2 --- /dev/null Mon Dec 24 14:04:54 2007 +++ phpdoc/en/reference/sdo_das_xml/examples.xml Mon Dec 24 14:04:54 2007 @@ -0,0 +1,697 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.2 $ --> + +<chapter xml:id="sdo-das-xml.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + &reftitle.examples; + <para> + Several of the following examples are based on the + <link linkend="sdo.sample.sequence">letter example</link> + described in the + <link linkend="ref.sdo">SDO documentation</link>. + The examples assume the XML Schema for the letter is contained in a file + <filename>letter.xsd</filename> + and the letter instance is in the file + <filename>letter.xml</filename>. + These two files are reproduced here: + </para> + <para> + <programlisting role="xml"> +<![CDATA[ +<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" + xmlns:letter="http://letterSchema" + targetNamespace="http://letterSchema"> + <xsd:element name="letters" type="letter:FormLetter"/> + <xsd:complexType name="FormLetter" mixed="true"> + <xsd:sequence> + <xsd:element name="date" minOccurs="0" type="xsd:string"/> + <xsd:element name="firstName" minOccurs="0" type="xsd:string"/> + <xsd:element name="lastName" minOccurs="0" type="xsd:string"/> + </xsd:sequence> + </xsd:complexType> +</xsd:schema> +]]> + </programlisting> + </para> + + <para> + <programlisting role="xml"> +<![CDATA[ +<letter:letters xmlns:letter="http://letterSchema"> + <date>March 1, 2005</date> + Mutual of Omaha + Wild Kingdom, USA + Dear + <firstName>Casy</firstName> + <lastName>Crocodile</lastName> + Please buy more shark repellent. + Your premium is past due. +</letter:letters> +]]> + </programlisting> + </para> + + <example> + <title>Loading, altering, and saving an XML document</title> + + <para> + The following example shows how an XML document can be loaded from a file, + altered, and written back. + </para> + + <programlisting role="php" xml:id="sdo-das-xml.examples.loadfromfile"> + <![CDATA[ +<?php +/** + * Load, update, and save an XML document + */ +try { + $xmldas = SDO_DAS_XML::create("letter.xsd"); + $document = $xmldas->loadFile("letter.xml"); + $root_data_object = $document->getRootDataObject(); + $root_data_object->date = "September 03, 2004"; + $root_data_object->firstName = "Anantoju"; + $root_data_object->lastName = "Madhu"; + $xmldas->saveFile($document, "letter-out.xml"); + echo "New file has been written:\n"; + print file_get_contents("letter-out.xml"); +} catch (SDO_Exception $e) { + print($e->getMessage()); +} +?> ]]> + </programlisting> + + <para> + An instance of the XML DAS is first obtained from the + <function>SDO_DAS_XML::create</function> + method, + which is a static method of the + <classname>SDO_DAS_XML</classname> + class. + The location of the xsd is passed as a parameter. + Once we have an instance of the XML DAS initialised + with a given schema, + we can use it to load the instance document using the + <function>loadFile</function> + method. + There is also a + <function>loadString</function> + method if you want to load an XML + instance document from a string. + If the instance document loads successfully, + you will be returned an object of type + <classname>SDO_DAS_XML_Document</classname>, + on which you can call the + <function>getRootDataObject</function> + method to get the SDO data object which is the root + of the SDO data graph. + You can then use SDO operations to change the graph. + In this example we alter the + <varname>date</varname>, + <varname>firstName</varname>, and + <varname>lastName</varname> properties. + Then we use the + <function>saveFile</function> + method to write the changed document back to the file system. + The saveFile method has an optional extra integer argument which if specified + will cause the XML DAS to format the XML, using the integer as the amount to + indent by at each change in level on the document. + </para> + + <para> + This will write the following to <filename>letter-out.xml</filename>. + </para> + + <programlisting role="xml" xml:id="sdo-das-xml.examples.loadfromfile.output"> + <![CDATA[ +<?xml version="1.0" encoding="UTF-8"?> +<FormLetter xmlns="http://letterSchema" xsi:type="FormLetter" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> + <date>September 03, 2004</date> + Mutual of Omaha + Wild Kingdom, USA + Dear + <firstName>Anantoju</firstName> + <lastName>Madhu</lastName> + Please buy more shark repellent. + Your premium is past due. +</FormLetter> +]]> + </programlisting> + + </example> + + <example> + + <title>Creating a new XML document</title> + + <para> + The previous example loaded the document from a file. + This example shows how to create an SDO data graph in memory. + In this example it is then saved to an XML string. + Furthermore, because the letter contains both structured and + unstructured content, it uses + <link linkend="sdo.sample.sequence">the Sequence API</link> + as well assignments to properties to construct the data graph. + </para> + + <programlisting role="php" xml:id="sdo-das-xml.examples.create"> + <![CDATA[ +<?php +/** + * Create an XML document from scratch + */ +try { + $xmldas = SDO_DAS_XML::create("letter.xsd"); + try { + $doc = $xmldas->createDocument(); + $rdo = $doc->getRootDataObject(); + $seq = $rdo->getSequence(); + $seq->insert("April 09, 2005", NULL, 'date'); + $seq->insert("Acme Inc. ", NULL, NULL); + $seq->insert("United Kingdom. "); + $seq->insert("Dear", NULL, NULL); + $seq->insert("Tarun", NULL, "firstName"); + $seq->insert("Nayaraaa", NULL, "lastName"); + $rdo->lastName = "Nayar"; + $seq->insert("Please note that your order number "); + $seq->insert(12345); + $seq->insert(" has been dispatched today. Thanks for your business with us."); + print($xmldas->saveString($doc)); + } catch (SDO_Exception $e) { + print($e); + } +} catch (SDO_Exception $e) { + print("Problem creating an XML document: " . $e->getMessage()); +} +?> + ]]> + </programlisting> + + </example> + + <para> + The + <function>createDocument</function> + method on the XML DAS returns a document object + with a single root data object corresponding to an empty document element. + The element name of the document element is known from the schema file. + If there is any ambiguity about what the document element is, as there can be + when more than one schema has been loaded into the same XML DAS, + the element name and the namespace URI can be passed to the + <function>createDocument</function> + method. + </para> + + <para> + This will emit the following output (line breaks have been inserted for readability): + </para> + + <programlisting role="xml" xml:id="sdo-das-xml.examples.create.output"> + <![CDATA[ +<?xml version="1.0" encoding="UTF-8"?> +<FormLetter xmlns="http://letterSchema" xsi:type="FormLetter" +xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> +<date>April 09, 2005</date> +Acme Inc. United Kingdom. +Dear +<firstName>Tarun</firstName> +<lastName>Nayar</lastName> +Please note that your order number 12345 has been +dispatched today. Thanks for your business with us. +</FormLetter> +]]> + </programlisting> + + + <example> + + <title>Setting XML document properties</title> + + <para> + This third example shows you how to set the XML version and + encoding on the document object. + These will be used when the XML is written out. + If no XML declaration is wanted at all + (perhaps you want to generate the XML as a string to embed + in something) then you can use the + <function>setXMLDeclaration</function> + method to suppress it. + </para> + + <programlisting role="php" xml:id="sdo-das-xml.examples.Example3"> + <![CDATA[ +<?php +/** + * Illustrate the calls that control the XML declaration + */ + $xmldas = SDO_DAS_XML::create("letter.xsd"); + $document = $xmldas->loadFile("letter.xml"); + $document->setXMLVersion("1.1"); + $document->setEncoding("ISO-8859-1"); + print($xmldas->saveString($document)); +?> ]]> + </programlisting> + + <para> + The XML version and encoding are set in the XML declaration at the top + of the XML document. + </para> + + <programlisting role="xml" xml:id="sdo-das-xml.examples.sdo_das_xml_document.output"> +<![CDATA[ +<?xml version="1.1" encoding="ISO-8859-1"?> +.../... +]]> + </programlisting> + + </example> + + + <example> + <title>Using an open type</title> + <para> + This fourth example illustrates the use of an SDO open type + and the use of the + <function>createDataObject</function> + method. + For this example we use the following two + schema: + </para> + <para> + <programlisting role="xml"> +<![CDATA[ +<schema + xmlns="http://www.w3.org/2001/XMLSchema"> + + <element name="jungle"> + <complexType> + <sequence> + <any minOccurs="0" maxOccurs="unbounded"/> + </sequence> + </complexType> + </element> + +</schema> +]]> + </programlisting> + </para> + + <para> + Note the presence of the + <varname>any</varname> + element in the definition. + This first schema defines the + <varname>jungle</varname> + complex type as containing a sequence of + any other type. + The other types that the example will use are defined in a + second schema file: + </para> + + <para> + <programlisting role="xml"> +<![CDATA[ +<schema xmlns= "http://www.w3.org/2001/XMLSchema"> + + <complexType name="snakeType"> + <sequence> + <element name= "name" type="string"/> + <element name= "length" type="positiveInteger" /> + </sequence> + </complexType> + + <complexType name="bearType"> + <sequence> + <element name= "name" type="string"/> + <element name= "weight" type="positiveInteger" /> + </sequence> + </complexType> + + <complexType name="pantherType"> + <sequence> + <element name= "name" type="string"/> + <element name= "colour" type="string" /> + </sequence> + </complexType> + +</schema> +]]> + </programlisting> + </para> + + <para> + Here is the example PHP code that uses these two schema files: + </para> + + <para> + <programlisting role="php" xml:id="sdo-das-xml.examples.Example4"> + <![CDATA[ +<?php + +/** + * Illustrate open types and the use of the addTypes() method + */ + +$xmldas = SDO_DAS_XML::create(); +$xmldas->addTypes("jungle.xsd"); // this is an open type i.e. the xsd specifies it can contain "any" type +$xmldas->addTypes('animalTypes.xsd'); + +$baloo = $xmldas->createDataObject('','bearType'); +$baloo->name = "Baloo"; +$baloo->weight = 800; + +$bagheera = $xmldas->createDataObject('','pantherType'); +$bagheera->name = "Bagheera"; +$bagheera->colour = 'inky black'; + +$kaa = $xmldas->createDataObject('','snakeType'); +$kaa->name = "Kaa"; +$kaa->length = 25; + +$document = $xmldas->createDocument(); +$do = $document->getRootDataObject(); +$do->bear = $baloo; +$do->panther = $bagheera; +$do->snake = $kaa; + +print($xmldas->saveString($document,2)); + +?> + ]]> + </programlisting> + </para> + <para> + These two schema files are loaded into the XML DAS with first the + <function>create</function> + and + <function>addTypes</function> + methods. + The + <function>createDataObject</function> + method is used to create three separate data objects. + In each case the namespaceURI and typename of the type are passed to the + <function>createDataObject</function> + method: in this example the namespace URI is blank because no + namespace is used in the schema. + Once the three data objects - representing a bear, a panther and a snake - + have been created, a document object is created with the + <function>createDocument</function> + method. + In this case there is no ambiguity about what the document element of the + document should be - as the second schema file only defines complex types, + the document element can only be the global + <varname>jungle</varname> + element defined + in the first schema. + This document will have a single root data object corresponding to an + empty document element <varname>jungle</varname>. + As this is an open type, properties can be added at will. + When the first assignment is made to <varname>$do->bear</varname>, + a property + <varname>bear</varname> + is added to the root data object: + likewise for the next two assignments. + When the document is written out by the + <function>saveString</function> + method, the resulting document is: + </para> + + <para> + <programlisting role="xml"> +<![CDATA[ +<?xml version="1.0" encoding="UTF-8"?> +<jungle xsi:type="jungle" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> + <bear xsi:type="bearType"> + <name>Baloo</name> + <weight>800</weight> + </bear> + <panther xsi:type="pantherType"> + <name>Bagheera</name> + <colour>inky black</colour> + </panther> + <snake xsi:type="snakeType"> + <name>Kaa</name> + <length>25</length> + </snake> +</jungle> +]]> + </programlisting> + </para> + + </example> + + <example> + + <title>Finding out what you can from the document</title> + + <para> + This example is intended to illustrate how you can find the + element name and + namespace of the document element from the XML Document object, and + the SDO type and namespace from the root data object of the XML data + object, and how they relate to one another. + This can be difficult to understand because there are four method calls: + two can be made against the Document object, and two that can be made + against any data object including the root data object. + Because of the rules that define how the SDO model is derived + from the XML model, when the data object concerned is the + root object that represents the document object for the document, + only three possible values can come back from these + four method calls. + + </para> + + <para> + The two method calls that can be made against the document + are <function>getRootElementName</function> and + <function>getRootEelementURI</function>. + These return the element name and namespace of the document element, + respectively. + </para> + + <para> + The two method calls that can be made against any data object are + <function>getTypeName</function> + and + <function>getTypeNamespaceURI</function>. + These return the SDO type name and type namespace of the data object, + respectively. + </para> + + <para> + Always, calling <function>getRootElementURI</function> + on the document object will return the same value as + calling <function>getNamespaceURI</function> on the + root data object. + Essentially, the information is all derived from the first few lines of the + schema file, + where there are three distinct pieces of information. + For illustration, here again are the first few lines of the + letter.xsd that we used above. + </para> + + <programlisting role="xml"> +<![CDATA[ +<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" + xmlns:letter="http://letterSchema" + targetNamespace="http://letterSchema"> + + <xsd:element name="letters" type="letter:FormLetter"/> + + <xsd:complexType name="FormLetter" mixed="true"> + .../... +]]> + </programlisting> + + <para> + The three important values are: + <itemizedlist> + <listitem> + <para> + <varname>letters</varname>, the name of the document element + </para> + </listitem> + <listitem> + <para> + <varname>FormLetter</varname>, the name of the complex type of the document element. + This is also the name of the SDO type of the root data object. + </para> + </listitem> + <listitem> + <para> + <varname>http://letterSchema</varname>, the namespace to which the document element belongs. + This is also the namespaceURI of the SDO type of the root data object. + </para> + </listitem> + </itemizedlist> + It is part of the XML-SDO mapping rules that + when the SDO model is built from the schema file, + the typename and namespaceURI of the SDO types for the root element + are taken + from those of the complex type of the document element, where it exists. + Hence in this example the typename of the root data object is FormLetter. + In the event that there is no separate complex type definition + for the document element, when the the type is defined inline and is + anonymous, + the SDO type name will be the same as the element name. + </para> + + <para> + The following program loads the letter document and checks the + return values from each of the four calls. + </para> + <programlisting role="php" xml:id="sdo-das-xml.examples.Example5"> + <![CDATA[ +<?php +/** + * Finding out what you can about the document and document element + * This can be quite hard to understand because there are four calls + * Two calls are made against the document + * Two calls are made against the root data object and its model + * Because of the SDO-XML mapping rules and how the SDO model is derived + * from the XML model, only three possible values can come back from these four calls. + * Always, $document->getRootElementURI() == (type of root data object)->namespaceURI + * Essentially, it all comes form the first few lines of the xsd: + * <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" + * xmlns:letter="http://letterSchema" + * targetNamespace="http://letterSchema"> + * <xsd:element name="letters" type="letter:FormLetter"/> + */ + +$xmldas = SDO_DAS_XML::create("letter.xsd"); +$document = $xmldas->loadFile("letter.xml"); +$root_do = $document->getRootDataObject(); + +/** + * The "root element name" is the element name of the document element + * in this case 'letters' + * This matches the 'name' attribute of the document element in the xsd and matches + * the element name from the xml + */ +echo "The document element name is " . $document->getRootElementName() . "\n"; +assert($document->getRootElementName() == 'letters'); // a property of the document + +/** + * The "root element URI" is the namespace part of the element name of the document element + * in this case 'http://letterSchema' since 'letters' is in that namespace + * This is taken from the xsd and matches the namespace picked up from the xml + */ +echo "The document element is in the namespace " . $document->getRootElementURI() . "\n"; +assert($document->getRootElementURI() == 'http://letterSchema'); // a property of the document + +/** + * The type name is taken from the SDO model + * The XML-SDO mapping rules make this either: + * The name of the complexType if there is one (in this case there is) + * The document element name if there no complexType + * This is taken from the xsd + */ +echo "The type name of the root data object is " . $root_do->getTypeName() . "\n"; +assert($root_do->getTypeName() == 'FormLetter'); + +/** + * The type's namespaceURI is taken from the SDO model + * The XML-SDO mapping rules ensure that this will always be the same as + * the namepace URI of the document element + */ +echo "The namespaceURI of the root data object is " . $root_do->getTypeNamespaceURI() . "\n"; +assert($root_do->getTypeNamespaceURI() == 'http://letterSchema'); + +?> + ]]> + </programlisting> + <para> + The output from this program is as follows: + </para> + <programlisting role="xml" xml:id="sdo-das-xml.examples.Example5.output"> +<![CDATA[ +The document element name is letters +The document element is in the namespace http://letterSchema +The type name of the root data object is FormLetter +The namespaceURI of the root data object is http://letterSchema +]]> + </programlisting> + + </example> + + <example> + + <title>Printing the SDO model</title> + + <para> + The XML DAS provides a simple means to see what types and properties + have been loaded. The php "print" or "echo" instruction will + print out the types and properties. + </para> + + <programlisting role="php" xml:id="sdo-das-xml.examples.Example6"> + <![CDATA[ +<?php +/** + * Illustrate printing out the model + */ + +$xmldas = SDO_DAS_XML::create("letter.xsd"); +print $xmldas; + +?> +]]> + </programlisting> + + <para> + The output from this program is as follows: + </para> + <programlisting role="xml" xml:id="sdo-das-xml.examples.Example6.output"> +<![CDATA[ +object(SDO_XML_DAS)#1 { +18 types have been defined. The types and their properties are:: +1. commonj.sdo:BigDecimal +2. commonj.sdo:BigInteger +3. commonj.sdo:Boolean +4. commonj.sdo:Byte +5. commonj.sdo:Bytes +6. commonj.sdo:ChangeSummary +7. commonj.sdo:Character +8. commonj.sdo:DataObject +9. commonj.sdo:Date +10. commonj.sdo:Double +11. commonj.sdo:Float +12. commonj.sdo:Integer +13. commonj.sdo:Long +14. commonj.sdo:Short +15. commonj.sdo:String +16. commonj.sdo:URI +17. http://letterSchema:FormLetter + - date (commonj.sdo:String) + - firstName (commonj.sdo:String) + - lastName (commonj.sdo:String) +18. http://letterSchema:RootType + - letters (http://letterSchema:FormLetter) +]]> + </programlisting> + + </example> + + +</chapter> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sdo_das_xml/setup.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/sdo_das_xml/setup.xml diff -u /dev/null phpdoc/en/reference/sdo_das_xml/setup.xml:1.2 --- /dev/null Mon Dec 24 14:04:54 2007 +++ phpdoc/en/reference/sdo_das_xml/setup.xml Mon Dec 24 14:04:54 2007 @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.2 $ --> + +<chapter xml:id="sdo-das-xml.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + &reftitle.setup; + + <!-- {{{ Requirements --> + <section xml:id="sdo-das-xml.requirements"> + &reftitle.required; + <para> + The SDO XML Data Access Service requires PHP 5.1.0 or higher. + It is packaged with the SDO extension and requires + SDO to have been installed. + See the + <link linkend="sdo.installation">SDO installation instructions</link> + for the details of how to do this. + </para> + </section> + <!-- }}} --> + + <!-- {{{ Installation --> + <section xml:id="sdo-das-xml.installation"> + &reftitle.install; + <para> + The XML Data Access Service is packaged and installed as part of the + <link linkend='ref.sdo'>SDO extension</link>. Please Refer + <link linkend="sdo.installation">SDO installation instructions</link>. + </para> + </section> + <!-- }}} --> + + <!-- {{{ Configuration --> + <section xml:id="sdo-das-xml.configuration"> + &reftitle.runtime; + &no.config; + </section> + <!-- }}} --> + + <!-- {{{ Resources --> + <section xml:id="sdo-das-xml.resources"> + &reftitle.resources; + &no.resource; + </section> + <!-- }}} --> + +</chapter> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml +vi: ts=1 sw=1 +--> + http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/sdo_das_xml/reference.xml?r1=1.24&r2=1.25&diff_format=u Index: phpdoc/en/reference/sdo_das_xml/reference.xml diff -u phpdoc/en/reference/sdo_das_xml/reference.xml:1.24 phpdoc/en/reference/sdo_das_xml/reference.xml:1.25 --- phpdoc/en/reference/sdo_das_xml/reference.xml:1.24 Mon Dec 10 17:06:09 2007 +++ phpdoc/en/reference/sdo_das_xml/reference.xml Mon Dec 24 14:04:54 2007 @@ -1,737 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.24 $ --> -<!-- Purpose: xml --> -<!-- Membership: pecl --> +<!-- $Revision: 1.25 $ --> <reference xml:id="ref.sdo-das-xml" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>SDO XML Data Access Service Functions</title> + <title>SDO XML Data Access Service &Functions;</title> <titleabbrev>SDO DAS XML</titleabbrev> <partintro> - <section xml:id="sdo-das-xml.intro"> - &reftitle.intro; - <para> - In order to use the XML Data Access Service for Service Data Objects, - you will need to understand some of the concepts behind SDO: - the data graph, the data object, XPath and property expressions, - and so on. - If you are not familiar with these ideas, you might want to look first at - <link linkend='ref.sdo'>the section on SDO</link>. - </para> - <para> - The job of the XML DAS is to move data between the - application and an XML data source, which can be either a file or - a URL. SDOs are always created and maintained according to a model - which defines type names and what property names each type may have. - For data which is from XML, this SDO model is built from a schema file - written in XML schema language (an xsd file). This schema file is - usually passed to the create method when the XMLDAS is initialised. - The - <link xlink:href='&url.ibm.sdo;'>SDO 2.0 specification</link> - defines the mapping between XML types and SDO types. - There are a number of small limitations in the PHP support - - not everything which is in the specification can be done - and - these limitations are summarised in a later section. - </para> - </section> - - <section xml:id="sdo-das-xml.requirements"> - &reftitle.required; - <para> - The SDO XML Data Access Service requires PHP 5.1.0 or higher. - It is packaged with the SDO extension and requires - SDO to have been installed. - See the - <link linkend="sdo.installation">SDO installation instructions</link> - for the details of how to do this. - </para> - </section> - - <section xml:id="sdo-das-xml.installation"> - &reftitle.install; - <para> - The XML Data Access Service is packaged and installed as part of the - <link linkend='ref.sdo'>SDO extension</link>. Please Refer - <link linkend="sdo.installation">SDO installation instructions</link>. - </para> - </section> - - <section xml:id='sdo-das-xml.examples'> - &reftitle.examples; - <para> - Several of the following examples are based on the - <link linkend="sdo.sample.sequence">letter example</link> - described in the - <link linkend="ref.sdo">SDO documentation</link>. - The examples assume the XML Schema for the letter is contained in a file - <filename>letter.xsd</filename> - and the letter instance is in the file - <filename>letter.xml</filename>. - These two files are reproduced here: - </para> - <para> - <programlisting role="xml"> -<![CDATA[ -<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" - xmlns:letter="http://letterSchema" - targetNamespace="http://letterSchema"> - <xsd:element name="letters" type="letter:FormLetter"/> - <xsd:complexType name="FormLetter" mixed="true"> - <xsd:sequence> - <xsd:element name="date" minOccurs="0" type="xsd:string"/> - <xsd:element name="firstName" minOccurs="0" type="xsd:string"/> - <xsd:element name="lastName" minOccurs="0" type="xsd:string"/> - </xsd:sequence> - </xsd:complexType> -</xsd:schema> -]]> - </programlisting> - </para> - - <para> - <programlisting role="xml"> -<![CDATA[ -<letter:letters xmlns:letter="http://letterSchema"> - <date>March 1, 2005</date> - Mutual of Omaha - Wild Kingdom, USA - Dear - <firstName>Casy</firstName> - <lastName>Crocodile</lastName> - Please buy more shark repellent. - Your premium is past due. -</letter:letters> -]]> - </programlisting> - </para> - - <example> - <title>Loading, altering, and saving an XML document</title> - - <para> - The following example shows how an XML document can be loaded from a file, - altered, and written back. - </para> - - <programlisting role="php" xml:id="sdo-das-xml.examples.loadfromfile"> - <![CDATA[ -<?php -/** - * Load, update, and save an XML document - */ -try { - $xmldas = SDO_DAS_XML::create("letter.xsd"); - $document = $xmldas->loadFile("letter.xml"); - $root_data_object = $document->getRootDataObject(); - $root_data_object->date = "September 03, 2004"; - $root_data_object->firstName = "Anantoju"; - $root_data_object->lastName = "Madhu"; - $xmldas->saveFile($document, "letter-out.xml"); - echo "New file has been written:\n"; - print file_get_contents("letter-out.xml"); -} catch (SDO_Exception $e) { - print($e->getMessage()); -} -?> ]]> - </programlisting> - - <para> - An instance of the XML DAS is first obtained from the - <function>SDO_DAS_XML::create</function> - method, - which is a static method of the - <classname>SDO_DAS_XML</classname> - class. - The location of the xsd is passed as a parameter. - Once we have an instance of the XML DAS initialised - with a given schema, - we can use it to load the instance document using the - <function>loadFile</function> - method. - There is also a - <function>loadString</function> - method if you want to load an XML - instance document from a string. - If the instance document loads successfully, - you will be returned an object of type - <classname>SDO_DAS_XML_Document</classname>, - on which you can call the - <function>getRootDataObject</function> - method to get the SDO data object which is the root - of the SDO data graph. - You can then use SDO operations to change the graph. - In this example we alter the - <varname>date</varname>, - <varname>firstName</varname>, and - <varname>lastName</varname> properties. - Then we use the - <function>saveFile</function> - method to write the changed document back to the file system. - The saveFile method has an optional extra integer argument which if specified - will cause the XML DAS to format the XML, using the integer as the amount to - indent by at each change in level on the document. - </para> - - <para> - This will write the following to <filename>letter-out.xml</filename>. - </para> - - <programlisting role="xml" xml:id="sdo-das-xml.examples.loadfromfile.output"> - <![CDATA[ -<?xml version="1.0" encoding="UTF-8"?> -<FormLetter xmlns="http://letterSchema" xsi:type="FormLetter" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> - <date>September 03, 2004</date> - Mutual of Omaha - Wild Kingdom, USA - Dear - <firstName>Anantoju</firstName> - <lastName>Madhu</lastName> - Please buy more shark repellent. - Your premium is past due. -</FormLetter> -]]> - </programlisting> - - </example> - - <example> - - <title>Creating a new XML document</title> - - <para> - The previous example loaded the document from a file. - This example shows how to create an SDO data graph in memory. - In this example it is then saved to an XML string. - Furthermore, because the letter contains both structured and - unstructured content, it uses - <link linkend="sdo.sample.sequence">the Sequence API</link> - as well assignments to properties to construct the data graph. - </para> - - <programlisting role="php" xml:id="sdo-das-xml.examples.create"> - <![CDATA[ -<?php -/** - * Create an XML document from scratch - */ -try { - $xmldas = SDO_DAS_XML::create("letter.xsd"); - try { - $doc = $xmldas->createDocument(); - $rdo = $doc->getRootDataObject(); - $seq = $rdo->getSequence(); - $seq->insert("April 09, 2005", NULL, 'date'); - $seq->insert("Acme Inc. ", NULL, NULL); - $seq->insert("United Kingdom. "); - $seq->insert("Dear", NULL, NULL); - $seq->insert("Tarun", NULL, "firstName"); - $seq->insert("Nayaraaa", NULL, "lastName"); - $rdo->lastName = "Nayar"; - $seq->insert("Please note that your order number "); - $seq->insert(12345); - $seq->insert(" has been dispatched today. Thanks for your business with us."); - print($xmldas->saveString($doc)); - } catch (SDO_Exception $e) { - print($e); - } -} catch (SDO_Exception $e) { - print("Problem creating an XML document: " . $e->getMessage()); -} -?> - ]]> - </programlisting> - - </example> - - <para> - The - <function>createDocument</function> - method on the XML DAS returns a document object - with a single root data object corresponding to an empty document element. - The element name of the document element is known from the schema file. - If there is any ambiguity about what the document element is, as there can be - when more than one schema has been loaded into the same XML DAS, - the element name and the namespace URI can be passed to the - <function>createDocument</function> - method. - </para> - - <para> - This will emit the following output (line breaks have been inserted for readability): - </para> - - <programlisting role="xml" xml:id="sdo-das-xml.examples.create.output"> - <![CDATA[ -<?xml version="1.0" encoding="UTF-8"?> -<FormLetter xmlns="http://letterSchema" xsi:type="FormLetter" -xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> -<date>April 09, 2005</date> -Acme Inc. United Kingdom. -Dear -<firstName>Tarun</firstName> -<lastName>Nayar</lastName> -Please note that your order number 12345 has been -dispatched today. Thanks for your business with us. -</FormLetter> -]]> - </programlisting> - - - <example> - - <title>Setting XML document properties</title> - - <para> - This third example shows you how to set the XML version and - encoding on the document object. - These will be used when the XML is written out. - If no XML declaration is wanted at all - (perhaps you want to generate the XML as a string to embed - in something) then you can use the - <function>setXMLDeclaration</function> - method to suppress it. - </para> - - <programlisting role="php" xml:id="sdo-das-xml.examples.Example3"> - <![CDATA[ -<?php -/** - * Illustrate the calls that control the XML declaration - */ - $xmldas = SDO_DAS_XML::create("letter.xsd"); - $document = $xmldas->loadFile("letter.xml"); - $document->setXMLVersion("1.1"); - $document->setEncoding("ISO-8859-1"); - print($xmldas->saveString($document)); -?> ]]> - </programlisting> - - <para> - The XML version and encoding are set in the XML declaration at the top - of the XML document. - </para> - - <programlisting role="xml" xml:id="sdo-das-xml.examples.sdo_das_xml_document.output"> -<![CDATA[ -<?xml version="1.1" encoding="ISO-8859-1"?> -.../... -]]> - </programlisting> - - </example> - - - <example> - <title>Using an open type</title> - <para> - This fourth example illustrates the use of an SDO open type - and the use of the - <function>createDataObject</function> - method. - For this example we use the following two - schema: - </para> - <para> - <programlisting role="xml"> -<![CDATA[ -<schema - xmlns="http://www.w3.org/2001/XMLSchema"> - - <element name="jungle"> - <complexType> - <sequence> - <any minOccurs="0" maxOccurs="unbounded"/> - </sequence> - </complexType> - </element> - -</schema> -]]> - </programlisting> - </para> - - <para> - Note the presence of the - <varname>any</varname> - element in the definition. - This first schema defines the - <varname>jungle</varname> - complex type as containing a sequence of - any other type. - The other types that the example will use are defined in a - second schema file: - </para> - - <para> - <programlisting role="xml"> -<![CDATA[ -<schema xmlns= "http://www.w3.org/2001/XMLSchema"> - - <complexType name="snakeType"> - <sequence> - <element name= "name" type="string"/> - <element name= "length" type="positiveInteger" /> - </sequence> - </complexType> - - <complexType name="bearType"> - <sequence> - <element name= "name" type="string"/> - <element name= "weight" type="positiveInteger" /> - </sequence> - </complexType> - - <complexType name="pantherType"> - <sequence> - <element name= "name" type="string"/> - <element name= "colour" type="string" /> - </sequence> - </complexType> - -</schema> -]]> - </programlisting> - </para> - - <para> - Here is the example PHP code that uses these two schema files: - </para> - - <para> - <programlisting role="php" xml:id="sdo-das-xml.examples.Example4"> - <![CDATA[ -<?php - -/** - * Illustrate open types and the use of the addTypes() method - */ - -$xmldas = SDO_DAS_XML::create(); -$xmldas->addTypes("jungle.xsd"); // this is an open type i.e. the xsd specifies it can contain "any" type -$xmldas->addTypes('animalTypes.xsd'); - -$baloo = $xmldas->createDataObject('','bearType'); -$baloo->name = "Baloo"; -$baloo->weight = 800; - -$bagheera = $xmldas->createDataObject('','pantherType'); -$bagheera->name = "Bagheera"; -$bagheera->colour = 'inky black'; - -$kaa = $xmldas->createDataObject('','snakeType'); -$kaa->name = "Kaa"; -$kaa->length = 25; - -$document = $xmldas->createDocument(); -$do = $document->getRootDataObject(); -$do->bear = $baloo; -$do->panther = $bagheera; -$do->snake = $kaa; - -print($xmldas->saveString($document,2)); - -?> - ]]> - </programlisting> - </para> - <para> - These two schema files are loaded into the XML DAS with first the - <function>create</function> - and - <function>addTypes</function> - methods. - The - <function>createDataObject</function> - method is used to create three separate data objects. - In each case the namespaceURI and typename of the type are passed to the - <function>createDataObject</function> - method: in this example the namespace URI is blank because no - namespace is used in the schema. - Once the three data objects - representing a bear, a panther and a snake - - have been created, a document object is created with the - <function>createDocument</function> - method. - In this case there is no ambiguity about what the document element of the - document should be - as the second schema file only defines complex types, - the document element can only be the global - <varname>jungle</varname> - element defined - in the first schema. - This document will have a single root data object corresponding to an - empty document element <varname>jungle</varname>. - As this is an open type, properties can be added at will. - When the first assignment is made to <varname>$do->bear</varname>, - a property - <varname>bear</varname> - is added to the root data object: - likewise for the next two assignments. - When the document is written out by the - <function>saveString</function> - method, the resulting document is: - </para> - - <para> - <programlisting role="xml"> -<![CDATA[ -<?xml version="1.0" encoding="UTF-8"?> -<jungle xsi:type="jungle" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> - <bear xsi:type="bearType"> - <name>Baloo</name> - <weight>800</weight> - </bear> - <panther xsi:type="pantherType"> - <name>Bagheera</name> - <colour>inky black</colour> - </panther> - <snake xsi:type="snakeType"> - <name>Kaa</name> - <length>25</length> - </snake> -</jungle> -]]> - </programlisting> - </para> - - </example> - - <example> - - <title>Finding out what you can from the document</title> - - <para> - This example is intended to illustrate how you can find the - element name and - namespace of the document element from the XML Document object, and - the SDO type and namespace from the root data object of the XML data - object, and how they relate to one another. - This can be difficult to understand because there are four method calls: - two can be made against the Document object, and two that can be made - against any data object including the root data object. - Because of the rules that define how the SDO model is derived - from the XML model, when the data object concerned is the - root object that represents the document object for the document, - only three possible values can come back from these - four method calls. - - </para> - - <para> - The two method calls that can be made against the document - are <function>getRootElementName</function> and - <function>getRootEelementURI</function>. - These return the element name and namespace of the document element, - respectively. - </para> - - <para> - The two method calls that can be made against any data object are - <function>getTypeName</function> - and - <function>getTypeNamespaceURI</function>. - These return the SDO type name and type namespace of the data object, - respectively. - </para> - - <para> - Always, calling <function>getRootElementURI</function> - on the document object will return the same value as - calling <function>getNamespaceURI</function> on the - root data object. - Essentially, the information is all derived from the first few lines of the - schema file, - where there are three distinct pieces of information. - For illustration, here again are the first few lines of the - letter.xsd that we used above. - </para> - - <programlisting role="xml"> -<![CDATA[ -<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" - xmlns:letter="http://letterSchema" - targetNamespace="http://letterSchema"> - - <xsd:element name="letters" type="letter:FormLetter"/> - - <xsd:complexType name="FormLetter" mixed="true"> - .../... -]]> - </programlisting> - - <para> - The three important values are: - <itemizedlist> - <listitem> - <para> - <varname>letters</varname>, the name of the document element - </para> - </listitem> - <listitem> - <para> - <varname>FormLetter</varname>, the name of the complex type of the document element. - This is also the name of the SDO type of the root data object. - </para> - </listitem> - <listitem> - <para> - <varname>http://letterSchema</varname>, the namespace to which the document element belongs. - This is also the namespaceURI of the SDO type of the root data object. - </para> - </listitem> - </itemizedlist> - It is part of the XML-SDO mapping rules that - when the SDO model is built from the schema file, - the typename and namespaceURI of the SDO types for the root element - are taken - from those of the complex type of the document element, where it exists. - Hence in this example the typename of the root data object is FormLetter. - In the event that there is no separate complex type definition - for the document element, when the the type is defined inline and is - anonymous, - the SDO type name will be the same as the element name. - </para> - - <para> - The following program loads the letter document and checks the - return values from each of the four calls. - </para> - <programlisting role="php" xml:id="sdo-das-xml.examples.Example5"> - <![CDATA[ -<?php -/** - * Finding out what you can about the document and document element - * This can be quite hard to understand because there are four calls - * Two calls are made against the document - * Two calls are made against the root data object and its model - * Because of the SDO-XML mapping rules and how the SDO model is derived - * from the XML model, only three possible values can come back from these four calls. - * Always, $document->getRootElementURI() == (type of root data object)->namespaceURI - * Essentially, it all comes form the first few lines of the xsd: - * <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" - * xmlns:letter="http://letterSchema" - * targetNamespace="http://letterSchema"> - * <xsd:element name="letters" type="letter:FormLetter"/> - */ - -$xmldas = SDO_DAS_XML::create("letter.xsd"); -$document = $xmldas->loadFile("letter.xml"); -$root_do = $document->getRootDataObject(); - -/** - * The "root element name" is the element name of the document element - * in this case 'letters' - * This matches the 'name' attribute of the document element in the xsd and matches - * the element name from the xml - */ -echo "The document element name is " . $document->getRootElementName() . "\n"; -assert($document->getRootElementName() == 'letters'); // a property of the document - -/** - * The "root element URI" is the namespace part of the element name of the document element - * in this case 'http://letterSchema' since 'letters' is in that namespace - * This is taken from the xsd and matches the namespace picked up from the xml - */ -echo "The document element is in the namespace " . $document->getRootElementURI() . "\n"; -assert($document->getRootElementURI() == 'http://letterSchema'); // a property of the document - -/** - * The type name is taken from the SDO model - * The XML-SDO mapping rules make this either: - * The name of the complexType if there is one (in this case there is) - * The document element name if there no complexType - * This is taken from the xsd - */ -echo "The type name of the root data object is " . $root_do->getTypeName() . "\n"; -assert($root_do->getTypeName() == 'FormLetter'); - -/** - * The type's namespaceURI is taken from the SDO model - * The XML-SDO mapping rules ensure that this will always be the same as - * the namepace URI of the document element - */ -echo "The namespaceURI of the root data object is " . $root_do->getTypeNamespaceURI() . "\n"; -assert($root_do->getTypeNamespaceURI() == 'http://letterSchema'); - -?> - ]]> - </programlisting> - <para> - The output from this program is as follows: - </para> - <programlisting role="xml" xml:id="sdo-das-xml.examples.Example5.output"> -<![CDATA[ -The document element name is letters -The document element is in the namespace http://letterSchema -The type name of the root data object is FormLetter -The namespaceURI of the root data object is http://letterSchema -]]> - </programlisting> - - </example> - - <example> - - <title>Printing the SDO model</title> - - <para> - The XML DAS provides a simple means to see what types and properties - have been loaded. The php "print" or "echo" instruction will - print out the types and properties. - </para> - - <programlisting role="php" xml:id="sdo-das-xml.examples.Example6"> - <![CDATA[ -<?php -/** - * Illustrate printing out the model - */ - -$xmldas = SDO_DAS_XML::create("letter.xsd"); -print $xmldas; - -?> -]]> - </programlisting> - - <para> - The output from this program is as follows: - </para> - <programlisting role="xml" xml:id="sdo-das-xml.examples.Example6.output"> -<![CDATA[ -object(SDO_XML_DAS)#1 { -18 types have been defined. The types and their properties are:: -1. commonj.sdo:BigDecimal -2. commonj.sdo:BigInteger -3. commonj.sdo:Boolean -4. commonj.sdo:Byte -5. commonj.sdo:Bytes -6. commonj.sdo:ChangeSummary -7. commonj.sdo:Character -8. commonj.sdo:DataObject -9. commonj.sdo:Date -10. commonj.sdo:Double -11. commonj.sdo:Float -12. commonj.sdo:Integer -13. commonj.sdo:Long -14. commonj.sdo:Short -15. commonj.sdo:String -16. commonj.sdo:URI -17. http://letterSchema:FormLetter - - date (commonj.sdo:String) - - firstName (commonj.sdo:String) - - lastName (commonj.sdo:String) -18. http://letterSchema:RootType - - letters (http://letterSchema:FormLetter) -]]> - </programlisting> - - </example> - - - </section> - - + <!-- FIXME: Upgrade to the new-oo-markup --> <!-- class definition section --> - <section xml:id='sdo-das-xml.classes'> + <section xml:id='sdo-das-xml.classes'><!-- {{{ --> &reftitle.classes; <para> The XML DAS provides two main classes. @@ -746,7 +23,7 @@ xml files. </para> - <section xml:id='sdo-das-xml.class.sdo_das_xml'> + <section xml:id='sdo-das-xml.class.sdo_das_xml'><!-- {{{ --> <title> <classname>SDO_DAS_XML</classname> </title> @@ -756,7 +33,7 @@ and also used to write the data back. Other than the methods to load and save xml files, </para> - <section xml:id='sdo-das-xml.class.SDO_DAS_XML.methods'> + <section xml:id='sdo-das-xml.class.SDO_DAS_XML.methods'><!-- {{{ --> &reftitle.methods; <itemizedlist> @@ -817,11 +94,11 @@ </itemizedlist> - </section> - </section> + </section><!-- }}} --> + </section><!-- }}} --> - <section xml:id='sdo-das-xml.class.sdo_das_xml_document'> + <section xml:id='sdo-das-xml.class.sdo_das_xml_document'><!-- {{{ --> <title> <classname>SDO_DAS_XML_Document</classname> </title> @@ -831,7 +108,7 @@ Lastly, it can also be used to set the XML version and encoding of a document on output. </para> - <section xml:id='sdo-das-xml.class.SDO_DAS_XML_Document.methods'> + <section xml:id='sdo-das-xml.class.SDO_DAS_XML_Document.methods'><!-- {{{ --> &reftitle.methods; <itemizedlist> <listitem> @@ -875,8 +152,8 @@ </para> </listitem> </itemizedlist> - </section> - </section> + </section><!-- }}} --> + </section><!-- }}} --> <section xml:id='sdo-das-xml.class.sdo_das_xml_parserexception'> <title> @@ -1038,6 +315,7 @@ </step> </procedure> </section> + <!-- }}} --> </partintro> &reference.sdo-das-xml.entities.functions;
« previous php.doc.cvs (#806) next »