EQP.EFRepository.Core 1.3.9

EQP.EFRepository.Core

Pacchetto che implementa il pattern UnitOfWork & Repository e permette la centralizzazione di interfacce, modelli, repository (con operazioni CRUD di base) e servizi basati su database gestiti tramite Entity Framework Core.

Per la gestione dei modelli sono esposte le seguenti interfacce:

• IPrimaryKeyEntity<TPrimaryKey>: interfaccia che permette di attribuire la proprietà ID (identificativo univoco) a un modello e indicarne il tipo (TPrimaryKey sarà il tipo primitivo da attribuire alla primary key)
• IBaseEntity: interfaccia che implementa la IPrimaryKeyEntity<int> definendo già la primary key come campo intero. I modelli che implementano questa interfaccia avranno sempre la proprietà ID di tipo int
• IBaseStringEntity: interfaccia che implementa la IPrimaryKeyEntity<int> definendo la primary key come campo di tipo string. I modelli che implementano questa interfaccia avranno sempre la proprietà ID di tipo string
• IAuditEntity: interfaccia che permette l'implementazione delle proprietà necessarie all'audit, quindi identificativo dell'utente che esegue una insert o update sui dati di un certo modello, e le date di inserimento e modifica di un record
• ISoftDeleteEntity: interfaccia che permette la gestione della cancellazione logica. I modelli che implementano questa interfaccia non verranno cancellati fisicamente dal database ma solo logicamente. Inoltre verrà tenuto traccia dell'identificativo dell'utente che esegue la soft delete e la data in cui è avvenuta tale cancellazione
• IDisableEntity: interfaccia che permette la gestione della disattivazione/attivazione di un'entità. I modelli che implementano questa interfaccia potranno essere disabilitati in modo da impedirne la ricerca ma lasciarli comunque visibili in alcune sezioni.
• IUnitOfWork: interfaccia che permette la gestione di più unit of work e quindi di più connessioni e transazioni su stesso db o db differenti.
• ISessionModel: interfaccia utilizzata per centralizzare dati di sessione riutilizzabili all'interno di repository e servizi. L'interfaccia implementa solo la proprietà User di tipo IBaseEntity. Al momento viene usata, se definita, solo per la scrittura dei dati di audit per le entità che implementano l'interfaccia IAuditEntity

Livello di accesso ai dati

UnitOfWork

Centralizza l'esecuzione delle operazioni CRUD e la gestione delle transazioni sul contesto del database. Implementa l'interfaccia IUnitOfWork per fare in modo di poter gestire più database e quindi più UnitOfWork. Per poter essere istanziata è necessario passare nel costruttore l'istanza del DbContext da utilizzare. I metodi esposti da questa classe sono:

• SaveChanges() : scrive sul database tutte le modifiche pendenti tracciate nell'istanza del DbContext passata nel costruttore
• BeginTransaction(): apre una nuova transazione sull'istanza del DbContext passata nel costruttore. Se esiste già una transazione aperta sul DbContext genera un'eccezione.
• CommitTransaction() esegue la commit della transazione aperta sull'istanza del DbContext passata nel costruttore. Se non ci sono transazioni aperte genera un'eccezione.
• RollbackTransaction() esegue il rollback transazione aperta sull'istanza del DbContext passata nel costruttore. Se non ci sono transazioni aperte genera un'eccezione.
• GetIdentityRepository<TRepository, TEntity>(): utilizza la reflection per restituire una nuova istanza del repository avente tipo uguale al TRepository definito.

IRepository

Interfaccia che permette la centralizzazione di tutte le operazioni CRUD di base. Per poter implementare tale interfaccia è obbligatorio definire i seguenti tipi:

• TEntity: tipo dell'entità gestita con EFCore e che deve implementare l'interfaccia IPrimaryKeyEntity<TPrimaryKey>
• TPrimaryKey: tipo primitivo della primary key ID

L'interfaccia definisce i seguenti metodi:

• void Save(TEntity entity):
• TEntity Get(TPrimaryKey, params Expression<Func<TEntity, object>>[] includes):
• IQueryable<TEntity> GetAll(Expression<Func<TEntity, object>>[] includes = null):
• IQueryable<TEntity> GetBy(Expression<Func<TEntity, bool>> predicate, Expression<Func<TEntity, object>>[] includes = null):
• void Delete(TEntity entity):
• void Delete(TPrimaryKey ID):
• bool Exists(TPrimaryKey ID):
• bool Exists(Expression<Func<TEntity, bool>> predicate):
• void WriteAuditData(TEntity auditEntity):
• IQueryable<TEntity> IncludeMultiple(params Expression<Func<TEntity, object>>[] includes):

IdentityRepository

Questo repository implementa l'interfaccia IRepository definendo già il tipo TPrimaryKey come intero, pertanto tutte le classi che erediteranno da questo dovranno essere classi che gestiscono modelli la cui primary key è un intero. //TO DO

GenericRepository

//TO DO

Livello di gestione dei servizi centralizzati

//TO DO

IdentityService

//TO DO

GenericService

//TO DO