Tactical DDD patterns in Go

Transcript

1. roblaszczak TACTICAL DDD PATTERNS IN GOLANG
2. roblaszczak 2
3. roblaszczak 3
4. roblaszczak 4
5. roblaszczak 5 Dlaczego to nie działa tak jak ustaliliśmy?
6. roblaszczak 6 Myśleliśmy, że wiecie że to tak będzie działać
7. roblaszczak 7 Czy ktoś w ogóle wie jak to działa?
8. roblaszczak 8 Poczekaj, sprawdzę w tym handlerze na 1k linii i w triggerach DB
9. roblaszczak 9
10. roblaszczak 10
11. roblaszczak 11 DOKŁADNE ODZWIERCIEDLENIE LOGIKI BIZNESOWEJ
12. roblaszczak 12 KOD KTÓRY MOŻNA POKAZAĆ EKSPERTOWI DOMENOWEMU
13. roblaszczak 13 BEZPIECZNE WPROWADZANIE ZNACZĄCYCH ZMIAN W LOGICE BIZNESOWEJ
14. roblaszczak 14 LEGENDARNY SAMODOKUMENTUJĄCY SIĘ KOD
15. roblaszczak 15 UPORZĄDKOWANIE NAZEWNICTWA
16. roblaszczak 16 WERYFIKACJA LOGIKI DOMENOWEJ PRZED ROZPOCZĘCIEM IMPLEMENTACJI
17. roblaszczak 17 EVENT STORMING
18. roblaszczak 18 HOT SPOTS
19. roblaszczak 19
20. roblaszczak 20 LITE DDD =
21. roblaszczak 21 ENTITY
22. roblaszczak 22 Nurse administers standard flu vaccine dose to adult patient.
23. roblaszczak 23 patient := patient.NewPatient() patient.SetShotType(vaccine.Flu) patient.SetDose(10) patient.SetNurse(nurse)
24. roblaszczak 24 patient := patient.NewPatient() patient.SetShotType(vaccine.Flu) patient.SetDose(10) patient.SetNurse(nurse)
25. roblaszczak 25 patient.GiveFluShot()
26. roblaszczak 26 patient.GiveFluShot()
27. roblaszczak 27 vaccine := vaccine.StandardAdultFluDose() nurse.AdministerFluVaccine( patient, vaccine, )
28. roblaszczak 28 Nurse administers standard flu vaccine dose to adult patient.
29. roblaszczak 29 vaccine := vaccine.StandardAdultFluDose() nurse.AdministerFluVaccine( patient, vaccine, )
30. roblaszczak 30
31. roblaszczak 31
32. roblaszczak 32 package backlog type ItemID struct{ id.ID } type Item struct { id ItemID name string // ... }
33. roblaszczak 33 package backlog type ItemID struct{ id.ID } type Item struct { id ItemID name string // ... }
34. roblaszczak 34 func NewItem(id ItemID, name string) (*Item, error) { if id.Empty() { return nil, ErrItemEmptyID } i := &Item{id: id} if err := i.SetName(name); err != nil { return nil, err } return i, nil }
35. roblaszczak 35 func NewItem(id ItemID, name string) (*Item, error) { if id.Empty() { return nil, ErrItemEmptyID } i := &Item{id: id} if err := i.SetName(name); err != nil { return nil, err } return i, nil }
36. roblaszczak 36 func (i *Item) SetName(name string) error { if name == "" { return ErrItemEmptyName } i.name = name return nil }
37. roblaszczak 37 func (i *Item) SetName(name string) error { if name == "" { return ErrItemEmptyName } i.name = name return nil }
38. roblaszczak 38 var ( ErrItemEmptyName = domain.NewIllegalStateError("name cannot be empty") )
39. roblaszczak 39 func (i *Item) setName(name string) error { if name == "" { return ErrItemEmptyName } i.name = name return nil }
40. roblaszczak 40
41. roblaszczak 41 { name: "scheduled_for_release", item: createTestScheduledForReleaseItem(t), wantErr: nil, },
42. roblaszczak 42
43. roblaszczak 43 { name: "scheduled_for_release", item: createTestScheduledForReleaseItem(t), wantErr: nil, },
44. roblaszczak 44 { name: "not_scheduled_for_release", item: createTestItem(t), wantErr: backlog.ErrMustBeScheduledToCommit, },
45. roblaszczak 45 { name: "already_commited_to_sprint", item: createTestCommitedToSprintItem(t), wantErr: nil, },
46. roblaszczak 46 for _, tt := range tests { t.Run(tt.name, func(t *testing.T) { s := createTestSprint(t) initialSprintID := tt.i.CommitedSprintID() initialStatus := tt.i.Status() err := tt.i.CommitToSprint(s) assert.Equal(t, tt.wantErr, err) // ... }) }
47. roblaszczak 47 if tt.wantErr == nil { assert.Equal(t, s.ID(), tt.i.CommitedSprintID()) assert.Equal( t, tt.i.Status(), backlog.ItemStatusCommited ) } else { assert.Equal(t,initialSprintID,tt.i.CommitedSprintID()) assert.Equal(t, tt.item.Status(), initialStatus) }
48. roblaszczak 48 if tt.wantErr == nil { assert.Equal(t, s.ID(), tt.i.CommitedSprintID()) assert.NotEqual(t, s.ID(), initialSprintID) assert.Equal( t, tt.i.Status(), backlog.ItemStatusCommited ) } else { assert.Equal(t,initialSprintID,tt.i.CommitedSprintID()) assert.Equal(t, tt.item.Status(), initialStatus) }
49. roblaszczak 49 if tt.wantErr == nil { assert.Equal(t, s.ID(), tt.i.CommitedSprintID()) assert.NotEqual(t, s.ID(), initialSprintID) assert.Equal( t, tt.i.Status(), backlog.ItemStatusCommited ) } else { assert.Equal(t,initialSprintID,tt.i.CommitedSprintID()) assert.Equal(t, tt.item.Status(), initialStatus) }
50. roblaszczak 50 if tt.wantErr == nil { assert.Equal(t, s.ID(), tt.i.CommitedSprintID()) assert.NotEqual(t, s.ID(), initialSprintID) assert.Equal( t, tt.i.Status(), backlog.ItemStatusCommited ) } else { assert.Equal(t,initialSprintID,tt.i.CommitedSprintID()) assert.Equal(t, tt.item.Status(), initialStatus) }
51. roblaszczak 51 func (i *Item) CommitToSprint(s *sprint.Sprint) error { if !i.IsScheduledForRelease() { return ErrMustBeScheduledToCommit } if i.IsCommittedToSprint() { i.UncommitFromSprint() } i.setStatus(ItemStatusCommited) i.setSprintID(s.ID()) return nil }
52. roblaszczak 52 func (i *Item) CommitToSprint(s *sprint.Sprint) error { if !i.IsScheduledForRelease() { return ErrMustBeScheduledToCommit } if i.IsCommittedToSprint() { i.UncommitFromSprint() } i.setStatus(ItemStatusCommited) i.setSprintID(s.ID()) return nil }
53. roblaszczak 53 func (i *Item) CommitToSprint(s *sprint.Sprint) error { if !i.IsScheduledForRelease() { return ErrMustBeScheduledToCommit } if i.IsCommittedToSprint() { i.UncommitFromSprint() } i.setStatus(ItemStatusCommited) i.setSprintID(s.ID()) return nil }
54. roblaszczak 54 func (i *Item) CommitToSprint(s *sprint.Sprint) error { if !i.IsScheduledForRelease() { return ErrMustBeScheduledToCommit } if i.IsCommittedToSprint() { i.UncommitFromSprint() } i.setStatus(ItemStatusCommited) i.setSprintID(s.ID()) return nil }
55. roblaszczak 55
56. roblaszczak 56 func (i *Item) CommitToSprint(s *sprint.Sprint) error { if !i.IsScheduledForRelease() { return ErrMustBeScheduledToCommit } if i.IsCommittedToSprint() { i.UncommitFromSprint() } i.setStatus(ItemStatusCommited) i.setSprintID(s.ID()) return nil }
57. roblaszczak 57 func (i *Item) CommitToSprint(s *sprint.Sprint) error { if !i.IsScheduledForRelease() { return ErrMustBeScheduledToCommit } if i.IsCommittedToSprint() { i.UncommitFromSprint() } i.setStatus(ItemStatusCommited) i.setSprintID(s.ID()) return nil }
58. roblaszczak 58 VALUE OBJECT
59. roblaszczak 59 (RACZEJ) NIE POSIADA ID
60. roblaszczak 60 JEST IMMUTABLE
61. roblaszczak 61 CZĘSTO ŁĄCZY 2 WARTOŚCI KTÓRE ODDZIELNIE NIE MAJĄ SENSU
62. roblaszczak 62 type Price struct { cents int currency string }
63. roblaszczak 63 func NewPrice(cents int, currency string) (Price, error) { if cents <= 0 { return Price{}, ErrCentsTooLow } if len(currency) != 3 { return Price{}, ErrInvalidCurrency } return Price{cents, currency}, nil }
64. roblaszczak 64 func NewPrice(cents int, currency string) (Price, error) { if cents <= 0 { return Price{}, ErrCentsTooLow } if len(currency) != 3 { return Price{}, ErrInvalidCurrency } return Price{cents, currency}, nil }
65. roblaszczak 65 func NewPrice(cents int, currency string) (Price, error) { if cents <= 0 { return Price{}, ErrCentsTooLow } if len(currency) != 3 { return Price{}, ErrInvalidCurrency } return Price{cents, currency}, nil }
66. roblaszczak 66 Price{}
67. roblaszczak 67 func (p Price) Empty() bool { return p.cents == 0 || p.currency == "" }
68. roblaszczak 68 func (p Price) Add(toAdd Price) (Price, error) { if p.currency != toAdd.currency { return Price{}, ErrCurrencyDoesntMatch } return NewPrice(p.cents+toAdd.cents, p.currency) }
69. roblaszczak 69 REPOSITORY
70. roblaszczak 70
71. roblaszczak 71
72. roblaszczak 72 ODKŁADAMY DECYZJĘ O BAZIE DANYCH NA PÓŹNIEJ
73. roblaszczak 73 ODKŁADAMY DECYZJĘ O BAZIE DANYCH NA PÓŹNIEJ
74. roblaszczak 74 package backlog type ItemRepository interface { Add(*Item) error ByID(ItemID) (*Item, error) Update(*Item) error }
75. roblaszczak 75 package backlog // …. var ( ErrItemNotFound = errors.New("item not found") ErrItemAlreadyExists = errors.New("item already exists") )
76. roblaszczak 76 type BacklogItemRepository struct { items map[string]backlog.Item } func (r *BacklogItemRepository) Add(i *backlog.Item) error { if _, ok := r.items[i.ID().String()]; ok { return backlog.ErrItemAlreadyExists } r.items[i.ID().String()] = *i return nil }
77. roblaszczak 77 type BacklogItemRepository struct { items map[string]backlog.Item } func (r *BacklogItemRepository) Add(i *backlog.Item) error { if _, ok := r.items[i.ID().String()]; ok { return backlog.ErrItemAlreadyExists } r.items[i.ID().String()] = *i return nil }
78. roblaszczak 78 type BacklogItemRepository struct { items map[string]backlog.Item } func (r *BacklogItemRepository) Add(i *backlog.Item) error { if _, ok := r.items[i.ID().String()]; ok { return backlog.ErrItemAlreadyExists } r.items[i.ID().String()] = *i return nil }
79. roblaszczak 79 Jak tego teraz użyć?
80. roblaszczak 80 CQRS
81. roblaszczak 81
82. roblaszczak 82 type CommitBacklogItemToSprint struct { BacklogItemID backlog.ItemID SprintID sprint.ID }
83. roblaszczak 83 type CommitBacklogItemToSprintHandler struct { sprintRepository sprint.Repository backlogItemRepository backlog.ItemRepository }
84. roblaszczak 84 type CommitBacklogItemToSprintHandler struct { sprintRepository sprint.Repository backlogItemRepository backlog.ItemRepository }
85. roblaszczak 85 func (c CommitBacklogItemToSprintHandler) Handle(cmd CommitBacklogItemToSprint) error { sprint, err := c.sprintRepository.ByID(cmd.SprintID) if err != nil { return err } item, err := c.backlogItemRepository.ByID(cmd.BacklogItemID) if err != nil { return err } // ...
86. roblaszczak 86 func (c CommitBacklogItemToSprintHandler) Handle(cmd CommitBacklogItemToSprint) error { sprint, err := c.sprintRepository.ByID(cmd.SprintID) if err != nil { return err } item, err := c.backlogItemRepository.ByID(cmd.BacklogItemID) if err != nil { return err } // ...
87. roblaszczak 87 func (c CommitBacklogItemToSprintHandler) Handle(cmd CommitBacklogItemToSprint) error { // ... if err := item.CommitToSprint(sprint); err != nil { return err } return c.backlogItemRepository.Update(item) }
88. roblaszczak 88 func (c CommitBacklogItemToSprintHandler) Handle(cmd CommitBacklogItemToSprint) error { // … if item.IsCommitedToBacklog() { return err } // … return c.backlogItemRepository.Update(item) }
89. roblaszczak 89 func (c CommitBacklogItemToSprintHandler) Handle(cmd CommitBacklogItemToSprint) error { // … if item.IsCommitedToBacklog() { return err } // … return c.backlogItemRepository.Update(item) }
90. roblaszczak 90 DOBRE MIEJSCE NA CROSS-CUTTING CONCERNS
91. roblaszczak 91 Gdzie to teraz upchnąć?
92. roblaszczak 92 Jeden package == tracimy enkapsulację
93. roblaszczak 93 . ├── app │ └── command ├── domain │ ├── backlog │ └── sprint ├── infrastructure │ └── memory └── interfaces └── rest
94. roblaszczak 94
95. roblaszczak 95 github.com/roblaszczak/go-cleanarch
96. roblaszczak 96 github.com/roblaszczak/go-cleanarch (wszystkie linki podam pod koniec prezentacji)
97. roblaszczak 97
98. roblaszczak 98 type Item struct { id ItemID `json:"id"` name string `json:"name"` status ItemStatus `json:"status"` releaseSchedule time.Time `json:"release_schedule"` commitedSprintID sprint.ID `json:"commited_sprint_id"` }
99. roblaszczak 99 Zmiana widoku wymaga zmiany w domenie
100. roblaszczak 100 Atrybuty są prywatne więc się nie zmarshalują :)
101. roblaszczak 101 type BacklogItemView struct { ID string `json:"id"` Name string `json:"name"` } func NewBacklogItemView(item *backlog.Item) BacklogItemView { return BacklogItemView{item.ID().String(), item.Name()} }
102. roblaszczak 102 PERSYSTENTNE REPOZYTORIUM
103. roblaszczak 103
104. roblaszczak 104 Jak unmarshalować obiekt domenowy bez zbytniej ingerencji?
105. roblaszczak 105 type ItemUnmarshalData struct { ID ItemID Name string Status ItemStatus ReleaseSchedule time.Time CommitedSprintID sprint.ID } func UnmarshalItem(ud ItemUnmarshalData) *Item { return &Item{ ud.ID, ud.Name, ud.Status, ud.ReleaseSchedule, ud.CommitedSprintID, } }
106. roblaszczak 106 type ItemUnmarshalData struct { ID ItemID Name string Status ItemStatus ReleaseSchedule time.Time CommitedSprintID sprint.ID } func UnmarshalItem(ud ItemUnmarshalData) *Item { return &Item{ ud.ID, ud.Name, ud.Status, ud.ReleaseSchedule, ud.CommitedSprintID, } }
107. roblaszczak 107 SILVER BULLET NIE ISTNIEJE DDD TEGO NIE ZMIENI
108. roblaszczak 108 CRUD
109. roblaszczak Pragmatic Hype-driven development Kraków 109
110. roblaszczak Pragmatic Hype-driven development Kraków 2018/11/26-27 110 Będę miał do rozdania 2 wejściówki
111. roblaszczak 111 LITE DDD =
112. roblaszczak 112 What next?
113. roblaszczak 113 Wrzucę linki na Twitterze roblaszczak
114. roblaszczak 114
115. roblaszczak 115
116. roblaszczak 116
117. roblaszczak 117 https://threedots.tech/
118. roblaszczak 118
119. roblaszczak 119 SpeakerRate: http://spkr8.com/t/76351 Do wygrania 2 wejściówki na CoreDump!
120. roblaszczak DZIĘKI! 120 http://spkr8.com/t/76351 roblaszczak