strv backend go net

ตาข่าย strv

GO แพ็คเกจอำนวยความสะดวกในการเขียนแอปพลิเคชัน API อย่างรวดเร็วและง่ายดาย

แพ็คเกจที่มีอยู่

ข้อผิดพลาด

คำจำกัดความของข้อผิดพลาดทั่วไป

สุทธิ

ฟังก์ชั่นทั่วไปที่มีประโยชน์โดยไม่คำนึงถึงสถาปัตยกรรม API ที่ใช้แล้ว ปัจจุบัน net รองรับการสร้างรหัสคำขอด้วยวิธีการช่วยบางอย่าง

http

Wrapper รอบเซิร์ฟเวอร์ HTTP Native GO http กำหนด Server ที่สามารถกำหนดค่าได้โดย ServerConfig คุณสมบัติที่นำไปใช้:

• เริ่มต้นเซิร์ฟเวอร์ HTTP สามารถหยุดได้อย่างง่ายดายโดยการยกเลิกบริบทที่ส่งผ่านโดยวิธี Run
• Server สามารถกำหนดค่าด้วย slog.logger สำหรับการบันทึกข้อมูลสำคัญระหว่างการเริ่ม/สิ้นสุดของเซิร์ฟเวอร์
• Server ฟังสัญญาณ SIGINT และ SIGTERM เพื่อให้สามารถหยุดได้โดยการยิงสัญญาณ
• โดย ServerConfig สามารถกำหนดค่าฟังก์ชั่นที่จะเรียกได้ก่อนที่ Server จะสิ้นสุด

http กำหนดหลาย ๆ อย่างของผู้ช่วย:

• ประเภทเนื้อหาและส่วนหัวที่ API ใช้บ่อย
• Middlewares:
  • 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 )
}