strv backend go net

Strv net

GO PACOTO FACILITAR APIOS API DE ESCRITÓRIO DE UMA MUITO FÁCIL e FÁCIL.

Pacotes disponíveis

erros

Definição de erros comuns.

líquido

Funcionalidade comum que é útil, independentemente da arquitetura de API usada. Atualmente, net suporta a geração de IDs de solicitação com alguns métodos auxiliares.

http

Wrapper em torno do servidor HTTP nativo Go. http define o Server que pode ser configurado pelo ServerConfig . Recursos implementados:

• O servidor HTTP iniciado pode ser facilmente interrompido cancelando o contexto que é passado pelo método Run .
• O Server pode ser configurado com um slog.logger para registrar informações importantes durante o início/acabamento do servidor.
• O Server ouve os sinais SIGINT e SIGTERM para que possa ser interrompido disparando o sinal.
• Pelo ServerConfig pode ser configurado funções a serem chamadas antes que o Server termine.

http define vários conscientes auxiliares:

• Tipos de conteúdo e cabeçalhos que são frequentemente usados ​​pelas APIs.
• Middlewares:
  • RequestIDMiddleware Define ID de solicitação no contexto.
  • RecoverMiddleware se recupera do pânico e define o objeto de pânico no escritor da resposta para registrar.
  • LoggingMiddleware registra informações sobre a solicitação (método, caminho, código de status, ID de solicitação, duração da solicitação, mensagem de erro e mensagem de pânico).
• Method WriteResponse para escrever uma resposta HTTP e WriteErrorResponse para escrever uma resposta HTTP de erro. A escrita das respostas pode ser configurada por ResponseOption .

Exemplos

http

Iniciando o servidor:

 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 ))
	}
}

Escrevendo respostas 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 )
}