/* * Copyright (c) 2015 * * This file is licensed under the Affero General Public License version 3 * or later. * * See the COPYING-README file. * */ /* global dav */ (function(OC, FileInfo) { /** * @class OC.Files.Client * @classdesc Client to access files on the server * * @param {Object} options * @param {String} options.host host name * @param {int} [options.port] port * @param {boolean} [options.useHTTPS] whether to use https * @param {String} [options.root] root path * @param {String} [options.userName] user name * @param {String} [options.password] password * * @since 8.2 */ var Client = function(options) { this._root = options.root; if (this._root.charAt(this._root.length - 1) === '/') { this._root = this._root.substr(0, this._root.length - 1); } var url = 'http://'; if (options.useHTTPS) { url = 'https://'; } url += options.host + this._root; this._defaultHeaders = options.defaultHeaders || {'X-Requested-With': 'XMLHttpRequest'}; this._baseUrl = url; var clientOptions = { baseUrl: this._baseUrl, xmlNamespaces: { 'DAV:': 'd', 'http://owncloud.org/ns': 'oc' } }; if (options.userName) { clientOptions.userName = options.userName; } if (options.password) { clientOptions.password = options.password; } this._client = new dav.Client(clientOptions); this._client.xhrProvider = _.bind(this._xhrProvider, this); }; Client.NS_OWNCLOUD = 'http://owncloud.org/ns'; Client.NS_DAV = 'DAV:'; Client._PROPFIND_PROPERTIES = [ /** * Modified time */ [Client.NS_DAV, 'getlastmodified'], /** * Etag */ [Client.NS_DAV, 'getetag'], /** * Mime type */ [Client.NS_DAV, 'getcontenttype'], /** * Resource type "collection" for folders, empty otherwise */ [Client.NS_DAV, 'resourcetype'], /** * File id */ [Client.NS_OWNCLOUD, 'fileid'], /** * Letter-coded permissions */ [Client.NS_OWNCLOUD, 'permissions'], //[Client.NS_OWNCLOUD, 'downloadURL'], /** * Folder sizes */ [Client.NS_OWNCLOUD, 'size'], /** * File sizes */ [Client.NS_DAV, 'getcontentlength'] ]; /** * @memberof OC.Files */ Client.prototype = { /** * Root path of the Webdav endpoint * * @type string */ _root: null, /** * Client from the library * * @type dav.Client */ _client: null, /** * Array of file info parsing functions. * * @type Array */ _fileInfoParsers: [], /** * Returns the configured XHR provider for davclient * @return {XMLHttpRequest} */ _xhrProvider: function() { var headers = this._defaultHeaders; var xhr = new XMLHttpRequest(); var oldOpen = xhr.open; // override open() method to add headers xhr.open = function() { var result = oldOpen.apply(this, arguments); _.each(headers, function(value, key) { xhr.setRequestHeader(key, value); }); return result; }; return xhr; }, /** * Prepends the base url to the given path sections * * @param {...String} path sections * * @return {String} base url + joined path, any leading or trailing slash * will be kept */ _buildUrl: function() { var path = this._buildPath.apply(this, arguments); if (path.charAt([path.length - 1]) === '/') { path = path.substr(0, path.length - 1); } if (path.charAt(0) === '/') { path = path.substr(1); } return this._baseUrl + '/' + path; }, /** * Append the path to the root and also encode path * sections * * @param {...String} path sections * * @return {String} joined path, any leading or trailing slash * will be kept */ _buildPath: function() { var path = OC.joinPaths.apply(this, arguments); var sections = path.split('/'); var i; for (i = 0; i < sections.length; i++) { sections[i] = encodeURIComponent(sections[i]); } path = sections.join('/'); return path; }, /** * Parse headers string into a map * * @param {string} headersString headers list as string * * @return {Object.} map of header name to header contents */ _parseHeaders: function(headersString) { var headerRows = headersString.split('\n'); var headers = {}; for (var i = 0; i < headerRows.length; i++) { var sepPos = headerRows[i].indexOf(':'); if (sepPos < 0) { continue; } var headerName = headerRows[i].substr(0, sepPos); var headerValue = headerRows[i].substr(sepPos + 2); if (!headers[headerName]) { // make it an array headers[headerName] = []; } headers[headerName].push(headerValue); } return headers; }, /** * Parses the etag response which is in double quotes. * * @param {string} etag etag value in double quotes * * @return {string} etag without double quotes */ _parseEtag: function(etag) { if (etag.charAt(0) === '"') { return etag.split('"')[1]; } return etag; }, /** * Parse Webdav result * * @param {Object} response XML object * * @return {Array.} array of file info */ _parseFileInfo: function(response) { var path = response.href; if (path.substr(0, this._root.length) === this._root) { path = path.substr(this._root.length); } if (path.charAt(path.length - 1) === '/') { path = path.substr(0, path.length - 1); } path = decodeURIComponent(path); if (response.propStat.length === 0 || response.propStat[0].status !== 'HTTP/1.1 200 OK') { return null; } var props = response.propStat[0].properties; var data = { id: props['{' + Client.NS_OWNCLOUD + '}fileid'], path: OC.dirname(path) || '/', name: OC.basename(path), mtime: (new Date(props['{' + Client.NS_DAV + '}getlastmodified'])).getTime() }; var etagProp = props['{' + Client.NS_DAV + '}getetag']; if (!_.isUndefined(etagProp)) { data.etag = this._parseEtag(etagProp); } var sizeProp = props['{' + Client.NS_DAV + '}getcontentlength']; if (!_.isUndefined(sizeProp)) { data.size = parseInt(sizeProp, 10); } sizeProp = props['{' + Client.NS_OWNCLOUD + '}size']; if (!_.isUndefined(sizeProp)) { data.size = parseInt(sizeProp, 10); } var contentType = props['{' + Client.NS_DAV + '}getcontenttype']; if (!_.isUndefined(contentType)) { data.mimetype = contentType; } var resType = props['{' + Client.NS_DAV + '}resourcetype']; var isFile = true; if (!data.mimetype && resType) { var xmlvalue = resType[0]; if (xmlvalue.namespaceURI === Client.NS_DAV && xmlvalue.nodeName.split(':')[1] === 'collection') { data.mimetype = 'httpd/unix-directory'; isFile = false; } } data.permissions = OC.PERMISSION_READ; var permissionProp = props['{' + Client.NS_OWNCLOUD + '}permissions']; if (!_.isUndefined(permissionProp)) { var permString = permissionProp || ''; data.mountType = null; for (var i = 0; i < permString.length; i++) { var c = permString.charAt(i); switch (c) { // FIXME: twisted permissions case 'C': case 'K': data.permissions |= OC.PERMISSION_CREATE; if (!isFile) { data.permissions |= OC.PERMISSION_UPDATE; } break; case 'W': data.permissions |= OC.PERMISSION_UPDATE; break; case 'D': data.permissions |= OC.PERMISSION_DELETE; break; case 'R': data.permissions |= OC.PERMISSION_SHARE; break; case 'M': if (!data.mountType) { // TODO: how to identify external-root ? data.mountType = 'external'; } break; case 'S': // TODO: how to identify shared-root ? data.mountType = 'shared'; break; } } } // extend the parsed data using the custom parsers _.each(this._fileInfoParsers, function(parserFunction) { _.extend(data, parserFunction(response) || {}); }); return new FileInfo(data); }, /** * Parse Webdav multistatus * * @param {Array} responses */ _parseResult: function(responses) { var self = this; return _.map(responses, function(response) { return self._parseFileInfo(response); }); }, /** * Returns whether the given status code means success * * @param {int} status status code * * @return true if status code is between 200 and 299 included */ _isSuccessStatus: function(status) { return status >= 200 && status <= 299; }, /** * Returns the default PROPFIND properties to use during a call. * * @return {Array.} array of properties */ getPropfindProperties: function() { if (!this._propfindProperties) { this._propfindProperties = _.map(Client._PROPFIND_PROPERTIES, function(propDef) { return '{' + propDef[0] + '}' + propDef[1]; }); } return this._propfindProperties; }, /** * Lists the contents of a directory * * @param {String} path path to retrieve * @param {Object} [options] options * @param {boolean} [options.includeParent=false] set to true to keep * the parent folder in the result list * @param {Array} [options.properties] list of Webdav properties to retrieve * * @return {Promise} promise */ getFolderContents: function(path, options) { if (!path) { path = ''; } options = options || {}; var self = this; var deferred = $.Deferred(); var promise = deferred.promise(); var properties; if (_.isUndefined(options.properties)) { properties = this.getPropfindProperties(); } else { properties = options.properties; } // TODO: headers this._client.propFind( this._buildUrl(path), properties, 1 ).then(function(result) { if (self._isSuccessStatus(result.status)) { var results = self._parseResult(result.body); if (!options || !options.includeParent) { // remove root dir, the first entry results.shift(); } deferred.resolve(result.status, results); } else { deferred.reject(result.status); } }); return promise; }, /** * Fetches a flat list of files filtered by a given filter criteria. * (currently only system tags is supported) * * @param {Object} filter filter criteria * @param {Object} [filter.systemTagIds] list of system tag ids to filter by * @param {Object} [options] options * @param {Array} [options.properties] list of Webdav properties to retrieve * * @return {Promise} promise */ getFilteredFiles: function(filter, options) { options = options || {}; var self = this; var deferred = $.Deferred(); var promise = deferred.promise(); var properties; if (_.isUndefined(options.properties)) { properties = this.getPropfindProperties(); } else { properties = options.properties; } if (!filter || !filter.systemTagIds || !filter.systemTagIds.length) { throw 'Missing filter argument'; } var headers = _.extend({}, this._defaultHeaders); // root element with namespaces var body = '\n'; _.each(properties, function(prop) { var property = self._client.parseClarkNotation(prop); body += ' <' + self._client.xmlNamespaces[property.namespace] + ':' + property.name + ' />\n'; }); body += ' \n'; // rules block body += ' \n'; _.each(filter.systemTagIds, function(systemTagIds) { body += ' ' + escapeHTML(systemTagIds) + '\n'; }); body += ' \n'; // end of root body += '\n'; this._client.request( 'REPORT', this._buildUrl(), headers, body ).then(function(result) { if (self._isSuccessStatus(result.status)) { var results = self._parseResult(result.body); deferred.resolve(result.status, results); } else { deferred.reject(result.status); } }); return promise; }, /** * Returns the file info of a given path. * * @param {String} path path * @param {Array} [options.properties] list of Webdav properties to retrieve * * @return {Promise} promise */ getFileInfo: function(path, options) { if (!path) { path = ''; } options = options || {}; var self = this; var deferred = $.Deferred(); var promise = deferred.promise(); var properties; if (_.isUndefined(options.properties)) { properties = this.getPropfindProperties(); } else { properties = options.properties; } // TODO: headers this._client.propFind( this._buildUrl(path), properties, 0 ).then( function(result) { if (self._isSuccessStatus(result.status)) { deferred.resolve(result.status, self._parseResult([result.body])[0]); } else { deferred.reject(result.status); } } ); return promise; }, /** * Returns the contents of the given file. * * @param {String} path path to file * * @return {Promise} */ getFileContents: function(path) { if (!path) { throw 'Missing argument "path"'; } var self = this; var deferred = $.Deferred(); var promise = deferred.promise(); this._client.request( 'GET', this._buildUrl(path), this._defaultHeaders ).then( function(result) { if (self._isSuccessStatus(result.status)) { deferred.resolve(result.status, result.body); } else { deferred.reject(result.status); } } ); return promise; }, /** * Puts the given data into the given file. * * @param {String} path path to file * @param {String} body file body * @param {Object} [options] * @param {String} [options.contentType='text/plain'] content type * @param {bool} [options.overwrite=true] whether to overwrite an existing file * * @return {Promise} */ putFileContents: function(path, body, options) { if (!path) { throw 'Missing argument "path"'; } var self = this; var deferred = $.Deferred(); var promise = deferred.promise(); options = options || {}; var headers = _.extend({}, this._defaultHeaders); var contentType = 'text/plain;charset=utf-8'; if (options.contentType) { contentType = options.contentType; } headers['Content-Type'] = contentType; if (_.isUndefined(options.overwrite) || options.overwrite) { // will trigger 412 precondition failed if a file already exists headers['If-None-Match'] = '*'; } this._client.request( 'PUT', this._buildUrl(path), headers, body || '' ).then( function(result) { if (self._isSuccessStatus(result.status)) { deferred.resolve(result.status); } else { deferred.reject(result.status); } } ); return promise; }, _simpleCall: function(method, path) { if (!path) { throw 'Missing argument "path"'; } var self = this; var deferred = $.Deferred(); var promise = deferred.promise(); this._client.request( method, this._buildUrl(path), this._defaultHeaders ).then( function(result) { if (self._isSuccessStatus(result.status)) { deferred.resolve(result.status); } else { deferred.reject(result.status); } } ); return promise; }, /** * Creates a directory * * @param {String} path path to create * * @return {Promise} */ createDirectory: function(path) { return this._simpleCall('MKCOL', path); }, /** * Deletes a file or directory * * @param {String} path path to delete * * @return {Promise} */ remove: function(path) { return this._simpleCall('DELETE', path); }, /** * Moves path to another path * * @param {String} path path to move * @param {String} destinationPath destination path * @param {boolean} [allowOverwrite=false] true to allow overwriting, * false otherwise * * @return {Promise} promise */ move: function(path, destinationPath, allowOverwrite) { if (!path) { throw 'Missing argument "path"'; } if (!destinationPath) { throw 'Missing argument "destinationPath"'; } var self = this; var deferred = $.Deferred(); var promise = deferred.promise(); var headers = _.extend({ 'Destination' : this._buildUrl(destinationPath) }, this._defaultHeaders); if (!allowOverwrite) { headers['Overwrite'] = 'F'; } this._client.request( 'MOVE', this._buildUrl(path), headers ).then( function(response) { if (self._isSuccessStatus(response.status)) { deferred.resolve(response.status); } else { deferred.reject(response.status); } } ); return promise; }, /** * Add a file info parser function * * @param {OC.Files.Client~parseFileInfo>} */ addFileInfoParser: function(parserFunction) { this._fileInfoParsers.push(parserFunction); } }; /** * File info parser function * * This function receives a list of Webdav properties as input and * should return a hash array of parsed properties, if applicable. * * @callback OC.Files.Client~parseFileInfo * @param {Object} XML Webdav properties * @return {Array} array of parsed property values */ if (!OC.Files) { /** * @namespace OC.Files * * @since 8.2 */ OC.Files = {}; } /** * Returns the default instance of the files client * * @return {OC.Files.Client} default client * * @since 8.2 */ OC.Files.getClient = function() { if (OC.Files._defaultClient) { return OC.Files._defaultClient; } var client = new OC.Files.Client({ host: OC.getHost(), port: OC.getPort(), root: OC.linkToRemoteBase('webdav'), useHTTPS: OC.getProtocol() === 'https' }); OC.Files._defaultClient = client; return client; }; OC.Files.Client = Client; })(OC, OC.Files.FileInfo);