/** * Finds Locations for the given query. * * @throws \eZ\Publish\API\Repository\Exceptions\InvalidArgumentException if query is not valid * * @param \eZ\Publish\API\Repository\Values\Content\LocationQuery $query * @param boolean $filterOnUserPermissions if true only the objects which is the user allowed to read are returned. * * @return \eZ\Publish\API\Repository\Values\Content\Search\SearchResult */ public function findLocations( LocationQuery $query, $filterOnUserPermissions = true ) { $query = clone $query; $query->filter = $query->filter ?: new Criterion\MatchAll(); $this->validateSortClauses( $query ); if ( $filterOnUserPermissions && !$this->permissionsCriterionHandler->addPermissionsCriterion( $query->filter ) ) { return new SearchResult( array( 'time' => 0, 'totalCount' => 0 ) ); } if ( $query->limit === null ) { $query->limit = self::MAX_LIMIT; } $result = $this->locationSearchHandler->findLocations( $query ); foreach ( $result->searchHits as $hit ) { $hit->valueObject = $this->domainMapper->buildLocationDomainObject( $hit->valueObject ); } return $result; }
/** * Adds a relation of type common. * * The source of the relation is the content and version * referenced by $versionInfo. * * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException if the user is not allowed to edit this version * @throws \eZ\Publish\API\Repository\Exceptions\BadStateException if the version is not a draft * * @param \eZ\Publish\API\Repository\Values\Content\VersionInfo $sourceVersion * @param \eZ\Publish\API\Repository\Values\Content\ContentInfo $destinationContent the destination of the relation * * @return \eZ\Publish\API\Repository\Values\Content\Relation the newly created relation */ public function addRelation( APIVersionInfo $sourceVersion, ContentInfo $destinationContent ) { $sourceVersion = $this->loadVersionInfoById( $sourceVersion->contentInfo->id, $sourceVersion->versionNo ); if ( $sourceVersion->status !== APIVersionInfo::STATUS_DRAFT ) { throw new BadStateException( "\$sourceVersion", "Relations of type common can only be added to versions of status draft" ); } if ( !$this->repository->canUser( 'content', 'edit', $sourceVersion ) ) throw new UnauthorizedException( 'content', 'edit', array( 'contentId' => $sourceVersion->contentInfo->id ) ); $sourceContentInfo = $sourceVersion->getContentInfo(); $this->repository->beginTransaction(); try { $spiRelation = $this->persistenceHandler->contentHandler()->addRelation( new SPIRelationCreateStruct( array( 'sourceContentId' => $sourceContentInfo->id, 'sourceContentVersionNo' => $sourceVersion->versionNo, 'sourceFieldDefinitionId' => null, 'destinationContentId' => $destinationContent->id, 'type' => APIRelation::COMMON ) ) ); $this->repository->commit(); } catch ( Exception $e ) { $this->repository->rollback(); throw $e; } return $this->domainMapper->buildRelationDomainObject( $spiRelation, $sourceContentInfo, $destinationContent ); }
/** * Updates $location in the content repository * * @throws \eZ\Publish\API\Repository\Exceptions\UnauthorizedException If the current user user is not allowed to update this location * @throws \eZ\Publish\API\Repository\Exceptions\InvalidArgumentException if if set the remoteId exists already * * @param \eZ\Publish\API\Repository\Values\Content\Location $location * @param \eZ\Publish\API\Repository\Values\Content\LocationUpdateStruct $locationUpdateStruct * * @return \eZ\Publish\API\Repository\Values\Content\Location the updated Location */ public function updateLocation(APILocation $location, LocationUpdateStruct $locationUpdateStruct) { if ($locationUpdateStruct->priority !== null && !is_int($locationUpdateStruct->priority)) { throw new InvalidArgumentValue("priority", $locationUpdateStruct->priority, "LocationUpdateStruct"); } if ($locationUpdateStruct->remoteId !== null && (!is_string($locationUpdateStruct->remoteId) || empty($locationUpdateStruct->remoteId))) { throw new InvalidArgumentValue("remoteId", $locationUpdateStruct->remoteId, "LocationUpdateStruct"); } if ($locationUpdateStruct->sortField !== null && !$this->domainMapper->isValidLocationSortField($locationUpdateStruct->sortField)) { throw new InvalidArgumentValue("sortField", $locationUpdateStruct->sortField, "LocationUpdateStruct"); } if ($locationUpdateStruct->sortOrder !== null && !$this->domainMapper->isValidLocationSortOrder($locationUpdateStruct->sortOrder)) { throw new InvalidArgumentValue("sortOrder", $locationUpdateStruct->sortOrder, "LocationUpdateStruct"); } $loadedLocation = $this->loadLocation($location->id); if ($locationUpdateStruct->remoteId !== null) { try { $existingLocation = $this->loadLocationByRemoteId($locationUpdateStruct->remoteId); if ($existingLocation !== null) { throw new InvalidArgumentException("locationUpdateStruct", "location with provided remote ID already exists"); } } catch (APINotFoundException $e) { } } if (!$this->repository->canUser('content', 'edit', $loadedLocation->getContentInfo(), $loadedLocation)) { throw new UnauthorizedException('content', 'edit'); } $updateStruct = new UpdateStruct(); $updateStruct->priority = $locationUpdateStruct->priority !== null ? $locationUpdateStruct->priority : $loadedLocation->priority; $updateStruct->remoteId = $locationUpdateStruct->remoteId !== null ? trim($locationUpdateStruct->remoteId) : $loadedLocation->remoteId; $updateStruct->sortField = $locationUpdateStruct->sortField !== null ? $locationUpdateStruct->sortField : $loadedLocation->sortField; $updateStruct->sortOrder = $locationUpdateStruct->sortOrder !== null ? $locationUpdateStruct->sortOrder : $loadedLocation->sortOrder; $this->repository->beginTransaction(); try { $this->persistenceHandler->locationHandler()->update($updateStruct, $loadedLocation->id); $this->repository->commit(); } catch (Exception $e) { $this->repository->rollback(); throw $e; } return $this->loadLocation($loadedLocation->id); }
/** * Create a Content Type object. * * The content type is created in the state STATUS_DRAFT. * * @throws \eZ\Publish\API\Repository\Exceptions\InvalidArgumentException In case when * - array of content type groups does not contain at least one content type group * - identifier or remoteId in the content type create struct already exists * - there is a duplicate field identifier in the content type create struct * - content type create struct does not contain at least one field definition create struct * @throws \eZ\Publish\API\Repository\Exceptions\ContentTypeFieldDefinitionValidationException * if a field definition in the $contentTypeCreateStruct is not valid * @throws \eZ\Publish\API\Repository\Exceptions\ContentTypeValidationException * if a multiple field definitions of a same singular type are given * * @param \eZ\Publish\API\Repository\Values\ContentType\ContentTypeCreateStruct $contentTypeCreateStruct * @param \eZ\Publish\API\Repository\Values\ContentType\ContentTypeGroup[] $contentTypeGroups Required array of {@link ContentTypeGroup} to link type with (must contain one) * * @return \eZ\Publish\API\Repository\Values\ContentType\ContentTypeDraft */ public function createContentType(APIContentTypeCreateStruct $contentTypeCreateStruct, array $contentTypeGroups) { // Prevent argument mutation $contentTypeCreateStruct = clone $contentTypeCreateStruct; $this->validateInputContentTypeCreateStruct($contentTypeCreateStruct); $this->validateInputContentTypeGroups($contentTypeGroups); $initialLanguageId = $this->repository->getContentLanguageService()->loadLanguage($contentTypeCreateStruct->mainLanguageCode)->id; try { $this->contentTypeHandler->loadByIdentifier($contentTypeCreateStruct->identifier); throw new InvalidArgumentException("\$contentTypeCreateStruct", "Another ContentType with identifier '{$contentTypeCreateStruct->identifier}' exists"); } catch (APINotFoundException $e) { // Do nothing } if ($contentTypeCreateStruct->remoteId !== null) { try { $this->contentTypeHandler->loadByRemoteId($contentTypeCreateStruct->remoteId); throw new InvalidArgumentException("\$contentTypeCreateStruct", "Another ContentType with remoteId '{$contentTypeCreateStruct->remoteId}' exists"); } catch (APINotFoundException $e) { // Do nothing } } $fieldDefinitionIdentifierSet = array(); $fieldDefinitionPositionSet = array(); foreach ($contentTypeCreateStruct->fieldDefinitions as $fieldDefinitionCreateStruct) { // Check for duplicate identifiers if (!isset($fieldDefinitionIdentifierSet[$fieldDefinitionCreateStruct->identifier])) { $fieldDefinitionIdentifierSet[$fieldDefinitionCreateStruct->identifier] = true; } else { throw new InvalidArgumentException("\$contentTypeCreateStruct", "Argument contains duplicate field definition identifier '{$fieldDefinitionCreateStruct->identifier}'"); } // Check for duplicate positions if (!isset($fieldDefinitionPositionSet[$fieldDefinitionCreateStruct->position])) { $fieldDefinitionPositionSet[$fieldDefinitionCreateStruct->position] = true; } else { throw new InvalidArgumentException("\$contentTypeCreateStruct", "Argument contains duplicate field definition position '{$fieldDefinitionCreateStruct->position}'"); } } $allValidationErrors = array(); $spiFieldDefinitions = array(); $fieldTypeIdentifierSet = array(); foreach ($contentTypeCreateStruct->fieldDefinitions as $fieldDefinitionCreateStruct) { /** @var $fieldType \eZ\Publish\SPI\FieldType\FieldType */ $fieldType = $this->repository->getFieldTypeService()->buildFieldType($fieldDefinitionCreateStruct->fieldTypeIdentifier); if ($fieldType->isSingular() && isset($fieldTypeIdentifierSet[$fieldDefinitionCreateStruct->fieldTypeIdentifier])) { throw new ContentTypeValidationException("FieldType '{$fieldDefinitionCreateStruct->fieldTypeIdentifier}' is singular and can't be repeated in a ContentType"); } $fieldTypeIdentifierSet[$fieldDefinitionCreateStruct->fieldTypeIdentifier] = true; $fieldType->applyDefaultSettings($fieldDefinitionCreateStruct->fieldSettings); $fieldType->applyDefaultValidatorConfiguration($fieldDefinitionCreateStruct->validatorConfiguration); $validationErrors = $this->validateFieldDefinitionCreateStruct($fieldDefinitionCreateStruct, $fieldType); if (!empty($validationErrors)) { $allValidationErrors[$fieldDefinitionCreateStruct->identifier] = $validationErrors; } if (!empty($allValidationErrors)) { continue; } $spiFieldDefinitions[] = $this->buildSPIFieldDefinitionCreate($fieldDefinitionCreateStruct, $fieldType); } if (!empty($allValidationErrors)) { throw new ContentTypeFieldDefinitionValidationException($allValidationErrors); } $groupIds = array_map(function ($contentTypeGroup) { return $contentTypeGroup->id; }, $contentTypeGroups); if ($contentTypeCreateStruct->creatorId === null) { $contentTypeCreateStruct->creatorId = $this->repository->getCurrentUser()->id; } if ($contentTypeCreateStruct->creationDate === null) { $timestamp = time(); } else { $timestamp = $contentTypeCreateStruct->creationDate->getTimestamp(); } if ($contentTypeCreateStruct->remoteId === null) { $contentTypeCreateStruct->remoteId = $this->domainMapper->getUniqueHash($contentTypeCreateStruct); } $spiContentTypeCreateStruct = new SPIContentTypeCreateStruct(array("identifier" => $contentTypeCreateStruct->identifier, "name" => $contentTypeCreateStruct->names, "status" => APIContentType::STATUS_DRAFT, "description" => $contentTypeCreateStruct->descriptions === null ? array() : $contentTypeCreateStruct->descriptions, "created" => $timestamp, "modified" => $timestamp, "creatorId" => $contentTypeCreateStruct->creatorId, "modifierId" => $contentTypeCreateStruct->creatorId, "remoteId" => $contentTypeCreateStruct->remoteId, "urlAliasSchema" => $contentTypeCreateStruct->urlAliasSchema === null ? "" : $contentTypeCreateStruct->urlAliasSchema, "nameSchema" => $contentTypeCreateStruct->nameSchema === null ? "" : $contentTypeCreateStruct->nameSchema, "isContainer" => $contentTypeCreateStruct->isContainer === null ? false : $contentTypeCreateStruct->isContainer, "initialLanguageId" => $initialLanguageId, "sortField" => $contentTypeCreateStruct->defaultSortField === null ? Location::SORT_FIELD_PUBLISHED : $contentTypeCreateStruct->defaultSortField, "sortOrder" => $contentTypeCreateStruct->defaultSortOrder === null ? Location::SORT_ORDER_DESC : $contentTypeCreateStruct->defaultSortOrder, "groupIds" => $groupIds, "fieldDefinitions" => $spiFieldDefinitions, "defaultAlwaysAvailable" => $contentTypeCreateStruct->defaultAlwaysAvailable)); $this->repository->beginTransaction(); try { $spiContentType = $this->contentTypeHandler->create($spiContentTypeCreateStruct); $this->repository->commit(); } catch (Exception $e) { $this->repository->rollback(); throw $e; } return $this->buildContentTypeDraftDomainObject($spiContentType); }