이번 포스팅에서는 Maven 설치 및 Maven project를 import하여 간단한 코드를 실행하는 것을 해 보겠습니다.

---

0. 📍 Maven 설치

1) ⛺ Maven 다운로드

https://maven.apache.org/
위의 사이트에 들어가서 최신버전의 Maven을 다운받아 줍니다.

2) ⛺ 환경 변수 설정

저는 시스템 변수 가 아닌 사용자 변수 로 설정해 주었습니다.

• PATH : Path 경로에 "[메이븐 설치폴더]\bin"을 추가합니다. 저의 경우에는 아래와 같았습니다.

  

아래와 같이 cmd 창에 mvn - version 를 입력하였을 때, 설치한 Maven의 버전이 나오면 성공입니다.

1. 📍 Maven project

1) ♾️ 프로젝트 폴더 생성

workspace 아래에 import 할 프로젝트 명으로 폴더를 만든 후 아래와 같이 하위폴더들을 생성해줍니다. 여기서는 01.CHAP01 이 프로젝트 명입니다.

2) ♾️ Maven 프로젝트 생성

위와 같이 폴더생성을 완료했다면, pom.xml 파일을 프로젝트파일 아래에 만들어줍니다.

그리고 아래 xml 파일을 작성해줍니다. 메모장으로도 충분히 가능하지만 저는 Notepad++를 사용하여 작성한 후 저장하였습니다.

C:/PRACTICE/00.TOBY/01.CHAP01/workspace/01.CHAP01/pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
		http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<groupId>sp5</groupId>
	<artifactId>01.CHAP01</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	
	<dependencies>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-context</artifactId>
			<version>5.0.2.RELEASE</version>
		</dependency>
	</dependencies>
	
	<build>
		<plugins>
			<plugin>
				<artifactId>maven-compiler-plugin</artifactId>
				<version>3.7.0</version>
				<configuration>
					<source>1.8</source>
					<target>1.8</target>
					<encoding>utf-8</encoding>
				</configuration>
			</plugin>
		</plugins>
	</build>
	
</project>

• 주요 코드

<artifactId>01.CHAP01</artifactId>
 : 프로젝트의 식별자를 지정합니다. 여기서는 프로젝트 폴더와 동일하게 지정 하였습니다.

<dependency>
	<groupId>org.springframework</groupId>
	<artifactId>spring-context</artifactId>
	<version>5.0.2.RELEASE</version>
</dependency>
 : 프로젝트에서 5.0.2.RELEASE 버전의 spring-context 모듈을 사용한다고 설정합니다.
 
 <plugin>
	<artifactId>maven-compiler-plugin</artifactId>
	<version>3.7.0</version>
	<configuration>
		<source>1.8</source>
		<target>1.8</target>
		<encoding>utf-8</encoding>
	</configuration>
</plugin>
 : JDK 1.8 버전으로 자바 소스를 컴파일합니다. 자바 컴파일러가 소스코드를 읽을 때, 사용할 인코딩은 UTF-8 입니다.

① Maven dependency 설정

위의 pom.xml 에서 dependency와 plugin의 두 가지 정보를 설정했습니다. 여기서 dependency 설정은 다음과 같습니다.

<dependency>
	<groupId>org.springframework</groupId>
	<artifactId>spring-context</artifactId>
	<version>5.0.2.RELEASE</version>
</dependency>

Maven은 한 개의 모듈을 artifact라는 단위로 관리합니다. 위 설정은 spring-context라는 식별자를 가진 5.0.2.RELEASE 버전의 아티팩트에 대한 의존(dependency)을 추가한 것입니다.

여기서 의존을 추가한다는 것은 일반적인 자바 어플리케이션에서 클래스 패스에 spring-context 모듈을 추가한다는 것을 뜻합니다.

각 아티팩트의 완전한 이름은 아티팩트이름-버전.jar이므로, 위 설정은 Maven 프로젝트의 소스코드를 컴파일하고 실행할 때 사용할 클래스 패스에 spring-context-5.0.2.RELEASE.jar 파일을 추가한다는 것을 의미 합니다.

② Maven repository

이전 포스팅인 🧩 프로젝트 세팅을 보면 프로젝트 내에 repository 폴더와 setting.xml 파일이 존재하는것을 볼 수 있습니다.

이러한 방법을 활용하면 프로젝트에서 다운로드되는
Maven 파일들(ex. spring-context-5.0.2.RELEASE.jar)이 모두 프로젝트 폴더 내의 repository로 저장됩니다.

3) ♾️ Project import

Maven 프로젝트를 Eclipse에 import 하려면 File - Import... 메뉴를 사용합니다.

이 메뉴를 실행하면 아래의 그림과 같은 창이 표시됩니다. 아래의 화면에서 Maven/Existing Maven Projects를 선택한 후 Next 버튼을 클릭합니다.

여기서 Browse... 버튼을 눌러 앞서 생성한 Maven 프로젝트 폴더를 Root Directory: 로 선택해 주며, 아래 그림과 같이 나온다면 Finish 버튼을 눌러서 마무리해 줍니다.

기다리면 아래와 같이 Eclipse에 프로젝트가 import 되는것을 볼 수 있습니다.

Eclipse에 생성된 프로젝트를 보면 다음을 알 수 있습니다.

• src/main/java 폴더
  : 소스 폴더로 정의되어 있음
• Maven Dependencies
  : 메이븐 의존에 설정한 아티팩트가 Eclipse 프로젝트의 클래스패스에 추가됨

Maven Dependencies에 등록된 jar 파일들은 앞서 설명한 repository에 위치합니다. 실제로 Eclipse는 Maven 프로젝트를 import 할 때 필요한 모든 jar파일을 로컬로 받아온 다음 그 파일을 클래스패스에 추가합니다.

이제 Eclipse를 이용해서 Spring을 이용한 자바 어플리케이션을 개발할 준비가 끝났습니다. 이제 실제 코드를 작성하고 실행해 보겠습니다.

4) ♾️ Example

간단하게 Spring을 이용한 프로그램을 작성해 보겠습니다. 다음은 작성할 파일입니다.

• Greeter.java : 콘솔에 간단한 메시지를 출력하는 자바 클래스
• AppContext.java : Spring 설정 파일
• Main.java : main() 메서드를 통해 Spring과 Greeter를 실행하는 자바 클래스

먼저 Eclipse에서 src/main/java 소스 폴더에 chap02 패키지를 생성한 후 클래스들을 모두 추가해 줍니다.

01.CHAP01/src/main/java/chap02/Greeter.java

package chap02;

public class Greeter {

	private String format;
	
	public String greet(String guest) {
		return String.format(format, guest);
	}
	
	public void setFormat(String format) {
		this.format = format;
	}
	
}

Greeter 클래스의 greet() 메서드는 String의 문자열 포맷을 이용해서 새로운 문자열을 생성합니다. greet() 메서드에서 사용할 문자열 포맷은 setFormat() 메서드를 이용해서 설정하도록 구현하였습니다.

Greeter 클래스를 사용하는 코드는 다음과 같이 Greeter 객체를 생성한 뒤, setFormat() 메서드를 이용해서 문자열 포맷을 지정하고, greet() 메서드를 이용해서 메시지를 생성할 것입니다.

Greeter greeter = new Greeter();
greeter.setFormat("%s, 헤위");
String str = greeter.greet("Spring");	//str은 "Spring, 헤위"가 된다.

01.CHAP01/src/main/java/chap02/AppContext.java

package chap02;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class AppContext {

	@Bean
	public Greeter greeter() {
		Greeter g = new Greeter();
		g.setFormat("%s, 헤위");
		return g;
	}
	
}

06행의 @Configuration 어노테이션은 해당 클래스를 Spring 설정 클래스로 지정합니다.

AppContext.java에서 핵심은 @Bean 어노테이션 아래에 있는 코드입니다. Spring은 객체를 생성하고 초기화하는 기능을 제공하는데, 이 코드가 한 개 객체를 생성하고 초기화하는 설정을 담고 있기 때문입니다.

Spring이 생성하는 객체를 Bean 객체라고 부르는데, 이 Bean 객체에 대한 정보를 담고 있는 메서드가 greeter() 메서드입니다. 이 메서드에는 @Bean 어노테이션이 붙어 있습니다.

@Bean 어노테이션을 메서드에 붙이면 해당 메서드가 생성한 객체를 Spring이 관리하는 Bean 객체로 등록합니다.

@Bean 어노테이션을 붙인 메서드의 이름은 Bean 객체를 구분할 때 사용합니다. 예를 들어 Spring이 현재 코드의 @Bean 아래에서 생성한 객체를 구분할 때 greeter라는 이름을 사용합니다. 이 이름은 Bean 객체를 참조할 때 사용되며, 뒤에서 이 값을 사용할 것입니다.

@Bean 어노테이션을 붙인 메서드는 객체를 생성하고 알맞게 초기화 해야 합니다. 위 코드에서는

g.setFormat("%s, 안녕하세요!");

에서 Greeter 객체를 초기화하고 있습니다.

01.CHAP01/src/main/java/chap02/Main.java

package chap02;

import org.springframework.context.annotation.AnnotationConfigApplicationContext;

public class Main {

	public static void main(String[] args) {
		AnnotationConfigApplicationContext ctx = 
				new AnnotationConfigApplicationContext(AppContext.class);
		Greeter g = ctx.getBean("greeter", Greeter.class);
		String msg = g.greet("Spring");
		System.out.println(msg);
		ctx.close();
	}
}

• 주요 코드

import org.springframework.context.annotation.AnnotationConfigApplicationContext;

: AnnotationConfigApplicationContext 클래스는 자바 설정에서 정보를 읽어와 Bean 객체를 생성하고 관리합니다.

---

AnnotationConfigApplicationContext ctx = 
				new AnnotationConfigApplicationContext(AppContext.class);

: AnnotationConfigApplicationContext 객체를 생설할 때 앞서 작성한 AppContext 클래스를 생성자 파라미터로 전달합니다.

AnnotationConfigApplicationContext는 AppContext에 정의한 @Bean 설정 정보를 읽어와 Greeter 객체를 생성하고 초기화합니다.

---

Greeter g = ctx.getBean("greeter", Greeter.class);

: getBean() 메서드는 AnnotationConfigApplicationContext가 자바 설정을 읽어와 생성한 Bean 객체를 검색할 때 사용됩니다.

getBean() 메서드의 첫 번째 파라미터는 @Bean 어노테이션의 메서드 이름인 Bean 객체의 이름이며, 두 번째 파라미터는 검색할 Bean 객체의 타입입니다.

앞서 작성한 자바 설정(AppContext)을 보면 @Bean 메서드의 이름이 greeter 이고 생성한 객체의 리턴 타입이 Greeter 이므로, 10행의 getBean() 메서드는 greeter() 메서드가 생성한 Greeter 객체를 리턴합니다.

@Bean
public Greeter greeter() {
	Greeter g = new Greeter();
    g.setFormat("%s, 헤위");
    return g;
}

---

String msg = g.greet("Spring");

: 11행에서는 Greeter 객체의 greet() 메서드를 실행하고 있습니다. Greet.java 코드를 보면 greet() 메서드는 다음과 같이 정의되어 있습니다.

// format 필드는 setFormat() 메서드로 설정함
public String greet(String guest) {
	return String.format(format, guest);
}

---

앞서 AppContext 설정에 따르면 생성한 Greeter 객체의 format 필드의 값은 "%s, 헤위"가 됩니다.

따라서 11행의 g.greet("Spring") 코드는 다음의 코드와 동일한 결과를 생성합니다.

String.format("%s, 헤위", "Spring")	// 결과 : "Spring, 헤위"

5) ♾️ Code Execution

아래와 같이 Main.java 에서 오른쪽 마우스를 클릭하여 Java Application 을 클릭해 주어도 되고, ctrl + F11을 눌러서 실행해 주어도 됩니다.

아래와 같이 결과가 나오면 성공입니다.

2. 📍 Spring Container

앞에서 작성한 Main.java 코드를 보면 다음과 같이 설정 정보를 이용하여 Bean 객체를 생성하고, 해당 Bean 객체를 제공하는 것을 알 수 있습니다.

// 1. 설정 정보를 이용해서 Bean 객체를 생성함
AnnotationConfigApplicationContext ctx =
	new AnnotationConfigApplicationContext(AppContext.class);

// 2. Bean 객체를 제공함
Greeter g = ctx.getBean("greeter", Greeter.class);

ApplicationContext(또는 BeanFactory)는 Bean 객체의 생성, 초기화, 보관, 제거 등을 관리하고 있어서 ApplicationContext를 컨테이너(Container)라고도 부릅니다.

• Spring Container의 Bean 객체 관리
  

  Spring Container는 내부적으로 Bean 객체와 Bean 이름을 연결하는 정보를 가집니다. 예를 들어 chap02.Greeter 타입의 객체를 greeter라는 이름의 Bean으로 설정했다고 하겠습니다. 이 경우 Container는 다음 그림처럼 greeter 이름과 Greeter 객체를 연결한 정보를 관리합니다.
  
  이름과 실제 객체의 관계뿐만 아니라 실제 객체의 생성, 초기화, 의존 주입 등 Spring Container는 객체 관리를 위한 다양한 기능을 제공합니다.

1) 🏷️ Singleton Obejct

싱글튼 객체에 대해 알아보기 위해 아래 코드를 보겠습니다.

01.CHAP01/src/main/java/chap02/Main2.java

package chap02;

import org.springframework.context.annotation.AnnotationConfigApplicationContext;

public class Main2 {

	public static void main(String[] args) {
		AnnotationConfigApplicationContext ctx = 
				new AnnotationConfigApplicationContext(AppContext.class);
		Greeter g1 = ctx.getBean("greeter", Greeter.class);
		Greeter g2 = ctx.getBean("greeter", Greeter.class);
		System.out.println("(g1 == g2) = " + (g1 == g2));
		ctx.close();
	}
}

---

10행과 11행은 이름이 greeter인 Bean 객체를 구해서 각각 g1과 g2 변수에 할당합니다.

Greeter g1 = ctx.getBean("greeter", Greeter.class);
Greeter g2 = ctx.getBean("greeter", Greeter.class);

---

12행에서는 g1과 g2가 같은 객체인지 여부를 콘솔에 출력합니다.

System.out.println("(g1 == g2) = " + (g1 == g2));

결과가 어떻게 될지 궁금했는데, 위 코드를 실행하면 (g1 == g1)의 결과가 true로 출력되는 것을 확인할 수 있었습니다.

(g1 == g1)의 결과가 true라는 것은 g1과 g2가 같은 객체라는 것을 의미합니다. 즉 아래 코드에서 getBean() 메서드는 같은 객체를 리턴하는 것입니다.

Greeter g1 = ctx.getBean("greeter", Greeter.class);
Greeter g2 = ctx.getBean("greeter", Greeter.class);

별도 설정을 하지 않을 경우 Spring은 한 개의 Bean 객체만을 생성하며, 이때 Bean 객체는 Singleton 범위를 갖는다고 표현합니다.

Singleton은 단일 객체(single object)를 의미하는 단어로서 Spring은 기본적으로 한 개의 @Bean 어노테이션에 대해 한 개의 Bean 객체를 생성합니다.

따라서 다음과 같은 설정을 사용하면 greeter에 해당하는 객체 한 개와 greeter1에 해당하는 객체 한 개, 이렇게 두 개의 Bean 객체가 생성됩니다.

@Bean
public Greeter greeter() {
	Greeter g = new Greeter();
	g.setFormat("%s, 헤위");
	return g;
}

@Bean
public Greeter greeter1() {
	Greeter g = new Greeter();
	g.setFormat("안녕하신가, %s여");
	return g;
}

Singleton 범위 외에 프로토타입 범위도 존재합니다. 이에 관한 내용은 추후에 기회가 된다면 정리해 보도록 하겠습니다.

---

오늘은 Maven project를 import하여 기본적인 코드들을 실행해 보았습니다.

다음에는 DI 즉 Dependency Injectioin에 대한 포스팅을 해 보겠습니다.

감사합니다.

---

💡 Reference

https://www.kame.co.kr/nkm/detail.php?tcode=306&tbook_jong=3

🐈‍⬛ git

실습한 코드입니다.
https://github.com/LimNakHyun/Spring/tree/main/02.CHAPTER2/src/main/java/chap02