xMolecules

Living architecture documentation

Transcript

1. Starring Directed By Presented by With
4. https://hschwentner.io
5. @hschwentner
6. ! " # $
7. @hschwentner
8. BankAccount withdraw() deposit() Amount
9. BankAccount withdraw() deposit() Amount
10. @hschwentner Domain-Driven Design Eric Evans
11. @hschwentner Entity vs. Value - Identity - Life cycle - Can be mutable - No identity - Always immutable Contract Map Name Length 12.5 m “John Miller”
12. Entity Value Object Aggregate Service Factory Repository Tactical Design
13. «Entity» BankAccount withdraw() deposit() «Value Object» Amount
14. «stereotype» Value Object «stereotype» Entity ??? «stereotype» Identity
15. xMolecules
17. Hexagonal Architecture Layerered Architecture Onion Architecture Clean Architecture
18. @hschwentner How To Express Architecture?
19. class Account { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
20. class AccountEntity { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
21. class Account extends Entity { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
22. class Account extends Entity<IBAN> { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
23. import org.jmolecules.ddd.types.Entity; class Account extends Entity<IBAN> { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
24. @Entity class Account { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
25. import org.jmolecules.ddd.annotation.Entity; @Entity class Account { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
26. @hschwentner How To Express Architecture?
27. class Account { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
28. class AccountEntity { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
29. class Account : Entity { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
30. class Account : Entity<IBAN> { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
31. using NMolecules.DDD; class Account : Entity<IBAN> { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
32. [Entity] class Account { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
33. using NMolecules.DDD; [Entity] class Account { public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
34. [Entity] class Account { [Identity] public IBAN IBAN { get; } public void deposit(Amount amount) //... public void withdraw(Amount amount) //... }
35. @hschwentner How To Express Architecture?
36. class Account { public function deposit(Amount $amount) //... public function withdraw(Amount $amount) //... }
37. class AccountEntity { public function deposit(Amount $amount) //... public function withdraw(Amount $amount) //... }
38. class Account extends Entity { public function deposit(Amount $amount) //... public function withdraw(Amount $amount) //... }
39. /** * @extends Entity<IBAN> */ class Account extends Entity { public function deposit(Amount $amount) //... public function withdraw(Amount $amount) //... }
40. use PHPMolecules\DDD\Type\Entity; class Account extends Entity { public function deposit(Amount $amount) //... public function withdraw(Amount $amount) //... }
41. #[Entity] class Account { public function deposit(Amount $amount) //... public function withdraw(Amount $amount) //... }
42. use PHPMolecules\DDD\Annotation\Entity; #[Entity] class Account { public function deposit(Amount $amount) //... public function withdraw(Amount $amount) //... }
43. @hschwentner Why Express Architecture?
44. Documentation Verification Boilerplate Reduction
45. @hschwentner Documentation
46. @hschwentner ! " «Entity» XXX «Value Object» YYY ??
48. @hschwentner Verification
49. @hschwentner value Architecture Rules entity allowed forbidden
51. @AnalyzeClasses(packagesOf = ArchitectureTests.class) class ArchitectureTests { @ArchTest ArchRule ddd = JMoleculesDddRules.all(); }
53. PHPStan Psalm Phan PHPArkitect PHPArch
54. @hschwentner Boilerplate Reduction
55. @javax.persistence.Entity class BankAccount { /*...*/ } @javax.persistence.???.Embeddable class Amount { /*...*/ }
56. @hschwentner jmolecules-bytebuddy jmolecules-jpa jmolecules-spring jmolecules-jackson jmolecules-intellij
57. @hschwentner Boilerplate Reduction
58. ???
59. @hschwentner nmolecules-ef nmolecules-roslyn nmolecules-rider
60. @hschwentner Boilerplate Reduction
61. /** * @ORM\Entity * @ORM\Table(name="bank_accounts") */ class BankAccount { /** * @ORM\Id * @ORM\GeneratedValue * @ORM\Column(type="integer") */ private IBAN iban; /*...*/ }
62. @hschwentner phpmolecules-doctrine phpmolecules-symphony phpmolecules-serializer phpmolecules-phpstorm
63. @hschwentner Installation
64. <dependency> <groupId>org.jmolecules</groupId> <artifactId>jmolecules-ddd</artifactId> <version>1.4.0</version> </dependency>
65. @hschwentner Installation
66. > dotnet add package NMolecules.DDD
67. // Install NMolecules.DDD as a Cake Addin #addin nuget:?package=NMolecules.DDD&version=0.2.1 // Install NMolecules.DDD as a Cake Tool #tool nuget:?package=NMolecules.DDD&version=0.2.1
68. @hschwentner Installation
69. $ composer require --dev xmolecules/phpmolecules
70. @hschwentner LeasingNinja.io
72. Bibliography Evans, Eric. Domain-Driven Design: Tackling Complexity in the Heart of Software. Boston: Addison-Wesley, 2004. Hofer, Stefan and Henning Schwentner. Domain Storytelling: a Collaborative, Visual, and Agile Way to Develop Domain-Driven Software. Boston: Addison-Wesley, 2022.
74. Henning Schwentner ⌂ https://hschwentner.io @hschwentner hs@wps.de