El proyecto implementa una extensión del framework maximo-perez-villalba/framework-dao
para persistencia de objetos en archivos con formato Json. Para ver el proyecto padre ir a framework-dao. Y aunque su fin principal es de apoyo pedagógico, la extensión es completamente funcional.
Se puede instalar framework-dao-json
a través de Composer.
1 Desde una consola de comandos ir al directorio del proyecto y ejecutar:
composer require maximo-perez-villalba/framework-dao-json
2 También agregando en el archivo composer.json
, dentro de la sección "require"
.
"require": {
"maximo-perez-villalba/framework-dao-json": ">=1.0.0"
},
2.1 Luego desde una consola de comandos ejecutar:
composer update
Esta extensión implementa a través de la clase DAOJson el CRUD definido en la clase DAO, para persistir objectos en un repositorio con formato Json usando la componente code.max/tool-repository-json. A su vez la clase DAOJson incorpora métodos específicos para la recuperación de datos desde el repositorio.
El diagrama de clases muestra el diseño de implementación de la extensión DAOJson, donde los objetos de modelo deben extender de la clase PersistentJson. La clase PersistentJson implementa la interfaz IRepositoryObject que define que los objetos que pueden ser guardados en el repositorio deben tener definido el método guid
(Global Unique Identificator).
<?php
// Para obtener una instancia de la clase DAOJson.
$dao = new DAOJson( $somethingPersistentJson );
// También puedo obtener una instancia de la clase DAOJson desde el objeto persistible.
$dao = $somethingPersistentJson->dao();
// Para guardar una nueva instancia de la clase Something en el repositorio.
$dao->create();
// Para sincronizar los cambios de un objeto de modelo.
$dao->update();
// Para borrar un objeto de modelo.
$daodb->delete();
// Para recuperar un objeto de modelo almacenado en formato objeto de la clase PersistentJson.
$something = DAOJson::getObjectByGuid( 'aGlobalUniqueIdentificator' );
// Para recuperar datos almacenados en formato mapa de arreglos .
$list = DAOJson::read( 'class', ['class'=>'aFullClassname'] );
// Para recuperar objetos almacenados en formato mapa de objetos.
$list = DAOJson::listByClass( 'aFullClassname' );