[스프링 핵심 원리와 활용] 섹션7. 외부 설정과 프로필 (2)

[seyeop03]

${\textsf{\color{orange}1.2. OS 환경 변수}}$

OS 환경 변수(OS environment variables)는 해당 OS를 사용하는 모든 프로그램에서 읽을 수 있는 설정값이다. 한마디로 다른 외부 설정과 비교해서 사용 범위가 가장 넓다.

조회 방법

• 윈도우 OS: set
• MAC, 리눅스 OS: printenv

set 실행 결과

현재 OS에 설정된 OS 환경 변수 값들을 출력했다.

설정 방법: OS 환경 변수의 값을 설정하는 방법은 윈도우 환경 변수, MAC 환경 변수 등으로 검색해보자. 수 많은 예시를 확인할 수 있다.

애플리케이션에서 OS 환경 변수의 값을 읽어보자.

OsEnv - src/test 하위

@Slf4j
public class OsEnv {

		public static void main(String[] args) {
				Map<String, String> envMap = System.getenv();
				for (String key : envMap.keySet()) {
						log.info("env {}={}", key, System.getenv(key));
				}
		}
}

• System.getenv()를 사용하면 전체 OS 환경 변수를 Map으로 조회할 수 있다.
• System.getenv(key)를 사용하면 특정 OS 환경 변수의 값을 String으로 조회할 수 있다.

실행 결과

---

OS 환경 변수를 설정하고, 필요한 곳에서 System.getenv()를 사용하면 외부 설정을 사용할 수 있다. 이제 데이터베이스 접근 URL과 같은 정보를 OS 환경 변수에 설정해두고 읽어들이면 된다.

• 예를 들어서 개발 서버에서는 [DB_URL=dev.db.com](http://dburl=dev.db.com/) 과 같이 설정하고, 운영 서버에서는 [DB_URL=prod.db.com](http://dburl=prod.db.com/) 와 같이 설정하는 것이다.
• 이렇게 하면 System.getenv("DB_URL")로 조회 시 각각 환경에 따라서 서로 다른 값을 읽게 된다.

하지만 OS 환경 변수는 이 프로그램 뿐만 아니라 다른 프로그램에서도 사용할 수 있다. 쉽게 이야기해서 전역 변수 같은 효과가 있다. 여러 프로그램에서 사용하는 것이 맞을 때도 있지만, 해당 애플리케이션을 사용하는 자바 프로그램 안에서만 사용되는 외부 설정값을 사용하고 싶을 때도 있다. 다음에는 특정 자바 프로그램 안에서 사용하는 외부 설정을 알아보자.

${\textsf{\color{orange}1.3. 외부 설정 - 자바 시스템 속성}}$

자바 시스템 속성(Java System properties)은 실행한 JVM 안에서 접근 가능한 외부 설정이다. 추가로 자바가 내부에서 미리 설정해두고 사용하는 속성들도 있다.

자바 시스템 속성은 다음과 같이 자바 프로그램을 실행할 때 사용한다.

• 예) java -Durl=dev -jar app.jar
• -D VM 옵션을 통해서 key=value 형식을 주면 된다. 이 예제는 url=dev 속성이 추가된다.
• 순서에 주의해야 한다. -D 옵션이 -jar 보다 앞에 있다.

JavaSystemProperties - src/test 하위

@Slf4j
public class JavaSystemProperties {

		public static void main(String[] args) {
				Properties properties = System.getProperties();
				for (Object key : properties.keySet()) {
						log.info("prop {}={}", key, System.getProperty(String.valueOf(key)));
				}
		}
}

• System.getProperties()를 사용하면 Map과 유사한(Map의 자식 타입) key=value 형식의 Properties 를 받을 수 있다. 이것을 통해서 모든 자바 시스템 속성을 조회할 수 있다.
• System.getProperty(key)를 사용하면 속성값을 조회할 수 있다.

실행 결과

• 자바가 기본으로 제공하는 수 많은 속성들이 추가되어 있는 것을 확인할 수 있다. 자바는 내부에서 필요할
  때 이런 속성들을 사용하는데, 예를 들어서 file.encoding=UTF-8를 통해서 기본적인 파일 인코딩 정보 등으로 사용한다.

이번에는 사용자가 직접 정의하는 자바 시스템 속성을 추가해보자.

url, username, password 를 조회하는 코드를 추가하자

JavaSystemProperties - 추가

@Slf4j
public class JavaSystemProperties {

		public static void main(String[] args) {
				Properties properties = System.getProperties();
				for (Object key : properties.keySet()) {
						log.info("prop {}={}", key, 
						System.getProperty(String.valueOf(key)));
				}
				
				String url = System.getProperty("url");
				String username = System.getProperty("username");
				String password = System.getProperty("password");
				log.info("url={}", url);
				log.info("username={}", username);
				log.info("password={}", password);
		}
}

• 실행할 때 자바 시스템 속성을 추가해야 한다.

IDE에서 실행시 VM 옵션 추가

• VM options에 -Durl=devdb -Dusername=dev_user -Dpassword=dev_pw 추가

실행 결과

• 실행해보면 -D 옵션을 통해 추가한 자바 시스템 속성들을 확인할 수 있다.

Jar 실행

jar로 빌드되어 있다면 실행시 다음과 같이 자바 시스템 속성을 추가할 수 있다.

자바 시스템 속성을 자바 코드로 설정하기

자바 시스템 속성은 앞서 본 것 처럼 -D 옵션을 통해 실행 시점에 전달하는 것도 가능하고, 다음과 같이 자바 코드 내부에서 추가하는 것도 가능하다. 코드에서 추가하면 이후에 조회시에 값을 조회할 수 있다.

• 설정: System.setProperty(propertyName, "propertyValue")
• 조회: System.getProperty(propertyName)

참고로 이 방식은 코드 안에서 사용하는 것이기 때문에 외부로 설정을 분리하는 효과는 없다.

${\textsf{\color{orange}1.4. 외부 설정 - 커맨드 라인 인수}}$

커맨드 라인 인수(Command line arguments)는 애플리케이션 실행 시점에 외부 설정값을 main(args) 메서드의 args 파라미터로 전달하는 방법이다.

다음과 같이 사용한다.

• 예) java -jar app.jar dataA dataB
• 필요한 데이터를 마지막 위치에 스페이스로 구분해서 전달하면 된다. 이 경우 dataA, dataB 2개의 문자가 args에 전달된다.

CommandLineV1 - src/test 하위

/**
 * CommandLine 인수는 스페이스로 구분
 * java -jar app.jar dataA dataB -> [dataA, dataB] 2개
 * java -jar app.jar url=devdb -> [url=devdb] 1개
 * url=devdb 이라는 단어를 개발자가 직접 파싱해야 함
 **/
@Slf4j
public class CommandLineV1 {
		public static void main(String[] args) {
		
				for (String arg : args) {
						log.info("arg {}", arg);
				}
		}
}

IDE에서 실행시 커맨드 라인 인수 추가

• 여기에 dataA dataB 를 입력하고 실행하자.
• 커맨드 라인 인수는 공백(space)으로 구분한다.

참고
빨간색으로 칠한 Program arguments가 보이지 않는다면 바로 위에 있는 파란색 Modify options버튼을 눌러서 추가할 수 있다.

실행 결과

Jar 실행

jar로 빌드되어 있다면 실행시 다음과 같이 커맨드 라인 인수를 추가할 수 있다.

key=value 형식 입력

애플리케이션을 개발할 때는 보통 key=value 형식으로 데이터를 받는 것이 편리하다.

이번에는 커맨드 라인 인수를 다음과 같이 입력하고 실행해보자.

실행 결과

실행 결과를 보면 알겠지만 커맨드 라인 인수는 key=value 형식이 아니다. 단순히 문자를 여러게 입력 받는 형식인 것이다. 그래서 3가지 문자가 입력되었다.

• url=devdb
• username=dev_user
• password=dev_pw

이것은 파싱되지 않은, 통 문자이다.
이 경우 개발자가 =을 기준으로 직접 데이터를 파싱해서 key=value 형식에 맞도록 분리해야 한다. 그리고 형식이 배열이기 때문에 루프를 돌면서 원하는 데이터를 찾아야 하는 번거로움도 발생한다.
실제 애플리케이션을 개발할 때는 주로 key=value 형식을 자주 사용하기 때문에 결국 파싱해서 Map 같은 형식으로 변환하도록 직접 개발해야 하는 번거로움이 있다.

${\textsf{\color{orange}1.5. 외부 설정 - 커맨드 라인 옵션 인수}}$

일반적인 커맨드 라인 인수

커맨드 라인에 전달하는 값은 형식이 없고, 단순히 띄어쓰기로 구분한다.

• aaa bbb → [aaa, bbb] 값 2개
• hello world → [hello, world] 값 2개
• "hello world" → [hello world] (공백을 연결하려면 "를 사용하면 된다.) 값 1개
• key=value → [key=value] 값 1개

커맨드 라인 옵션 인수(command line option arguments)

커맨드 라인 인수를 key=value 형식으로 구분하는 방법이 필요하다. 그래서 스프링에서는 커맨드 라인 인수를 key=value 형식으로 편리하게 사용할 수 있도록 스프링 만의 표준 방식을 정의했는데, 그것이 바로 커맨드 라인 옵션 인수이다.

스프링은 커맨드 라인에 -(dash) 2개(--)를 연결해서 시작하면 key=value 형식으로 정하고 이것을 커맨드 라인 옵션 인수라 한다.

• --key=value 형식으로 사용한다.
• --username=userA --username=userB 하나의 키에 여러 값도 지정할 수 있다.

@Slf4j
public class CommandLineV2 {

		public static void main(String[] args) {
				for (String arg : args) {
						log.info("arg {}", arg);
				}
				ApplicationArguments appArgs = new DefaultApplicationArguments(args);
				log.info("SourceArgs = {}", List.of(appArgs.getSourceArgs()));
				log.info("NonOptionArgs = {}", appArgs.getNonOptionArgs());
				log.info("OptionNames = {}", appArgs.getOptionNames());
				Set<String> optionNames = appArgs.getOptionNames();
				for (String optionName : optionNames) {
						log.info("option args {}={}", optionName, appArgs.getOptionValues(optionName));
				}
				
				List<String> url = appArgs.getOptionValues("url");
				List<String> username = appArgs.getOptionValues("username");
				List<String> password = appArgs.getOptionValues("password");
				List<String> mode = appArgs.getOptionValues("mode");
				log.info("url={}", url);
				log.info("username={}", username);
				log.info("password={}", password);
				log.info("mode={}", mode);
		}
}

스프링이 제공하는 ApplicationArguments 인터페이스와 DefaultApplicationArguments 구현체를 사용하면 커맨드 라인 옵션 인수를 규격대로 파싱해서 편리하게 사용할 수 있다.

실행

커맨드 라인 인수를 다음과 같이 입력하고 실행해보자

이해를 돕기 위해 --(dash)가 없는 mode=on이라는 옵션도 마지막에 추가했다.

${\textsf{\color{orange}1.6. 외부 설정 - 커맨드 라인 옵션 인수와 스프링 부트}}$

스프링 부트는 커맨드 라인을 포함해서 커맨드 라인 옵션 인수를 활용할 수 있는 ApplicationArguments를 스프링 빈으로 등록해둔다. 그리고 그 안에 입력한 커맨드 라인을 저장해둔다. 그래서 해당 빈을 주입 받으면 커맨드 라인으로 입력한 값을 어디서든 사용할 수 있다.

CommandLineBean - src/main 하위

@Slf4j
@Component
public class CommandLineBean {

		private final ApplicationArguments arguments;
		
		public CommandLineBean(ApplicationArguments arguments) {
				this.arguments = arguments;
		}
		
		@PostConstruct
		public void init() {
				log.info("source {}", List.of(arguments.getSourceArgs()));
				log.info("optionNames {}", arguments.getOptionNames());
				Set<String> optionNames = arguments.getOptionNames();
				for (String optionName : optionNames) {
						log.info("option args {}={}", optionName, 
						arguments.getOptionValues(optionName));
				}
		}
}

실행

커맨드 라인 인수를 다음과 같이 입력하고 실행해보자

다음을 실행한다. ExternalApplication.main()

실행 결과

실행 결과를 보면, 입력한 커맨드 라인 인수, 커맨드 라인 옵션 인수를 확인할 수 있다.

${\textsf{\color{orange}1.7. 외부 설정 - 스프링 통합}}$

지금까지 살펴본, 커맨드 라인 옵션 인수, 자바 시스템 속성, OS 환경변수는 모두 외부 설정을 key=value 형식으로 사용할 수 있는 방법이다. 그런데 이 외부 설정값을 읽어서 사용하는 개발자 입장에서 단순하게 생각해보면, 모두 key=value 형식이고, 설정값을 외부로 뽑아둔 것이다. 그런데 어디에 있는 외부 설정값을 읽어야 하는지에 따라서 각각 읽는 방법이 다르다는 단점이 있다.
예를 들어서 OS 환경 변수에 두면 System.getenv(key) 를 사용해야 하고, 자바 시스템 속성을 사용하면 System.getProperty(key)를 사용해야 한다. 만약 OS에 환경 변수를 두었는데, 이후에 정책이 변경되어서 자바 시스템 속성에 환경 변수를 두기로 했다고 가정해보자. 그러면 해당 코드들을 모두 변경해야 한다.

외부 설정값이 어디에 위치하든 상관없이 일관성 있고, 편리하게 key=value 형식의 외부 설정값을 읽을 수 있으면 사용하는 개발자 입장에서 더 편리하고 또 외부 설정값을 설정하는 방법도 더 유연해질 수 있다. 예를 들어서 외부 설정 값을 OS 환경변수를 사용하다가 자바 시스템 속성으로 변경하는 경우에 소스코드를 다시 빌드하지 않고 그대로 사용할 수 있다.

스프링은 이 문제를 Environment와 PropertySource라는 추상화를 통해서 해결한다.

스프링의 외부 설정 통합

PropertySource

• org.springframework.core.env.PropertySource
• 스프링은 PropertySource라는 추상 클래스를 제공하고, 각각의 외부 설정를 조회하는 XxxPropertySource 구현체를 만들어두었다.
  • ex)
    • CommandLinePropertySource
    • SystemEnvironmentPropertySource
• 스프링은 로딩 시점에 필요한 PropertySource들을 생성하고, Environment에서 사용할 수 있게 연결해둔다.

Environment

• org.springframework.core.env.Environment
• Environment 를 통해서 특정 외부 설정에 종속되지 않고, 일관성 있게 key=value 형식의 외부 설정에 접근할 수 있다.
  • environment.getProperty(key)를 통해서 값을 조회할 수 있다.
  • Environment는 내부에서 여러 과정을 거쳐서 PropertySource들에 접근한다.
  • 같은 값이 있을 경우를 대비해서 스프링은 미리 우선순위를 정해두었다. (뒤에서 설명한다.)
• 모든 외부 설정은 이제 Environment 를 통해서 조회하면 된다.

설정 데이터(파일)

여기에 우리가 잘 아는 application.properties, application.yml도 PropertySource에 추가된다.
따라서, Environment를 통해서 접근할 수 있다.

@Slf4j
@Component
public class EnvironmentCheck {

		private final Environment env;
		
		public EnvironmentCheck(Environment env) {
				this.env = env;
		}
		
		@PostConstruct
		public void init() {
				String url = env.getProperty("url");
				String username = env.getProperty("username");
				String password = env.getProperty("password");
				log.info("env url={}", url);
				log.info("env username={}", username);
				log.info("env password={}", password);
		}
}

• 커맨드 라인 옵션 인수 실행
  • --url=devdb --username=dev_user --password=dev_pw
• 자바 시스템 속성 실행
  • -Durl=devdb -Dusername=dev_user -Dpassword=dev_pw

ExternalApplication.main을 실행하자.

실행 결과

정리

커맨드 라인 옵션 인수, 자바 시스템 속성 모두 Environment를 통해서 동일한 방법으로 읽을 수 있는 것을 확인했다. 스프링은 Environment를 통해서 외부 설정을 읽는 방법을 추상화했다. 덕분에 자바 시스템 속성을 사용하다가 만약 커맨드 라인 옵션 인수를 사용하도록 읽는 방법이 변경되어도, 개발 소스 코드는 전혀 변경하지 않아도 된다.

우선순위

예를 들어서 커맨드 라인 옵션 인수와 자바 시스템 속성을 다음과 같이 중복해서 설정하면 어떻게 될까?

• 커맨드 라인 옵션 인수 실행
  • --url=proddb --username=prod_user --password=prod_pw
• 자바 시스템 속성 실행
  • -Durl=devdb -Dusername=dev_user -Dpassword=dev_pw

우선순위는 상식 선에서 딱 2가지만 기억하면 된다.

1. 더 유연한 것이 우선권을 가진다. (변경하기 어려운 파일 보다 실행시 원하는 값을 줄 수 있는 자바 시스템
   속성이 더 우선권을 가진다.)
2. 범위가 넒은 것 보다 좁은 것이 우선권을 가진다. (자바 시스템 속성은 해당 JVM 안에서 모두 접근할 수 있
   다. 반면에 커맨드 라인 옵션 인수는 main의 arg를 통해서 들어오기 때문에 접근 범위가 더 좁다.)

자바 시스템 속성과 커맨드 라인 옵션 인수의 경우 커맨드 라인 옵션 인수의 범위가 더 좁기 때문에 커맨드 라인 옵션 인수가 우선권을 가진다.

우선순위는 뒤에서 더 자세히 다루겠다.