We won't talk about Akeneo nor Sylius today, we will speak about the Bouchonnois Corp, a French corporation of hunters. At the cutting edge of the technology, the company owns many applications and one of them is used to manage their galinette farming. We will focus on a small part of this application to speak about the pattern repository.

1. WHATISTHEDIFFERENCEBETWEENWHATISTHEDIFFERENCEBETWEEN
AAGOODGOODANDAANDABADBADREPOSITORY?REPOSITORY?
1

2. HI,IAMHI,IAMARNAUD!ARNAUD!
2

3. BOUCHONNOISCORPBOUCHONNOISCORP
3

4. WHATISAWHATISAREPOSITORYREPOSITORY??
«A repository behaves like an collection of unique domain
object without taking care about the storage»
4

5. PUBLICPUBLICAPIAPI
namespace BouchonnoisCorpDomainWrite;
interface Repository
{
/**
* @throws LogicException
*/
public function add(Object $object): void;
/**
* @throws UnknownObject | LogicException
*/
public function get(Identifier $identifier): Object;
/**
* @throws LogicException
*/
public function remove(Identifier $identifier): void;
/**
* @throws LogicException
*/
public function nextIdentity(): Identifier;
}
5

6. LET'SMODELALET'SMODELAGALINETTEGALINETTE!!
Dédé, Business Expert @BouchonnoisCorp
6

7. namespace BouchonnoisCorpDomainWrite;
/**final*/ class Galinette
{
// constructor ...
public static function born(
Identifier $identifier,
Birthday $birthday,
Gender $gender
): Galinette {
return new self($identifier, $birthday, new Name(''), $gender);
}
public function name(Name $name): void
{
$this->name = $name;
}
public function goToHeaven(): void
{
$this->goToHeavenAt = new DateTimeImmutable('NOW');
}
}
7

8. THEBADTHEBADREPOSITORYREPOSITORY
8

9. namespace BouchonnoisCorpDomainWrite;
interface GalinetteRepository
{
public function find(int $id): Galinette;
public function findGalinetteArray(): array;
public function findGalinetteForARelease(): Galinette[];
public function findGalinetteIdentifierForAReleaseAsString(): string[];
public function findGalinetteNameByIdentifier(int $id): string;
public function getQueryBuilder(): QueryBuilder;
// etc ...
}
9

10. THESEARENOTTHESEARENOTREPOSITORIESREPOSITORIES!!
These are more SQL query repositories
10

11. THEGOODTHEGOODREPOSITORYREPOSITORY
11

12. LET'SLET'SDESIGNDESIGNIT!IT!
Gérard, CTO @BouchonnoisCorp
12

13. REPOSITORYREPOSITORYDEPENDENCIESDEPENDENCIES
namespace BouchonnoisCorpInfrastructureStorageDoctrine;
use BouchonnoisCorpDomainWriteGalinetteRepository;
final class GalinetteRepository implements GalinetteRepository
{
private $entityManager;
public function __construct(EntityManagerInterface $entityManager)
{
$this->entityManager = $entityManager;
}
// ...
}
13

14. GETTHEGETTHENEXTIDENTITYNEXTIDENTITY
namespace BouchonnoisCorpInfrastructureStorageDoctrine;
final class GalinetteRepository implements GalinetteRepository
{
// ...
public function nextIdentity(): Identifier
{
try {
return new Identifier(Uuid::uuid4()->toString());
} catch (Exception $e) {
throw new LogicException('It is not possible to build the next identity');
}
}
}
14

15. ADDADDAGALINETTEAGALINETTE
namespace BouchonnoisCorpInfrastructureStorageDoctrine;
final class GalinetteRepository implements GalinetteRepository
{
// ...
public function add(Galinette $galinette)
{
try {
$this->entityManager->persist($galinette);
$this->entityManager->flush($galinette);
} catch (ORMInvalidArgumentException | ORMException $e) {
throw new LogicException('It is not possible to add this galinette');
}
}
// ...
}
15

16. RETRIEVERETRIEVEAGALINETTEAGALINETTE
namespace BouchonnoisCorpInfrastructureStorageDoctrine;
final class GalinetteRepository implements GalinetteRepository
{
// ...
public function get(Identifier $identifier): Galinette
{
try {
$galinette = $this->entityManager->find(Galinette::class, $identifier);
} catch (ORMInvalidArgumentException | ORMException $e) {
throw new LogicException('It is not possible to retrieve this galinette');
} finally {
if (null === $galinette) {
throw new ExceptionUnknownGalinette(
(string) $identifier,
Galinette::class
);
}
return $galinette;
}
}
// ...
}
16

17. REMOVEREMOVEAGALINETTE?AGALINETTE?
namespace BouchonnoisCorpInfrastructureStorageDoctrine;
final class ObjectRepository
{
// ...
public function remove(Identifier $identifier)
{
try {
$galinette = $this->entityManager->getReference(
Object::class,
(string) $identifier
);
$this->entityManager->remove($galinette);
$this->entityManager->flush($galinette);
} catch (ORMInvalidArgumentException | ORMException $e) {
throw new LogicException('It is not possible to remove this object');
}
}
// ...
}
17

18. AREPOSITORYMAYHAVEEXTRAAREPOSITORYMAYHAVEEXTRA
FINDERFINDERANDANDCOUNTCOUNTMETHODSMETHODS
18

19. HOWTOMANAGEMYHOWTOMANAGEMYSQLQUERIESSQLQUERIES??
19

20. WHATISAWHATISAQUERYFUNCTIONQUERYFUNCTION??
«A query function is a class which represents a SQL query.»
20

21. namespace BouchonnoisCorpInfrastructureStorageDoctrineQuery;
final class ReleaseOfGalinettes
{
private $connection;
public function __construct(Connection $connection)
{
$this->connection = $connection;
}
public function findGalinettes(): array
{
$query = 'SELECT g.* FROM galinette
INNER JOIN g.censored_table_name ...'
$statement = $this->connection->query($query);
$galinettes = [];
while ($galinette = $statement->fetch()) {
$galinettes[] = new ReleasedGalinette(
$galinette['identifier'],
$galinette['name'],
$galinette['birthday']
);
}
return $galinettes;
}
}
21

22. namespace BouchonnoisCorpDomainRead;
final class ReleasedGalinette
{
private $identifier;
private $name;
private $birthday;
public function __construct(
string $identifier,
string $name,
string $birthday
) {
$this->identifier = $identifier;
$this->name = $name;
$this->birthday = $birthday;
}
public function normalize(): array
{
return [
'id' => $this->identifier,
'name' => $this->name,
'birthday' => $this->birthday,
];
}
}
22

23. TOCONCLUDE!TOCONCLUDE!
23

24. CODECODEANDANDSLIDESSLIDESAREAVAILABLEONAREAVAILABLEONGITLABGITLAB!!
https://gitlab.com/arnolanglade/bad-or-good-repository
24

25. THANKYOU!QUESTIONS?THANKYOU!QUESTIONS?
arnolanglade
https://joind.in/talk/afbbd
25