{{위키데이터 속성 추적}}
소프트웨어 엔지니어링에서 '''의존성 주입'''({{lang|en|dependency injection}})은 하나의 객체가 다른 객체의 의존성을 제공하는 테크닉이다. "의존성"은 예를 들어 서비스로 사용할 수 있는 객체이다. 클라이언트가 어떤 서비스를 사용할 것인지 지정하는 대신, 클라이언트에게 무슨 서비스를 사용할 것인지를 말해주는 것이다. "주입"은 의존성(서비스)을 사용하려는 객체(클라이언트)로 전달하는 것을 의미한다. 서비스는 클라이언트 상태의 일부이다. 클라이언트가 서비스를 구축하거나 찾는 것을 허용하는 대신 클라이언트에게 서비스를 전달하는 것이 패턴의 기본 요건이다.

의존성 주입의 의도는 객체의 생성과 사용의 관심을 분리하는 것이다. 이는 가독성과 코드 재사용을 높혀준다.

의존성 주입은 광범위한 역제어 테크닉의 한 형태이다. 어떤 서비스를 호출하려는 클라이언트는 그 서비스가 어떻게 구성되었는지 알지 못해야 한다. 클라이언트는 대신 서비스 제공에 대한 책임을 외부 코드(주입자)로 위임한다. 클라이언트는 주입자 코드를 호출할 수 없다. 그 다음, 주입자는 이미 존재하거나 주입자에 의해 구성되었을 서비스를 클라이언트로 주입(전달)한다. 그리고 나서 클라이언트는 서비스를 사용한다. 이는 클라이언트가 주입자와 서비스 구성 방식 또는 사용중인 실제 서비스에 대해 알 필요가 없음을 의미한다. 클라이언트는 서비스의 사용 방식을 정의하고 있는 서비스의 고유한 인터페이스에 대해서만 알면 된다. 이것은 "구성"의 책임으로부터 "사용"의 책임을 구분한다.

== 의도 ==
의존성 주입은 다음과 같은 문제를 해결한다.<ref>{{웹 인용|url=http://w3sdesign.com/?gr=u01&ugr=proble|title=The Dependency Injection design pattern - Problem, Solution, and Applicability|website=w3sDesign.com|accessdate=2017-08-12|archive-date=2020-05-23|archive-url=https://web.archive.org/web/20200523164834/http://w3sdesign.com/?gr=u01&ugr=proble|url-status=}}</ref>

* 어떻게 애플리케이션이나 클래스가 객체의 생성 방식과 독립적일 수 있는가?
* 어떻게 객체의 생성 방식을 분리된 구성 파일에서 지정할 수 있는가?
* 어떻게 애플리케이션이 다른 구성을 지원할 수 있는가?

객체를 필요로하는 클래스 내에서 직접 객체를 생성하는 것은 클래스를 특정 객체에 커밋하는 것이고 이후에 클래스로부터 독립적으로(클래스의 수정 없이) 인스턴스의 생성을 변경하는 것이 불가능하기 때문에 유연하지 못하다. 이는 다른 객체를 필요로하는 경우 클래스를 재사용할 수 없게하며, 실제 객체를 모의 객체로 대체할 수 없기 때문에 클래스를 테스트하기 힘들게한다.

클래스는 더 이상 객체 생성에 대한 책임이 없으며, [[추상 팩토리 패턴|추상 팩토리]]<ref name="GoF">{{서적 인용|url=https://archive.org/details/designpatternsel00gamm/page/87|title=Design Patterns: Elements of Reusable Object-Oriented Software|author=Erich Gamma, Richard Helm, Ralph Johnson, John Vlissides|year=1994|publisher=Addison Wesley|pages=[https://archive.org/details/designpatternsel00gamm/page/87 87ff]|isbn=0-201-63361-2|url-access=registration}}</ref> 디자인 패턴에서처럼 팩토리 객체로 생성을 위임할 필요가 없다.

아래의 UML 클래스 및 시퀀스 다이어그램을 참고.

== 개요 ==
{{Quote box|quote='''5세의 의존성 주입'''

스스로 냉장고로 가서 무언가를 가져올 때 문제가 발생할 수 있다. 문을 열어 놓고 갈수도 있고, 엄마나 아빠의 물건을 가져갈 수도 있다. 심지어 있지도 않은 물건이나 유효기간이 지난 것을 찾고 있을 수도 있다.

필요한 것을 정의해야한다. "나는 점심이랑 같이 마실 뭔가가 필요해", 그 후에 뭔가를 가져왔는지 확인하고 앉아서 먹으면 된다.|source=John Munsch, 28 October 2009.<ref name=MarkSeeman2011P4>{{서적 인용|last1=Seeman|first1=Mark|title=Dependency Injection in .NET|date=October 2011|publisher=Manning Publications|isbn=9781935182504|page=4}}<!--|accessdate=18 July 2015--></ref><ref>{{웹 인용|title = Dependency Injection in NET|url = http://philkildea.co.uk/james/books/Dependency.Injection.in.NET.pdf|page = 4|website = philkildea.co.uk|accessdate = 2015-07-18|보존url = https://web.archive.org/web/20150721171646/http://philkildea.co.uk/james/books/Dependency.Injection.in.NET.pdf|보존날짜 = 2015-07-21|url-status = dead}}</ref><ref>{{웹 인용|title = How to explain dependency injection to a 5-year-old?|url = https://stackoverflow.com/questions/1638919/how-to-explain-dependency-injection-to-a-5-year-old|website = stackoverflow.com|accessdate = 2015-07-18}}</ref>|align=right|width=33%}}의존성 주입은 프로그램 디자인이 [[결합도]]를 [[:en:Loose_coupling|느슨하게]]<ref>{{웹 인용|url=http://blog.ploeh.dk/2010/04/07/DependencyInjectionisLooseCoupling/|title=Dependency Injection is Loose Coupling|last=Seemann|first=Mark|website=blog.ploeh.dk|accessdate=2015-07-28}}</ref> 되도록하고 [[의존관계 역전 원칙]]과 [[단일 책임 원칙]]을 따르도록 클라이언트의 생성에 대한 의존성을 클라이언트의 행위로부터 분리하는 것이다.<ref>Niko Schwarz, Mircea Lungu, Oscar Nierstrasz, “Seuss: Decoupling responsibilities from static methods for fine-grained configurability”, Journal of Object Technology, Volume 11, no. 1 (April 2012), pp. 3:1-23</ref> 이는 클라이언트가 의존성을 찾기 위해 그들이 사용하는 시스템에 대해 알도록 하는 [[:en:Service_locator_pattern|서비스 로케이터 패턴]]과 정반대되는 것이다.

의존성 주입의 기본 단위인 주입은 새롭거나 관습적인 메커니즘이 아니다. "[[매개변수 (컴퓨터 프로그래밍)|매개변수 전달]]"과 동일하게 동작한다. 주입으로써 "파라미터 전달"은 클라이언트를 세부 사항과 분리하기 위해 수행되고 있는 부가적인 의미를 전달한다.

또한 주입은 전달을 제어하는 대상(클라이언트가 아님)에 대한 것이며 전달의 수행 방식-참조 또는 값 전달-과 독립적이다.

의존성 주입은 네 가지 역할을 담당하는 객체 및 인터페이스를 전제로 한다.

* 사용될 '''서비스''' 객체
* 사용하는 서비스에 의존하는 '''클라이언트''' 객체
* 클라이언트의 서비스 사용 방법을 정의하는 [[:en:Interface_(object-oriented_programming)|인터페이스]]
* 서비스를 생성하고 클라이언트로 주입하는 책임을 갖는 '''주입자'''

비유하자면,

* 서비스 - 전기, 가스, 하이브리드 또는 디젤 자동차
* 클라이언트 - 엔진에 상관 없이 동일하게 차를 사용하는 운전자
* 인터페이스 - 운전자가 기어와 같은 엔진의 세부 사항을 이해할 필요가 없도록 보장해주는 '''[[자동변속기]]'''
* 주입자 - 아이에게 어떤 차를 사줄지 결정하고 구매해준 부모

사용될 수 있는 모든 객체는 '''서비스'''로 여겨진다. 다른 객체를 사용하는 모든 객체는 '''클라이언트'''로 여겨진다. 이름은 객체가 무엇을 위한 것인지와 무관하며 한 번의 주입에서 객체가 하는 역할과 관련이 있다.

'''인터페이스'''는 클라이언트가 의존성으로 예상하는 타입이다. 쟁점은 무엇을 접근할 수 있게 하는가이다. 이는 실제로 서비스에 의해 구현된 인터페이스 타입일 수도 있지만 추상 클래스 또는 [[의존관계 역전 원칙|DIP]]<ref>{{웹 인용|url=http://www.codeproject.com/Articles/538536/A-curry-of-Dependency-Inversion-Principle-DIP-Inve|title=A curry of Dependency Inversion Principle (DIP), Inversion of Control (IoC), Dependency Injection (DI) and IoC Container - CodeProject|website=www.codeproject.com|accessdate=2015-08-08}}</ref>를 위반하고, 테스트를 하기위한 동적으로 결합도 낮추는것을 희생하긴 하지만 [[:en:Class_(computer_programming)#Abstract_and_Concrete|concrete]] 서비스 자체일 수도 있다. 클라이언트가 인터페이스를 구성하거나 확장하는 것처럼 구체적으로 다룰 수 없도록 알지 못하게 하는 것이 요구된다.

클라이언트는 의존성의 특정 구현에 대한 구체적인 지식이 필요 없다. 인터페이스의 이름과 [[API]]만 알면 된다. 결과적으로 인터페이스가 변경되더라도 클라이언트는 수정할 필요가 없어진다. 하지만 인터페이스가 클래스로 존재하다가 인터페이스 타입으로(그 반대의 경우에도) [[리팩터링|리팩토링]]될 경우 클라이언트는 다시 컴파일이 필요할 수 있다. 이는 클라이언트와 서비스가 독립적으로 발행될 경우 중요하다. 이런경우에 결합도가 높아지는 문제는 안타깝게도 의존성 주입으로 해결할 수 없다.

'''주입자'''는 클라이언트에게 서비스를 소개한다. 종종 클라이언트를 생성하기도 한다. 주입자는 객체를 클라이언트와 같이 처리하고 나중에 다른 클라이언트의 서비스로 처리하여 매우 복잡한 객체 그래프를 함께 연결할수도 있다. 주입자는 실제로 함께 동작하는 많은 객체가 될 수 있지만 클라이언트는 될 수 없다. 주입자는 다음과 같은 많은 이름들로 참조될 수 있다: assembler, provider, container, factory, builder, spring, construction code, or main.

의존성 주입은 모든 객체가 구성과 동작을 분리하도록 요구하는 하나의 규율로 적용될 수 있다. 구성을 수행하는 DI 프레임워크에 의지하면 '''new''' 키워드의 사용을 금지하거나 덜 엄격하게 [[:en:Value_object|값 객체]]의 직접 생성을 허용할 수 있다.<ref>{{웹 인용|url=http://misko.hevery.com/2008/09/30/to-new-or-not-to-new/|title=To "new" or not to "new"…|accessdate=2015-07-18}}</ref><ref>{{웹 인용|url=http://www.loosecouplings.com/2011/01/how-to-write-testable-code-overview.html|title=How to write testable code|website=www.loosecouplings.com|accessdate=2015-07-18}}</ref><ref>{{웹 인용|url=http://www.ethanresnick.com/blog/testableCode.html|title=Writing Clean, Testable Code|website=www.ethanresnick.com|accessdate=2015-07-18}}</ref><ref>{{웹 인용|url=http://www.giorgiosironi.com/2009/07/when-to-inject-distinction-between.html|title=When to inject: the distinction between newables and injectables - Invisible to the eye|last=Sironi|first=Giorgio|website=www.giorgiosironi.com|accessdate=2015-07-18}}</ref>

=== 분류 ===
[[제어 반전|역제어]](IoC)는 DI보다 더 일반적이다. 간단하게 말하자면 IoC는 호출을 요구하는 대신 다른 코드가 호출할 수 있게 함을 의미한다. DI가 없는 IoC의 한 예로 [[템플릿 메소드 패턴]]이 있다. 여기서 [[다형성 (컴퓨터 과학)|다형성]]은 [[상속 (객체 지향 프로그래밍)#서브클래스와 수퍼클래스|서브클래싱]], 즉, [[상속 (객체 지향 프로그래밍)|상속]]을 통해 달성된다.<ref>{{웹 인용|url=https://stackoverflow.com/questions/6550700/inversion-of-control-vs-dependency-injection|title=Inversion of Control vs Dependency Injection|website=stackoverflow.com|accessdate=2015-08-05}}</ref>

의존성 주입은 [[:en:Object_composition|컴포지션]]을 통해 IoC를 구현하므로 종종 [[전략 패턴]]과 동일하지만, 전략 패턴의 의도는 객체의 [[:en:Object_lifetime|수명]]동안 의존성을 교환할 수 있도록 하는 것이고, 의존성 주입에서는 단일 의존성 인스턴스만 사용할 수 있도록 하는 것이다.<ref>{{웹 인용|url=https://stackoverflow.com/questions/4176520/what-is-the-difference-between-strategy-pattern-and-dependency-injection|title=What is the difference between Strategy pattern and Dependency Injection?|website=stackoverflow.com|accessdate=2015-07-18}}</ref> 여전히 다형성은 유지되지만 [[:en:Delegation_pattern|위임]]과 [[:en:Object_composition|컴포지션]]을 통해 이루어진다.

=== 의존성 주입 프레임워크 ===
[http://cdi-spec.org/ CDI]와 그 구현물인 [http://weld.cdi-spec.org/ Weld], [[스프링 프레임워크|Spring]], [[:en:Guice|Guice]], [[플레이 프레임워크|Play framework]], [https://ruediste.github.io/salta/ Salta], [[:en:HK2_DI_Kernel|Glassfish HK2]], [https://google.github.io/dagger/ Dagger], [[:en:Managed_Extensibility_Framework|Managed Extensibility Framework]](MEF)와 같은 [[애플리케이션 프레임워크]]는 의존성 주입을 지원하지만 필수는 아니다.<ref>{{웹 인용|url=http://www.loosecouplings.com/2011/01/dependency-injection-using-di-container.html|title=Dependency Injection != using a DI container|website=www.loosecouplings.com|accessdate=2015-07-18}}</ref><ref>{{웹 인용|url=http://blacksheep.parry.org/archives/diy-di/print/|title=Black Sheep » DIY-DI » Print|website=blacksheep.parry.org|archiveurl=https://web.archive.org/web/20150627215638/http://blacksheep.parry.org/archives/diy-di/print|archivedate=2015-06-27|url-status=dead|accessdate=2015-07-18}}</ref>

=== 장점 ===

* 의존성 주입은 클라이언트의 구성 가능성을 유연하게 해준다. 클라이언트의 행위는 고정되어 있다. 클라이언트는 클라이언트가 기대하는 고유한 인터페이스를 지원하는 모든 것을 할 수 있다.
* 의존성 주입을 통해 시스템의 구성 세부 사항을 외부의 구성 파일에서 사용하여 리컴파일 없이 시스템을 재 구성할 수 있다. 분리된 구성은 컴포넌트의 여러 구현을 요구하는 다양한 상황을 위해 작성될 수 있다. 이는 국한되어 있지는 않지만 테스팅을 포함한다.
* 의존성 주입은 코드의 동작에서의 어떠한 변경도 요구하지 않으므로 [[리팩터링]]으로써 레거시 코드에도 적용할 수 있다. 클라이언트는 더 독립적이며 테스트에 속하지 않은 다른 객체를 가장하는 [[메소드 스텁|stubs]] 또는 [[모의 객체]]를 사용해 독립된 [[유닛 테스트]]가 더 쉬워지는 결과를 얻는다.
* 의존성 주입을 통해 클라이언트는 사용해야하는 모든 구체적인 구현에 대한 지식을 제거할 수 있다. 디자인 변경이나 결함의 영향으로부터 클라이언트를 독립하는데 도움을 주며, 이는 재사용성, 테스트가능성, 유지가능성을 향상시킨다.<ref name="JSR330">{{웹 인용|url=https://jcp.org/en/jsr/detail?id=330|title=The Java Community Process(SM) Program - JSRs: Java Specification Requests - detail JSR# 330|website=jcp.org|accessdate=2015-07-18}}</ref>

== 구조 ==

=== UML 클래스 및 시퀀스 다이어그램 ===
[[파일:w3sDesign Dependency Injection Design Pattern UML.jpg|프레임|없음|A sample UML class and sequence diagram for the Dependency Injection design pattern.<ref>{{웹 인용|title=The Dependency Injection design pattern - Structure and Collaboration|url=http://w3sdesign.com/?gr=u01&ugr=struct|website=w3sDesign.com|accessdate=2017-08-12}}</ref>]]

== 의존성 주입의 이점 ==
* 의존 관계 설정이 [[컴파일]]시가 아닌 [[실행]]시에 이루어져 모듈들간의 [[결합도]]를 낮출 수 있다.
* [[코드 재사용]]을 높여서 작성된 모듈을 여러 곳에서 소스코드의 수정 없이 사용할 수 있다.
* [[모의 객체]] 등을 이용한 [[유닛 테스트|단위 테스트]]의 편의성을 높여준다.

== 적용 유형 ==
[[마틴 파울러]]는 다음과 같은 세 가지의 의존성 주입 패턴을 제시하였다.
<ref>{{웹 인용|저자=마틴 파울러
| url=http://www.martinfowler.com/articles/injection.html#FormsOfDependencyInjection
| 저자=마틴 파울러
| 제목=Inversion of Control Containers and the Dependency Injection pattern
| 날짜=2004년 1월 23일
| 확인날짜=2012년 6월 7일}}
</ref>

* 생성자 주입 : 필요한 의존성을 모두 포함하는 클래스의 생성자를 만들고 그 생성자를 통해 의존성을 주입한다.
* 세터(Setter)를 통한 주입 : 의존성을 입력받는 세터(Setter) 메소드를 만들고 이를 통해 의존성을 주입한다.
* [[인터페이스]](Interface)를 통한 주입 : 의존성을 주입하는 함수를 포함한 인터페이스를 작성하고 이 인터페이스를 구현하도록 함으로써 [[실행]]시에 이를 통하여 의존성을 주입한다.

== 같이 보기 ==
* [[스프링 프레임워크]]
* [[구글 주스]]

== 각주 ==
{{각주}}

{{디자인 패턴(소프트웨어)}}

[[분류:소프트웨어 구조]]
[[분류:소프트웨어 디자인 패턴]]
[[분류:컴포넌트 기반 소프트웨어 공학]]