gorm

Overview ¶

Package gorm provides a GORM-based implementation of the UsersService. It supports any database that GORM supports (PostgreSQL, MySQL, SQLite, etc.) and is suitable for production deployments requiring relational database storage.

Database Schema ¶

The service uses auto-migration to create/update the users table:

CREATE TABLE users (
    id VARCHAR PRIMARY KEY,
    created_at TIMESTAMP,
    updated_at TIMESTAMP,
    name VARCHAR,
    description TEXT,
    tags JSON,           -- Stored as JSON array
    image_url VARCHAR,
    email VARCHAR,
    extras JSON          -- App-specific data as JSON
);

Generated Code ¶

This package uses protoc-gen-dal-gorm generated code:

• UserGORM: GORM model with proper tags
• UserGORMToUser/UserToUserGORM: conversion functions
• UserGORMDAL: data access layer with CRUD operations

Usage ¶

db, _ := gorm.Open(postgres.Open(dsn), &gorm.Config{})
userService := gormbe.NewUsersService(db)
resp, err := userService.CreateUser(ctx, &v1.CreateUserRequest{
    User: &v1.User{Name: "John Doe", Email: "john@example.com"},
})