nilportugues/repository

Implementation of a base repository

Repository

, _(*1)

Generic implementation and definition of a Repository and its in-memory implementation., _(*2)

Installation

Use Composer to install the package:, _(*3)

$ composer require nilportugues/repository

InMemory Implementation

A custom repository can be easily created by extending the InMemoryRepository class provided., _(*4)

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

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

Implementation can be seen here., _(*5)

The base InMemoryRepository implements the following interfaces:, _(*6)

• 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., _(*7)

In the example:, _(*8)

• 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., _(*9)

• NilPortugues\Foundation\Domain\Model\Repository\Fields, _(*10)

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

• NilPortugues\Foundation\Domain\Model\Repository\Filter, _(*11)

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

• NilPortugues\Foundation\Domain\Model\Repository\BaseFilter, _(*12)

  • 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, _(*13)

  • 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, _(*14)

  • 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, _(*15)

  • 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, _(*16)

  • 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, _(*17)

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

• NilPortugues\Foundation\Domain\Model\Repository\Contracts\Repository, _(*18)

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

• NilPortugues\Foundation\Domain\Model\Repository\Contracts\PageRepository, _(*19)

  • public function findAll(Pageable $pageable = null)

• NilPortugues\Foundation\Domain\Model\Repository\Contracts\ReadRepository, _(*20)

  • 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, _(*21)

  • 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., _(*22)

This library attempts to comply with PSR-1, PSR-2, PSR-4., _(*23)

If you notice compliance oversights, please send a patch via Pull Request., _(*24)

Contribute

Contributions to the package are always welcome!, _(*25)

• 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:, _(*26)

• Emailing me at contact@nilportugues.com
• Opening an Issue

Authors

• Nil Portugués Calderó
• The Community Contributors

License

The code base is licensed under the MIT license., _(*27)