의존성 주입

의존성 주입은 service가 필요한 것을 직접 만들지 않고 받아서 쓰는 방식입니다. 이렇게 하면 비즈니스 코드는 작아지고, 외부 시스템도 쉽게 교체할 수 있습니다.

`use`는 app 또는 library option에 등록한 값을 받습니다.
`adapt`와 `plug`는 storage, cache, message API처럼 교체 가능한 도구에 좋습니다.
`service`는 service끼리 연결합니다.
`env`는 런타임 설정을 모든 함수에 넘기지 않고 읽게 해줍니다.

use로 등록하기

`AkanOption.use()`는 글로벌 값을 준비하는 단순한 자리입니다. API client, 생성된 secret, host 값, 공통 설정을 여기에 둡니다.

Option에서 값 등록

Service에서 값 받기

adapt와 plug

도구가 동작을 가지고 있고 나중에 교체될 수 있다면 adaptor를 사용하세요. Service는 필요한 역할만 요청하면 됩니다.

Adaptor 선언

Service에 plug하기

Service 주입

한 service가 다른 service의 업무 method가 필요할 때 `service()`를 사용합니다. 직접 import해서 생성하는 것보다 흐름이 명확합니다.

Service끼리 연결

환경값 읽기

`env()`는 service가 app name, operation mode, hostname, feature flag 같은 런타임 정보를 알아야 할 때 유용합니다.

환경값 사용

꿀팁

외부 client를 method마다 만들지 마세요. `use` 또는 `adapt`로 한 번 등록하세요.
업무 협력은 `service()`, 교체 가능한 인프라는 `plug()`를 사용하세요.
가능하면 secret은 env/options에 두고 raw credential보다 준비된 client를 주입하세요.
여러 service가 공유하는 값은 보통 `AkanOption.use()`에 두는 것이 가장 깔끔합니다.

의존성 주입

`use`는 app 또는 library option에 등록한 값을 받습니다.
`adapt`와 `plug`는 storage, cache, message API처럼 교체 가능한 도구에 좋습니다.
`service`는 service끼리 연결합니다.
`env`는 런타임 설정을 모든 함수에 넘기지 않고 읽게 해줍니다.

use로 등록하기

`AkanOption.use()`는 글로벌 값을 준비하는 단순한 자리입니다. API client, 생성된 secret, host 값, 공통 설정을 여기에 둡니다.

Option에서 값 등록

Service에서 값 받기

adapt와 plug

도구가 동작을 가지고 있고 나중에 교체될 수 있다면 adaptor를 사용하세요. Service는 필요한 역할만 요청하면 됩니다.

Adaptor 선언

Service에 plug하기

Service 주입

한 service가 다른 service의 업무 method가 필요할 때 `service()`를 사용합니다. 직접 import해서 생성하는 것보다 흐름이 명확합니다.

Service끼리 연결

환경값 읽기

`env()`는 service가 app name, operation mode, hostname, feature flag 같은 런타임 정보를 알아야 할 때 유용합니다.

환경값 사용

꿀팁

외부 client를 method마다 만들지 마세요. `use` 또는 `adapt`로 한 번 등록하세요.
업무 협력은 `service()`, 교체 가능한 인프라는 `plug()`를 사용하세요.
가능하면 secret은 env/options에 두고 raw credential보다 준비된 client를 주입하세요.
여러 service가 공유하는 값은 보통 `AkanOption.use()`에 두는 것이 가장 깔끔합니다.