Name
XMLType.createXML — Creates an XML Type instance.
Synopsis
static method XMLType.createXML ( |
in src any , |
in schema_uri varchar , | |
in validated integer , | |
in wellformed any
) ; |
Description
The static method creates an XMLType instance from the
src
XML entity. If the
parameter src
is not an XML
entity then it is converted to it via an internal call of
xtree_doc()
or xml_tree_doc()
. A schema may be associated with
an XML entity by passing its URI as schema_uri
; this schema can be used
later to validate the structure of the document.
Parameters
src
An XML entity or a value that can be converted to an XML entity.
schema_uri
A URI of the schema of the document. The default is NULL to make result non-schema based.
validated
An integer flag that indicates if the document is already validated against the schema of the document (this is to avoid redundant validations). The default is 0.
wellformed
This parameter is unused and is listed solely for compatibility.
Return Types
The method returns a new instance of XMLType.
Examples
Example24.546.Creating instances of XMLType
The procedure creates two instances (a schema-based and a non schema-based) and demonstrates that these instances are filled with proper data.
create procedure createxml_test () { declare test1 XMLType; declare test2 XMLType; declare PROBE varchar; result_names (PROBE); test1 := createXML ('<test attr="value1"/>'); test2 := createXML ('<test attr="value2"/>', 'http://www.example.com/test.xsd'); result (concat ( '"test1" is created as non schema-based, URI=', cast (test1.getSchemaURL() as varchar) ) ); result (concat ( 'Sample data from "test1": value of test/@attr is ', test1.extract ('test/@attr') ) ); result (concat ( '"test2" is created as schema-based, URI=', test2.getSchemaURL() ) ); result (concat ( 'Sample data from "test2": value of test/@attr is ', test2.extract ('test/@attr') ) ); } createxml_test () PROBE VARCHAR _______________________________________________________________________________ "test1" is created as non schema-based, URI= Sample data from "test1": value of test/@attr is value1 "test2" is created as schema-based, URI=http://www.example.com/test.xsd Sample data from "test2": value of test/@attr is value2 4 Rows. -- 00000 msec.