nilportugues/repository

Implementation of a base repository

3.1.0 2017-03-03 14:58 UTC

Requires

• php: >=7.0
• nilportugues/serializer: ^1.1

Requires (Dev)

• friendsofphp/php-cs-fixer: 1.9.*
• phpunit/phpunit: ~4.8

MIT

• Nil Portugués

• repository
• pagination
• ddd
• adapters
• hexagonal
• nil portugues
• nilportugues
• ports and adapters
• ports
• pageable

README

Generic implementation and definition of a Repository and its in-memory implementation.

Installation

Use Composer to install the package:

$ composer require nilportugues/repository

InMemory Implementation

A custom repository can be easily created by extending the InMemoryRepository class provided.

use NilPortugues\Foundation\Infrastructure\Model\Repository\InMemory\InMemoryRepository

class MyInMemoryRepository extends InMemoryRepository
{
    //... your custom implementation.
}

Implementation can be seen here.

The base InMemoryRepository implements the following interfaces:

• NilPortugues\Foundation\Domain\Model\Repository\Contracts\Repository
• NilPortugues\Foundation\Domain\Model\Repository\Contracts\PageRepository
• NilPortugues\Foundation\Domain\Model\Repository\Contracts\ReadRepository
• NilPortugues\Foundation\Domain\Model\Repository\Contracts\WriteRepository

InMemoryRepository Example

An example with a complete implementation can be found in the /example directory.

In the example:

• Colors are defined as a class implementing the Identity interface.
• A ColorRepository is implemented. Will throw exception if Color is not found.
• Examples on how to filter are provided in the example.php file.

Foundation Classes

Interaction with the repository requires the usage of the following classes or classes implementing interfaces.

• NilPortugues\Foundation\Domain\Model\Repository\Fields

  • public function __construct(array $fields = [])
  • public function add($field)
  • public function get()

• NilPortugues\Foundation\Domain\Model\Repository\Filter

  • public function filters()
  • public function must()
  • public function mustNot()
  • public function should()
  • public function clear()

• NilPortugues\Foundation\Domain\Model\Repository\BaseFilter

  • public function notStartsWith($filterName, $value)
  • public function notEndsWith($filterName, $value)
  • public function notEmpty($filterName)
  • public function empty($filterName)
  • public function notNull($filterName)
  • public function empty($filterName)
  • public function startsWith($filterName, $value)
  • public function endsWith($filterName, $value)
  • public function equal($filterName, $value)
  • public function notEqual($filterName, $value)
  • public function includeGroup($filterName, array $value)
  • public function notIncludeGroup($filterName, array $value)
  • public function range($filterName, $firstValue, $secondValue)
  • public function notRange($filterName, $firstValue, $secondValue)
  • public function notContain($filterName, $value)
  • public function contain($filterName, $value)
  • public function beGreaterThanOrEqual($filterName, $value)
  • public function beGreaterThan($filterName, $value)
  • public function beLessThanOrEqual($filterName, $value)
  • public function beLessThan($filterName, $value)
  • public function clear()
  • public function get()
  • public function hasEmpty($filterName) //alias of empty() for BC reasons.

• NilPortugues\Foundation\Domain\Model\Repository\Order

  • public function __construct($direction)
  • public function isDescending()
  • public function isAscending()
  • public function __toString()
  • public function equals($object)
  • public function direction()

• NilPortugues\Foundation\Domain\Model\Repository\Pageable

  • public function __construct($pageNumber, $pageSize, SortInterface $sort = null, FilterInterface $filter = null, FieldsInterface $fields = null)
  • public function offset()
  • public function pageNumber()
  • public function sortings()
  • public function next()
  • public function pageSize()
  • public function previousOrFirst()
  • public function hasPrevious()
  • public function first()
  • public function filters()
  • public function fields()

• NilPortugues\Foundation\Domain\Model\Repository\Page

  • public function __construct(array $elements, $totalElements, $pageNumber, $totalPages, SortInterface $sort = null, FilterInterface $filter = null, FieldsInterface $fields = null)
  • public function content()
  • public function hasPrevious()
  • public function isFirst()
  • public function isLast()
  • public function hasNext()
  • public function pageSize()
  • public function pageNumber()
  • public function totalPages()
  • public function nextPageable()
  • public function sortings()
  • public function filters()
  • public function fields()
  • public function previousPageable()
  • public function totalElements()
  • public function map(callable $converter)

• NilPortugues\Foundation\Domain\Model\Repository\Sort

  • public function __construct(array $properties = [], OrderInterface $order = null)
  • public function andSort(SortInterface $sort)
  • public function orders()
  • public function equals(SortInterface $sort)
  • public function orderFor($propertyName)
  • public function setOrderFor($propertyName, OrderInterface $order)
  • public function property($propertyName)

Interfaces

• NilPortugues\Foundation\Domain\Model\Repository\Contracts\Identity

  • public function id()
  • public function __toString()

• NilPortugues\Foundation\Domain\Model\Repository\Contracts\Repository

  • public function count(Filter $filter = null)
  • public function exists(Identity $id)

• NilPortugues\Foundation\Domain\Model\Repository\Contracts\PageRepository

  • public function findAll(Pageable $pageable = null)

• NilPortugues\Foundation\Domain\Model\Repository\Contracts\ReadRepository

  • public function find(Identity $id, Fields $fields = null)
  • public function findBy(Filter $filter = null, Sort $sort = null, Fields $fields = null)
  • public function findByDistinct(Fields $distinctFields, Filter $filter = null, Sort $sort = null, Fields $fields = null)

• NilPortugues\Foundation\Domain\Model\Repository\Contracts\WriteRepository

  • public function add($value)
  • public function addAll(array $values)
  • public function remove(Identity $id)
  • public function removeAll(Filter $filter = null)
  • public function transactional(callable $transaction)

Quality

To run the PHPUnit tests at the command line, go to the tests directory and issue phpunit.

This library attempts to comply with PSR-1, PSR-2, PSR-4.

If you notice compliance oversights, please send a patch via Pull Request.

Contribute

Contributions to the package are always welcome!

• Report any bugs or issues you find on the issue tracker.
• You can grab the source code at the package's Git repository.

Support

Get in touch with me using one of the following means:

• Emailing me at [e-mail]
• Opening an Issue

Authors

• Nil Portugués Calderó
• The Community Contributors

License

The code base is licensed under the MIT license.