a simple API project with DDD (Domain-Driven Design) principles in Go using Iris…
- User
a simple API project with DDD (Domain-Driven Design) principles in Go using Iris Framework and Ent
- Assistant
Creating an API project using Go with the Iris framework and Ent ORM while adhering to Domain-Driven Design (DDD) principles involves several steps. Here's a simple walk-through.
We will create a Todo API that allows users to create, read, update, and delete todos. For simplicity, assume a Todo has an ID, Title, and Completed status.
Step-by-Step Guide:
-
Initialize the Project
First, create a new Go module for your project:
mkdir todo-api cd todo-api go mod init github.com/yourusername/todo-api -
Install Dependencies
Install the necessary dependencies:
go get github.com/kataras/iris/v12 go get entgo.io/ent go get entgo.io/ent/cmd/ent -
Generate Ent Schema
First, initialize the Ent schema:
go run entgo.io/ent/cmd/ent init TodoModify the generated schema in
ent/schema/todo.goto look like this:package schema import ( "entgo.io/ent" "entgo.io/ent/schema/field" ) // Todo holds the schema definition for the Todo entity. type Todo struct { ent.Schema } // Fields of the Todo. func (Todo) Fields() []ent.Field { return []ent.Field{ field.String("title").NotEmpty(), field.Bool("completed").Default(false), } } // Edges of the Todo. func (Todo) Edges() []ent.Edge { return nil }Now, generate the ent code:
go generate ./ent -
Define the DDD Layers
- Domain Layer: This is where we define our core business logic and entities.
- Repository: The way we interact with the database.
- Service Layer: Business logic and rules.
- API Layer: Entrypoint for the HTTP API.
Directory structure:
├── domain │ └── todo.go ├── repository │ └── todo_repo.go ├── service │ └── todo_service.go ├── api │ └── todo_handler.go ├── ent │ ├── schema │ │ └── todo.go ├── main.go -
Domain Layer:
domain/todo.gopackage domain type Todo struct { ID int Title string Completed bool } -
Repository Layer:
repository/todo_repo.gopackage repository import ( "context" "github.com/yourusername/todo-api/domain" "github.com/yourusername/todo-api/ent" ) type TodoRepository struct { client *ent.Client } func NewTodoRepository(client *ent.Client) *TodoRepository { return &TodoRepository{client: client} } func (r *TodoRepository) Create(ctx context.Context, title string) (*domain.Todo, error) { todo, err := r.client.Todo.Create().SetTitle(title).Save(ctx) if err != nil { return nil, err } return &domain.Todo{ID: todo.ID, Title: todo.Title, Completed: todo.Completed}, nil } func (r *TodoRepository) Get(ctx context.Context, id int) (*domain.Todo, error) { todo, err := r.client.Todo.Get(ctx, id) if err != nil { return nil, err } return &domain.Todo{ID: todo.ID, Title: todo.Title, Completed: todo.Completed}, nil } // Similarly, implement other CRUD methods (Update, Delete, List) here... -
Service Layer:
service/todo_service.gopackage service import ( "context" "github.com/yourusername/todo-api/domain" "github.com/yourusername/todo-api/repository" ) type TodoService struct { repo *repository.TodoRepository } func NewTodoService(repo *repository.TodoRepository) *TodoService { return &TodoService{repo: repo} } func (s *TodoService) CreateTodo(ctx context.Context, title string) (*domain.Todo, error) { return s.repo.Create(ctx, title) } func (s *TodoService) GetTodoByID(ctx context.Context, id int) (*domain.Todo, error) { return s.repo.Get(ctx, id) } // Similarly, implement other CRUD methods (Update, Delete, List) here... -
API Layer:
api/todo_handler.gopackage api import ( "strconv" "github.com/kataras/iris/v12" "github.com/yourusername/todo-api/service" ) type TodoHandler struct { service *service.TodoService } func NewTodoHandler(service *service.TodoService) *TodoHandler { return &TodoHandler{service: service} } func (h *TodoHandler) CreateTodo(ctx iris.Context) { var params struct { Title string `json:"title"` } if err := ctx.ReadJSON(¶ms); err != nil { ctx.StatusCode(400) ctx.JSON(iris.Map{"error": "Invalid input"}) return } todo, err := h.service.CreateTodo(ctx.Request().Context(), params.Title) if err != nil { ctx.StatusCode(500) ctx.JSON(iris.Map{"error": err.Error()}) return } ctx.StatusCode(201) ctx.JSON(todo) } func (h *TodoHandler) GetTodoByID(ctx iris.Context) { id, err := strconv.Atoi(ctx.Params().Get("id")) if err != nil { ctx.StatusCode(400) ctx.JSON(iris.Map{"error": "Invalid ID"}) return } todo, err := h.service.GetTodoByID(ctx.Request().Context(), id) if err != nil { ctx.StatusCode(404) ctx.JSON(iris.Map{"error": "Todo not found"}) return } ctx.JSON(todo) } // Similarly, implement other CRUD methods (Update, Delete, List) here... -
Main Entry Point:
main.gopackage main import ( "log" "github.com/yourusername/todo-api/api" "github.com/yourusername/todo-api/repository" "github.com/yourusername/todo-api/service" "github.com/yourusername/todo-api/ent" "github.com/kataras/iris/v12" _ "github.com/mattn/go-sqlite3" // import your database driver ) func main() { client, err := ent.Open("sqlite3", "file:ent?mode=memory&cache=shared&_fk=1") if err != nil { log.Fatalf("failed opening connection to sqlite: %v", err) } defer client.Close() // Run the auto migration tool. if err := client.Schema.Create(context.Background()); err != nil { log.Fatalf("failed creating schema resources: %v", err) } app := iris.New() todoRepo := repository.NewTodoRepository(client) todoSvc := service.NewTodoService(todoRepo) todoHandler := api.NewTodoHandler(todoSvc) app.Post("/todos", todoHandler.CreateTodo) app.Get("/todos/{id:int}", todoHandler.GetTodoByID) // Similarly, register other CRUD routes... app.Listen(":8080") }
Conclusion
This is a basic skeleton of an API project following DDD principles using Go, Iris, and Ent. This example covers the creation and retrieval of todos, but similar methods can be implemented for updating, deleting, and listing todos.
Make sure to handle errors and edge cases according to your project's requirements.
-