https://github.com/zarusz/lightdatainterface

Common interface to work with your data access layer. Minimizes boiler plate code, dependency on your persistence framework (NHibernate/EntityFramework/MongoDriver) and adds some helpers for common scenarios.
https://github.com/zarusz/lightdatainterface

Last synced: 3 days ago
JSON representation

Common interface to work with your data access layer. Minimizes boiler plate code, dependency on your persistence framework (NHibernate/EntityFramework/MongoDriver) and adds some helpers for common scenarios.

• Host: GitHub
• URL: https://github.com/zarusz/lightdatainterface
• Owner: zarusz
• License: apache-2.0
• Created: 2016-05-26T06:46:39.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2017-07-20T00:38:31.000Z (over 7 years ago)
• Last Synced: 2024-11-02T17:12:09.406Z (12 days ago)
• Language: C#
• Homepage:
• Size: 45.9 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# LightDataInterface

This project is in BETA stage.

## Benefits

* Common and light data access interface enables your client code to be independent of the specific DAL technology (e.g. NHibernate).

* Easier to switch from an existing DAL implementation (e.g. NHibernate) to another (e.g. Entity Framework).

* Eliminates boilerplate in DAL client code (e.g. starting a transaction, or opening a data session).

* Enables to have both DAL implementations (e.g. ADO.NET + NHibernate) transparent to the DAL client code.

* Ability to have more than one database/store and transparently bind repository implementation to use the appropiate database/store.

## Features

### Common interfaces

The DAL client code (e.g. application layer) uses minimalistic and straightforward interfaces to coordinate the data access layer. No dependencies on any particular framework (e.g. NHibernate, ADO.NET or EntityFramework).

* `IDataSession`

* `IUnitOfWork`

* `IDataSessionFactory`

* `IUnitOfWorkFactory`

* `DataSession`

When you decide to move to a different data access implementation or have two different DAL strategies - this gets easier.

Package: `LightDataInterface`

### Providers for your favorite data access framework

* Adapter for EntityFramework

  * Package: `LightDataInterface.EntityFramework`

* Adapter for NHibernate (*pending*)

  * Package: `LightDataInterface.NHibernate`

* Adapter for MongoDb (*roadmap/future*)

* Adapter for ADO.NET (*roadmap/future*)

### WebApi integration

`[UnitOfWork]` attribute wraps controller's action in a transaction (`UnitOfWork`). When the action executes successfully the transaction is commited automatically, otherwise when an exception occurs the transaction is rolled back automatically. 

```CS

[HttpPost]

[Route("{markId}/Like")]

[UnitOfWork] // method wrapped in a transaction

public HttpResponseMessage Like(int markId, bool value)

{

    var mark = _markRepo.FindById(markId, MarkFetchStrategy.Like);

    if (mark == null)

    {

        return Request.CreateResponse(HttpStatusCode.NotFound);

    }

    mark.SetLiked(CurrentUser, value);

    return Request.CreateResponse(HttpStatusCode.OK);

}

```

Package: `LightDataInterface.Extra.WebApi`

## Examples

### Entity Framework and WebApi example

#### Domain model layer

ToDo

#### Services layer (WebApi)

ToDo

#### Data access layer (EntityFramework)

ToDo

#### Setup/configuration (Autofac)

ToDo

## Packages

Name | Descripton | Dependencies

------------ | ------------- | -------------

`LightDataInterface` | The interfaces to work with LightDataInterface | `Common.Logging`

`LightDataInterface.Core` | The core classes that help with setup and provide reusable runtime implementation for DAL providers | `LightDataInterface`

`LightDataInterface.EntityFramework` | Provider for Entity Framework | `LightDataInterface.Core` `EntityFramework`

`LightDataInterface.Extra.WebApi` | Adds integration goodies for WebApi | `LightDataInterface.Core` `Microsoft.AspNet.WebApi.Core`

## License

[Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0)