// (C) Copyright 2015 Martin Dougiamas // // Licensed 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. import { Injectable, Injector } from '@angular/core'; import { CoreFilepoolProvider } from '@providers/filepool'; import { CoreGroupsProvider } from '@providers/groups'; import { CoreTimeUtilsProvider } from '@providers/utils/time'; import { CoreCommentsProvider } from '@core/comments/providers/comments'; import { CoreCourseProvider } from '@core/course/providers/course'; import { CoreCourseModulePrefetchHandlerBase } from '@core/course/classes/module-prefetch-handler'; import { AddonModDataProvider } from './data'; import { AddonModDataHelperProvider } from './helper'; /** * Handler to prefetch databases. */ @Injectable() export class AddonModDataPrefetchHandler extends CoreCourseModulePrefetchHandlerBase { name = 'AddonModData'; modName = 'data'; component = AddonModDataProvider.COMPONENT; updatesNames = /^configuration$|^.*files$|^entries$|^gradeitems$|^outcomes$|^comments$|^ratings/; constructor(injector: Injector, protected dataProvider: AddonModDataProvider, protected timeUtils: CoreTimeUtilsProvider, protected filepoolProvider: CoreFilepoolProvider, protected dataHelper: AddonModDataHelperProvider, protected groupsProvider: CoreGroupsProvider, protected commentsProvider: CoreCommentsProvider, protected courseProvider: CoreCourseProvider) { super(injector); } /** * Download or prefetch the content. * * @param {any} module The module object returned by WS. * @param {number} courseId Course ID. * @param {boolean} [prefetch] True to prefetch, false to download right away. * @param {string} [dirPath] Path of the directory where to store all the content files. This is to keep the files * relative paths and make the package work in an iframe. Undefined to download the files * in the filepool root data. * @return {Promise} Promise resolved when all content is downloaded. Data returned is not reliable. */ downloadOrPrefetch(module: any, courseId: number, prefetch?: boolean, dirPath?: string): Promise { const promises = [], siteId = this.sitesProvider.getCurrentSiteId(); promises.push(super.downloadOrPrefetch(module, courseId, prefetch)); promises.push(this.getDatabaseInfoHelper(module, courseId, false, false, true, siteId).then((info) => { // Prefetch the database data. const database = info.database, promises = []; promises.push(this.dataProvider.getFields(database.id, false, true, siteId)); promises.push(this.filepoolProvider.addFilesToQueue(siteId, info.files, this.component, module.id)); info.groups.forEach((group) => { promises.push(this.dataProvider.getDatabaseAccessInformation(database.id, group.id, false, true, siteId)); }); info.entries.forEach((entry) => { promises.push(this.dataProvider.getEntry(database.id, entry.id, siteId)); if (database.comments) { promises.push(this.commentsProvider.getComments('module', database.coursemodule, 'mod_data', entry.id, 'database_entry', 0, siteId)); } }); // Add Basic Info to manage links. promises.push(this.courseProvider.getModuleBasicInfoByInstance(database.id, 'data', siteId)); return Promise.all(promises); })); return Promise.all(promises); } /** * Retrieves all the entries for all the groups and then returns only unique entries. * * @param {number} dataId Database Id. * @param {any[]} groups Array of groups in the activity. * @param {boolean} [forceCache] True to always get the value from cache, false otherwise. Default false. * @param {boolean} [ignoreCache] True if it should ignore cached data (it will always fail in offline or server down). * @param {string} [siteId] Site ID. * @return {Promise} All unique entries. */ protected getAllUniqueEntries(dataId: number, groups: any[], forceCache: boolean = false, ignoreCache: boolean = false, siteId?: string): Promise { const promises = groups.map((group) => { return this.dataProvider.fetchAllEntries(dataId, group.id, undefined, undefined, undefined, forceCache, ignoreCache, siteId); }); return Promise.all(promises).then((responses) => { const uniqueEntries = {}; responses.forEach((groupEntries) => { groupEntries.forEach((entry) => { uniqueEntries[entry.id] = entry; }); }); return this.utils.objectToArray(uniqueEntries); }); } /** * Helper function to get all database info just once. * * @param {any} module Module to get the files. * @param {number} courseId Course ID the module belongs to. * @param {boolean} [omitFail] True to always return even if fails. Default false. * @param {boolean} [forceCache] True to always get the value from cache, false otherwise. Default false. * @param {boolean} [ignoreCache] True if it should ignore cached data (it will always fail in offline or server down). * @param {string} siteId Site ID. * @return {Promise} Promise resolved with the info fetched. */ protected getDatabaseInfoHelper(module: any, courseId: number, omitFail: boolean = false, forceCache: boolean = false, ignoreCache: boolean = false, siteId?: string): Promise { let database, groups = [], entries = [], files = []; siteId = siteId || this.sitesProvider.getCurrentSiteId(); return this.dataProvider.getDatabase(courseId, module.id, siteId, forceCache).then((data) => { files = this.getIntroFilesFromInstance(module, data); database = data; return this.groupsProvider.getActivityGroupInfo(module.id, false, undefined, siteId).then((groupInfo) => { if (!groupInfo.groups || groupInfo.groups.length == 0) { groupInfo.groups = [{id: 0}]; } groups = groupInfo.groups; return this.getAllUniqueEntries(database.id, groups, forceCache, ignoreCache, siteId); }); }).then((uniqueEntries) => { entries = uniqueEntries; files = files.concat(this.getEntriesFiles(entries)); return { database: database, groups: groups, entries: entries, files: files }; }).catch((message): any => { if (omitFail) { // Any error, return the info we have. return { database: database, groups: groups, entries: entries, files: files }; } return Promise.reject(message); }); } /** * Returns the file contained in the entries. * * @param {any[]} entries List of entries to get files from. * @return {any[]} List of files. */ protected getEntriesFiles(entries: any[]): any[] { let files = []; entries.forEach((entry) => { entry.contents.forEach((content) => { files = files.concat(content.files); }); }); return files; } /** * Get the list of downloadable files. * * @param {any} module Module to get the files. * @param {number} courseId Course ID the module belongs to. * @param {boolean} [single] True if we're downloading a single module, false if we're downloading a whole section. * @return {Promise} Promise resolved with the list of files. */ getFiles(module: any, courseId: number, single?: boolean): Promise { return this.getDatabaseInfoHelper(module, courseId, true).then((info) => { return info.files; }); } /** * Returns data intro files. * * @param {any} module The module object returned by WS. * @param {number} courseId Course ID. * @return {Promise} Promise resolved with list of intro files. */ getIntroFiles(module: any, courseId: number): Promise { return this.dataProvider.getDatabase(courseId, module.id).catch(() => { // Not found, return undefined so module description is used. }).then((data) => { return this.getIntroFilesFromInstance(module, data); }); } /** * Invalidate the prefetched content. * * @param {number} moduleId The module ID. * @param {number} courseId Course ID the module belongs to. * @return {Promise} Promise resolved when the data is invalidated. */ invalidateContent(moduleId: number, courseId: number): Promise { return this.dataProvider.invalidateContent(moduleId, courseId); } /** * Invalidate WS calls needed to determine module status. * * @param {any} module Module. * @param {number} courseId Course ID the module belongs to. * @return {Promise} Promise resolved when invalidated. */ invalidateModule(module: any, courseId: number): Promise { return this.dataProvider.invalidateDatabaseData(courseId); } /** * Check if a database is downloadable. * A database isn't downloadable if it's not open yet. * * @param {any} module Module to check. * @param {number} courseId Course ID the module belongs to. * @return {Promise} Promise resolved with true if downloadable, resolved with false otherwise. */ isDownloadable(module: any, courseId: number): boolean | Promise { return this.dataProvider.getDatabase(courseId, module.id, undefined, true).then((database) => { return this.dataProvider.getDatabaseAccessInformation(database.id).then((accessData) => { // Check if database is restricted by time. if (!accessData.timeavailable) { const time = this.timeUtils.timestamp(); // It is restricted, checking times. if (database.timeavailablefrom && time < database.timeavailablefrom) { return false; } if (database.timeavailableto && time > database.timeavailableto) { return false; } } return true; }); }); } /** * Whether or not the handler is enabled on a site level. * * @return {boolean|Promise} A boolean, or a promise resolved with a boolean, indicating if the handler is enabled. */ isEnabled(): boolean | Promise { return this.dataProvider.isPluginEnabled(); } }