====== Basics ======

===== 개요 =====
Spring Framework에서 객체가 생성자 인수, 팩토리 메서드에 대한 인수 또는 객체 인스턴스가 생성되거나 팩토리 메서드에서 반환된 후 객체 인스턴스에 설정된 속성을 통해서만 종속성(함께 작업하는 다른 객체)을 정의하는 프로세스를 제어의 역전(Inversion of Control, IoC)라고 한다. 의존성 주입(Dependency Injection, DI)은 모듈간의 의존성을 모듈의 외부 컨테이너 에서 주입시켜주는 기능으로 IoC의 한 종류이다.

===== 설명 =====
Spring Framework에서 Bean은 어플리케이션을 구성하고, IoC Container에 의해 관리되어지는 객체로 간단히 말해 IoC Container에 의해 객체화되고, 조립되고, 또는 관리되는 객체를 의미한다.\\
Bean들과 Bean들간의 종속성은 Container가 사용하는 설정 메타데이터에 의해 결정된다.

==== The Container ====
org.springframework.beans.factory.BeanFactory 인터페이스는 Spring IoC Container의 핵심 인터페이스로 Spring IoC Container는 객체를 생성하고, 객체간의 종속성을 이어주는 역할을 한다.

{{ :egovframework:rte:fdl:ioc_Container:Container-magic.png  | Spring IoC Container}}

=== 설정 정보(Configuration Metadata) ===
위 그림에서 보듯이, Spring IoC Container는 설정 정보(configuration metadata)를 필요로 한다. 이 설정 정보는 Spring IoC Container가 "객체를 생성하고, 객체간의 종속성을 이어줄 수 있도록" 필요한 정보를 제공한다.\\
설정 정보는 일반적으로 XML 형태로 작성된다. 설정 정보는 XML 형태가 아닌 Java Annotation을 이용하여 설정이 가능하다.\\
Annotation을 사용한 설정 방법은 [[eGovframework:RTE:FDL:IoC Container:Annotation-based configuration]]에서 설명하고 있다.\\

아래 예제는 XML 형태의 설정 정보의 기본적인 모습이다.

<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd">

    <bean id="..." class="...">
        <!-- collaborators and configuration for this bean go here -->
    </bean>

    <bean id="..." class="...">
        <!-- collaborators and configuration for this bean go here -->
    </bean>

    <!-- more bean definitions go here -->
</beans>
</code>

%%<beans>%% tag는 Spring IoC Container의 설정 정보를 나타내는 tag이다. 그리고 각각의 %%<bean>%% tag는 Spring IoC Container가 생성하고, 관리할 객체의 정의를 나타낸다.\\
XML 설정 정보를 여러 개의 파일로 나뉘어 구성될 수 있다. 이 경우, 전체 설정 정보를 읽기 위해서 하나의 설정 파일에서 다른 파일을 import할 수 있다. Import 하는 방법으로 %%<import>%% tag를 사용한다.

<code xml>
<beans>
    <import resource="services.xml"/>
    <import resource="resources/messageSource.xml"/>
    <import resource="/resources/themeSource.xml"/>

    <bean id="bean1" class="..."/>
    <bean id="bean2" class="..."/>
</beans>
</code>

%%<import>%% tag의 ''resource'' attribute는 import할 XML 설정 파일의 위치를 나타낸다.

=== Container 객체화 ===
다음은 Container를 객체화하는 한 예이다.

<code java>
ApplicationContext context = new ClassPathXmlApplicationContext(new String[] {"services.xml", "daos.xml"});

// an Application is also a BeanFactory (via inheritance)
BeanFactory factory = context;
</code>

위 예제의 ''ClassPathXmlApplicationContext''는 ''ApplicationContext''의 한 종류이며, ''ApplicationContext'' 인터페이스는 ''BeanFactory'' 인터페이스를 상속하고 있다.

=== Container 사용 방법 ===
Container를 객체화하면 ''getBean(String)'' 메소드를 사용하여 bean을 가져올 수 있다.

==== The beans ====
Spring IoC Container는 다수의 //bean//들을 관리한다. Container는 설정 정보를 사용하여 bean들은 생성한다. Container에서 사용하는 bean 정의는 아래 정보를 담고 있다.
  * 클래스 이름(a package-qualified class name): bean의 실제 구현 클래스를 나타낸다.
  * Bean 행동 정보(bean behavioral configuration elements): Container 안에서 bean이 어떤 식으로 행동하는지에 대한 정보를 나타낸다.(scope, lifecycle callbacks 등등)
  * 다른 bean에 대한 참조(references to other beans): bean이 동작하기 위해 필요한 다른 bean들에 대한 참조 정보를 나타낸다. 이런 참조는 협력자(collaborators) 또는 종속성(dependencies)라고도 한다.
  * 기타 객체에 설정할 정보들(other configuration settings): connection pool을 관리하는 bean에서 사용할 connection의 개수, 또는 pool의 최대 크기 등

위 개념적인 정보들은 실제 %%<bean>%% tag로 작성된다. %%<bean>%% tag를 구성하는 bean 정의는 아래 표와 같다.

^  Feature  ^  Explained in...  ^
| class  | [[#Bean 객체화(Instantiation beans)]]  |
| name  | [[#Bean 이름(Naming beans)]]  |
| scope  | [[eGovframework:RTE:FDL:IoC Container:Bean scope|Bean scope]]  |
| constructor arguments  | [[eGovframework:RTE:FDL:IoC Container:Dependencies:#종속성 삽입(Injecting dependencies)|종속성 삽입(Injecting dependencies)]]  |
| properties  | [[eGovframework:RTE:FDL:IoC Container:Dependencies:#종속성 삽입(Injecting dependencies)|종속성 삽입(Injecting dependencies)]]  |
| autowiring mode  | [[eGovframework:RTE:FDL:IoC Container:Dependencies:#자동엮기(Autowiring collaborators)|자동엮기(Autowiring collaborators)]]  |
| dependency checking mode  | [[eGovframework:RTE:FDL:IoC Container:Dependencies:#종속성 검사(Checking for dependencies)|종속성 검사(Checking for dependencies)]]  |
| lazy-initialization mode  | [[eGovframework:RTE:FDL:IoC Container:Dependencies:#늦은 객체화(Lazily-instantiated beans)|늦은 객체화(Lazily-instantiated beans)]]  |
| initialization method  | [[eGovframework:RTE:FDL:IoC Container:Customizing the nature of a bean:#객체화 callbacks(Initialization callbacks)|객체화 callbacks(Initialization callbacks)]]  |
| destruction method  | [[eGovframework:RTE:FDL:IoC Container:Customizing the nature of a bean:#파괴 callbacks(Destruction callbacks)|파괴 callbacks(Destruction callbacks)]]  |

=== Bean 이름(Naming beans) ===
모든 bean은 하나 이상의 ''id''를 가져야 하며, 각각의 ''id''는 Container안에서 단 하나만 존재해야 한다. 일반적으로 대부분의 bean은 하나의 id를 가지지만, 별명(alias)를 사용하여 둘 이상의 id를 가질 수도 있다.\\
Bean id에 대한 명명 규칙은 Java의 class field 명명 규칙과 같다. id는 소문자로 시작하고, 두번째 단어부터는 첫글자는 대문자로 작성한다. '''accountManager''', '''accountService''', '''userDao''', '''loginController''' 등

== Bean 별명(Aliasing beans) ==
%%<alias>%% tag를 사용하여 이미 정의된 bean에게 추가적인 이름을 부여할 수 있다.

<code xml>
<alias name="fromName" alias="toName"/>
</code>

''name'' attribute는 대상이 되는 bean의 이름이고, ''alias'' attribute는 부여할 새로운 이름이다.

=== Bean 객체화(Instantiation beans) ===
모든 bean 정의는 객체화를 위해 실제 Java Class가 필요하다.\\
XML 설정에서는 '''class''' attribute를 통해 Java Class를 설정한다. 대부분의 경우 Container는 bean를 객체화하기 위해서 Java의 //'new'// 연산자를 사용한다.\\
또는 특수한 경우, static 메소드를 사용할 수도 있다. 본 문서는 생성자를 이용한 객체화만을 설명한다.\\
생성자를 이용한 객체화는 가장 일반적인 방식으로, 다음과 같이 사용한다.

<code xml>
<bean id="exampleBean" class="example.ExampleBean"/>

<bean name="anotherExample" class="examples.ExampleBeanTwo"/>
</code>

===== 참고자료 =====
  * [[https://docs.spring.io/spring-framework/docs/5.3.27/reference/html/core.html#beans-introduction|Spring Framework - Reference Document / 1.1 Introduction to the Spring IoC Container and Beans]]