118 lines
4.5 KiB
JavaScript
118 lines
4.5 KiB
JavaScript
/*
|
|
*
|
|
* Licensed to the Apache Software Foundation (ASF) under one
|
|
* or more contributor license agreements. See the NOTICE file
|
|
* distributed with this work for additional information
|
|
* regarding copyright ownership. The ASF licenses this file
|
|
* to you under the Apache License, Version 2.0 (the
|
|
* "License"); you may not use this file except in compliance
|
|
* with the License. You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing,
|
|
* software distributed under the License is distributed on an
|
|
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
* KIND, either express or implied. See the License for the
|
|
* specific language governing permissions and limitations
|
|
* under the License.
|
|
*
|
|
*/
|
|
|
|
var argscheck = require('cordova/argscheck'),
|
|
utils = require('cordova/utils'),
|
|
exec = require('cordova/exec'),
|
|
Entry = require('./Entry'),
|
|
FileError = require('./FileError'),
|
|
DirectoryReader = require('./DirectoryReader');
|
|
|
|
/**
|
|
* An interface representing a directory on the file system.
|
|
*
|
|
* {boolean} isFile always false (readonly)
|
|
* {boolean} isDirectory always true (readonly)
|
|
* {DOMString} name of the directory, excluding the path leading to it (readonly)
|
|
* {DOMString} fullPath the absolute full path to the directory (readonly)
|
|
* {FileSystem} filesystem on which the directory resides (readonly)
|
|
*/
|
|
var DirectoryEntry = function(name, fullPath, fileSystem, nativeURL) {
|
|
|
|
// add trailing slash if it is missing
|
|
if ((fullPath) && !/\/$/.test(fullPath)) {
|
|
fullPath += "/";
|
|
}
|
|
// add trailing slash if it is missing
|
|
if (nativeURL && !/\/$/.test(nativeURL)) {
|
|
nativeURL += "/";
|
|
}
|
|
DirectoryEntry.__super__.constructor.call(this, false, true, name, fullPath, fileSystem, nativeURL);
|
|
};
|
|
|
|
utils.extend(DirectoryEntry, Entry);
|
|
|
|
/**
|
|
* Creates a new DirectoryReader to read entries from this directory
|
|
*/
|
|
DirectoryEntry.prototype.createReader = function() {
|
|
return new DirectoryReader(this.toInternalURL());
|
|
};
|
|
|
|
/**
|
|
* Creates or looks up a directory
|
|
*
|
|
* @param {DOMString} path either a relative or absolute path from this directory in which to look up or create a directory
|
|
* @param {Flags} options to create or exclusively create the directory
|
|
* @param {Function} successCallback is called with the new entry
|
|
* @param {Function} errorCallback is called with a FileError
|
|
*/
|
|
DirectoryEntry.prototype.getDirectory = function(path, options, successCallback, errorCallback) {
|
|
argscheck.checkArgs('sOFF', 'DirectoryEntry.getDirectory', arguments);
|
|
var fs = this.filesystem;
|
|
var win = successCallback && function(result) {
|
|
var entry = new DirectoryEntry(result.name, result.fullPath, fs, result.nativeURL);
|
|
successCallback(entry);
|
|
};
|
|
var fail = errorCallback && function(code) {
|
|
errorCallback(new FileError(code));
|
|
};
|
|
exec(win, fail, "File", "getDirectory", [this.toInternalURL(), path, options]);
|
|
};
|
|
|
|
/**
|
|
* Deletes a directory and all of it's contents
|
|
*
|
|
* @param {Function} successCallback is called with no parameters
|
|
* @param {Function} errorCallback is called with a FileError
|
|
*/
|
|
DirectoryEntry.prototype.removeRecursively = function(successCallback, errorCallback) {
|
|
argscheck.checkArgs('FF', 'DirectoryEntry.removeRecursively', arguments);
|
|
var fail = errorCallback && function(code) {
|
|
errorCallback(new FileError(code));
|
|
};
|
|
exec(successCallback, fail, "File", "removeRecursively", [this.toInternalURL()]);
|
|
};
|
|
|
|
/**
|
|
* Creates or looks up a file
|
|
*
|
|
* @param {DOMString} path either a relative or absolute path from this directory in which to look up or create a file
|
|
* @param {Flags} options to create or exclusively create the file
|
|
* @param {Function} successCallback is called with the new entry
|
|
* @param {Function} errorCallback is called with a FileError
|
|
*/
|
|
DirectoryEntry.prototype.getFile = function(path, options, successCallback, errorCallback) {
|
|
argscheck.checkArgs('sOFF', 'DirectoryEntry.getFile', arguments);
|
|
var fs = this.filesystem;
|
|
var win = successCallback && function(result) {
|
|
var FileEntry = require('./FileEntry');
|
|
var entry = new FileEntry(result.name, result.fullPath, fs, result.nativeURL);
|
|
successCallback(entry);
|
|
};
|
|
var fail = errorCallback && function(code) {
|
|
errorCallback(new FileError(code));
|
|
};
|
|
exec(win, fail, "File", "getFile", [this.toInternalURL(), path, options]);
|
|
};
|
|
|
|
module.exports = DirectoryEntry;
|