メソッド説明

moveTo(DirectoryEntry entry, String name, Function<DirectoryEntry> successCallback, Function<FileError> errorCallback)

ディレクトリを移動します。
移動先に同名のディレクトリが存在する場合は移動先のディレクトリを削除します。

パラメータ

Return

サンプルコード

//ファイルシステムを取得
function() {
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, moveToGotFS, moveToError);
}

//DirectoryEntry取得
function moveToGotFS(fileSystem) {
	fileSystem.root.getDirectory("newDir", null, moveToGetDirectory, moveToError);
}

//ディレクトリ移動
function moveToGetDirectory(directoryEntry) {
	var tmp = directoryEntry.fullPath;
	var parentPath = tmp.substring(0, tmp.lastIndexOf("/"));
	var parentName = parentPath.substring(parentPath.lastIndexOf("/") + 1);
	var parentEntry = new DirectoryEntry(parentName, parentPath);

	directoryEntry.moveTo(parentEntry, "newDir2", moveToSuccess, moveToError);
}

//ディレクトリ移動成功時のcallback処理
function moveToSuccess(entry) {
	var dump = "ディレクトリを移動しました。\n";
	dump    += "name : "     + entry.name     + "\n";
	dump    += "fullPath : " + entry.fullPath + "\n";
	document.getElementById("dumpAreaFile").value = dump;
}

//ディレクトリ移動失敗時のcallback処理
function moveToError(error) {
	var dump = "ディレクトリの移動に失敗しました: \n" + error.code + " : " + errMessageList[error.code];
	document.getElementById("dumpAreaFile").value = dump;
	alert(dump);
}

※

requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

メソッド説明

copyTo(DirectoryEntry entry, String name, Function<DirectoryEntry> successCallback, Function errorCallback)

ディレクトリをコピーします。

パラメータ

Return

サンプルコード

//ファイルシステムを取得
function(){
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, copyToGotFS, copyToError);
}

//DirectoryEntry取得
function copyToGotFS(fileSystem) {
	fileSystem.root.getDirectory("newDir", null, copyToGetDirectory, copyToError);
}

//ディレクトリコピー
function copyToGetDirectory(directoryEntry) {
	var tmp = directoryEntry.fullPath;
	var parentPath = tmp.substring(0, tmp.lastIndexOf("/"));
	var parentName = parentPath.substring(parentPath.lastIndexOf("/") + 1);
	var parentEntry = new DirectoryEntry(parentName, parentPath);

	directoryEntry.copyTo(parentEntry, "newDir3", copyToSuccess, copyToError);
}

//ディレクトリコピー成功時のcallback処理
function copyToSuccess(entry) {
	var dump = "ディレクトリをコピーしました。\n";
	dump    += "name : "     + entry.name     + "\n";
	dump    += "fullPath : " + entry.fullPath + "\n";
	document.getElementById("dumpAreaFile").value = dump;
}

//ディレクトリコピー失敗時のcallback処理
function copyToError(error) {
	var dump = "ディレクトリのコピーに失敗しました: \n" + error.code + " : " + errMessageList[error.code];
	document.getElementById("dumpAreaFile").value = dump;
	alert(dump);
}

※

requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

メソッド説明

toURL() : String

ディレクトリをアクセス可能な文字列に変換します。

パラメータ

Return

サンプルコード

//ファイルシステムを取得
function(){
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, toURLGotFS, toURLError);
}

//DirectoryEntry取得
function toURLGotFS(fileSystem) {
	fileSystem.root.getDirectory("newDir", null, toURLGetDirectory, toURLError);
}

//ディレクトリのURLを取得する
function toURLGetDirectory(directoryEntry) {
	var directoryURL = directoryEntry.toURL();
	var dump = "ディレクトリのURLを取得しました。\n";
	dump    += "URL : " + directoryURL + "\n";
	document.getElementById("dumpAreaFile").value = dump;
}

//ディレクトリのURLを取得失敗時のcallback処理
function toURLError(error) {
	var dump = "ディレクトリURLの取得に失敗しました: \n" + error.code + " : " + errMessageList[error.code];
	document.getElementById("dumpAreaFile").value = dump;
	alert(dump);
}

※

requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

メソッド説明

remove(Function successCallback, Function<FileError> errorCallback)

中身が空のディレクトリを削除します。

パラメータ

Return

サンプルコード(ファイル削除)

//ファイルシステムを取得
function(){
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, deleteFileGotFS, deleteFileError);
}

//FileEntry取得
function deleteFileGotFS(fileSystem) {
	var fileNm = document.getElementById("fileName").value;
	fileSystem.root.getFile(fileNm, null, deleteFileGotFileEntry, deleteFileError);
}

//ファイル削除
function deleteFileGotFileEntry(fileEntry) {
	fileEntry.remove(deleteFileSuccess, deleteFileError);
}

//ファイル削除成功時のcallback処理
function deleteFileSuccess() {
	var dump = "ファイルを削除しました。\n";
	document.getElementById("dumpAreaFile").value = dump;
}

//ファイル削除失敗時のcallback処理
function deleteFileError(error) {
	var dump = "ファイルの削除に失敗しました: \n" + error.code + " : " + errMessageList[error.code];
	document.getElementById("dumpAreaFile").value = dump;
	alert(dump);
}

※

requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

メソッド説明

getParent(Function<DirectoryEntry> successCallback, Function errorCallback)

親ディレクトリを取得します。

パラメータ

Return

サンプルコード

//ファイルシステムを取得
function(){
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, getParentGotFS, getParentError);
}

//親ディレクトリのDirectoryEntryを取得
function getParentGotFS(fileSystem) {
	fileSystem.root.getDirectory("newDir", null, getParentGetDirectory, getParentError);
}

//親ディレクトリを取得
function getParentGetDirectory(directoryEntry) {
	directoryEntry.getParent(getParentSuccess, getParentError);
}

//親ディレクトリを取得成功時のcallback処理
function getParentSuccess(entry) {
	var dump = "親ディレクトリを取得しました。\n";
	dump    += "name : "     + entry.name     + "\n";
	dump    += "fullPath : " + entry.fullPath + "\n";
	document.getElementById("dumpAreaFile").value = dump;
}

//親ディレクトリを取得失敗時のcallback処理
function getParentError(error) {
	var dump = "親ディレクトリの取得に失敗しました: \n" + error.code + " : " + errMessageList[error.code];
	document.getElementById("dumpAreaFile").value = dump;
	alert(dump);
}

※

requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

メソッド説明

createReader() : DirectoryReader

ディレクトリに含まれるファイルとディレクトリを取得するオブジェクトを作成します。

パラメータ

Return

サンプルコード

//ファイルシステムを取得
function directoryReader1(){
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, directoryReader1_gotFS, directoryReader1_fail);
}
//指定ディレクトリからファイルを読み込み
function directoryReader1_gotFS(fileSystem) {
	var directoryReader = fileSystem.root.createReader();//取得オブジェクトの作成
	directoryReader.readEntries(directoryReader1_readEntries, directoryReader1_fail);
}
//ファイル一覧取得成功時のcallback処理
function directoryReader1_readEntries(entries) {
	var dump = "directoryReader1_readEntries\n";
	document.getElementById("dumpAreaFile").value =dump;

	var i;
	for (i=0; i<entries.length; i++) {
		document.getElementById("dumpAreaFile").value += entries[i].name+(entries[i].isDirectory?"/":"")+"\n";
	}
}
//ファイル一覧取得失敗時のcallback処理
function directoryReader1_fail(error) {
	alert("directoryReader1_fail: " + error.code);
}

※

requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

メソッド説明

getDirectory(String path, DirectoryOptions options, Function<DirectoryEntry> successCallback, Function<FileError> errorCallback)

ディレクトリを取得または作成します。

パラメータ

Return

サンプルコード

//ファイルシステムを取得
function() {
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, mkdirGotFS, mkdirError);
}

//DirectoryEntry取得
function mkdirGotFS(fileSystem) {
	fileSystem.root.getDirectory("newDir", {create: true, exclusive: false}, mkdirGetDirectory, mkdirError);
}

//ディレクトリ作成成功時のcallback処理
function mkdirGetDirectory(directoryEntry) {
	var dump = "ディレクトリを作成しました。\n";
	dump    += "name : "     + directoryEntry.name     + "\n";
	dump    += "fullPath : " + directoryEntry.fullPath + "\n";
	document.getElementById("dumpAreaFile").value = dump;
}

//ディレクトリ作成失敗時のcallback処理
function mkdirError(error) {
	var dump = "ディレクトリの作成に失敗しました: \n" + error.code + " : " + errMessageList[error.code];
	document.getElementById("dumpAreaFile").value = dump;
	alert(dump);
}

※

requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

メソッド説明

getFile(String path, FileOptions options, Function<FileEntry> successCallback, Function<FileError> errorCallback)

ファイルを取得または作成します。

パラメータ

Return

サンプルコード

//ファイルシステムを取得
function fileWrite1(){
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, fileWrite1_gotFS, fileWrite1_fail);
}
//ファイルシステムを取得成功時のcallback処理
function fileWrite1_gotFS(fileSystem) {
	fileSystem.root.getFile("readme.txt", {create: true, exclusive: false}, fileWrite1_gotFileEntry, fileWrite1_fail);//ファイルを作成
}
//ファイル取得成功時のcallback処理
function fileWrite1_gotFileEntry(fileEntry) {
	fileEntry.createWriter(fileWrite1_gotFileWriter, fileWrite1_fail);
}
//ファイル取得失敗時のcallback処理
function fileWrite1_fail(error) {
	var dump = "fileWrite1_fail\n";
	dump += "code:"+error.code+"\n";
	document.getElementById("dumpAreaFile").value =dump;
}
//取得したファイルへの書き込み処理
function fileWrite1_gotFileWriter(writer) {
	var dump = "fileWrite1_gotFileWriter\n";
	document.getElementById("dumpAreaFile").value =dump;

	writer.onwritestart = function(evt) {
		document.getElementById("dumpAreaFile").value += "onwritestart\n";
	};
	writer.onabort = function(evt) {
		document.getElementById("dumpAreaFile").value += "onabort\n";
	};
	writer.onwrite = function(evt) {
		document.getElementById("dumpAreaFile").value += "onwrite\n";
	};
	writer.onerror = function(evt) {
		document.getElementById("dumpAreaFile").value += "onerror\n";
	};
	writer.onwriteend = function(evt) {
		document.getElementById("dumpAreaFile").value += "onwriteend\n";
	};
	writer.write("some sample text 1");
}

※

requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

メソッド説明

removeRecursively(Function successCallback, Function<FileError> errorCallback)

ディレクトリ自身を削除します。ディレクトリ内に含まれるファイルも一緒に削除されます。

パラメータ

Return