/**
* Delete a specific session
*
* @param string $str_id
* @return bool
*/
public function destroy($str_id)
{
if ($this->obj_session_entity instanceof Entity && $str_id === $this->obj_session_entity->getKeyName()) {
$this->getStore()->delete($this->obj_session_entity);
$this->obj_session_entity = null;
$this->str_data = '';
$this->bol_new = false;
} else {
$obj_session_entity = $this->getStore()->fetchByName($str_id);
if ($obj_session_entity instanceof Entity) {
$this->getStore()->delete($obj_session_entity);
}
}
$this->obj_mc->delete($this->getMemcacheKey($str_id));
return true;
}
/**
* Create a fully qualified Key path
*
* @equivalent ProtoBuf::configureKey() ?
*
* @param Entity $obj_gds_entity
* @param bool $bol_first_node
* @return array
* @throws \Exception
*/
public function buildKeyPath(Entity $obj_gds_entity, $bol_first_node = true)
{
$str_kind = $obj_gds_entity->getKind();
if (null === $str_kind) {
if ($bol_first_node) {
if ($this->obj_schema instanceof Schema) {
$str_kind = $this->obj_schema->getKind();
} else {
throw new \Exception('Could not build full key path, no Schema set on Mapper and no Kind set on Entity');
}
} else {
throw new \Exception('Could not build full key path, no Kind set on (nth node) GDS Entity');
}
}
// Build the first node in the Key Path from this entity
$arr_full_path = [$this->createKeyPathElement(['kind' => $str_kind, 'id' => $obj_gds_entity->getKeyId(), 'name' => $obj_gds_entity->getKeyName()])];
// Add any ancestors to the Key Path
$mix_ancestry = $obj_gds_entity->getAncestry();
if (is_array($mix_ancestry)) {
$arr_ancestor_path = [];
foreach ($mix_ancestry as $arr_ancestor_element) {
$arr_ancestor_path[] = $this->createKeyPathElement($arr_ancestor_element);
}
$arr_full_path = array_merge($arr_ancestor_path, $arr_full_path);
} elseif ($mix_ancestry instanceof Entity) {
$arr_full_path = array_merge($this->buildKeyPath($mix_ancestry, false), $arr_full_path);
}
return $arr_full_path;
}
/**
* Create a fully qualified Key path
*
* @equivalent ProtoBuf::configureKey() ?
*
* @param Entity $obj_gds_entity
* @param bool $bol_first_node
* @return array
* @throws \Exception
*/
private function buildKeyPath(Entity $obj_gds_entity, $bol_first_node = TRUE)
{
$str_kind = $obj_gds_entity->getKind();
if (null === $str_kind) {
if ($bol_first_node) {
$str_kind = $this->obj_schema->getKind();
} else {
throw new \Exception('Could not build full key path, no Kind set on (nth node) GDS Entity');
}
}
// Build the first node in the Key Path from this entity
$arr_full_path = [$this->createKeyPathElement(['kind' => $str_kind, 'id' => $obj_gds_entity->getKeyId(), 'name' => $obj_gds_entity->getKeyName()])];
// Add any ancestors to the Key Path
$mix_ancestry = $obj_gds_entity->getAncestry();
if (is_array($mix_ancestry)) {
foreach ((array) $obj_gds_entity->getAncestry() as $arr_ancestor_element) {
array_unshift($arr_full_path, $this->createKeyPathElement($arr_ancestor_element));
}
} elseif ($mix_ancestry instanceof Entity) {
$arr_full_path = array_merge($this->buildKeyPath($mix_ancestry, FALSE), $arr_full_path);
}
return $arr_full_path;
}
/**
* Populate a ProtoBuf Key from a GDS Entity
*
* @param Key $obj_key
* @param Entity $obj_gds_entity
* @return Key
*/
public function configureGoogleKey(Key $obj_key, Entity $obj_gds_entity)
{
// Add any ancestors FIRST
$mix_ancestry = $obj_gds_entity->getAncestry();
if (is_array($mix_ancestry)) {
// @todo Get direction right!
foreach ($mix_ancestry as $arr_ancestor_element) {
$this->configureGoogleKeyPathElement($obj_key->addPathElement(), $arr_ancestor_element);
}
} elseif ($mix_ancestry instanceof Entity) {
// Recursive
$this->configureGoogleKey($obj_key, $mix_ancestry);
}
// Root Key (must be the last in the chain)
$this->configureGoogleKeyPathElement($obj_key->addPathElement(), ['kind' => $obj_gds_entity->getKind(), 'id' => $obj_gds_entity->getKeyId(), 'name' => $obj_gds_entity->getKeyName()]);
return $obj_key;
}