strv backend go net

strv网

GO包装以快速简便的方式促进编写API应用程序。

可用的软件包

错误

常见错误的定义。

网

无论使用的API架构如何，都可以用方便地进行通用功能。 net当前支持使用一些辅助方法生成请求ID。

http

围绕GO本机HTTP服务器包装。 http定义了可以由ServerConfig配置的Server 。实施功能：

• 启动HTTP服务器可以通过取消Run方法传递的上下文来轻松停止。
• Server可以配置使用slog.logger，以在服务器的启动/结束期间记录重要信息。
• 该Server听SIGINT和SIGTERM信号，因此可以通过启动信号来停止它。
• 可以通过ServerConfig配置Server结束之前要调用的函数。

http定义了几个辅助辅导结构：

• API经常使用的内容类型和标题。
• 中间大道：
  • RequestIDMiddleware将请求ID设置在上下文中。
  • RecoverMiddleware从恐慌中恢复，并将恐慌对象设置为响应作者进行记录。
  • LoggingMiddleware日志有关请求的信息（方法，路径，状态代码，请求ID，请求的持续时间，错误消息和恐慌消息）。
• 用于编写HTTP响应和WriteErrorResponse错误HTTP响应的方法WriteResponse 。响应的撰写可以通过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 )
}