// (C) Copyright 2015 Moodle Pty Ltd. // // 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 { TranslateService } from '@ngx-translate/core'; import { CoreAppProvider } from '@providers/app'; import { CoreFilepoolProvider } from '@providers/filepool'; import { CoreSitesProvider } from '@providers/sites'; import { CoreDomUtilsProvider } from '@providers/utils/dom'; import { CoreUtilsProvider } from '@providers/utils/utils'; import { CoreCourseProvider } from '@core/course/providers/course'; import { CoreSitePluginsProvider } from '../../providers/siteplugins'; import { CoreCourseActivityPrefetchHandlerBase } from '@core/course/classes/activity-prefetch-handler'; import { CoreFilterHelperProvider } from '@core/filter/providers/helper'; /** * Handler to prefetch a module site plugin. */ export class CoreSitePluginsModulePrefetchHandler extends CoreCourseActivityPrefetchHandlerBase { protected ROOT_CACHE_KEY = 'CoreSitePluginsModulePrefetchHandler:'; protected isResource: boolean; constructor(translate: TranslateService, appProvider: CoreAppProvider, utils: CoreUtilsProvider, courseProvider: CoreCourseProvider, filepoolProvider: CoreFilepoolProvider, sitesProvider: CoreSitesProvider, domUtils: CoreDomUtilsProvider, filterHelper: CoreFilterHelperProvider, protected sitePluginsProvider: CoreSitePluginsProvider, component: string, name: string, modName: string, protected handlerSchema: any) { super(translate, appProvider, utils, courseProvider, filepoolProvider, sitesProvider, domUtils, filterHelper); this.component = component; this.name = name; this.modName = modName; this.isResource = handlerSchema.isresource; if (handlerSchema.updatesnames) { try { this.updatesNames = new RegExp(handlerSchema.updatesnames); } catch (ex) { // Ignore errors. } } } /** * Download the module. * * @param module The module object returned by WS. * @param courseId Course ID. * @param dirPath Path of the directory where to store all the content files. * @return Promise resolved when all content is downloaded. */ download(module: any, courseId: number, dirPath?: string): Promise { return this.prefetchPackage(module, courseId, false, this.downloadPrefetchPlugin.bind(this), undefined, false, dirPath); } /** * Download or prefetch the plugin, downloading the files and calling the needed WS. * * @param module The module object returned by WS. * @param courseId Course ID. * @param single True if we're downloading a single module, false if we're downloading a whole section. * @param siteId Site ID. If not defined, current site. * @param prefetch True to prefetch, false to download right away. * @param dirPath Path of the directory where to store all the content files. * @return Promise resolved when done. */ protected downloadPrefetchPlugin(module: any, courseId: number, single?: boolean, siteId?: string, prefetch?: boolean, dirPath?: string): Promise { return this.sitesProvider.getSite(siteId).then((site) => { const promises = [], args = { courseid: courseId, cmid: module.id, userid: site.getUserId() }; // Download the files (if any). promises.push(this.downloadOrPrefetchFiles(site.id, module, courseId, prefetch, dirPath)); // Call all the offline functions. promises.push(this.sitePluginsProvider.prefetchFunctions(this.component, args, this.handlerSchema, courseId, module, prefetch, dirPath, site)); return Promise.all(promises); }); } /** * Download or prefetch the plugin files. * * @param module The module object returned by WS. * @param courseId Course ID. * @param prefetch True to prefetch, false to download right away. * @param dirPath Path of the directory where to store all the content files. * @return Promise resolved when done. */ protected downloadOrPrefetchFiles(siteId: string, module: any, courseId: number, prefetch?: boolean, dirPath?: string) : Promise { // Load module contents (ignore cache so we always have the latest data). return this.loadContents(module, courseId, true).then(() => { // Get the intro files. return this.getIntroFiles(module, courseId); }).then((introFiles) => { const contentFiles = this.getContentDownloadableFiles(module), promises = []; if (dirPath) { // Download intro files in filepool root folder. promises.push(this.filepoolProvider.downloadOrPrefetchFiles(siteId, introFiles, prefetch, false, this.component, module.id)); // Download content files inside dirPath. promises.push(this.filepoolProvider.downloadOrPrefetchFiles(siteId, contentFiles, prefetch, false, this.component, module.id, dirPath)); } else { // No dirPath, download everything in filepool root folder. const files = introFiles.concat(contentFiles); promises.push(this.filepoolProvider.downloadOrPrefetchFiles(siteId, files, prefetch, false, this.component, module.id)); } return Promise.all(promises); }); } /** * Get the download size of a module. * * @param module Module. * @param courseId Course ID the module belongs to. * @param single True if we're downloading a single module, false if we're downloading a whole section. * @return Promise resolved with the size and a boolean indicating if it was able * to calculate the total size. */ getDownloadSize(module: any, courseId: number, single?: boolean): Promise<{ size: number, total: boolean }> { // In most cases, to calculate the size we'll have to do all the WS calls. Just return unknown size. return Promise.resolve({ size: -1, total: false }); } /** * Invalidate the prefetched content. * * @param moduleId The module ID. * @param courseId Course ID the module belongs to. * @return Promise resolved when the data is invalidated. */ invalidateContent(moduleId: number, courseId: number): Promise { const promises = [], currentSite = this.sitesProvider.getCurrentSite(), siteId = currentSite.getId(), args = { courseid: courseId, cmid: moduleId, userid: currentSite.getUserId() }; // Invalidate files and the module. promises.push(this.filepoolProvider.invalidateFilesByComponent(siteId, this.component, moduleId)); promises.push(this.courseProvider.invalidateModule(moduleId, siteId)); // Also invalidate all the WS calls. for (const method in this.handlerSchema.offlinefunctions) { if (currentSite.wsAvailable(method)) { // The method is a WS. promises.push(currentSite.invalidateWsCacheForKey(this.sitePluginsProvider.getCallWSCacheKey(method, args))); } else { // It's a method to get content. promises.push(this.sitePluginsProvider.invalidateContent(this.component, method, args)); } } return this.utils.allPromises(promises); } /** * Whether or not the handler is enabled on a site level. * * @return A boolean, or a promise resolved with a boolean, indicating if the handler is enabled. */ isEnabled(): boolean | Promise { return true; } /** * Load module contents into module.contents if they aren't loaded already. * * @param module Module to load the contents. * @param courseId The course ID. Recommended to speed up the process and minimize data usage. * @param ignoreCache True if it should ignore cached data (it will always fail in offline or server down). * @return Promise resolved when loaded. */ loadContents(module: any, courseId: number, ignoreCache?: boolean): Promise { if (this.isResource) { return this.courseProvider.loadModuleContents(module, courseId, undefined, false, ignoreCache); } return Promise.resolve(); } /** * Prefetch a module. * * @param module Module. * @param courseId Course ID the module belongs to. * @param single True if we're downloading a single module, false if we're downloading a whole section. * @param dirPath Path of the directory where to store all the content files. * @return Promise resolved when done. */ prefetch(module: any, courseId?: number, single?: boolean, dirPath?: string): Promise { return this.prefetchPackage(module, courseId, false, this.downloadPrefetchPlugin.bind(this), undefined, true, dirPath); } }