strv backend go net

Strv net

Go Package облегчает написание приложений API быстро и простым образом.

Доступные пакеты

ошибки

Определение общих ошибок.

сеть

Общая функциональность, которая пригодится независимо от используемой архитектуры API. В настоящее время net поддерживает генерирование идентификаторов запросов с помощью некоторых вспомогательных методов.

http

Обертка вокруг нативного HTTP -сервера GO. http определяет Server , который может быть настроен ServerConfig . Реализованные функции:

• Запуск HTTP Server может быть легко остановлен, отменив контекст, который передается методом Run .
• Server может быть настроен с помощью slog.logger для регистрации важной информации во время запуска/окончания сервера.
• Server прослушивает сигналы SIGINT и SIGTERM поэтому его можно остановить, стреляя по сигналу.
• С помощью ServerConfig можно настроить функции, которые будут вызваны до завершения Server .

http определяет несколько вспомогательных соединений:

• Типы контента и заголовки, которые часто используются API.
• Средние войны:
  • RequestIDMiddleware устанавливает идентификатор запроса в контексте.
  • RecoverMiddleware восстанавливается после паники и устанавливает объект паники в авторитете ответа для ведения журнала.
  • LoggingMiddleware Отправляет информацию о запросе (метод, путь, код состояния, идентификатор запроса, продолжительность запроса, сообщение об ошибке и сообщение о панике).
• Method WriteResponse Для написания ответа HTTP и WriteErrorResponse Для написания ошибки HTTP -ответ. Написание ответов может быть настроено с помощью ResponseOption .

Примеры

http

Запуск сервера:

 package main

import (
	...

	httpx "go.strv.io/net/http"
)

func main () {
	...
	h := slog . NewJSONHandler ( os . Stderr , & slog. HandlerOptions {
		Level : level ,
		ReplaceAttr : func ( groups [] string , a slog. Attr ) slog. Attr {
			if a . Key == slog . TimeKey {
				a . Value = slog . StringValue ( a . Value . Time (). Format ( "2006-01-02T15:04:05.000Z" ))
			}
			return a
		},
	})
	l := slog . New ( h )
	serverConfig := httpx. ServerConfig {
		Addr :    ":8080" ,
		Handler : handler (), // define your http handler
		Hooks : httpx. ServerHooks {
			BeforeShutdown : []httpx. ServerHookFunc {
				func ( _ context. Context ) {
					storage . Close () // it may be useful for example to close a storage before the server ends
				},
			},
		},
		Limits : nil ,
		Logger : l . WithGroup ( "httpx.Server" ), // the server expects *slog.Logger
	}
	server := httpx . NewServer ( & serverConfig )
	if err = server . Start ( ctx ); err != nil {
		l . Error ( "HTTP server unexpectedly ended" , slog . Any ( "error" , err ))
	}
}

Написание ответов HTTP:

 func ( h * Handler ) GetUser ( w http. ResponseWriter , r * http. Request ) {
	userID := userIDFromCtx ( r . Context ())
	
	user , err := h . service . GetUser ( r . Context (), userID )
	if err != nil {
		_ = httpx . WriteErrorResponse ( w , http . StatusInternalServerError , httpx . WithErrorCode ( "ERR_UNKNOWN" ))
		return
	}
	
	userResp := model . ToUser ( user )
	_ = httpx . WriteResponse ( w , userResp , http . StatusOK )
}