Build Web Apps

The HTTP package adds web application support on top of Procyon's component and runtime model. Routes are configured by components, handlers receive a request context, and responses are returned as structured results or written directly to the response.

Web application shape

Most web applications follow this flow:

1. Register controller or route configuration components.
2. Implement http.EndpointConfigurer to map endpoints.
3. Use http.Handle or http.HandleResult to adapt handler methods.
4. Read request data from http.Context or http.EndpointContext.
5. Return an http.Result when the response should be serialized.

type HelloController struct{}

func NewHelloController() *HelloController {
	return &HelloController{}
}

func (h *HelloController) ConfigureEndpoints(endpoints http.Endpoints) {
	endpoints.MapGet("/hello", http.HandleResult(h.sayHello))
}

func (h *HelloController) sayHello(ctx *http.Context) (http.Result, error) {
	return http.TypedResult[string]{
		Body: "Hello, World!",
	}, nil
}

func init() {
	component.Register(NewHelloController)
}

The controller is still a normal component. That means it can receive services, repositories, configuration, or other dependencies through its constructor.