Українська
Контрольна точка
Що має працювати
powershell
dotnet buildpowershell
dotnet format Chatex.slnx --verify-no-changespowershell
dotnet test --solution Chatex.slnxpowershell
git diff --no-index Source/Chatex.Core/Common D:\Work\Chatex-Reference\Source\Chatex.Core\CommonВ еталонній папці є ще три файли, які з’являться в темі 9 (AvatarStore.cs, FileUpload.cs, LimitedReadStream.cs); шість файлів цієї теми не повинні відрізнятися.
Закомітьте:
powershell
git add .powershell
git commit -m "Add the foundations of the business layer: results, errors, validation and cursors"Типові помилки
Таблиця 7.1. Типові помилки в основах
| Симптом | Причина | Виправлення |
|---|---|---|
CS0029: Cannot implicitly convert type 'Error' to 'Result<…>' | відсутній неявний оператор або в нього хибний тип | перевірте обидва: implicit operator Result<T>(T value) і implicit operator Result<T>(Error error) |
CS8602: Dereference of a possibly null reference після if (!result.IsSuccess) | [MemberNotNullWhen(false, nameof(Error))] відсутній на IsSuccess | додайте атрибут (простір імен System.Diagnostics.CodeAnalysis) |
попередження CA1000 або CA1716 ламають збірку | правила не вимкнено в .editorconfig | порівняйте .editorconfig з еталоном (тема 2) |
у подробицях перевірки є UserName замість userName | до назви властивості не застосовано CamelCase | залиште GroupBy(e => CamelCase(e.PropertyName)) |
TryDecode неоднозначний | в аргумента out немає типу | напишіть out Guid? id або out ChatListCursor? cursor |
Питання для самоперевірки
- Які збої Chatex повертає як результати, а які кидає? Чому така різниця?
- З яких трьох частин складається
Errorі хто читає кожну з них? - Чому
Result<T>– цеreadonly structіз закритими конструкторами? - Як неявні перетворення роблять сервіси коротшими? Наведіть приклад.
- Що
[MemberNotNullWhen(false, nameof(Error))]повідомляє компілятору? - Чому читання
Valueневдалого результату кидає виняток, а не повертаєdefault? - Що FluentValidation дає порівняно з операторами
ifна початку методу? - Чому назви полів у подробицях перевірки записують у camelCase?
- Чому курсори, які отримують клієнти, непрозорі? Що буде з підробленим курсором?
- Чому
CursorCodecзаписує байтиGuidу порядку big-endian? - Чому
AddCoreвикликаєAddData, а не лишає API викликати обидва?
Вправи
- Результат для операцій без значення. Додайте до
results.csметодResult Deposit(decimal amount), який завершується помилкою для недодатних сум і повертаєResult.Successв іншому разі. Виведіть підсумок черезMatch. - Перевіряльник. У «пісочниці» підключіть пакет FluentValidation (
#:package [email protected]) і напишітьAbstractValidator<TransferCommand>для записуTransferCommand(string FromIban, string ToIban, decimal Amount): обидва IBAN непорожні й різні, сума від 0,01 до 10 000. Виведіть помилки недійсної команди, згруповані за властивостями. - Розміри курсорів. Якою довжини текст Base64Url курсора повідомлення (16 байтів) і курсора списку чатів (24 байти)? Обчисліть, а потім перевірте через
Convert.ToBase64Stringу «пісочниці».