/**
* Saves user data to the Management API. This operates as both insert and
* update.
*
* If user's email doesn't look valid (must contain @), a
* ParameterException is thrown.
*
* @param bool|null $force_update
* If false, assume that this is a new instance.
* If true, assume that this is an update to an existing instance.
* If null, try an update, and if that fails, try an insert.
* @param string|null $old_email
* If the developer's email has changed, this field must contain the
* previous email value.
*
* @throws \Apigee\Exceptions\ParameterException
*/
public function save($force_update = false, $old_email = null)
{
// See if we need to brute-force this.
if ($force_update === null) {
try {
$this->save(true, $old_email);
} catch (ResponseException $e) {
if ($e->getCode() == 404) {
// Update failed because dev doesn't exist.
// Try insert instead.
$this->save(false, $old_email);
} else {
// Some other response error.
throw $e;
}
}
return;
}
if (!$this->validateUser()) {
$message = 'Developer requires valid-looking email address, firstName, lastName and userName.';
throw new ParameterException($message);
}
if (empty($old_email)) {
$old_email = $this->email;
}
$payload = array('email' => $this->email, 'userName' => $this->userName, 'firstName' => $this->firstName, 'lastName' => $this->lastName);
if (count($this->attributes) > 0) {
$payload['attributes'] = array();
$i = 0;
foreach ($this->attributes as $name => $value) {
$i++;
if ($i > self::MAX_ATTRIBUTE_COUNT && $this->pagingEnabled) {
// This truncation occurs silently; should we throw an exception?
break;
}
$payload['attributes'][] = array('name' => $name, 'value' => $value);
}
}
$url = null;
if ($force_update || $this->createdAt) {
if ($this->developerId) {
$payload['developerId'] = $this->developerId;
}
$url = rawurlencode($old_email);
}
// Save our desired status for later.
$cached_status = $this->status;
if ($force_update) {
$this->put($url, $payload);
} else {
$this->post($url, $payload);
}
self::loadFromResponse($this, $this->responseObj);
// We must cache the DebugData from the developer-save call so that
// we can make it available to clients AFTER the "action" call below.
$responseData = DebugData::toArray();
// If status has changed, we must directly change it with a separate
// POST call, because Edge will ignore a 'status' member in the
// app-save payload.
// We must also do this when creating a developer ex nihilo in order
// to set initial status. Otherwise new developer will have default
// status, which is generally 'approved'.
$this->post($this->email . '?action=' . $cached_status);
$this->status = $cached_status;
// Restore DebugData from cached response.
DebugData::fromArray($responseData);
}
