4 * Manages startup data loading and data caching.
5 * All registered loaders run * simultaneously. When all promises
6 * are resolved, the promise * returned by egEnv.load() is resolved.
8 * There are two main uses cases for egEnv:
10 * 1. When loading a variety of objects on page load, having them
11 * loaded with egEnv ensures that the load will happen in parallel
12 * and that it will complete before egStartup completes, which is
13 * generally before page controllers run.
15 * 2. When loading generic IDL data across different services,
16 * having them all stash the data in egEnv means they each have
17 * an agreed-upon cache mechanism.
19 * It's also a good place to stash other environmental tidbits...
21 * Generic and class-based loaders are supported.
23 * To load a registred class, push the class hint onto
26 * // will cause all 'pgt' objects to be fetched
27 * egEnv.loadClasses.push('pgt');
29 * To register a new class loader,attach a loader function to
30 * egEnv.classLoaders, keyed on the class hint, which returns a promise.
32 * egEnv.classLoaders.ccs = function() {
33 * // loads copy status objects, returns promise
36 * Generic loaders go onto the egEnv.loaders array. Each should
39 * egEnv.loaders.push(function() {
40 * return egNet.request(...)
41 * .then(function(stuff) { console.log('stuff!')
45 angular.module('egCoreMod')
49 ['$q','$window','$injector','egAuth','egPCRUD','egIDL',
50 function($q, $window , $injector , egAuth, egPCRUD, egIDL) {
53 // collection of custom loader functions
56 // Add class hints to this list when offline does not need them and
57 // if they cause "Maximum call stack size exceeded" console errors.
58 // If offline does need a list that causes problems, a custom loader
60 // We'll start with authority-related classes causing problems in the
62 ignoreOffline : ['at','acs','abaafm','aba','acsbf','acsaf']
66 // <base href="<basePath>"/> from the current index page
67 // Currently defaults to /eg/staff for all pages.
68 // Use $location.path() to jump around within an app.
69 // Use egEnv.basePath to create URLs to new apps.
70 // NOTE: the dynamic version below derived from the DOM does not
71 // work w/ unit tests. Use hard-coded value instead for now.
72 service.basePath = '/eg/staff/';
73 //$window.document.getElementsByTagName('base')[0].getAttribute('href');
75 /* returns a promise, loads all of the specified classes */
76 service.load = function() {
77 // always assume the user is logged in
78 if (!egAuth.user()) return $q.when();
81 var classes = this.loadClasses;
82 console.debug('egEnv loading classes => ' + classes);
84 angular.forEach(classes, function(cls) {
85 allPromises.push(service.classLoaders[cls]());
87 angular.forEach(this.loaders, function(loader) {
88 allPromises.push(loader());
91 return $q.all(allPromises).then(
92 function() { console.debug('egEnv load complete') });
95 /** given a tree-shaped collection, captures the tree and
96 * flattens the tree for absorption.
98 service.absorbTree = function(tree, class_, noOffline) {
100 function squash(node) {
102 angular.forEach(node.children(), squash);
105 var blob = service.absorbList(list, class_, noOffline);
109 var egLovefield; // we'll inject it manually
111 /** caches the object list both as the list and an id => object map */
112 service.absorbList = function(list, class_, noOffline) {
114 var pkey = egIDL.classes[class_].pkey;
116 if (service[class_]) {
117 // appending data to an existing class. Useful for receiving
118 // class elements as-needed. Avoid adding items which are
119 // already tracked in the list.
120 blob = service[class_];
121 angular.forEach(list, function(item) {
122 if (!service[class_].map[item[pkey]()])
123 blob.list.push(item);
126 blob = {list : list, map : {}};
129 if (!noOffline && service.ignoreOffline.indexOf(class_) < 0) {
131 egLovefield = $injector.get('egLovefield');
133 //console.debug('About to cache a list of ' + class_ + ' objects...');
134 egLovefield.isCacheGood(class_).then(
137 egLovefield.setListInOfflineCache(class_, blob.list);
140 function() {} // Not Supported
144 angular.forEach(list, function(item) {blob.map[item[pkey]()] = item});
145 service[class_] = blob;
146 service[class_].loaded = true;
151 * list of classes to load on every page, regardless of whether
152 * a page-specific list is provided.
154 service.loadClasses = ['aou'];
156 // sort orgs at each level by shortname
157 service.sort_aou = function(node) {
158 node.children(node.children().sort(function(a, b) {
159 return a.shortname() < b.shortname() ? -1 : 1;
161 angular.forEach(node.children(), service.sort_aou);
165 * Default class loaders. Only add classes directly to this file
166 * that are loaded practically always. All other app-specific
167 * classes should be registerd from within the app.
169 service.classLoaders = {
173 egLovefield = $injector.get('egLovefield');
176 return egLovefield.reconstituteTree('aou').then(function(offline) {
177 if (offline) return $q.when();
178 if (service.aou && service.aou.loaded) return $q.when();
180 // EXPERIMENT: cache the org tree in session storage.
181 // This means that if the org tree changes, users will have to
182 // open the client in a new browser tab to clear the cached tree.
183 var treeJSON = $window.sessionStorage.getItem('eg.env.aou.tree');
185 console.debug('serving org tree from cache');
186 var tree = JSON2js(treeJSON);
187 service.absorbTree(tree, 'aou')
188 return $q.when(tree);
191 return egPCRUD.search('aou', {parent_ou : null},
192 {flesh : -1, flesh_fields : {aou : ['children', 'ou_type']}}
195 service.sort_aou(tree);
196 $window.sessionStorage.setItem(
197 'eg.env.aou.tree', js2JSON(tree));
198 service.absorbTree(tree, 'aou');
203 function() {return $q.when()} // Not Supported, exit gracefully