기본 HTTP 서비스

이 가이드는 go-zero의 API framework를 사용해 최소 HTTP 서비스를 만드는 과정을 단계별로 설명합니다.

API 정의

hello.api 파일을 만듭니다.

syntax = "v1"

type HelloReq {
    Name string `path:"name,options=you|me"`
}

type HelloReply {
    Message string `json:"message"`
}

service hello-api {
    @handler HelloHandler
    get /hello/:name (HelloReq) returns (HelloReply)
}

코드 생성

goctl api go -api hello.api -dir ./hello

생성된 구조는 다음과 같습니다.

hello/
├── etc/hello-api.yaml
├── internal/
│   ├── config/config.go
│   ├── handler/hellohandler.go
│   ├── logic/hellologic.go
│   ├── svc/servicecontext.go
│   └── types/types.go
└── hello.go

로직 구현

internal/logic/hellologic.go

func (l *HelloLogic) Hello(req *types.HelloReq) (resp *types.HelloReply, err error) {
    return &types.HelloReply{
        Message: "Hello " + req.Name,
    }, nil
}

설정

etc/hello-api.yaml

Name: hello-api
Host: 0.0.0.0
Port: 8888

서버 시작

cd hello && go mod tidy && go run hello.go

테스트

curl http://localhost:8888/hello/world
# {"message":"Hello world"}

오류 처리

import "github.com/zeromicro/go-zero/rest/httpx"

httpx.Error(w, errorx.NewCodeError(400, "invalid name"))