//-- 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 {HalRequestService} from '../hal-request/hal-request.service'; import {HalResource} from '../hal-resources/hal-resource.service'; import FunctionBind = _.FunctionBind; var $q:ng.IQService; var halRequest:HalRequestService; export interface HalLinkInterface { href:string|null; method:string; title?:string; templated?:boolean; payload?:any; type?:string; } interface CallableHalLink extends HalLinkInterface { data?:ng.IPromise; } export class HalLink implements HalLinkInterface { /** * Create the HalLink from an object with the HalLinkInterface. */ public static fromObject(link:HalLinkInterface):HalLink { return new HalLink(link.href, link.title, link.method, link.templated, link.payload, link.type); } /** * Return a function that fetches the resource. */ public static callable(link:HalLinkInterface):CallableHalLink { return HalLink.fromObject(link).$callable(); } constructor(public href:string|null = null, public title:string = '', public method:string = 'get', public templated:boolean = false, public payload?:any, public type:string = 'application/json') { } /** * Fetch the resource. */ public $fetch(...params:any[]):ng.IPromise { const [data, headers] = params; return halRequest.request(this.method, this.href as string, data, headers); } /** * Prepare the templated link and return a CallableHalLink with the templated parameters set * * @returns {CallableHalLink} */ public $prepare(templateValues:{[templateKey:string]: string}) { if (!this.templated) { throw 'The link ' + this.href + ' is not templated.'; } let href = _.clone(this.href) || ''; _.each(templateValues, (value:string, key:string) => { let regexp = new RegExp('{' + key + '}'); href = href.replace(regexp, value); }); return HalLink.callable({ href: href, title: this.title, method: this.method, templated: false, payload: this.payload, type: this.type }); } /** * Return a function that fetches the resource. * * @returns {CallableHalLink} */ public $callable():CallableHalLink { const linkFunc:any = (...params:any[]) => this.$fetch(...params); _.extend(linkFunc, { $link: this, href: this.href, title: this.title, method: this.method, templated: this.templated, payload: this.payload, type: this.type }); return linkFunc; } } function halLinkService(...args:any[]) { [$q, halRequest] = args; return HalLink; } halLinkService.$inject = ['$q', 'halRequest']; opApiModule.factory('HalLink', halLinkService);