%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
declare(strict_types=1);
/**
* SPDX-FileCopyrightText: 2021 Nextcloud GmbH and Nextcloud contributors
* SPDX-License-Identifier: AGPL-3.0-or-later
*/
namespace OCA\Circles\Service;
use Exception;
use OCA\Circles\Db\ShareWrapperRequest;
use OCA\Circles\Exceptions\RequestBuilderException;
use OCA\Circles\Exceptions\ShareWrapperNotFoundException;
use OCA\Circles\Model\FederatedUser;
use OCA\Circles\Model\Probes\CircleProbe;
use OCA\Circles\Model\ShareWrapper;
use OCA\Circles\Tools\Traits\TDeserialize;
use OCA\Circles\Tools\Traits\TStringTools;
use OCP\Files\Folder;
use OCP\Files\NotFoundException;
use OCP\Share\IShare;
/**
* Class ShareWrapperService
*
* @package OCA\Circles\Service
*/
class ShareWrapperService {
use TStringTools;
use TDeserialize;
public function __construct(
private ShareWrapperRequest $shareWrapperRequest,
) {
}
/**
* @param string $singleId
* @param int $nodeId
*
* @return ShareWrapper
* @throws RequestBuilderException
* @throws ShareWrapperNotFoundException
*/
public function searchShare(string $singleId, int $nodeId): ShareWrapper {
return $this->shareWrapperRequest->searchShare($singleId, $nodeId);
}
/**
* @param IShare $share
*
* @throws NotFoundException
*/
public function save(IShare $share): void {
$this->shareWrapperRequest->save($share);
}
/**
* @param ShareWrapper $shareWrapper
*/
public function update(ShareWrapper $shareWrapper): void {
$this->shareWrapperRequest->update($shareWrapper);
}
/**
* @param ShareWrapper $shareWrapper
*/
public function delete(ShareWrapper $shareWrapper): void {
$this->shareWrapperRequest->delete((int)$shareWrapper->getId());
}
/**
* @param string $circleId
* @param string $userId
*
* @throws Exception
*/
public function deleteUserSharesToCircle(string $circleId, string $userId): void {
if ($userId === '') {
throw new Exception('$initiator cannot be empty');
}
$this->shareWrapperRequest->deleteSharesToCircle($circleId, $userId);
}
/**
* @param string $circleId
*/
public function deleteAllSharesToCircle(string $circleId): void {
$this->shareWrapperRequest->deleteSharesToCircle($circleId, '');
}
/**
* @param string $circleId
* @param FederatedUser|null $shareRecipient
* @param FederatedUser|null $shareInitiator
* @param bool $completeDetails
*
* @return ShareWrapper[]
* @throws RequestBuilderException
*/
public function getSharesToCircle(
string $circleId,
?FederatedUser $shareRecipient = null,
?FederatedUser $shareInitiator = null,
bool $completeDetails = false
): array {
return $this->shareWrapperRequest->getSharesToCircle(
$circleId,
$shareRecipient,
$shareInitiator,
$completeDetails
);
}
/**
* @param int $shareId
* @param FederatedUser|null $federatedUser
*
* @return ShareWrapper
* @throws ShareWrapperNotFoundException
* @throws RequestBuilderException
*/
public function getShareById(int $shareId, ?FederatedUser $federatedUser = null): ShareWrapper {
return $this->shareWrapperRequest->getShareById($shareId, $federatedUser);
}
/**
* @param int $fileId
* @param bool $getData
*
* @return ShareWrapper[]
* @throws RequestBuilderException
*/
public function getSharesByFileId(int $fileId, bool $getData = false): array {
return $this->shareWrapperRequest->getSharesByFileId($fileId, $getData);
}
/**
* @param array $fileIds
* @param bool $getData
*
* @return ShareWrapper[]
* @throws RequestBuilderException
*/
public function getSharesByFileIds(array $fileIds, bool $getData = false, bool $getChild = false): array {
return ($fileIds === []) ? [] : $this->shareWrapperRequest->getSharesByFileIds($fileIds, $getData, $getChild);
}
/**
* @param string $token
* @param FederatedUser|null $federatedUser
*
* @return ShareWrapper
* @throws RequestBuilderException
* @throws ShareWrapperNotFoundException
*/
public function getShareByToken(string $token, ?FederatedUser $federatedUser = null): ShareWrapper {
return $this->shareWrapperRequest->getShareByToken($token, $federatedUser);
}
/**
* @param FederatedUser $federatedUser
* @param int $nodeId
* @param CircleProbe|null $probe
*
* @return ShareWrapper[]
* @throws RequestBuilderException
*/
public function getSharedWith(
FederatedUser $federatedUser,
int $nodeId,
?CircleProbe $probe
): array {
return $this->shareWrapperRequest->getSharedWith($federatedUser, $nodeId, $probe);
}
/**
* @param FederatedUser $federatedUser
* @param int $nodeId
* @param bool $reshares
* @param int $offset
* @param int $limit
* @param bool $getData
* @param bool $completeDetails
*
* @return ShareWrapper[]
* @throws RequestBuilderException
*/
public function getSharesBy(
FederatedUser $federatedUser,
int $nodeId,
bool $reshares,
int $limit,
int $offset,
bool $getData = false,
bool $completeDetails = false
): array {
return $this->shareWrapperRequest->getSharesBy(
$federatedUser, $nodeId, $reshares, $limit, $offset, $getData, $completeDetails
);
}
/**
* @param FederatedUser $federatedUser
* @param Folder $node
* @param bool $reshares
* @param bool $shallow Whether the method should stop at the first level, or look into sub-folders.
*
* @return ShareWrapper[]
* @throws RequestBuilderException
*/
public function getSharesInFolder(FederatedUser $federatedUser, Folder $node, bool $reshares, bool $shallow = true): array {
return $this->shareWrapperRequest->getSharesInFolder($federatedUser, $node, $reshares, $shallow);
}
/**
* @param FederatedUser $federatedUser
* @param IShare $share
*
* @return ShareWrapper
* @throws NotFoundException
* @throws ShareWrapperNotFoundException
* @throws RequestBuilderException
*/
public function getChild(IShare $share, FederatedUser $federatedUser): ShareWrapper {
try {
return $this->shareWrapperRequest->getChild($federatedUser, (int)$share->getId());
} catch (ShareWrapperNotFoundException $e) {
}
return $this->createChild($share, $federatedUser);
}
/**
* @param FederatedUser $federatedUser
* @param IShare $share
*
* @return ShareWrapper
* @throws ShareWrapperNotFoundException
* @throws NotFoundException
* @throws RequestBuilderException
*/
private function createChild(IShare $share, FederatedUser $federatedUser): ShareWrapper {
$share->setSharedWith($federatedUser->getSingleId());
$childId = $this->shareWrapperRequest->save($share, (int)$share->getId());
return $this->getShareById($childId, $federatedUser);
}
/**
* @param FederatedUser $federatedUser
* @param int $nodeId
* @param string $probeSum
*
* @return string
*/
private function generateSharedWithCacheKey(
FederatedUser $federatedUser,
int $nodeId,
string $probeSum
): string {
return $federatedUser->getSingleId() . '#'
. $nodeId . '#'
. $probeSum;
}
}
Zerion Mini Shell 1.0