//-- copyright // OpenProject is a project management system. // Copyright (C) 2012-2015 the OpenProject Foundation (OPF) // // This program is free software; you can redistribute it and/or // modify it under the terms of the GNU General Public License version 3. // // OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows: // Copyright (C) 2006-2013 Jean-Philippe Lang // Copyright (C) 2010-2013 the ChiliProject Team // // This program is free software; you can redistribute it and/or // modify it under the terms of the GNU General Public License // as published by the Free Software Foundation; either version 2 // of the License, or (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with this program; if not, write to the Free Software // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. // // See doc/COPYRIGHT.rdoc for more details. //++ import {opApiModule} from '../../../../angular-modules'; import {HalLinkInterface} from '../hal-link/hal-link.service'; import {HalResourceTypesStorageService} from '../hal-resource-types-storage/hal-resource-types-storage.service'; const ObservableArray:any = require('observable-array'); var $q:ng.IQService; var lazy; var HalLink; var halResourceTypesStorage:HalResourceTypesStorageService; export class HalResource { public static _type:string; public static create(element) { if (!(element._embedded || element._links)) { return element; } const resourceClass = halResourceTypesStorage.getResourceClassOfType(element._type); return new resourceClass(element); } public static fromLink(link:HalLinkInterface) { const resource = HalResource.getEmptyResource(HalLink.fromObject(link)); return new HalResource(resource, false); } public static getEmptyResource(self = {href: null}):any { return {_links: {self: self}}; } public $links:any = {}; public $embedded:any = {}; public $self:ng.IPromise; private _name:string; public get $isHal():boolean { return true; } public get $link():HalLinkInterface { return this.$links.self.$link; } public get name():string { return this._name || this.$link.title || ''; } public set name(name:string) { this._name = name; } public get href():string { return this.$link.href; } constructor(public $source:any = HalResource.getEmptyResource(), public $loaded:boolean = true) { this.$initialize($source); } public $load() { if (this.$loaded) { return $q.when(this); } if (!this.$loaded && this.$self) { return this.$self; } this.$self = this.$links.self().then(source => { this.$loaded = true; this.$initialize(source); return this; }); return this.$self; } public $plain() { return angular.copy(this.$source); } protected $initialize(source) { this.$source = source.$source || source; initializeResource(this); } } function initializeResource(halResource:HalResource) { setSource(); setupLinks(); setupEmbedded(); proxyProperties(); setLinksAsProperties(); setEmbeddedAsProperties(); function setSource() { halResource.$source = halResource.$source._plain || halResource.$source; if (!halResource.$source._links) { halResource.$source._links = {}; } if (!halResource.$source._links.self) { halResource.$source._links.self = new HalLink(); } } function proxyProperties() { var source = halResource.$source.restangularized ? halResource.$source.plain() : halResource.$source; _.without(Object.keys(source), '_links', '_embedded').forEach(property => { Object.defineProperty(halResource, property, { get() { return halResource.$source[property]; }, set(value) { halResource.$source[property] = value; }, enumerable: true, configurable: true }); }); } function setLinksAsProperties() { _.without(Object.keys(halResource.$links), 'self').forEach(linkName => { lazy(halResource, linkName, () => { const link:any = halResource.$links[linkName].$link || halResource.$links[linkName]; if (Array.isArray(link)) { var items = link.map(item => createLinkedResource(linkName, item.$link)); var property:HalResource[] = new ObservableArray(...items).on('change', () => { property.forEach(item => { if (!item.$link) { property.splice(property.indexOf(item), 1); } }); halResource.$source._links[linkName] = property.map(item => item.$link); }); return property; } if (link.href) { if (link.method !== 'get') { return HalLink.callable(link); } return createLinkedResource(linkName, link); } return null; }, val => setter(val, linkName) ); }); } function setEmbeddedAsProperties() { Object.keys(halResource.$embedded).forEach(name => { lazy(halResource, name, () => halResource.$embedded[name], val => setter(val, name)); }); } function setupProperty(name:string, callback:(element:any) => any) { const instanceName = '$' + name; const sourceName = '_' + name; const sourceObj = halResource.$source[sourceName]; if (angular.isObject(sourceObj)) { Object.keys(sourceObj).forEach(propName => { lazy(halResource[instanceName], propName, () => callback(sourceObj[propName])); }); } } function setupLinks() { setupProperty('links', link => Array.isArray(link) ? link.map(HalLink.callable) : HalLink.callable(link)); } function setupEmbedded() { setupProperty('embedded', element => { angular.forEach(element, (child:any, name:string) => { if (child) { lazy(element, name, () => HalResource.create(child)); } }); if (Array.isArray(element)) { return element.map(HalResource.create); } return HalResource.create(element); }); } function createLinkedResource(linkName, link) { var resource = HalResource.getEmptyResource(); resource._links.self = link; const resourceClass = halResourceTypesStorage .getResourceClassOfAttribute(halResource.constructor._type, linkName); return new resourceClass(resource, false); } function setter(val:HalResource, linkName:string) { if (!val) { halResource.$source._links[linkName] = {href: null}; } else if (val.$link) { const link = val.$link; if (link.href) { halResource.$source._links[linkName] = link; } } return val; } } function halResourceService(...args) { [$q, lazy, HalLink, halResourceTypesStorage] = args; return HalResource; } halResourceService.$inject = [ '$q', 'lazy', 'HalLink', 'halResourceTypesStorage' ]; opApiModule.factory('HalResource', halResourceService);