applican

マイページに戻る

FileEntry ver.1.0

ファイルシステム上のファイルに対してのアクションを提供する機能です。

アプリカンAPIのver.1.0系のFileSystemのFileEntryのリファレンスです

  1. アプリカンAPIのver.2.0系のFileSystemのFileEntryのリファレンスはこちらからご確認ください。

プロパティ

name : String パス情報を含まないファイル名です。
fullPath : String ルートディレクトリからのこのファイルを参照出来るパスです。

メソッド

moveTo

メソッド説明

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

ファイルを移動します。

移動先に同名のファイルが存在する場合は移動先のファイルを削除します。

パラメータ

entry : DirectoryEntry 移動先のディレクトリを指定します。
name : String 移動時の新しい名前を指定します。(未指定の場合は現在の名前を利用します)
successCallback : Function<FileEntry> ファイルを移動出来た場合にCallbackされます。
errorCallback : Function<FileError> ファイルの移動に失敗した場合にCallbackされます。

Return

void

サンプルコード

//ファイル移動
function moveTo1(){
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, moveTo1_gotFS, moveTo1_fail);
}
function moveTo1_gotFS(fileSystem) {
	fileSystem.root.getFile("readme.txt", null, moveTo1_gotFileEntry, moveTo1_fail);
}
function moveTo1_gotFileEntry(fileEntry) {
	var tmp =fileEntry.fullPath;
	var parentPath = tmp.substring(0, tmp.lastIndexOf('/'));
	var parentName = parentPath.substring(parentPath.lastIndexOf('/')+1);
	var parentEntry = new DirectoryEntry(parentName, parentPath);
	fileEntry.moveTo(parentEntry, "readme2.txt", moveTo1_moveToSuccess, moveTo1_fail);
}
function moveTo1_moveToSuccess(entry) {
	var dump = "moveTo1_moveToSuccess\n";
	dump += entry.name+"\n"+entry.fullPath+"\n";
	document.getElementById("dumpAreaFile").value =dump;
}
function moveTo1_fail(error){
	alert("moveTo1_fail: " + error.code);
}
requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

copyTo

メソッド説明

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

ファイルをコピーします。

パラメータ

entry : DirectoryEntry 移動先のディレクトリを指定します。
name : String コピー時の新しい名前を指定します。(未指定の場合は現在の名前を利用します)
successCallback : Function<FileEntry> ファイルをコピー出来た場合にCallbackされます。
errorCallback : Function<FileError> ファイルのコピーに失敗した場合にCallbackされます。

Return

void

サンプルコード

//ファイルコピー
function copyTo1(){
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, copyTo1_gotFS, copyTo1_fail);
}
function copyTo1_gotFS(fileSystem) {
	fileSystem.root.getFile("readme.txt", null, copyTo1_gotFileEntry, copyTo1_fail);
}
function copyTo1_gotFileEntry(fileEntry) {
	var tmp = fileEntry.fullPath;
	var parentPath = tmp.substring(0, tmp.lastIndexOf('/'));
	var parentName = parentPath.substring(parentPath.lastIndexOf('/')+1);
	var parentEntry = new DirectoryEntry(parentName, parentPath);
	fileEntry.copyTo(parentEntry, "readme3.txt", copyTo1_copyToSuccess, copyTo1_fail);
}
function copyTo1_copyToSuccess(entry) {
	var dump = "copyTo1_copyToSuccess\n";
	dump += entry.name+"\n"+entry.fullPath+"\n";
	document.getElementById("dumpAreaFile").value =dump;
}
function copyTo1_fail(error) {
	alert("copyTo1_fail: " + error.code);
}
requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

toURL

メソッド説明

toURL() : String

ファイルをアクセス可能な文字列に変換します。

パラメータ

(none)

Return

String URL形式の文字列

サンプルコード

//ファイルtoURL
function toURL1(){
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, toURL1_gotFS, toURL1_fail);
}
function toURL1_gotFS(fileSystem) {
	fileSystem.root.getFile("readme.txt", null, toURL1_gotFileEntry, toURL1_fail);
}
function toURL1_gotFileEntry(fileEntry) {
	var fileURL = fileEntry.toURL();
	var dump = "toURL1_gotFileEntry\n";
	dump += fileURL+"\n";
	document.getElementById("dumpAreaFile").value =dump;
}
function toURL1_fail(error) {
	alert("toURL1_fail: " + error.code);
}
requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

remove

メソッド説明

remove(Function successCallback, Function<FileError> errorCallback)

ファイルを削除します。

パラメータ

successCallback : Function ファイルの削除に成功した場合にCallbackされます。
errorCallback : Function<FileError> ファイルの削除に失敗した場合にCallbackされます。

Return

void

サンプルコード

//ファイル削除
function deleteFile1(){
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, deleteFile1_gotFS, deleteFile1_fail);
}
function deleteFile1_gotFS(fileSystem) {
	fileSystem.root.getFile("readme.txt", null, deleteFile1_gotFileEntry, deleteFile1_fail);
}
function deleteFile1_gotFileEntry(fileEntry) {
	fileEntry.remove(deleteFile1_removeSuccess, deleteFile1_fail);
}
function deleteFile1_removeSuccess() {
	var dump = "deleteFile1_removeSuccess\n";
	document.getElementById("dumpAreaFile").value =dump;
}
function deleteFile1_fail(error) {
	alert("deleteFile1_fail: " + error.code);
}
requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

getParent

メソッド説明

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

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

パラメータ

successCallback : Function<DirectoryEntry> 親ディレクトリを取得出来た場合にCallbackされます。
errorCallback : Function<FileError> 親ディレクトリの取得に失敗した場合にCallbackされます。

Return

void

サンプルコード

//親ディレクトリ
function getParent1(){
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, getParent1_gotFS, getParent1_fail);
}
function getParent1_gotFS(fileSystem) {
	fileSystem.root.getFile("readme.txt", null, getParent1_gotFileEntry, getParent1_fail);
}
function getParent1_gotFileEntry(fileEntry) {
	fileEntry.getParent(getParent1_getParentSuccess, getParent1_fail);
}
function getParent1_getParentSuccess(entry) {
	var dump = "getParent1_getParentSuccess\n";
	dump += entry.name+"\n"+entry.fullPath+"\n";
	document.getElementById("dumpAreaFile").value =dump;
}
function getParent1_fail(error) {
	alert("getParent1_fail: " + error.code);
}
requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

createWriter

メソッド説明

createWriter() : FileWriter

ファイルにデータを書き込むオブジェクトを生成します。

パラメータ

(none)

Return

FileWriter ファイルにデータを書き込むためのオブジェクトを返却します。

サンプルコード

//ファイル書き込み
function fileWrite1(){
	applican.requestFileSystem(LocalFileSystem.PERSISTENT, 0, fileWrite1_gotFS, fileWrite1_fail);
}
function fileWrite1_gotFS(fileSystem) {
	fileSystem.root.getFile("readme.txt", {create: true, exclusive: false}, fileWrite1_gotFileEntry, fileWrite1_fail);
}
function fileWrite1_gotFileEntry(fileEntry) {
	fileEntry.createWriter(fileWrite1_gotFileWriter, fileWrite1_fail);
}
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");
}
function fileWrite1_fail(error) {
	var dump = "fileWrite1_fail\n";
	dump += "code:"+error.code+"\n";
	document.getElementById("dumpAreaFile").value =dump;
}
requestFileSystemの第二引数には、サイズの指定が入ります。
現状はサイズ指定に未対応の為、どんな値を設定しても、OSが許す範囲まで自由に使えます。

file

メソッド説明

file(Function<File> successCallback, Function<FileError> errorCallback)

ファイル属性情報を取得します。

パラメータ

successCallback : Function<File> ファイル属性取得時にCallbackされます。
errorCallback : Function<FileError> ファイル属性取得失敗時にCallbackされます。

Return

void
loading