Go Academy · 강의

유연한 API 만들기

이 패턴 적용하기

유연한 API 만들기은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

패턴 적용하기

이제 전체 패턴을 조립합니다. 필수 인수와 옵션의 가변 인수 목록을 받는 생성자를 만듭니다.

가변 인수를 사용하는 생성자

필수 매개변수가 먼저 오고 옵션은 ...Option으로 뒤따릅니다.

package main

import "fmt"

type Server struct {
	Host string
	Port int
}
type Option func(*Server)

func WithPort(p int) Option { return func(s *Server) { s.Port = p } }

func NewServer(host string, opts ...Option) *Server {
	s := &Server{Host: host}
	for _, opt := range opts {
		opt(s)
	}
	return s
}

func main() {
	s := NewServer("localhost", WithPort(8080))
	fmt.Printf("%+v\n", *s)
}

옵션 없이 호출하기

옵션은 가변 인수이므로 호출자가 옵션을 완전히 생략하고 생성자가 설정한 값을 그대로 사용할 수 있습니다.

package main

import "fmt"

type Server struct{ Host string; Port int }
type Option func(*Server)

func NewServer(host string, opts ...Option) *Server {
	s := &Server{Host: host}
	for _, o := range opts { o(s) }
	return s
}

func main() {
	s := NewServer("localhost")
	fmt.Printf("%+v\n", *s)
}

여러 옵션으로 호출하기

원하는 만큼 옵션을 나열할 수 있으며, 각 옵션의 의미가 호출 위치에서 명확하게 드러납니다.

package main

import "fmt"

type Server struct {
	Host    string
	Port    int
	Timeout int
	TLS     bool
}
type Option func(*Server)

func WithPort(p int) Option    { return func(s *Server) { s.Port = p } }
func WithTimeout(t int) Option { return func(s *Server) { s.Timeout = t } }
func WithTLS() Option          { return func(s *Server) { s.TLS = true } }

func NewServer(host string, opts ...Option) *Server {
	s := &Server{Host: host}
	for _, o := range opts { o(s) }
	return s
}

func main() {
	s := NewServer("localhost", WithPort(9000), WithTimeout(60), WithTLS())
	fmt.Printf("%+v\n", *s)
}

호출만으로 의미가 드러납니다

NewServer("localhost", WithPort(9000), WithTLS())를 위치 기반 호출과 비교해 보세요. 시그니처를 확인하지 않아도 의도가 분명합니다.

나중에 옵션 추가하기

새 설정이 필요하신가요? WithX 함수를 추가하면 됩니다. 기존 호출 위치는 수정하지 않아도 계속 컴파일됩니다. 진정한 하위 호환성입니다.

package main

import "fmt"

type Server struct{ Host string; Retries int }
type Option func(*Server)

func WithRetries(n int) Option { return func(s *Server) { s.Retries = n } }

func NewServer(host string, opts ...Option) *Server {
	s := &Server{Host: host}
	for _, o := range opts { o(s) }
	return s
}

func main() {
	fmt.Printf("%+v\n", *NewServer("h", WithRetries(5)))
}

옵션 전달하기

옵션은 값이므로 다른 곳에서 슬라이스를 만든 다음 생성자에 전달할 수 있습니다.

package main

import "fmt"

type Server struct{ Host string; Port int }
type Option func(*Server)

func WithPort(p int) Option { return func(s *Server) { s.Port = p } }

func NewServer(host string, opts ...Option) *Server {
	s := &Server{Host: host}
	for _, o := range opts { o(s) }
	return s
}

func main() {
	common := []Option{WithPort(443)}
	s := NewServer("api", common...)
	fmt.Printf("%+v\n", *s)
}

공개 API로서의 옵션

Option 타입과 WithX 함수를 내보내면 라이브러리 사용자가 내부를 건드리지 않고 타입을 구성할 수 있습니다.

필드를 비공개로 유지하기

구성 필드는 내보내지 않는 상태로 유지할 수 있습니다. 옵션만 필드를 설정하는 공식적인 방법이 되므로 불변 조건을 보호할 수 있습니다.

패턴이 특히 유용한 곳

선택적 설정이 많은 라이브러리 생성자
성장하는 동안에도 안정적으로 유지해야 하는 API
클라이언트, 서버, 로거, 빌더

표준 라이브러리의 사례

Go 생태계 전반에서 이 스타일을 볼 수 있습니다(gRPC 및 여러 드라이버). 이 스타일을 알아두면 이러한 API가 익숙하게 느껴집니다.

확인 문제

유연한 API에 대한 지식을 테스트해 보세요.

복습

함수형 옵션으로 유연한 API를 만들었습니다.

필수 인수 다음에 ...Option을 둡니다
옵션을 반복하며 하나씩 적용합니다
호출자는 0개 또는 여러 옵션을 명확하게 전달할 수 있습니다
호출자를 깨뜨리지 않고 나중에 옵션을 추가할 수 있습니다

자주 묻는 질문

“유연한 API 만들기” 강의는 무료인가요?

네 — “유연한 API 만들기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“유연한 API 만들기”에서 뭘 배우나요?

이 패턴 적용하기 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Go Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“유연한 API 만들기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Go Academy(으)로 돌아가기