アプリケーションプログラミングインターフェイスガイド> 組み込み手順> 手順リファレンス> CopyResource
 
CopyResource
指定したリソースを新しい名前を使用してフォルダーにコピーします。
copyModeパラメーターは、newPathで指定されたコンテナーに同じ名前とタイプのリソースが存在する場合の動作を制御します。
copyModeオプションは次のとおりです。
ALTER_NAME_IF_EXISTS:ソースリソースと同じ名前とタイプのリソースがターゲットコンテナにすでに存在する場合は、新しい名前を自動的に生成して競合を回避します。名前は、指定された名前の末尾に番号を追加することによって生成されます。
FAIL_IF_EXISTS:同じ名前とタイプのソースリソースのリソースがターゲットコンテナにすでに存在する場合は失敗します。これが発生した場合、リソースはコピーされません。
OVERWRITE_MERGE_IF_EXISTS:ソースリソースと同じ名前とタイプのリソースがターゲットコンテナにすでに存在する場合は、ターゲットコンテナのリソースを上書きします。ソースリソースがコンテナの場合、ソースコンテナの内容をターゲット内の対応するリソースとマージします。ソースコンテナ内のすべてのリソースはターゲット内のリソースを上書きしますが、上書きされないターゲット内の既存のリソースは変更されません。
OVERWRITE_REPLACE_IF_EXISTS:ソースリソースと同じ名前とタイプのリソースがターゲットコンテナにすでに存在する場合は、ターゲットコンテナのリソースを上書きします。ソースリソースがコンテナの場合は、ターゲットコンテナ内のコンテナをソースコンテナに置き換えます。これは、ソースをコピーする前にターゲット内のコンテナを削除することと同じです。
ロケーション
/lib/resource/
Inputs(入力)
path:コピーするリソースのソースパス。
type:コピーするソースリソースのタイプ。
newPath:リソースをコピーするターゲットコンテナのパス。
newName:コピーされたリソースを呼び出すための新しい名前。
copyMode:有効なvalue:ALTER_NAME_IF_EXISTS、FAIL_IF_EXISTS、OVERWRITE_MERGE_IF_EXISTS、またはOVERWRITE_REPLACE_IF_EXISTS。これらの値は、/lib /resource/ResourceDefs SQL定義セットの定数タブにあります。
Outputs(出力)
該当なし
例外
DuplicateNameException:ターゲットコンテナ内のリソースがソースと同じタイプでnewNameと同じ名前で存在し、コピーモードがFAIL_IF_EXISTSである場合。
IllegalArgumentException:指定されたパスまたはタイプのいずれかが不正な形式である場合、またはcopyModeが有効な値ではない場合。
IllegalStateException:ソースリソースのコピーが許可されていない場合。 /services/databases/system、/services/webservices/system、または物理データソース内のリソースはコピーできません。
NotAllowedException:ソースリソースがターゲットコンテナ内に存在することを許可されていない場合。リソースを物理データソースにコピーすることはできません。 LINKリソースは、/servicesの下のRELATIONAL_DATA_SOURCE、SCHEMA、またはPORTにのみコピーできます。非LINKリソースは、/servicesの下のどの場所にもコピーできません。
NotFoundException:ソースリソースまたは新しいパスの一部が存在しない場合。
SecurityException:ユーザーがソースパス内のすべてのアイテムに対する読み取りアクセス権を持っていない場合。
SecurityException:ユーザーが最後のアイテム以外のnewPathのアイテムに対するREADアクセス権を持っていない場合。
SecurityException:ユーザーがnewPathの最後のアイテムへの書き込みアクセス権を持っていない場合。
SecurityException:ユーザーがいずれかの上書きモードで上書きされるリソースへの書き込みアクセス権を持っていない場合。