Англійська для розробників Go Fiber

API Fiber, натхнений Express, робить його доступним, але його основне використання fasthttp замість стандарту Go net/http вводить словник і хитрощі, які команда потребує спільної мови для - особливо навколо контекстних життєвих циклів і поведінки нульового розподілу. Цей підручник містить інформацію про англійську мову, яку використовують під час обговорення коду Fiber з командою.

Ключовий словник

** Fiber context ( fiber.Ctx ) ** — об’ єкт з обсягом запиту, переданий кожному обробнику, що надає доступ до запиту, відповіді, параметрів і методів допоміжних, побудованих на основі контексту fasthttp. “Не зберігати контекст Fiber ніде за межами обробника — fasthttp використовує його знову і скидає після надсилання відповіді, отже посилання, яке зберігається після цієї точки, небезпечно.”

** Ланцюг середнього програмного забезпечення ** — упорядкована послідовність функцій обробника, які запит проходить перед досягненням фінального обробника маршруту, кожен з яких може змінити запит, коротке замикання або виклик Next().

• “Пересунути середнє програмне забезпечення автентифікації перед середнім програмним забезпеченням журналювання у ланцюзі — зараз ми записуємо у журнал запити, які відкидаються, навіть не дізнавшись, хто їх зробив.” *

** Нульова виплата / нульова копія ** — метою розробки Fiber є уникнення небажаного виплати пам’ яті за допомогою повторного використання буферів з fasthttp, що є швидким, але означає, що деякі значення небезпечно зберігати після запитів. *“Цей рядок є переглядом з нульовою копією у буфері запиту — якщо вам потрібно зберегти його після повернення обробника, викликайте копію явно, замість зберігання посилання.” *

** Групування маршрутів ** — організація пов’ язаних маршрутів під спільним префіксом шляху і стеком середовища за допомогою app.Group(), зберігаючи версії або маршрути з обсягом ресурсів разом. “Покладемо всі маршрути /api/v1 під одну групу, щоб версії і аутентифікація середовища були оголошені в одному місці, а не повторювалися на маршруті.”

** Locals ** — зберігання ключів і значень за запитом у контексті Fiber, яке використовується для передачі даних (наприклад, розпізнаного користувача) з проміжного програмного забезпечення до обробників нижнього рівня. “Встановити обробленого користувача на c.Locals("user") у середовищі аутентифікації, а потім прочитати його назад у обробнику замість повторного оброблення токена двічі.”

** Fasthttp ** — побудований на високопродуктивному рушії HTTP Fiber, який обмінює певну сумісність net/http на швидкість за допомогою повторного використання об’ єктів у запитах. “Це стороннє середовище приймає стандарт net/http, тому воно не буде працювати безпосередньо з контекстом Fiber, заснованим на fasthttp, без адаптера.”

Звичайні фрази

• Чи це середнє програмне забезпечення впорядковане правильно, або auth працює після реєстрації?»
• «Це значення є нульовою копією — чи потрібно нам дублювати його перед зберіганням поза обробником?»
• Чи можемо ми групувати ці маршрути під одним префіксом замість повторення середовища на кожному з них?»
• Що ми тут поставили на місцевих, і чи читається це вниз по течії?»
• Чи очікує це середнє середовище сторонньої сторони net/http, або це Fiber-нативно?»

Приклади висловлювань

Перегляд запиту на звантаження: “Ця обробка зберігає рядок, що витягнуто безпосередньо з контексту Fiber, у структуру, яка переживається запитом — оскільки fasthttp повторно використовує цей буфер, нам потрібно скопіювати рядок явно.”

Пояснення рішення про проектування: “Ми згрупували всі адміністративні маршрути під /admin з одним середовищем перевірки ролей, тому додавання нової адміністративної кінцевої точки не вимагає повторного декларування логіки авторизації.”

Опис вади:

• “Вада з’ явилася лише під час завантаження, оскільки контекст зберігався після закінчення терміну служби обробника, а fasthttp вже скинув його для наступного запиту.” *

Професійні поради

• Використовуйте « zero- copy », якщо значення є безпечним лише у межах поточного запиту — це стандартна фраза попередження у перегляді коду Fiber.
• Під час перегляду середовища, запитайте “де це сидить в ланцюзі?” — помилки в порядку є поширеними і англійські рецензенти формулюють їх у термінах “запускається до” або “запускається після”
• Розрізняти “Fiber context” від загального Go context.Context — вони служать різним цілям і їх об’єднання плутає новачків.
• Використовуйте “locals” замість “session” або “state” коли мова йде про запит на ключ-значення Fiber - ці інші терміни означають тривалість за запитом.

Практичні вправи

1. Поясніть у двох реченнях, чому зберігання значення контексту Fiber поза його обробником небезпечно.
2. Написати коментар перегляду коду у одному реченні щодо неправильного порядку послідовності проміжних програм.
3. Опишете, вашими словами, для чого c.Locals() і як він відрізняється від сеансу бази даних.

Розрізняють: лінійне і лінійне-контекстуальне

Як розробники Go Fiber, ви вже знайомі з основними концепціями - маршрутами, обробниками, середнім програмним забезпеченням і потужним пакунком context. Однак, ефективне спілкування в команді розробників сильно залежить від точного словникового запасу і фразування. Для не-рідних носіїв англійської мови це може бути особливо складним. Це не просто про те, щоб знати * що * щось є; це розуміння * як * обговорювати це конструктивно, особливо в сценаріях, що часто трапляються під час перегляду коду або спільної розробки. Давайте розглянемо деякі тонкощі, які часто ігноруються, зосередившись на передачі намірів і впливу, а не просто на перекладі термінів.

Одна з часто зустрічається проблемних областей виникає при обговоренні проблем продуктивності. Простого «це повільно» недостатньо. Більш професійний підхід буде таким: «Я помітив пік затримки у часі відповіді на запити, що обробляють автентифікацію користувача. В середньому 300 мс, що перевищує наш цільовий показник 150 мс. Чи можемо ми дослідити потенційні вузли у середовищі jwt і запиту на базу даних?» Ця фраза чітко визначає проблему (затримку), надає контекст (запити на автентифікацію користувача), кількісно її оцінює (300 мс проти 150 мс) і пропонує напрямок дослідження. Аналогічно, під час перегляду коду, замість того, щоб сказати «це погано», спробуйте «Цей підхід вводить потенційні проблеми одночасності через відсутність належного блокування навколо спільних ресурсів. Розгляньте можливість використання mutexu або каналу для синхронізації доступу. Ключова відмінність полягає у * обґрунтуванні * за зворотним зв’ язком — демонстрації розуміння основної проблеми і запропоновані рішення.

Інша поширена пастка - це надмірне використання неясних термінів, таких як “виправити” або “покращити”. Вони надзвичайно суб’єктивні. Краще стратегія полягає в тому, щоб описати * що * ви робите і * чому *. Наприклад, при написанні опису PR, заява «Я виправив помилку» є слабкою. Замість цього ви можете написати: « Я вирішив проблему неправильного форматування даних у відповіді, реалізувавши твердження про тип, щоб переконатися, що всі поля відповідають очікуваній схемі, запобігаючи потенційним помилкам під час виконання ». Такий рівень деталізації показує ваш процес мислення і надає змогу переглядачам швидко зрозуміти зміни і їх наслідки. Пам’ятайте, чітке спілкування будує довіру і сприяє співпраці.

Нарешті, не вагайтеся попросити про пояснення, якщо щось не зовсім зрозуміло - навіть досвідчені розробники іноді використовують жаргон, не усвідомлюючи, що це може бути заплутаним. Питання «Чи можете ви розібратися, що ви маєте на увазі під «оптимізацією цієї кінцевої точки»?» є цілком прийнятним. Це показує готовність навчатися і гарантує, що всі на одній сторінці.

package main

import (
	"fmt"
)

func greet(name string) {
	fmt.Printf("Hello, %s!  This is a simple Go Fiber example.\n", name)
}

func main() {
	greet("World")
}