How do I expose XMLType data in the repository

Question

Assume the PO schema po.xsd
[oracle@chambers oracle]$ head po.xsd
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
           xmlns:xdb="http://xmlns.oracle.com/xdb"
           version="1.0"
           xdb:storeVarrayAsTable="true">
  <xs:element name="PurchaseOrder" type="PurchaseOrderType" xdb:defaultTable="PURCHASEORDER"/>
  <xs:complexType name="PurchaseOrderType" xdb:SQLType="PURCHASEORDER_T">
    <xs:sequence>
      <xs:element name="Reference" type="ReferenceType" minOccurs="1" xdb:SQLName="REFERENCE"/>
      <xs:element name="Actions" type="ActionsType" xdb:SQLName="ACTIONS"/>
      <xs:element name="Reject" type="RejectionType" minOccurs="0" xdb:SQLName="REJECTION"/>
...I have a document that conforms to the schema purchaseorder.xml
[oracle@chambers oracle]$ more purchaseorder.xml
<PurchaseOrder xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.nubridges.com/jchambers/po">
  <Reference>SBELL-2002100912333601PDT</Reference>
  <Actions>
    <Action>
      <User>SVOLLMAN</User>
    </Action>
  </Actions>
  <Reject/>
  <Requestor>Sarah J. Bell</Requestor>
  <User>SBELL</User>
  <CostCenter>S30</CostCenter>
  <ShippingInstructions>
    <name>Sarah J. Bell</name>
    <address>400 Oracle Parkway
Redwood Shores
CA
94065
USA</address>
Step 1. Register the schema
  DBMS_XMLSCHEMA.registerSchema(
    SCHEMAURL => 'http://www.nubridges.com/jchambers/po',
    SCHEMADOC => bfilename('ORACLE_USER_HOME', 'po.xsd'),
    CSID      => nls_charset_id('AL32UTF8'));
Step 2. Verify the registration
SQL> desc purchaseorder
Name                                      Null?    Type
TABLE of SYS.XMLTYPE(XMLSchema "http://www.nubridges.com/jchambers/po" Element "PurchaseOrder") STORAGE Object-relational TYPE "PURCHASEORDER_T"
Step 3. Insert a valid PO into the database
insert into purchaseorder values(XMLType(bfilename('ORACLE_USER_HOME', 'purchaseorder.xml'), nls_charset_id('AL32UTF8')));
Step 4. Verify PO insert ok
SQL> select * from purchaseorder
  2  ;
SYS_NC_ROWINFO$
<PurchaseOrder xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamesNow, I want to be able to expose the purchase order via HTTP/WebDav. In other words, I want to create a repository resource.
Step 5. Create a folder
DECLARE
  b BOOLEAN;
BEGIN
  b := DBMS_XDB.createFolder('/jchambers');
END;
Step 6. Create the resource.
How do I do this using DBMS_XDB.createResource?
I know I want to use one of these approaches, but how (I need some examples):
Creates a new resource with the given XMLType data as its contents:
DBMS_XDB.CREATERESOURCE(
   path    IN  VARCHAR2,
   data    IN  SYS.XMLTYPE)
RETURN BOOLEAN;Given a REF to an existing XMLType row, creates a resource whose contents point to that row. That row should not already exist inside another resource:
DBMS_XDB.CREATERESOURCE(
   path     IN  VARCHAR2,
   datarow  IN  REF SYS.XMLTYPE)
RETURN BOOLEAN;Please advise. Thanks

Answer 1

Step 6. Create the resource.
How do I do this using DBMS_XDB.createResource?
Creates a new resource with the given XMLType data as its contents:
In this case you do not need to insert the row into the table. When you create the resource XML DB will automatically store the contents of the resource in the table for you...
Eg
declare
  res boolean;
begin
  res :=  dbms_xdb.createResource('/jchambers/purchaseorder.xml',
                                         bfilename('ORACLE_USER_HOME', 'purchaseorder.xml'),  nls_charset_id('AL32UTF8'));
end;
/Given a REF to an existing XMLType row, creates a resource whose contents
point to that row. That row should not already exist inside another resource:
declare
  res boolean;
  xmlref ref xmltype;
begin
  select ref(x)
     into xmlref
     from PURCHASEORDER x
    where existsNode(object_value,'/Some/Xpath/That/Identifies/Exactly/One/Row') = 1;
  res :=  dbms_xdb.createResource('/jchambers/purchaseorder.xml',xmlref);
end;
/