mirror of
https://github.com/salesagility/SuiteCRM.git
synced 2024-12-22 20:38:31 +00:00
66954ac3af
# Conflicts: # .travis.yml # README.md # data/SugarBean.php # include/MVC/View/SugarView.php # include/Smarty/plugins/function.fetch.php # include/SugarFields/Fields/File/SugarFieldFile.php # include/SugarObjects/templates/person/Person.php # include/SugarXHprof/SugarXHprof.php # include/SugarXHprof/xhprof_lib/utils/xhprof_runs.php # include/nusoap/class.nusoap_base.php # include/nusoap/class.soap_transport_http.php # include/nusoap/class.soapclient.php # include/nusoap/class.wsdl.php # include/nusoap/class.wsdlcache.php # include/parsecsv.lib.php # include/social/get_feed_data.php # include/tcpdf/barcodes.php # lib/Robo/Plugin/Commands/CodeCoverageCommands.php # modules/AOD_Index/Lib/Zend/Search/Lucene/Storage/File.php # modules/AOR_Charts/lib/pChart/class/pBarcode128.class.php # modules/AOR_Charts/lib/pChart/class/pBarcode39.class.php # modules/AOR_Charts/lib/pChart/class/pCache.class.php # modules/AOR_Charts/lib/pChart/class/pData.class.php # modules/AOR_Charts/lib/pChart/class/pDraw.class.php # modules/AOR_Charts/lib/pChart/class/pImage.class.php # modules/AOR_Charts/lib/pChart/class/pSpring.class.php # modules/AOS_PDF_Templates/templateParser.php # modules/AOS_Products/AOS_Products.php # modules/AOW_Actions/FormulaCalculator.php # modules/AOW_WorkFlow/aow_utils.php # modules/Trackers/store/DatabaseStore.php # phpcs.xml # service/core/REST/SugarRest.php # service/example/Rest_Proxy.php # suitecrm_version.php # tests/SuiteCRM/Test/SuitePHPUnit_Framework_TestCase.php # tests/unit/phpunit/data/SugarBeanTest.php # tests/unit/phpunit/include/MVC/Controller/SugarControllerTest.php # tests/unit/phpunit/include/MVC/SugarApplicationTest.php # tests/unit/phpunit/include/MVC/View/SugarViewTest.php # tests/unit/phpunit/include/MVC/View/views/view.editTest.php # tests/unit/phpunit/include/utils/securityUtilsTest.php # tests/unit/phpunit/modules/ACLActions/ACLActionTest.php # tests/unit/phpunit/modules/Emails/EmailTest.php # tests/unit/phpunit/modules/ProspectLists/ProspectListTest.php # tests/unit/phpunit/modules/SchedulersJobs/SchedulersJobTest.php # tests/unit/phpunit/modules/UserPreferences/UserPreferenceTest.php # themes/SuiteP/css/Dawn/style.css # themes/SuiteP/css/Day/style.css # themes/SuiteP/css/Dusk/style.css # themes/SuiteP/css/Night/style.css
161 lines
5.5 KiB
PHP
161 lines
5.5 KiB
PHP
<?php
|
|
/**
|
|
*
|
|
* SugarCRM Community Edition is a customer relationship management program developed by
|
|
* SugarCRM, Inc. Copyright (C) 2004-2013 SugarCRM Inc.
|
|
*
|
|
* SuiteCRM is an extension to SugarCRM Community Edition developed by SalesAgility Ltd.
|
|
* Copyright (C) 2011 - 2018 SalesAgility Ltd.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify it under
|
|
* the terms of the GNU Affero General Public License version 3 as published by the
|
|
* Free Software Foundation with the addition of the following permission added
|
|
* to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
|
|
* IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
|
|
* OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
|
|
*
|
|
* 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 Affero General Public License for more
|
|
* details.
|
|
*
|
|
* You should have received a copy of the GNU Affero General Public License along with
|
|
* this program; if not, see http://www.gnu.org/licenses or write to the Free
|
|
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
|
* 02110-1301 USA.
|
|
*
|
|
* You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
|
|
* SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
|
|
*
|
|
* The interactive user interfaces in modified source and object code versions
|
|
* of this program must display Appropriate Legal Notices, as required under
|
|
* Section 5 of the GNU Affero General Public License version 3.
|
|
*
|
|
* In accordance with Section 7(b) of the GNU Affero General Public License version 3,
|
|
* these Appropriate Legal Notices must retain the display of the "Powered by
|
|
* SugarCRM" logo and "Supercharged by SuiteCRM" logo. If the display of the logos is not
|
|
* reasonably feasible for technical reasons, the Appropriate Legal Notices must
|
|
* display the words "Powered by SugarCRM" and "Supercharged by SuiteCRM".
|
|
*/
|
|
namespace SuiteCRM\API\JsonApi\v1\Resource;
|
|
|
|
use SuiteCRM\API\JsonApi\v1\Enumerator\RelationshipType;
|
|
use SuiteCRM\API\v8\Exception\ApiException;
|
|
use SuiteCRM\API\v8\Exception\ForbiddenException;
|
|
|
|
/** Class ResourceIdentifier
|
|
* @package SuiteCRM\API\JsonApi\v1\Resource
|
|
* @see http://jsonapi.org/format/1.0/#document-resource-identifier-objects
|
|
*/
|
|
class Relationship extends ResourceIdentifier
|
|
{
|
|
/** @var string $link */
|
|
protected $name;
|
|
|
|
/** @var RelationshipType $relationshipType */
|
|
protected $relationshipType = RelationshipType::TO_ONE;
|
|
|
|
/** @var ResourceIdentifier[] $link */
|
|
protected $link;
|
|
|
|
/**
|
|
* @param string $name
|
|
*/
|
|
public function setRelationshipName($name)
|
|
{
|
|
$this->name = $name;
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function getRelationshipName()
|
|
{
|
|
return $this->name;
|
|
}
|
|
|
|
/**
|
|
* @return RelationshipType
|
|
*/
|
|
public function getRelationshipType()
|
|
{
|
|
return $this->relationshipType;
|
|
}
|
|
|
|
public function setRelationshipType($type = RelationshipType::TO_ONE)
|
|
{
|
|
if ($type !== RelationshipType::TO_ONE && $type !== RelationshipType::TO_MANY) {
|
|
throw new ApiException('[Relationship] [Unsupported Relationship Type] '. $type);
|
|
}
|
|
$this->relationshipType = $type;
|
|
}
|
|
|
|
/**
|
|
* @param ResourceIdentifier $related
|
|
* @return Resource
|
|
* @throws ForbiddenException
|
|
* @throws \SuiteCRM\API\v8\Exception\ApiException
|
|
*/
|
|
public function withResourceIdentifier(ResourceIdentifier $related)
|
|
{
|
|
$this->withResourceObject($related);
|
|
return clone $this;
|
|
}
|
|
|
|
/**
|
|
* @return array
|
|
*/
|
|
public function toJsonApiResponse()
|
|
{
|
|
$payload = array();
|
|
if ($this->getRelationshipType() === RelationshipType::TO_ONE) {
|
|
$payload = $this->link->toJsonApiResponse();
|
|
} else {
|
|
if ($this->getRelationshipType() === RelationshipType::TO_MANY) {
|
|
foreach ($this->link as $link) {
|
|
$response = $link->toJsonApiResponse();
|
|
if (empty($response) === false) {
|
|
$payload[] = $response;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return $payload;
|
|
}
|
|
|
|
/**
|
|
* Sets the link property up
|
|
* @parm Resource|ResourceIdentiifer
|
|
* @throws \SuiteCRM\API\v8\Exception\ApiException
|
|
*/
|
|
private function withResourceObject($related)
|
|
{
|
|
if ($this->getType() === null) {
|
|
$this->type = $related->getType();
|
|
} elseif ($this->getType() !== $related->getType()) {
|
|
throw new ForbiddenException('[Relationship] [Incompatible Resource Type] "'. $related->getType().'"');
|
|
}
|
|
|
|
$this->id = $related->getId();
|
|
|
|
if ($this->relationshipType === RelationshipType::TO_ONE) {
|
|
$this->link = $related;
|
|
} elseif ($this->relationshipType === RelationshipType::TO_MANY) {
|
|
$this->link[] = $related;
|
|
} else {
|
|
throw new ApiException(
|
|
'[Relationship] [Unsupported Relationship Type] ' .
|
|
$this->relationshipType
|
|
);
|
|
}
|
|
|
|
if ($this->getType() === null) {
|
|
$this->type = $related->getType();
|
|
} elseif ($this->getType() !== $related->getType()) {
|
|
throw new ForbiddenException('[Relationship] [Incompatible Resource Type] "'. $related->getType().'"');
|
|
}
|
|
|
|
return clone $this;
|
|
}
|
|
}
|