173 lines
5.1 KiB
Text
173 lines
5.1 KiB
Text
http
|
||
Лекция 6
|
||
|
||
Фёдор Короткий
|
||
|
||
* Имеем из коробки
|
||
|
||
- HTTP клиент (HTTP/1.x, HTTP/2)
|
||
- HTTP сервер (с поддержкой TLS)
|
||
- Тестирование
|
||
|
||
* net/http
|
||
|
||
* net/http
|
||
|
||
Содержит в себе:
|
||
- HTTP клиент и сервер
|
||
- Константы статусов и методов HTTP
|
||
- Sentinel ошибки
|
||
- Вспомогательные функции для составления и разбора HTTP запросов
|
||
|
||
* HTTP клиент
|
||
|
||
* Делаем запрос
|
||
|
||
.play simpleget/simpleget.go
|
||
|
||
Доступные функции:
|
||
|
||
Get(url string) (*Response, error)
|
||
Post(url, contentType string, body io.Reader) (*Response, error)
|
||
Head(url string) (*Response, error)
|
||
PostForm(url string, form url.Values) (*Response, error)
|
||
|
||
* Делаем более лучший запрос
|
||
|
||
.play custompost/custompost.go /func/,/^}/
|
||
|
||
`http.DefaultClient` - базовый глобальный клиент с настройками по-умолчанию.
|
||
|
||
* http.Client
|
||
|
||
type Client struct {
|
||
// Определяет механизм выполнения каждого запроса
|
||
Transport RoundTripper
|
||
|
||
// Функция для кастомной проверки редиректов
|
||
// По-умолчанию - максимум 10 редиректов
|
||
CheckRedirect func(req *Request, via []*Request) error
|
||
|
||
// Хранилище кук
|
||
Jar CookieJar
|
||
|
||
// Таймаут любого запроса от клиента
|
||
// Считается все время от соединения до конца вычитывания тела
|
||
// 0 - без таймаута
|
||
Timeout time.Duration
|
||
}
|
||
|
||
* Тонкая настройка клиента
|
||
|
||
.code customclient/customclient.go /func main/,/^}/
|
||
|
||
* Keepalive
|
||
|
||
.play keepalive/naive/naive.go /func main/,/^}/
|
||
|
||
Как-то медленно
|
||
|
||
* Keepalive
|
||
|
||
.play keepalive/advanced/advanced.go /func main/,/^}/
|
||
|
||
Что-то лыжи не едут
|
||
|
||
* Keepalive
|
||
|
||
.play keepalive/correct/correct.go /func main/,/^}/
|
||
|
||
Вот теперь всё как надо!
|
||
|
||
* HTTP сервер
|
||
|
||
* Простой HTTP сервер
|
||
|
||
.code simpleserver/simpleserver.go /func RunServer/,/^}/
|
||
|
||
.code simpleserver/simpleserver.go /func RunTLSServer/,/^}/
|
||
|
||
* Простой HTTP сервер
|
||
|
||
`http.Handler` - интерфейс, описывающий функцию для обработки HTTP запроса.
|
||
|
||
type Handler interface {
|
||
ServeHTTP(ResponseWriter, *Request)
|
||
}
|
||
|
||
type ResponseWriter interface {
|
||
Header() Header
|
||
WriteStatus(int)
|
||
Write([]byte) (int, error)
|
||
}
|
||
|
||
* Роутинг
|
||
|
||
.code simpleserver/router.go /func RunServerWithRouting/,/OMIT/
|
||
|
||
* Что нужно знать
|
||
|
||
- Запуск сервера - блокирующая операция
|
||
- Каждый входящий HTTP запрос обрабатывается в отдельной горутине (следите за дескрипторами)
|
||
- Паника внутри одного хэндлера не приводит к остановке всего сервера
|
||
- Неотловленная паника закрывает HTTP соединение
|
||
- Хедеры ответа нельзя менять после вызова `ResponseWriter.WriteHeader` или `ResponseWriter.Write`
|
||
|
||
* Middleware
|
||
|
||
.code simpleserver/middleware.go /func RunServerWithMiddleware/,/^}/
|
||
|
||
* Middleware
|
||
|
||
.code simpleserver/middleware.go /func UnifiedErrorMiddleware/,/^}/
|
||
|
||
* Graceful shutdown
|
||
|
||
.play gracefulshutdown/gracefulshutdown.go /func run()/,/^}/
|
||
|
||
* Контекст в HTTP сервере
|
||
|
||
.code context/httpserver/httpserver.go /type ReqTimeContextKey/,/^}/
|
||
|
||
* Контекст в HTTP сервере
|
||
|
||
.code context/httpserver/handler.go /type handler/,/^}/
|
||
|
||
* httptest
|
||
|
||
* httptest
|
||
|
||
Содержит хелперы для удобного написания тестов для HTTP клиентов и серверов.
|
||
|
||
// стартует новый локальный HTTP сервер на слуйчаном свободном порту
|
||
httptest.NewServer(http.Handler)
|
||
// объект, реализующий интерфейс http.ResponseWriter и дающий доступ к результатам ответа
|
||
httptest.NewRecorder()
|
||
// возвращает объект, готовый к передаче прямо в http.Handler
|
||
httptest.NewRequest(method, target string, body io.Reader) *http.Request
|
||
|
||
* Пример тестирования клиента
|
||
|
||
.code httptest/code.go /^const \(/,/OMIT/
|
||
|
||
* Пример тестирования клиента
|
||
|
||
.code httptest/code_test.go /func TestGetReposCount/,/OMIT/
|
||
|
||
* Пример тестирования сервера
|
||
|
||
.code context/httpserver/handler_test.go /func TestHandlerServeHTTP/,/^}/
|
||
|
||
* Полезные библиотеки и фреймворки
|
||
|
||
Роутеры:
|
||
|
||
.link https://github.com/go-chi/chi
|
||
.link https://github.com/julienschmidt/httprouter
|
||
.link https://github.com/gorilla/mux
|
||
|
||
Фреймворки:
|
||
|
||
.link https://github.com/labstack/echo
|
||
.link https://github.com/gin-gonic/gin
|
||
.link https://github.com/gofiber/fiber
|