DBMS_XDBRESOURCE
パッケージは、リソースのメタデータと内容を操作するインタフェースを提供します。
関連項目: DBMS_XDBRESOURCE の使用方法の例は、『Oracle XML DB開発者ガイド』を参照してください。 |
この章では、次の項目について説明します。
DBMS_XDBRESOURCE
パッケージでは、リソースのメタデータと内容を取得および設定するルーチンが提供されています。 DBMS_XMLDOM
パッケージに用意されているDOMトラバース機能を利用するには、DBMS_XDBRESOURCE
.MAKEDOCUMENT
ルーチンを使用して、XDBResource
インスタンスをDOMDocument
タイプに変換します。
表150-1 DBMS_XDBRESOURCEパッケージのサブプログラム
サブプログラム | 説明 |
---|---|
|
XDBResourceに使用されているすべてのメモリーを解放します。 |
|
XDBResourceを指定すると、そのACLを文字列として戻します。 |
|
指定したリソースのACLドキュメントを |
|
XDBResourceを指定すると、その作成者を戻します。 |
|
XDBResourceを指定すると、そのキャラクタ・セットを戻します。 |
|
XDBResourceを指定すると、そのコメントを戻します。 |
|
リソースの内容を |
|
リソースの内容を |
|
リソースの内容を |
|
XDBResourceを指定すると、そのコンテンツ・タイプを戻します。 |
|
リソースの内容をXMLとして戻します。 |
|
リソースの内容を文字列として戻します。 |
|
XDBResourceを指定すると、その作成日を戻します。 |
|
XDBResourceを指定すると、その作成者を戻します。 |
|
メタデータにxpathと名前空間を指定すると、要求されたカスタム・メタデータを戻します。 |
|
XDBResourceを指定すると、その表示名を戻します。 |
|
XDBResourceを指定すると、その言語を戻します。 |
|
XDBResourceを指定すると、その最終変更者を戻します。 |
|
XDBResourceを指定すると、その変更日を戻します。 |
|
XDBResourceを指定すると、その所有者を戻します。 |
|
XDBResourceを指定すると、その参照数を戻します。 |
|
XDBResourceを指定すると、そのバージョンIDを戻します。 |
|
特定のリソースのACLが変更された場合は |
|
特定のリソースのACLが変更された場合は |
|
特定のXPathで示される要素または属性が変更された場合は |
|
特定のリソースのキャラクタ・セットが変更された場合は |
|
特定のリソースのコメントが変更された場合は |
|
特定のリソースの内容が変更された場合は |
|
特定のリソースのコンテンツ・タイプが変更された場合は |
|
特定のリソースの作成日が変更された場合は |
|
特定のリソースの作成者が変更された場合は |
HASCUSTOMMETADATACHANGEDファンクション |
このXPathのカスタム・メタデータが変更された場合はTRUE、それ以外の場合は |
|
特定のリソースの表示名が変更された場合は |
|
特定のリソースの言語が変更された場合は |
|
特定のリソースの最終変更者が変更された場合は |
HASMODIFICATIONDATECHANGEDファンクション |
特定のリソースの変更日が変更された場合は |
|
特定のリソースの所有者が変更された場合は |
|
特定のリソースの参照数が変更された場合は |
|
特定のリソースのバージョンIDが変更された場合は |
|
特定のリソースがフォルダの場合は |
|
入力したリソースが |
|
XDBResourceをXMLDOMインタフェースを使用して処理できるDOMDocumentに変換します。 |
|
リソースを任意の変更で更新します。 |
|
特定のXDBResourceのACLを指定したパスに設定します。 |
|
特定のXDBResourceの作成者を指定した文字列に設定します。 |
|
特定のXDBResourceのキャラクタ・セットを指定したキャラクタ・セットに設定します。 |
|
特定のXDBResourceに対応するコメントを設定します。 |
|
特定のリソースの内容を特定の |
|
特定のXDBResourceのコンテンツ・タイプを設定します。 |
|
XPathと名前空間で指定したカスタム・メタデータを新規データに設定します。 |
|
特定のXDBResourceの表示名を設定します。 |
|
特定のXDBResourceの言語を設定します。 |
|
特定のXDBResourceの所有者を設定します。 |
このファンクションは、XDBResourceに使用されているすべてのメモリーを解放します。
構文
DBMS_XDBRESEROUCE.FREERESOURCE ( res IN XDBResource) RETURN VARCHAR2;
パラメータ
XDBResourceを指定すると、このファンクションはそのACLを文字列として戻します。
構文
DBMS_XDBRESEROUCE.GETACL ( res IN XDBResource) RETURN VARCHAR2;
パラメータ
このファンクションは、指定したリソースのACLドキュメントをXMLType
として戻します。
構文
DBMS_XDBRESEROUCE.GETACLDOCFROMRES ( res IN XDBResource) RETURN SYS.XMLTYPE;
パラメータ
XDBResourceを指定すると、このファンクションはその作成者を戻します。
構文
DBMS_XDBRESEROUCE.GETAUTHOR ( res IN XDBResource) RETURN VARCHAR2;
パラメータ
XDBResourceを指定すると、このファンクションはそのキャラクタ・セットを戻します。
構文
DBMS_XDBRESEROUCE.GETCHARACTERSET ( res IN XDBResource) RETURN VARCHAR2;
パラメータ
XDBResourceを指定すると、このファンクションはそのコメントを戻します。
構文
DBMS_XDBRESEROUCE.GETCOMMENT ( res IN XDBResource) RETURN VARCHAR2;
パラメータ
このファンクションは、リソースの内容をBLOB
として戻します。
構文
DBMS_XDBRESEROUCE.GETCONTENTBLOB ( res IN XDBResource) RETURN BLOB;
パラメータ
このファンクションは、リソースの内容をCLOB
として戻します。
構文
DBMS_XDBRESEROUCE.GETCONTENTCLOB ( res IN XDBResource) RETURN CLOB;
パラメータ
このファンクションは、リソースの内容をXMLTypeRef
として戻します。
構文
DBMS_XDBRESEROUCE.GETCONTENTREF ( res IN XDBResource) RETURN VARCHAR2;
パラメータ
XDBResourceを指定すると、このファンクションはそのコンテンツ・タイプを戻します。
構文
DBMS_XDBRESEROUCE.GETCONTENTTYPE ( res IN XDBResource) RETURN VARCHAR2;
パラメータ
このファンクションは、リソースの内容をXMLTypeRef
として戻します。
構文
DBMS_XDBRESEROUCE.GETCONTENTXML ( res IN XDBResource) RETURN XMLType;
パラメータ
このファンクションは、リソースの内容を文字列として戻します。
構文
DBMS_XDBRESEROUCE.GETCONTENTVARCHAR2 ( res IN XDBResource) RETURN VARCHAR2;
パラメータ
XDBResourceを指定すると、このファンクションはその作成日を戻します。
構文
DBMS_XDBRESEROUCE.GETCREATIONDATE ( res IN XDBResource) RETURN TIMESTAMP;
パラメータ
XDBResourceを指定すると、このファンクションはその作成者を戻します。
構文
DBMS_XDBRESEROUCE.GETCREATOR ( res IN XDBResource) RETURN VARCHAR2;
パラメータ
メタデータにxpathと名前空間を指定すると、このファンクションは要求されたカスタム・メタデータを戻します。
構文
DBMS_XDBRESEROUCE.GETCUSTOMMETADATA ( res IN XDBResource, xpath IN VARCHAR2, namespace IN VARCHAR2) RETURN XMLType;
パラメータ
表150-16 GETCUSTOMMETADATAファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
XDBResource。 |
|
カスタム・メタデータのXPath。 |
|
名前空間。 |
使用上の注意
XPath式の1番目の要素は"Resource"である必要があります。
XDBResourceを指定すると、このファンクションはその表示名を戻します。
構文
DBMS_XDBRESEROUCE.GETDISPLAYNAME ( res IN XDBResource) RETURN VARCHAR2;
パラメータ
XDBResourceを指定すると、このファンクションはその言語を戻します。
構文
DBMS_XDBRESEROUCE.GETLANGUAGE ( res IN XDBResource) RETURN VARCHAR2;
パラメータ
XDBResourceを指定すると、このファンクションはその最終変更者を戻します。
構文
DBMS_XDBRESEROUCE.GETLASTMODIFIER ( res IN XDBResource) RETURN VARCHAR2;
パラメータ
XDBResourceを指定すると、このファンクションはその変更日を戻します。
構文
DBMS_XDBRESEROUCE.GETMODIFICATIONDATE ( res IN XDBResource) RETURN TIMESTAMP;
パラメータ
XDBResourceを指定すると、このファンクションはその所有者を戻します。
構文
DBMS_XDBRESEROUCE.GETOWNER ( res IN XDBResource) RETURN VARCHAR2;
パラメータ
XDBResourceを指定すると、このファンクションはその参照数を戻します。
構文
DBMS_XDBRESEROUCE.GETREFCOUNT ( res IN XDBResource) RETURN PLS_INTEGER;
パラメータ
XDBResourceを指定すると、このファンクションはそのバージョンIDを戻します。
構文
DBMS_XDBRESEROUCE.GETVERSIONID ( res IN XDBResource) RETURN PLS_INTEGER;
パラメータ
このファンクションは、特定のリソースのACLが変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASACLCHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースの作成者が変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASAUTHORCHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
XPathを指定すると、このファンクションはXPathで示される要素または属性が変更されているかどうかを判別します。
構文
DBMS_XDBRESEROUCE.HASCHANGED ( res IN XDBResource, xpath IN VARCHAR2, namespace IN VARCHAR2) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースのキャラクタ・セットが変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASCHARACTERSETCHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースのコメントが変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASCOMMENTCHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースの内容が変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASCONTENTCHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースのコンテンツ・タイプが変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASCONTENTTYPECHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースの作成日が変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASCREATIONDATECHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースの作成者が変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASCREATORCHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースのカスタム・メタデータが変更されているかどうかをチェックします。
構文
DBMS_XDBRESEROUCE.HASCUSTOMMETADATACHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースの表示名が変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASDISPLAYNAMECHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースの言語が変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASLANGUAGECHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースの最終変更者が変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASLASTMODIFIERCHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースの変更日が変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASMODIFICATIONDATECHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースの所有者が変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASOWNERCHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースの参照数が変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASREFCOUNTCHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースのバージョンIDが変更された場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.HASVERSIONIDCHANGED ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、特定のリソースがフォルダの場合はTRUE
、それ以外の場合はFALSE
を戻します。
構文
DBMS_XDBRESEROUCE.ISFOLDER ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、入力したリソースがNULL
の場合にTRUE
を戻します。
構文
DBMS_XDBRESEROUCE.ISNULL ( res IN XDBResource) RETURN BOOLEAN;
パラメータ
このファンクションは、XDBResourceを、XMLDOMインタフェースを使用して処理できるDOMDocumentに変換します。
構文
DBMS_XDBRESEROUCE.MAKEDOCUMENT ( res IN XDBResource) RETURN DBMS_XMLDOM.DOMDocument;
パラメータ
このプロシージャは、リソースを任意の変更で更新します。
構文
DBMS_XDBRESEROUCE.SAVE ( res IN XDBResource);
パラメータ
このプロシージャは、特定のXDBResourceのACLを指定したパスに設定します。
構文
DBMS_XDBRESEROUCE.SETACL ( res IN OUT XDBResource, ACLPath IN VARCHAR2);
パラメータ
このプロシージャは、特定のXDBResourceの作成者を指定した文字列に設定します。
構文
DBMS_XDBRESEROUCE.SETAUTHOR ( res IN OUT XDBResource, author IN VARCHAR2);
パラメータ
このプロシージャは、特定のXDBResourceのキャラクタ・セットを指定したキャラクタ・セットに設定します。
構文
DBMS_XDBRESEROUCE.SETCHARACTERSET ( res IN OUT XDBResource, charSet IN VARCHAR2);
パラメータ
このプロシージャは、特定のXDBResourceに対応するコメントを設定します。
構文
DBMS_XDBRESEROUCE.SETCOMMENT ( res IN OUT XDBResource, comment IN VARCHAR2);
パラメータ
このプロシージャは、特定のリソースの内容を特定のデータタイプに置き換えます。
構文
DBMS_XDBRESEROUCE.SETCONTENT ( res IN OUT XDBResource, data IN BFILE, csid IN NUMBER); DBMS_XDBRESEROUCE.SETCONTENT ( res IN OUT XDBResource, data IN BLOB, csid IN PLS_INTEGER); DBMS_XDBRESEROUCE.SETCONTENT ( res IN OUT XDBResource, data IN CLOB); DBMS_XDBRESEROUCE.SETCONTENT ( res IN OUT XDBResource, data IN REF SYS.XMLType, sticky IN BOOLEAN := TRUE); DBMS_XDBRESEROUCE.SETCONTENT ( res IN OUT XDBResource, data IN VARCHAR2); DBMS_XDBRESEROUCE.SETCONTENT ( res IN OUT XDBResource, data IN SYS.XMLType);
パラメータ
表150-49 SETCONTENTプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
XDBResource。 |
|
|
|
|
|
|
このプロシージャは、特定のXDBResourceのコンテンツ・タイプを設定します。
構文
DBMS_XDBRESEROUCE.SETCONTENTTYPE ( res IN OUT XDBResource, conttype IN VARCHAR2);
パラメータ
このプロシージャは、XPathと名前空間で指定したカスタム・メタデータを新規データに設定します。
構文
DBMS_XDBRESEROUCE.SETCUSTOMMETADATA ( res IN OUT XDBResource, xpath IN VARCHAR2, namespace IN VARCHAR2, newMetadata IN XMLType);
パラメータ
表150-51 SETCUSTOMMETADATAプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
XDBResource。 |
|
変更するXPath。 |
|
使用する名前空間。 |
|
特定のXPathのメタデータを置き換える必要がある新規データ。 |
使用上の注意
XPath式の1番目の要素は"Resource"である必要があります。
このプロシージャは、特定のXDBResourceの表示名を設定します。
構文
DBMS_XDBRESEROUCE.SETDISPLAYNAME ( res IN OUT XDBResource, name IN VARCHAR2);
パラメータ
このプロシージャは、特定のXDBResourceの言語を設定します。
構文
DBMS_XDBRESEROUCE.SETLANGUAGE ( res IN OUT XDBResource, ACLPath IN VARCHAR2);
パラメータ
このプロシージャは、特定のXDBResourceの所有者を設定します。
構文
DBMS_XDBRESEROUCE.SETOWNER ( res IN OUT XDBResource, owner IN VARCHAR2);
パラメータ