egutierrez
69dcfec4eb
Anade los 5 handlers CRUD genericos (list, get, create, update, delete) a partir de un CRUDResource y *sql.DB, la factory crud_generate_handlers que compone los 5 en un mapa, y crud_register_routes que registra todas las rutas REST en un http.ServeMux con la sintaxis METHOD /path de Go 1.22+. Caracteristicas: - List con paginacion (page, per_page), orden (sort_by, sort_dir) y filtros exactos (filter_<campo>), validando nombres de columna contra la definicion del recurso para evitar SQL injection. - Create valida required y validaciones (min/max, min_length/max_length, pattern, enum) antes de insertar; mapea UNIQUE violations a 409. - Update hace partial update — solo los campos presentes en el JSON. - Delete hace hard delete o soft delete segun CRUDResource.SoftDelete. - UUIDs generados via github.com/google/uuid; timestamps en RFC3339Nano UTC. Los handlers usan las funciones HTTP del registry (http_json_response, http_error_response, http_parse_body) y se pueden componer con el mux via http_router.
45 lines
1.7 KiB
Markdown
45 lines
1.7 KiB
Markdown
---
|
|
name: crud_register_routes
|
|
kind: function
|
|
lang: go
|
|
domain: infra
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "func CRUDRegisterRoutes(mux *http.ServeMux, basePath string, res CRUDResource, db *sql.DB)"
|
|
description: "Registra las 5 rutas REST de un CRUDResource en un http.ServeMux: GET /base, GET /base/{id}, POST /base, PUT /base/{id}, DELETE /base/{id}. Usa la sintaxis 'METHOD /path' de Go 1.22+."
|
|
tags: [crud, routes, register, http, mux, infra]
|
|
uses_functions: [crud_generate_handlers_go_infra]
|
|
uses_types: [CRUDResource_go_infra]
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: [database/sql, fmt, net/http, strings]
|
|
params:
|
|
- name: mux
|
|
desc: "*http.ServeMux donde se registran las rutas"
|
|
- name: basePath
|
|
desc: "prefijo de las rutas (ej: '/api/projects')"
|
|
- name: res
|
|
desc: "definicion CRUDResource del recurso"
|
|
- name: db
|
|
desc: "conexion *sql.DB a SQLite"
|
|
output: "muta mux con las 5 rutas CRUD registradas"
|
|
tested: true
|
|
tests: ["registra las 5 rutas y responde correctamente", "soporta multiples recursos en un mismo mux"]
|
|
test_file_path: "functions/infra/crud_test.go"
|
|
file_path: "functions/infra/crud_register_routes.go"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
mux := http.NewServeMux()
|
|
CRUDRegisterRoutes(mux, "/api/projects", projectRes, db)
|
|
CRUDRegisterRoutes(mux, "/api/users", userRes, db)
|
|
http.ListenAndServe(":8080", mux)
|
|
```
|
|
|
|
## Notas
|
|
|
|
Impura — muta el mux pasado como parametro. basePath se normaliza quitando el slash final. Si la ruta colisiona con una ya registrada en el mux, Go lanzara panic al arrancar (comportamiento estandar del ServeMux). Para combinar con middleware de logging/CORS, envolver el mux con HTTPMiddlewareChain al final.
|