Heute habe ich die Controller für die „Restfulen Applikationen“ erweitert. Zend bietet hier bereits einen abstrakten Controller, diesen habe ich, angepasst an die neue Strukturen (Services, etc.) erweitertl Hierzu habe ich die Standard Methoden wie get, getList, save bereits ausimplementiert. Da für jedes Entity auch ein Validator vorhanden sein sollte, kann dies leicht verwiklicht werden. Es muss lediglich eine Instanz der jeweiligen Validatoren zurückgeben werden, sowie die möglich geboten werden, die entsprechenden Services zu laden. Hier kommt uns zu gute das über den ServiceLocater ja bereits mit Strings gearbeitet wird um ein entsprechenden Service zu laden, dadurch müssen wir dann nur mehr diesen bereitstellen.
. Der AbstractRestfulController überprüft vor dem konkreten „Action“ aufruf (preDispatch()), welche HTTP Methode verwendet wurde und reagiert dementsprechend darauf. Wird z.B. die post Methode verwendet, so wird die Methode zum erstellen eines Entities aufgerufen. Bei „get“ gibt es ja dann noch den Sonderfall, wenn keine id beim Aufruf in der Url verwendet wurde, so wird alles zurückgegeben. Dies würde auch bei einen PUT ohne id geschehen, diese Methode wirft aber, wenn sie nicht in der erbenden Klasse überschrieben wird eine Exception in der nur gemeldet wird das diese Methode hier nicht verfügbar ist (von diesen gibt es noch einige siehe Zend\Mvc\Controller\AbstractRestfulController).
Darauf aufbauend müssen wir jetzt nur die entsprechenden Methoden ausimplementieren wie z.B. hier:
/**
* base controller class for the rest api controllers
* gives you an basic instantiation of the service for the entity the conroller is for
*/
abstract class AbstractRestfulDoctrineController extends AbstractRestfulController {
/**
* Returns the name of the class of the entity
* @return string
*/
abstract protected function getMainServiceName();
/**
* @return DoctrineReadyService
* @throws \Exception
*/
protected function getMainService(){
if($this->getMainServiceName() === null){
throw new \Exception("Entity Name must be set is (".$this->getMainServiceName().") instead");
}
return $this->getServiceLocator()->get($this->getMainServiceName());
}
/**
* @return JSONValidator
*/
abstract protected function getMainValidator();
/**
* @param $data
* @return BaseEntity
*/
abstract protected function getMainEntityWithData($data);
/**
* Return list of resources
*
* @return mixed
*/
public function getList()
{
return new JsonModel($this->getMainService()->findAllAsArray());
}
/**
* Return single resource
*
* @param mixed $id
* @return mixed
*/
public function get($id)
{
$id = $this->getEvent()->getRouteMatch()->getParam("id");
$entity = $this->getMainService()->findByIdAsArray($id);
if($entity === null){
return $this->getResponse()->setStatusCode(Response::STATUS_CODE_404);
}else{
return new JsonModel($this->getMainService()->findByIdAsArray($id));
}
}
/**
* Create a new resource
*
* @param mixed $data
* @return mixed
*/
public function create($data)
{
$response = $this->getResponse();
$validator = $this->getMainValidator();
if($validator->isValid($data)){
$response->setStatusCode(Response::STATUS_CODE_201); //created
return new JsonModel($this->getMainService()->save($this->getMainEntityWithData($data))->toArray());
}else{
$response->setStatusCode(Response::STATUS_CODE_400); // not acceptable
return new JsonModel(array("status"=>"error", "messages"=>$validator->getMessages()));
}
}
/**
* Update an existing resource
*
* @param mixed $id
* @param mixed $data
* @return mixed
*/
public function update($id, $data)
{
$validator = $this->getMainValidator();
$response = $this->getResponse();
if($validator->isValid($data)){
return new JsonModel($this->getMainService()->save($this->getMainEntityWithData($data))->toArray());
}else{
$response->setStatusCode(Response::STATUS_CODE_400); // not acceptable
return new JsonModel(array("status"=>"error", $validator->getMessages()));
}
}
/**
* Delete an existing resource
*
* @param mixed $id
* @return mixed
*/
public function delete($id)
{
$response = $this->getResponse();
$entity = $this->getMainService()->findById($id);
if($entity != null){
$this->getMainService()->delete($entity);
$response->setStatusCode(Response::STATUS_CODE_202); //accepted
return new JsonModel(array("status"=>"ok", "message"=>"entity deleted"));
} else{
$response->setStatusCode(Response::STATUS_CODE_404);
return new JsonModel(array("status"=>"error", "messages"=>"entity not found"));
}
}
}
Hierbei ist zu sagen, dass das HTTP StatusCode management noch nicht optimal ausgebaut ist, bzw. man mit diesen sicherlich noch mehr arbeiten könnte.
Ein konkreter Controller könnten dann z.B. so aussehen:
class PatStammApiController extends AbstractRestfulDoctrineController {
/**
* Returns the name of the class of the entity
* @return string
*/
protected function getMainServiceName()
{
return 'Medinfo\Service\PatStammService';
}
/**
* @return JSONValidator
*/
protected function getMainValidator()
{
return new PatStammValidator();
}
/**
* @param $data
* @return BaseEntity
*/
protected function getMainEntityWithData($data)
{
$entity = new PatStamm();
$entity->fillWithArray($data);
return $entity;
}
Nun da wir einen funktionierenden Controller haben müssen wir auch noch die Routen anpassen, da diese ja hier doch leicht anders aussehen. Eine Route könnte dann z.B. so aussehen:
...
'behandlungapi' => array(
'type' => 'segment',
'options' => array(
'route' => '/api/behandlung/[:id]',
'constraints' => array(
'id' => '[0-9]+',
),
'defaults' => array(
'controller' => 'Medinfo\Controller\BehandlungApi',
),
),
),
...
Wie man sieht wird hier nur mehr die Id übergeben, die dann im AbstractRestfulController abgegriffen wird. Für komplexere Datenstrukturen (z.B. nur Behandlungen von einen Patienten) z.B. child routes gerabeitet werden um so eventuell speziellere Aufrufe zu ermöglichen.
siehe auch