Към съдържанието
Съдържание на курса

Урок 20 — Прието, отхвърлено или неизвестно

От · съосновател и Chief Executive Officer на Hábil ·

Какво ще постигнеш: рутерът да класифицира всеки отговор на дестинацията според това, което тя наистина е казала: „да“, „не“ или нищо ясно. Едно „не“ да не се повтаря, а това, което е останало без отговор, след изчерпване на повторните опити да остане отбелязано, за да го прегледа човек, никога като провал.

Преди да започнеш, ти трябват: завършен урок 19 и включена средата от урок 00. Този урок използва API 1.5.0, който има три тестови режима: rechaza, lento и satura. Ако твоят API е отпреди, пресъздай го веднъж:

docker compose -f infra/compose.yaml up -d --wait --build --force-recreate api-pedidos

Новото днес, в едно изречение

В урок 19 рутерът се научи да опитва отново, когато дестинацията не отговаря. Но „не отговори“ е само един от възможните отговори. Има дестинации, които отговарят „не“ съвсем ясно, и има извиквания, които прекъсват по средата, без да знаем дали дестинацията е успяла да запише. Днес рутерът се учи да ги различава по доказателствата, а не по това, което е очаквал.

Картината: пратил си препоръчано писмо. Ако ти върнат подписаната обратна разписка, пристигнало е. Ако ти го върнат с печат „адресът не съществува“, не е пристигнало и няма смисъл да го пращаш пак на същия адрес. Но ако минат три седмици и не получиш нищо, не знаеш: може да се е загубило, а може да е пристигнало и разписката да се е загубила на връщане. Правилното не е да кажеш „загуби се“; а да кажеш „не знам“ и да попиташ в пощата.


1. Подготви папката си

cd lecciones/20-aceptado-rechazado-o-no-se-sabe
cp -R inicio mio

Днес работиш в два файла на рутера, които вече познаваш:

Файл Маршрут Какво променяш
reparto.camel.yaml intentar, този, който вика канала и записва как е минало choice-а, който решава резултата (TODO 1 и 2)
reintentos.camel.yaml onException от урок 19 Какво става, когато повторните опити се изчерпят (TODO 3)

И една част, която вече е направена: каналът int-rest слага на API-то таймаут от 3 секунди. Ако API-то не отговори в това време, int-rest не си измисля нито „да“, нито „не“: отговаря на рутера с 504, което в HTTP означава „този, който беше отзад, не отговори навреме“.

И още една, също готова: ако дестинацията каже колко да се чака, чака се толкова. Един 429 обикновено носи хедъра Retry-After: 3, „върни се след 3 секунди“. Рутерът го подава като пауза за следващия си повторен опит, с ограничение от 10 секунди, за да не може една дестинация да го спре за час. А HTTP клиентът на Camel, който сам би повторил един 429, без да остави следа, е изключен (automaticRetriesDisabled): единственият, който опитва отново, е рутерът и всеки опит остава в базата.

2. Предвиди

Отговори на лист хартия:

  1. API-то се забави 10 секунди, а каналът прекъсна на 3. Записало ли е поръчката, или не? Как би разбрал?
  2. API-то отговори 422 „отхвърлено по бизнес причина“. Ако рутерът го опита пет пъти, какво ще отговори петият път? А ако беше отговорило 429 „прати ми твърде много, върни се след 3 секунди“?
  3. Изчерпаха се петте повторни опита на извикване, което така и не получи отговор. „Провали“ ли се поръчката? Какво трябва да направи някой с нея?

Виж какво е положението днес:

./verifica inicio

Първият тест минава: с API-то в режим rechaza 4001 остава rechazada с един-единствен опит. Но вторият, с API-то в режим lento, излиза зле: 4002 остава rechazada, а последната отметка показва, че API-то все пак я има, в CREADO. Рутерът записа „дестинацията каза не“, когато дестинацията не каза нищо, а освен това записа поръчката. Ако някой се довери на този ред и я прати отново на ръка или я сметне за загубена, греши и в двата случая.

Третият също излиза зле: с API-то в режим satura 4003 получава 429 и остава rechazada още при първия опит. API-то я няма, но би я приело три секунди по-късно. Тази поръчка остава неизпратена.

3. Решавай по доказателствата

Отвори mio/orden-router/reparto.camel.yaml и намери маршрута intentar. Почти в края, след извикването на канала, има choice, който днес казва: 2xx е aceptada; всичко останало — rechazada. Над него са TODO 1 и 2.

Това е таблицата, която той трябва да спазва:

Какво е видяно ${variable.codigo} Резултат Опитва ли се отново?
Дестинацията каза „да“ от 200 до 299 aceptada Не е нужно
Сега не, опитай по-късно 408, 425, 429 no_se_sabe Да; ако носи Retry-After, с това изчакване (ограничение 10 s)
Дестинацията каза „не“ Останалите от 400 до 499 rechazada Не: ще каже същото
Нищо ясно: 5xx, 504 или без отговор от 500 до 599 или 0 no_se_sabe Да, с политиката от урок 19
TODO Какво пишеш За какво
1 Още два when, в този ред: един с ${variable.codigo} in '408,425,429', който слага desenlace на no_se_sabe, и след него един с ${variable.codigo} range '400..499', който го слага на rechazada Едно „сега не“ да се опитва отново, а едно „не“ да се записва като „не“
2 otherwise да слага no_se_sabe вместо rechazada Това, което не е нито „да“, нито „не“, да се записва като „неизвестно“

Защо в този ред? choice остава с първия when, който е изпълнен, а 429 също е между 400 и 499. Ако range беше първи, 429 никога нямаше да стигне до своя when.

Обърни внимание как това се връзва с урок 19. В края на intentar има filter: ако резултатът е останал no_se_sabe, хвърля IOException и точно това изключение улавя твоят onException, за да опита отново. Резултатът, който записваш днес, е този, който решава дали се опитва отново. Един rechazada не хвърля нищо, така че не се повтаря.

Сега отвори mio/orden-router/reintentos.camel.yaml. Вътре в onException, преди log, е TODO 3:

TODO Какво пишеш За какво
3 Един to със sql:UPDATE operacion SET estado = 'conciliacion_pendiente' WHERE id = :#${variable.operacion}, с dataSource: "#estado" Изчерпаното да остане отбелязано, за да го прегледа някой

Последният опит остава в no_se_sabe, защото точно това се е случило при този опит. Променя се операцията: тя вече не чака повторен опит, а чака човек.

4. Счупи едно нарочно

С всичко завършено промени своя TODO 1 така, че един 4xx също да е no_se_sabe, сякаш всичко, което не е 2xx, си струва да се повтори. Пусни ./verifica.

Преди това предвиди: API-то е в режим rechaza и всеки път отговаря с 422. Колко опита ще направи рутерът?

Шест: първият и пет повторни, и шестте получават 422. Излиза в червено отметката за бизнес отхвърлянето. Да повтаряш едно „не“ не го превръща в „да“: само удря шест пъти API-то, спира опашката за около трийсет секунди (урок 19) и накрая оставя операцията в conciliacion_pendiente, като праща човек да преглежда нещо, на което дестинацията вече беше отговорила ясно. Върни rechazada.

5. Провери

./verifica

verifica слага API-то в режим rechaza и праща 4001; после го слага в режим lento (отговаря след 10 секунди) и праща 4002; накрая, в режим satura (два пъти 429 с Retry-After: 3 и после обслужва), праща 4003. При излизане го връща в нормален режим. Урокът е завършен, когато видиш деветте зелени отметки:

✅ Arrancaron el router, los tres canales y el sondeo
✅ Rechazo de negocio: la 4001 quedó rechazada con un solo intento (422): un «no» no se repite
✅ Mientras la llamada va en camino, su intento ya está en la base (con huella y sin desenlace): se escribe antes de enviar
✅ No se sabe: la 4002 se intentó 6 veces, las 6 sin respuesta a tiempo (504, no_se_sabe), y quedó en conciliacion_pendiente
✅ Y la API sí tiene la 4002 (CREADO): por eso no era un fallo ni un rechazo, era «no se sabe»
✅ Ahora no: la 4003 recibió dos 429 (no_se_sabe), se reintentó y quedó aceptada al tercer intento (201): un 429 no es un «no»
✅ Y respetó el Retry-After: entre una llamada y la siguiente pasaron 3.05 3.04 s, ninguna antes de los 3 s que pidió la API
✅ La API tiene la 4003 (CREADO): los 429 no la registraron, el reintento sí
✅ Los otros canales siguieron: ERP y socio aceptaron las dos órdenes

Виж третата. Скриптът verifica наднича в базата, докато извикването още пътува, и намира опита вече записан, с неговия отпечатък и без резултат. Тази част не си я писал днес: съществува от урок 15. Но днес се вижда за какво служи: ако рутерът паднеше в този миг, базата щеше да каже „това е опитано и не знам как е минало“. Ако опитът се записваше след извикването, нямаше да остане нищо.

И виж тази за изчакванията: секундите идват от лога на API-то — часа, в който е пристигнало всяко извикване. Твоите ще са малко по-различни; иска се нито едно да не е под 3.

Не тръгва? ./verifica solucion тества нашето решение, а diff -r mio/orden-router solucion/orden-router ти казва по какво се различават.

Какво виждаш Какво правиш
esperaba rechazada, 1 intento y 422, а има 6 опита Един 4xx се взема за no_se_sabe: провери range '400..499'
esperaba conciliacion_pendiente con 6 intentos, а казва rechazada otherwise продължава да слага rechazada: трябва да е no_se_sabe (TODO 2)
Ahora no: esperaba aceptada con 3 intentos…, а има rechazada с един опит 429 е взет за „не“: when за 408,425,429 стои преди range '400..499' (TODO 1)
Retry-After: esperaba dos esperas de al menos 3 s… Нещо опитва отново, без да чака: провери дали не си пипал CamelRedeliveryDelay в intentar или onException
esperaba conciliacion_pendiente, а казва no_se_sabe Липсва UPDATE от TODO 3 или не носи dataSource: "#estado"
No pude poner la API en modo rechaza или en modo satura Твоят API е отпреди 1.5.0: пресъздай го, както казва „Преди да започнеш“
El puerto 8080 está ocupado Услугите от друго пускане са останали вдигнати: DONDE=mio docker compose -f compose.yaml down

Какво учи това извън курса

„Неизвестно“ е резултат, а не повреда на програмата. Във всяка система, която говори по мрежа, има извиквания, които прекъсват по средата. Дестинацията може да е записала, а може и да не е. Да го наречеш „провал“ води до две грешки: да го пратиш отново на ръка (и да дублираш, ако няма идемпотентност) или да го сметнеш за загубено (когато всъщност е пристигнало). Във verifica го видя: API-то регистрира 4002 десет секунди след като каналът прекъсна.

Един 4xx и един 5xx не се третират еднакво. 4xx е дестинацията, която казва „това, което ми прати, е грешно или не го приемам“. 5xx е дестинацията, която казва „нещо се случи с мен“. Първото не се променя, ако го повториш; второто понякога — да. Но не всеки 4xx е „не“: един 408 (забави се с изпращането), един 425 (твърде рано е) или един 429 (твърде бързо караш) казват „сега не, опитай по-късно“. Затова тук се опитват отново, а ако носят Retry-After, се чака колкото искат. С реална дестинация всеки код се класифицира според това, което казва договорът ѝ; тази таблица е на API-то от курса.

Опитът се записва преди изпращането. Това е единственият начин след срив да може да се намери това, което е останало във въздуха. Банките правят същото с един превод: първо го записват като „в процес“, а после го пращат.

Съгласуването означава да отидеш и да видиш дестинацията. Когато рутерът не може да знае, го отбелязва за някого, който може: този, който има достъп до API-то, до ERP или до партньора и проверява дали поръчката е останала там.

Упражнение: седем отговора

  1. Класифицирай тези седем отговора като aceptada, rechazada или no_se_sabe и напиши за всеки кое доказателство го решава:

    # Какво е върнал каналът
    a 201, API-то създаде поръчката
    b 200, API-то вече имаше тази поръчка със същия ключ (урок 02)
    c 422 llave-reusada: същият ключ с друго съдържание
    d 503, API-то е в профилактика
    e 504, каналът прекъсна на 3-тата секунда
    f Нищо: контейнерът на int-rest се рестартира по средата (код 0)
    g 429 с Retry-After: 3: API-то получи твърде много за кратко време
  2. В базата, след като пуснеш ./verifica, виж опитите на 4002: SELECT n, desenlace, respuesta->>'codigo' AS codigo FROM intento i JOIN operacion p ON p.id = i.operacion WHERE p.orden = '4002' AND p.canal = 'rest' ORDER BY n; А после попитай API-то: curl -s localhost:8081/pedidos/4002. Напиши в едно изречение какво би казал на човека, който трябва да съгласува тази операция.

  3. Ако опитът се записваше след извикването на канала и рутерът паднеше, докато извикването пътува, какво би останало в базата? Какво би станало с тази поръчка?


Защо е направено така

Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:

  • Три резултата, решени по доказателствата: прието, отхвърлено или неизвестно

Преговор

  1. Какви три резултата може да има един опит и кое доказателство решава всеки?
  2. Защо един 422 не се опитва отново, а един 429 или 504 — да? Защо when за 429 стои преди този за диапазона?
  3. Какво е conciliacion_pendiente и защо не се казва „провалена“?
  4. Защо каналът отговаря с 504, когато таймаутът му изтече, вместо с 500 или 422?
  5. Заключителният въпрос: опитът се записва преди изпращането. Използвай 4002, за да обясниш какво би се загубило, ако се записваше след това.

Следва: в урок 21 дестинацията е партньорът, а партньорът не отговаря в същото извикване. 850-ката остава на неговия SFTP, а потвърждението пристига по-късно, в друг файл. Да оставиш файла не значи да имаш потвърждение.

Да обсъдим вашия проект

Предпочитате имейл? Пишете ни на hola@habil.mx