gin-gonic/gin

Gin 1.12.0의 출시를 발표하게 되어 기쁩니다! 이번 릴리스에는 새로운 기능, 성능 향상 및 중요한 버그 수정이 포함되어 있습니다. 자세한 내용은 공식 블로그의 출시 공지사항을 확인해 주세요.

Gin은 Go 언어로 작성된 고성능 HTTP 웹 프레임워크 (web framework)입니다. Martini와 유사한 API를 제공하면서도, httprouter 덕분에 최대 40배 더 빠른 현저히 향상된 성능을 제공합니다. Gin은 속도와 개발자 생산성이 필수적인 REST API, 웹 애플리케이션 및 마이크로서비스 (microservices)를 구축하기 위해 설계되었습니다.

왜 Gin을 선택해야 할까요?

Gin은 Express.js 스타일 라우팅 (routing)의 단순함과 Go의 성능 특성을 결합하여 다음과 같은 작업에 이상적입니다:

• 높은 처리량 (high-throughput)의 REST API 구축
• 많은 동시 요청 (concurrent requests)을 처리해야 하는 마이크로서비스 개발
• 빠른 응답 시간이 필요한 웹 애플리케이션 생성
• 최소한의 보일러플레이트 (boilerplate)로 웹 서비스 빠르게 프로토타이핑

Gin의 주요 특징:

Zero allocation router - 힙 할당 (heap allocations)이 없는 매우 메모리 효율적인 라우팅
High performance - 벤치마크 (benchmarks) 결과 다른 Go 웹 프레임워크에 비해 우수한 속도 입증
Middleware support - 인증, 로깅 (logging), CORS 등을 위한 확장 가능한 미들웨어 (middleware) 시스템
Crash-free - 내장된 리커버리 (recovery) 미들웨어가 패닉 (panics)으로부터 서버가 중단되는 것을 방지
JSON validation - 자동화된 요청/응답 JSON 바인딩 (binding) 및 검증
Route grouping - 관련 라우트를 조직화하고 공통 미들웨어 적용
Error management - 중앙 집중식 에러 처리 및 로깅
Built-in rendering - JSON, XML, HTML 템플릿 (templates) 등을 지원
Extensible - 커뮤니티 미들웨어 및 플러그인의 방대한 생태계

Go 버전: Gin은 Go 버전 1.25 이상이 필요합니다.
기초 Go 지식: Go 문법 및 패키지 관리 (package management)에 익숙하면 도움이 됩니다.

Go의 모듈 (module) 지원을 통해, 코드에 Gin을 임포트 (import)하기만 하면 빌드 (build) 시 Go가 자동으로 가져옵니다:

import "github.com/gin-gonic/gin"

다음은 Gin의 단순함을 보여주는 완전한 예제입니다:

package main
import (
"log"
...

애플리케이션 실행:

• 위의 코드를

main.go

로 저장합니다.

• 애플리케이션을 실행합니다:

go run main.go

• 브라우저를 열고 다음 주소를 방문합니다:

http://localhost:8080/ping

• 다음과 같은 결과를 볼 수 있습니다:

{"message":"pong"}

이 예제가 보여주는 것:

• 기본 미들웨어 (middleware)를 포함한 Gin 라우터 (router) 생성
• 단순한 핸들러 (handler) 함수를 사용한 HTTP 엔드포인트 (endpoint) 정의
• JSON 응답 반환
• HTTP 서버 시작

첫 번째 Gin 애플리케이션을 실행한 후, 더 자세히 배우기 위해 다음 리소스들을 살펴보세요:

Gin Quick Start Guide- API 예제와 빌드 설정이 포함된 종합 튜토리얼
Example Repository- 다양한 Gin 사용 사례를 보여주는 즉시 실행 가능한 예제:

• REST API 개발
• 인증 (Authentication) 및 미들웨어 (middleware)
• 파일 업로드 및 다운로드
• WebSocket 연결
• 템플릿 렌더링 (Template rendering)

Go.dev API Documentation- 예제가 포함된 완전한 API 참조 문서

종합적인 문서는 gin-gonic.com에서 여러 언어로 제공됩니다:

Gin은 다른 Go 웹 프레임워크와 비교했을 때 탁월한 성능을 보여줍니다. 최대 효율성을 위해 HttpRouter의 커스텀 버전을 사용합니다. 상세 벤치마크 (benchmarks) 보기 →

Gin vs. Other Go Frameworks (GitHub API 라우팅 벤치마크):

벤치마크 이름	(1)	(2)	(3)	(4)
BenchmarkGin_GithubAll	43550	27364 ns/op	0 B/op	0 allocs/op
BenchmarkAce_GithubAll	40543	29670 ns/op	0 B/op	0 allocs/op
BenchmarkAero_GithubAll	57632	20648 ns/op	0 B/op	0 allocs/op
BenchmarkBear_GithubAll	9234	216179 ns/op	86448 B/op	943 allocs/op
...

• (1): 일정 시간 내에 달성된 총 반복 횟수 (Total Repetitions), 높을수록 결과의 신뢰도가 높음
• (2): 단일 반복 지속 시간 (Single Repetition Duration, ns/op), 낮을수록 좋음
• (3): 힙 메모리 (Heap Memory, B/op), 낮을수록 좋음
• (4): 반복당 평균 할당량 (Average Allocations per Repetition, allocs/op), 낮을수록 좋음

Gin은 일반적인 웹 개발 요구 사항을 위한 풍부한 미들웨어 (middleware) 생태계를 갖추고 있습니다. 커뮤니티에서 기여한 미들웨어를 살펴보세요:

gin-contrib- 다음을 포함하는 공식 미들웨어 (middleware) 컬렉션:

• 인증 (Authentication) (JWT, Basic Auth, Sessions)
• CORS, 속도 제한 (Rate limiting), 압축 (Compression)
• 로깅 (Logging), 메트릭 (Metrics), 트레이싱 (Tracing)
• 정적 파일 서빙 (Static file serving), 템플릿 엔진 (Template engines)

gin-gonic/contrib- 추가적인 커뮤니티 미들웨어

Gin은 프로덕션 환경의 많은 고트래픽 애플리케이션과 서비스를 구동합니다:

gorush- 고성능 푸시 알림 (push notification) 서버
fnproject- 컨테이너 네이티브 (Container-native), 서버리스 (serverless) 플랫폼
photoprism- AI 기반 개인 사진 관리
lura- 초고성능 API 게이트웨이 (API Gateway) 프레임워크
picfit- 실시간 이미지 처리 서버
dkron- 분산 작업 스케줄링 (Distributed job scheduling) 시스템

Gin은 전 세계 수백 명의 기여자들의 작업물입니다. 여러분의 기여를 환영하고 감사드립니다! 전체 기여자 목록을 확인하세요.

• 🐛
  버그 보고 (Report bugs)- 문제 식별 및 해결을 도와주세요 - 💡
  기능 제안 (Suggest features)- 개선을 위한 아이디어를 공유해 주세요 - 📝
  문서 개선 (Improve documentation)- 문서가 더 명확해지도록 도와주세요 - 🔧
  코드 제출 (Submit code)- 버그를 수정하거나 새로운 기능을 구현해 주세요 - 🧪
  테스트 작성 (Write tests)- 테스트 커버리지 (test coverage)를 개선해 주세요

• 자세한 가이드라인은 CONTRIBUTING.md를 확인하세요

• 커뮤니티 토론에 참여하고 질문을 남겨주세요

모든 기여는 가치 있게 여겨지며, Gin을 모두에게 더 나은 도구로 만드는 데 도움이 됩니다!