Systema Core

2020 - Alessandro Lanni

TODO

• Implementare Sessione su REDIS

Frontend TODO

• Integrare SB Admin 2 con bootstrap 4
• Integrare Grunt

Doctrine

Come generare le entita' dal DB:

docker-compose exec api php ./vendor/bin/doctrine-module orm:convert-mapping --namespace="Systema\\Entities\\" --force --from-database annotation ./EXPORT/

docker-compose exec api php ./vendor/bin/doctrine-module orm:generate-entities --update-entities="true" --generate-methods="true" ./EXPORT/.

Collection, Paginators e Adapters

Per consentire il passaggio dei dati daDoctrine a REST, e' utile ottenere con il queryBuilder la Query:

$localTypeRepo = $this->getORM()->getRepository(LocalType::class);
$queryBuilder = $localTypeRepo->createQueryBuilder('lt');
$query = $queryBuilder->getQuery();

Ottenuta la query, si passa alla creazione di un PaginatorAdapter di Doctrine:

$adapter = new \DoctrineORMModule\Paginator\Adapter\DoctrinePaginator(new \Doctrine\ORM\Tools\Pagination\Paginator($adapter));

L'adapter ottenuto puo' essere usato come Collection.

Abstract Systema\Paginator\PaginatorAbstract

Vedere i file api/module/Systema/src/V1/Rest/LocalType/LocalTypeCollection.php per capire l'implementazione.

Authentication e Authorization

Per innestare la propria gestione di Authentication e Authorization aggiungere nel file module.config.php

'service_manager' => [
        'factories' => [
            ...
            \Systema\Authentication\AuthAdapter::class => \Systema\Authentication\AuthAdapterFactory::class
        ],
        'delegators' => [
            \Laminas\ApiTools\MvcAuth\Authentication\DefaultAuthenticationListener::class => [
                \Systema\Authentication\AuthDelegatorFactory::class,
            ],
            \Laminas\ApiTools\MvcAuth\Authorization\DefaultAuthorizationListener::class => [
                \Systema\Authorization\AuthorizationListener::class,
            ],
        ],
    ],

Aggiungere anche la configurazione delle strategie di autenticazione:

'api-tools-mvc-auth' => [
        'authentication' => [
            'adapters' => [
                'SystemaAuth' => [
                    'adapter' => \Systema\Authentication\AuthAdapter::class,
                    'options' => [
                        //Da decidere
                    ],
                    ]
                ]
            ],
            .....

Da notare che il nome dell'adapter SystemaAuth deve essere riportato nella proprietá private array $providesTypes = ['SystemaAuth']; del file AuthAdapter (Service).

EventManagement

Per la gestione ad eventi e per la programmazione ad aspetti, si puo' creare un oggetto che implementa questa interfaccia:

ListenerAggregateInterface

Per innestare l'EventManager, nel Module.php:

    public function onBootstrap(MvcEvent $e)
    {
        $eventManager        = $e->getApplication()->getEventManager();
        $alService = $e->getApplication()->getServiceManager()->get(AuditLogService::class);
        $alListener = new AuditLogEvents($alService);
        $alListener->attach(
            $eventManager
        );
    }

Authenticazione su mezzio

Per innestare il controllo dell'autenticazione, inserire nella route della action desiderata \Mezzio\Authentication\AuthenticationMiddleware::class:

route.php

$app->get('/user/welcome', [
        \Mezzio\Authentication\AuthenticationMiddleware::class,
        App\Action\UserWelcomeAction::class,
    ],
        'user.welcome');

A questo punto, in App\Action\UserWelcomeAction::class si potra' accedere alla sessione in qeuesto modo:

public function handle(ServerRequestInterface $request) : ResponseInterface
{
    /** @var Session $user */
    $user = $request->getAttribute(UserInterface::class);
}

Authorization

Per la gestione dell'Authorization si usa l'array di configurazione:

    'systema-auth' => [
        // Array associativo tra Entity (in risposta) e AssertionClass
        'owner-assertions' => [
            'default' => \Systema\Authorization\Assertion\AssertOwner::class,
            'collection-default' => \Systema\Authorization\Assertion\AssertCollectionOwner::class,
            \Systema\V1\Rest\LocalType\LocalTypeEntity::class =>
                \Systema\Authorization\Assertion\AssertGrantedEntity::class,
            \Systema\V1\Rest\LocalType\LocalTypeCollection::class =>
                \Systema\Authorization\Assertion\AssertGrantedCollection::class,
            \SystemaAuth\V1\Rest\Role\RoleCollection::class =>
                \Systema\Authorization\Assertion\AssertAdminsCollection::class,
        ]
    ],