lode / jsonapi

	 * @param RelationshipObject $relationshipObject

	 * @param array              $options            optional {@see ResourceDocument::$defaults}

	 */

	public function addRelationshipObject($key, RelationshipObject $relationshipObject, array $options=[]) {

		$this->ensureResourceObject();

		$options = array_merge(self::$defaults, $options);

		$this->resource->addRelationshipObject($key, $relationshipObject);

		if ($options['includeContainedResources']) {

			$this->addIncludedResourceObject(...$relationshipObject->getNestedContainedResourceObjects());

		}

	}

	/**

	 * set the RelationshipsObject to the resource

	 * @param RelationshipsObject $relationshipsObject

	 * @param array               $options             optional {@see ResourceDocument::$defaults}

	 */

	public function setRelationshipsObject(RelationshipsObject $relationshipsObject, array $options=[]) {

		$this->ensureResourceObject();

		$options = array_merge(self::$defaults, $options);

		$this->resource->setRelationshipsObject($relationshipsObject);

		if ($options['includeContainedResources']) {

			$this->addIncludedResourceObject(...$relationshipsObject->getNestedContainedResourceObjects());

		}

	}

	/**

	 * spec api