계산기 백엔드 API In Go

또 다른 미니 프로젝트로 다시 돌아왔습니다. 이번에는 Go로 작성된 계산기 백엔드 API 도구입니다!

최근에 상태 비저장 계산기용 HTTP JSON API를 구축하는 프로젝트를 마무리했는데, 예상했던 것보다 훨씬 재미있었고 조금 더 어려웠습니다. 표면적으로는 간단하게 들릴 수도 있습니다. “야, 그냥 계산기일 뿐이지?” 그러나 일단 자세히 살펴보면 API를 실제로 프로덕션에 사용할 수 있게 만드는 모든 핵심적인 세부 사항을 발견하게 됩니다.

이제 과정과 배운 점, 다시 하게 된다면 수정하고 싶은 점을 공유해 보겠습니다.

~ 소스코드: 여기

상태 비저장 계산기 API

미션은 간단했습니다. 데이터를 저장하지 않고 데이터베이스나 메모리 내 캐싱도 저장하지 않는 계산기용 API를 구축하는 것이었습니다. 모든 계산은 독립적으로 이루어집니다. 무국적. 깨끗한. 단순한. API는 모든 엔드포인트와 예상 동작을 배치하는 OpenAPI 사양을 따릅니다.

다음은 무엇입니까?

입력 검증

제가 배운 첫 번째 교훈 중 하나는 입력 유효성 검사의 중요성이었습니다. 수학처럼 기본적인 것조차도 사용자를 믿을 수 없습니다. 예:

누군가가 아닌 번호로 보내면 어떻게 되나요? 붐.
0으로 나누는 것은 어떻습니까? 더블 붐.

이를 처리하기 위해 API가 처리를 고려하기 전에 모든 입력을 삭제하고 검증했는지 확인했습니다. 문제가 있는 경우 사용자에게 다음과 같은 유용하고 친숙한 오류 메시지가 표시됩니다.

{
  "error": "Division by zero is not allowed. Please provide a valid denominator."
}

암호적인 “500 서버 오류” 메시지를 좋아하는 사람은 없습니다.

디버깅을 위한 로깅

'로그는 최고의 친구'라는 말 아시죠? 사실이에요. Go golang.org/x/exp/slog 패키지를 사용하여 구조화된 로깅을 구현했는데, 덕분에 시간이 많이 절약되었습니다. 모든 요청은 다음과 같은 세부정보와 함께 기록되었습니다.

• 요청 경로
• 사용자의 IP 주소
• 상태 코드
• 뜨는 오류

다음은 텍스트 로그를 설정하는 방법의 일부입니다.

logger := slog.New(slog.NewTextHandler(os.Stdout, nil))

또는 JSON 로그(모니터링 도구와의 통합에 적합):

logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))

해당 로그를 편리하게 보관하면 무언가 예상대로 작동하지 않을 때 쉽게 디버깅할 수 있습니다.

CORS: 예상치 못한 영웅

처음에는 이 API를 브라우저 기반 앱에 사용할 계획이 없었지만 프로젝트가 발전하면서 CORS(Cross-Origin Resource Sharing)가 필요하다는 것이 분명해졌습니다.

github.com/rs/cors 패키지를 사용하여 브라우저 기반 클라이언트가 API와 상호 작용할 수 있도록 필요한 헤더를 빠르게 추가했습니다.

{
  "error": "Division by zero is not allowed. Please provide a valid denominator."
}

---

내 주요 패키지

1) net/http: HTTP 서버 설정 및 요청 라우팅을 위한 Go의 표준 라이브러리.
2) 인코딩/json: 요청 및 응답에 대한 JSON 인코딩/디코딩을 처리합니다.
3) golang.org/x/exp/slog: 모든 요청을 텍스트 또는 JSON 형식으로 기록합니다.
4) github.com/rs/cors: 웹 통합을 위한 교차 출처 요청을 처리합니다.

계산 논리는 어떻습니까?

저는 이러한 계산을 위해 몇 가지 핸들러를 만들었습니다. 이는 본질적으로 매우 기본적이며 주로 계산의 핵심 기능(덧셈, 뺄셈, 나눗셈 및 곱셈)에 중점을 둡니다.

logger := slog.New(slog.NewTextHandler(os.Stdout, nil))

이 외에도 유명한 net/http 패키지를 사용하여 HTTP 요청을 처리하는 것은 간단했으며 이 작업을 다양한 방식으로 수행하는 예가 많이 있습니다. 제 경우는 매우 간단했고 HTTP를 제공하고 응답 작성자와 요청을 처리하면 되었습니다.

logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))

다음은 몇 가지 사용 사례입니다.

c := cors.New(cors.Options{
        AllowedOrigins:   []string{"*"},
        AllowedMethods:   []string{"GET", "POST", "OPTIONS"},
        AllowedHeaders:   []string{"Content-Type"},
        AllowCredentials: true,
    })

요청:

//handlers.go

func AddHandler(logger *slog.Logger) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        handleOperation(logger, w, r, func(a, b float64) float64 { return a + b })
    }
}

func SubtractHandler(logger *slog.Logger) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        handleOperation(logger, w, r, func(a, b float64) float64 { return a - b })
    }
}

func MultiplyHandler(logger *slog.Logger) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        handleOperation(logger, w, r, func(a, b float64) float64 { return a * b })
    }
}

func DivideHandler(logger *slog.Logger) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        handleOperation(logger, w, r, func(a, b float64) float64 {
            if b == 0 {
                panic("division by zero")
            }
            return a / b
        })
    }
}

결론

그렇습니다! 거의 그 정도입니다! 빠르고 재미있게 즐길 수 있었던 미니 프로젝트였습니다! 자유롭게 시도해 보고 원하는 방식으로 개선하고 강화해 보세요.

다음번까지 화이팅! ? ?

위 내용은 계산기 백엔드 API In Go의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!