メソッド説明

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

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

パラメータ

Return

ver.2.0用サンプルコード

//ファイルシステムを取得
function copyTo() {
	applican.filesystem.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 applican.filesystem.createDirectoryEntry(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 + " : " + FileError[error];
	document.getElementById("dumpAreaFile").value = dump;
	alert(dump);
}

※

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

メソッド説明

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

createReader() : DirectoryReader

Return

ver.2.0用サンプルコード

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

//指定ディレクトリからファイルを読み込み
function getFileListGotFS(fileSystem) {
	//取得オブジェクトの作成
	var directoryReader = fileSystem.root.createReader();
	directoryReader.readEntries(getFileListReadEntries, getFileListError);
}

//ファイル一覧取得成功時のcallback処理
function getFileListReadEntries(entries) {
	var dump = "ファイル一覧を取得しました。\n";
	document.getElementById("dumpAreaFile").value = dump;

	for(var i = 0; i < entries.length; i++) {
		document.getElementById("dumpAreaFile").value += entries[i].name + (entries[i].isDirectory ? "/" : "" ) + "\n";
	}
}

//ファイル一覧取得失敗時のcallback処理
function getFileListError(error) {
		var dump = "ファイル一覧の取得に失敗しました。: \n" + error + " : " + FileError[error];
		document.getElementById("dumpAreaFile").value = dump;
		alert(dump);
}

※

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

メソッド説明

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

第一引数で指定したディレクトリ内にあるディレクトリを取得します。
オプションを指定することでディレクトリを作成することもできます。

パラメータ

Return

サンプルコード

//ファイルシステムを取得
function mkdir() {
	applican.filesystem.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 + " : " + FileError[error];
	document.getElementById("dumpAreaFile").value = dump;
	alert(dump);
}

※

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

メソッド説明

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

パラメータ

Return

サンプルコード

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

//ファイルシステムを取得成功時のcallback処理
function writeFileGotFS(fileSystem) {
	//ファイルを作成
	fileSystem.root.getFile("readme.txt", {create: true, exclusive: false}, writeFileGotFileEntry, writeFileError);
}

//ファイル取得成功時のcallback処理
function writeFileGotFileEntry(fileEntry) {
	fileEntry.createWriter(writeFileGotFileWriter, writeFileError);
}

//ファイル取得失敗時のcallback処理
function writeFileError(error) {
	var dump = "ファイルの書き込みに失敗しました。\n";
	dump += "code:" + error + "\n";
	document.getElementById("dumpAreaFile").value = dump;
}

//取得したファイルへの書き込み処理
function writeFileGotFileWriter(writer) {
	var dump = "ファイルを書き込みました。\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が許す範囲まで自由に使えます。

メソッド説明

getParent(Function<DirectoryEntry> successCallback, Function<FileError> errorCallback)

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

パラメータ

Return

メソッド説明

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

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

パラメータ

Return

メソッド説明

remove(Function successCallback, Function<FileError> errorCallback)

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

パラメータ

Return

メソッド説明

removeRecursively(Function successCallback, Function<FileError> errorCallback)

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

パラメータ

Return

メソッド説明

toURL() : String

ディレクトリのパスをアクセス可能なURL形式（file:///...）形式で取得します。

Return

DirectoryEntry

// ver.1.0
var entry = new DirectoryEntry();

// ver.2.0
var entry = applican.filesystem.createDirectoryEntry($DIR_NAME, $DIR_PATH);