/**
* /messages/{groupId}/outbox/{msgId}
* /messages/{groupId}/outbox
*
* @param RequestItem $requestItem
* @return responseItem
*/
public function handlePost(RequestItem $requestItem)
{
$requestItem->applyUrlTemplate(self::$MESSAGES_PATH);
$userIds = $requestItem->getUsers();
$message = $requestItem->getParameter('message');
$optionalMessageId = $requestItem->getParameter('msgId');
return $this->service->createMessage($userIds[0], $requestItem->getAppId(), $message, $optionalMessageId, $requestItem->getToken());
}
/**
* Updates the album. The URI structure: /{userId}/{groupId}/{albumId}
*/
public function handlePut(RequestItem $requestItem)
{
$this->checkService();
$requestItem->applyUrlTemplate(self::$ALBUM_PATH);
$userIds = $requestItem->getUsers();
$groupId = $requestItem->getGroup();
$albumIds = $requestItem->getListParameter('albumId');
$album = $requestItem->getParameter('album');
HandlerPreconditions::requireSingular($userIds, "userId must be singular value");
HandlerPreconditions::requireNotEmpty($groupId, "groupId must be specified.");
HandlerPreconditions::requireSingular($albumIds, "albumId must be singular value.");
HandlerPreconditions::requireNotEmpty($album, "album must be specified.");
$album['id'] = $albumIds[0];
return $this->service->updateAlbum($userIds[0], $groupId, $album, $requestItem->getToken());
}
/**
* /appdata/{userId}/{groupId}/{appId}
* - fields={field1, field2}
*
* examples:
* /appdata/john.doe/@friends/app?fields=count
* /appdata/john.doe/@self/app
*
* The post data should be a regular json object. All of the fields vars will
* be pulled from the values and set on the person object. If there are no
* fields vars then all of the data will be overridden.
*/
public function handlePost(RequestItem $requestItem)
{
$this->checkService();
$requestItem->applyUrlTemplate(self::$APP_DATA_PATH);
$userIds = $requestItem->getUsers();
if (count($userIds) < 1) {
throw new InvalidArgumentException("No userId specified");
} elseif (count($userIds) > 1) {
throw new InvalidArgumentException("Multiple userIds not supported");
}
$values = $requestItem->getParameter("data");
// this used to be $requestItem->getFields() instead of using the fields, but that makes no sense to me
// better to detect the fields depending on input right?
$fields = array();
foreach (array_keys($values) as $key) {
$fields[] = $key;
if (!$this->isValidKey($key)) {
throw new SocialSpiException("One or more of the app data keys are invalid: " . $key, ResponseError::$BAD_REQUEST);
}
}
$this->service->updatePersonData($userIds[0], $requestItem->getGroup(), $requestItem->getAppId(), $fields, $values, $requestItem->getToken());
}
/**
* /activities/{userId}/@self
*
* examples:
* /activities/@viewer/@self/@app
* /activities/john.doe/@self
* - postBody is an activity object
*
* @param RequestItem $requestItem
* @return ResponseItem
*/
public function handlePost(RequestItem $requestItem)
{
$this->checkService();
$requestItem->applyUrlTemplate(self::$ACTIVITY_ID_PATH);
$userIds = $requestItem->getUsers();
$activityIds = $requestItem->getListParameter("activityId");
if (empty($userIds)) {
throw new InvalidArgumentException("No userId specified");
} elseif (count($userIds) > 1) {
throw new InvalidArgumentException("Multiple userIds not supported");
}
// TODO This seems reasonable to allow on PUT but we don't have an update verb.
if (!empty($activityIds)) {
throw new InvalidArgumentException("Cannot specify activityId in create");
}
/*
* Note, on just about all types of social networks you would only allow activities to be created when the owner == viewer, and the userId == viewer as well, in code this would mean:
* if ($token->getOwnerId() != $token->getViewerId() || $token->getViewerId() != $userId->getUserId($token)) {
* throw new SocialSpiException("Create activity permission denied.", ResponseError::$UNAUTHORIZED);
* }
*/
return $this->service->createActivity($userIds[0], $requestItem->getGroup(), $requestItem->getAppId(), $requestItem->getFields(), $requestItem->getParameter("activity"), $requestItem->getToken());
}
/**
* /activities/{userId}/@self
*
* examples:
* /activities/@viewer/@self/@app
* /activities/john.doe/@self
* - postBody is an activity object
*/
public function handlePost(RequestItem $requestItem)
{
$requestItem->applyUrlTemplate(self::$ACTIVITY_ID_PATH);
$userIds = $requestItem->getUsers();
$activityIds = $requestItem->getListParameter("activityId");
if (empty($userIds)) {
throw new InvalidArgumentException("No userId specified");
} elseif (count($userIds) > 1) {
throw new InvalidArgumentException("Multiple userIds not supported");
}
// TODO This seems reasonable to allow on PUT but we don't have an update verb.
if (!empty($activityIds)) {
throw new InvalidArgumentException("Cannot specify activityId in create");
}
return $this->service->createActivity($userIds[0], $requestItem->getGroup(), $requestItem->getAppId(), $requestItem->getFields(), $requestItem->getParameter("activity"), $requestItem->getToken());
}
/**
* Updates a message or a message collection.
*/
public function handlePut(RequestItem $requestItem)
{
$this->checkService();
$requestItem->applyUrlTemplate(self::$MESSAGES_PATH);
$userIds = $requestItem->getUsers();
HandlerPreconditions::requireSingular($userIds, "UserId is not singular.");
$msgCollId = $requestItem->getParameter("msgCollId");
HandlerPreconditions::requireNotEmpty($msgCollId, "msgCollId is required.");
$messageIds = $requestItem->getListParameter("messageId");
if (empty($messageIds)) {
// Updates message collection.
$messageCollection = $requestItem->getParameter("entity");
$messageCollection['id'] = $msgCollId;
HandlerPreconditions::requireNotEmpty($messageCollection, "Can't parse message collection.");
return $this->service->updateMessageCollection($userIds[0], $messageCollection, $requestItem->getToken());
} else {
// Updates a message.
HandlerPreconditions::requireSingular($messageIds, "Message id is not singular.");
$message = $requestItem->getParameter("entity");
$message['id'] = $messageIds[0];
HandlerPreconditions::requireNotEmpty($message, "Can't parse message.");
return $this->service->updateMessage($userIds[0], $msgCollId, $message, $requestItem->getToken());
}
}
