http

Documentation

Index

• type Engine
  • func (e *Engine) Start() error
  • func (e *Engine) Stop() error
• type HTTPClient
  • func NewHTTPClient() *HTTPClient
  • func (c *HTTPClient) Send(req *generated.Request) *generated.Response
• type Server
  • func NewServer(cfg *ServerCfg) *Server
  • func (s *Server) Register(api api.APInterface)
  • func (s *Server) Start() error
  • func (s *Server) Stop() error
• type ServerCfg

Types

type Engine

type Engine struct {
	PORT   int      // The port number for the engine.
	DOMAIN string   // The domain of the engine.
	SUBS   []string // The subdomains of the engine.
	// contains filtered or unexported fields
}

Engine represents an HTTP engine. It is responsible for managing network listeners and the HTTP server for either standard or secure connections, keeping track of its running status and configuration details like port, domain, and subdomains.

func (*Engine) Start

func (e *Engine) Start() error

Start starts the HTTP engine, allowing it to accept incoming connections. This method initiates the listening process on the specified port and handles incoming requests.

Returns: - error: An error if any.

func (*Engine) Stop

func (e *Engine) Stop() error

Stop stops the HTTP engine. It terminates the listening process and stops the server from accepting new connections.

Returns: - error: An error if any.

type HTTPClient

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

HTTPClient represents an HTTP client. It encapsulates the functionality for sending HTTP requests and receiving responses, handling underlying client and transport configurations.

func NewHTTPClient

func NewHTTPClient() *HTTPClient

NewHTTPClient initializes a new HTTPClient and returns its pointer. This function sets up the HTTP client with a custom transport configuration, including TLS settings and default timeout.

Returns: - *HTTPClient: A pointer to the newly created HTTPClient.

func (*HTTPClient) Send

func (c *HTTPClient) Send(req *generated.Request) *generated.Response

Send sends an HTTP request and returns the HTTP response. This method constructs and sends an HTTP request based on the provided transport request, handling headers, method, endpoint, and body. It also processes the received HTTP response, extracting status, headers, and body.

Parameters: - req: *generated.Request The HTTP request to be sent.

Returns: - *generated.Response: The HTTP response received.

type Server

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

Server represents an HTTP server that handles both standard and secure connections. It encapsulates the functionality of two engines, one for handling standard HTTP connections and the other for secure HTTPS connections, along with a router for API routing.

func NewServer

func NewServer(cfg *ServerCfg) *Server

NewServer creates a new HTTP server based on the provided configuration. It initializes a standard and, if specified, a secure engine based on the server configuration.

Parameters: - cfg: *ServerCfg Configuration data for the HTTP server.

Returns: - *Server: A new HTTP server. - error: An error if any.

func (*Server) Register

func (s *Server) Register(api api.APInterface)

Register registers API handlers with the server. This method binds API interfaces to the server for handling different routes and requests.

Parameters: - api: api.APInterface An interface containing API handlers.

func (*Server) Start

func (s *Server) Start() error

Start starts the HTTP server, allowing it to accept incoming connections. It checks for any running instances of the server and starts the standard and secure engines.

Returns: - error: An error if any.

func (*Server) Stop

func (s *Server) Stop() error

Stop stops the HTTP server. This method halts the server's operations and stops accepting incoming connections.

Returns: - error: An error if any.

type ServerCfg

type ServerCfg struct {
	DOMAIN string   // The domain of the server.
	SUBS   []string // The subdomains of the server.
	HTTP   int      // The port number for HTTP connections.
	HTTPS  int      // The port number for HTTPS connections.
}

ServerCfg holds configuration data for the HTTP server. This structure includes details such as the server's domain, subdomains, and port numbers for both HTTP and HTTPS connections.