/**
* {@inheritdoc}
*/
protected function renderEntity(ReflectionEntity $entity)
{
if (!$entity instanceof RecordSchema) {
throw new DocumenterException("Unsupported entity type.");
}
$element = parent::renderEntity($entity);
//Element Document must have defined create method
$element->method('create', ['@param array|\\Traversable $fields', '@return ' . $entity->getShortName()], ['fields'])->setStatic(true)->parameter('fields')->setOptional(true, []);
//Document has collection, let's clarify static methods
$name = $entity->getName();
$return = $entity->getShortName();
$find = $this->helper('selector', $name) . '|' . $this->helper('iterator', $name) . '|\\' . $name . '[]';
//Static collection methods
$find = $element->method('find', ['@param array $where', '@param array $load', '@return ' . $find], ['where', 'load'])->setStatic(true);
$find->parameter('where')->setOptional(true, [])->setType('array');
$find->parameter('load')->setOptional(true, [])->setType('array');
$findOne = $element->method('findOne', ['@param array $where', '@param array $load', '@param array $sortBy', '@return ' . $return . '|null'], ['where', 'load', 'sortBy'])->setStatic(true);
$findOne->parameter('where')->setOptional(true, [])->setType('array');
$findOne->parameter('load')->setOptional(true, [])->setType('array');
$findOne->parameter('sortBy')->setOptional(true, [])->setType('array');
$findByPK = $element->method('findByPK', ['@param mixed $primaryKey', '@param array $load', '@return ' . $return . '|null'], ['primaryKey'])->setStatic(true);
$findByPK->parameter('load')->setOptional(true, [])->setType('array');
//The most fun part, rendering relations!
foreach ($entity->getRelations() as $relation) {
if (!$relation instanceof RelationSchema) {
//Only ORM relations for now
continue;
}
$this->renderRelation($entity, $element, $relation);
}
return $element;
}
/**
* {@inheritdoc}
*/
protected function renderEntity(ReflectionEntity $entity)
{
if (!$entity instanceof DocumentSchema) {
throw new DocumenterException("Unsupported entity type.");
}
$element = parent::renderEntity($entity);
//Invalid methods
if (!empty($entity->getFields()['_id'])) {
$element->property('_id', '\\MongoId')->setAccess(AbstractElement::ACCESS_PUBLIC);
}
//Element Document must have defined create method
$element->method('create', ['@param array|\\Traversable $fields', '@return ' . $entity->getShortName()], ['fields'])->setStatic(true)->parameter('fields')->setOptional(true, []);
//Document has collection, let's clarify static methods
if (!empty($entity->getCollection())) {
$parent = $entity->getName();
$return = $entity->getShortName();
if ($entity->getParent(true) != $entity) {
//Document parent (related to same collection)
$parent = $entity->getParent(true)->getName();
$return = $entity->getShortName() . '|\\' . $parent;
}
$find = $this->helper('collection', $parent) . '|' . $this->helper('cursor', $parent) . '|\\' . $parent . '[]';
//Static collection methods
$element->method('find', ['@param array $query', '@return ' . $find], ['query'])->setStatic(true)->parameter('query')->setOptional(true, [])->setType('array');
$findOne = $element->method('findOne', ['@param array $query', '@param array $sortBy', '@return ' . $return . '|null'], ['query', 'sortBy'])->setStatic(true);
$findOne->parameter('query')->setOptional(true, [])->setType('array');
$findOne->parameter('sortBy')->setOptional(true, [])->setType('array');
$element->method('findByPK', ['@param mixed $mongoID', '@return ' . $return . '|null'], ['mongoID'])->setStatic(true);
}
//Composition (we only need to handle MANY compositions)
foreach ($entity->getCompositions() as $name => $composition) {
if ($composition['type'] == ODM::CMP_ONE) {
continue;
}
//We are going to create helper compositor class
$class = $composition['class'];
$element->property($name, '@var ' . $this->helper('compositor', $class) . '|\\' . $class . '[]');
$element->method('get' . ucfirst($name))->setComment('@return ' . $this->helper('compositor', $class) . '|\\' . $class . '[]');
}
//Aggregations
foreach ($entity->getAggregations() as $name => $aggregation) {
$aggregated = $this->builder->document($aggregation['class']);
$parent = $aggregated->getParent(true)->getName();
if ($aggregation['type'] == Document::ONE) {
//Simple ONE aggregation
$element->method($name, ['@return \\' . $parent]);
} else {
$find = $this->helper('collection', $parent) . '|' . $this->helper('cursor', $parent) . '|\\' . $parent . '[]';
$element->method($name, ['@param array $query', '@return ' . $find], ['query'])->parameter('query')->setOptional(true, [])->setType('array');
}
}
return $element;
}
