Quickstart_kor

Quickstart

1. IDE 설치

개발 편의를 위해서 IDE에서 시작해보자. Milonga는 Spring 기반에서 동작하기 때문에 Spring 개발에 편리한 Spring Tool Suite(STS)를 설치한다.

2. Spring MVC Maven 프로젝트 생성

Spring MVC 프로젝트를 생성하자. 메뉴의 File → New → Spring Project를 클릭한다. Project name을 입력하고 Template으로 Spring MVC Project를 선택한 후 Next 버튼을 클릭한다.

적절한 패키지 명을 입력한 후 Next 버튼을 클릭한다.

Spring MVC Project가 생성되었다.

3. Milonga 설치

Milonga는 Spring MVC 3.2.3 이상에서 동작한다. pom.xml 파일을 열어 Spring 버전을 변경한다.

<properties>
	<java-version>1.6</java-version>
	<org.springframework-version>3.2.3.RELEASE</org.springframework-version>
	<org.aspectj-version>1.6.10</org.aspectj-version>
	<org.slf4j-version>1.6.6</org.slf4j-version>
</properties>

pom.xml 파일에 Milonga 설치를 위한 Repository와 Dependency를 추가한다.

<?xml version="1.0" encoding="UTF-8"?>
<project>

	…
	
	<dependencies>

	…
		<!-- Milonga 추가 -->
		<dependency>
			<groupId>com.skplanet</groupId>
			<artifactId>milonga</artifactId>
			<version>0.11.0</version>
		</dependency>
	</dependencies>
	
	…
	
</project>

4. Spring Configuration for Milonga

Milonga를 사용하기 위해서 Spring 설정에 Milonga에 대한 내용을 등록해야 한다. Milonga 설치는 Spring의 설정 방식에 따라 다음의 2가지 방법이 있다.

• Spring XML 설정

Milonga에서 제공하는 커스텀 태그를 이용하여 설정한다. servlet-context.xml 파일에 아래와 같이 추가한다.

<beans:beans xmlns="http://www.springframework.org/schema/mvc"
	...
	xmlns:milonga="http://www.skplanet.com/schema/milonga"
	xsi:schemaLocation="http://www.springframework.org/schema/mvc ...
		...
		http://www.skplanet.com/schema/milonga http://www.skplanet.com/schema/milonga/milonga.xsd">
	...
	<!-- Enables Milonga Beans -->
	<milonga:milonga>
		<milonga:location>WEB-INF/js</milonga:location>
		<milonga:autoRefreshable value="true"/>
	</milonga:milonga>
</beans:beans>

• Spring Java 설정

Milonga에서 제공하는 Annotation을 이용하여 Spring Java 설정에 Milonga를 등록하는 방법이다.

...
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
...

import com.skp.milonga.config.annotation.EnableMilonga;

@Configuration
@EnableWebMvc
@EnableMilonga(locations = "WEB-INF/js-test", autoRefreshable = true)
public class AppConfig extends WebMvcConfigurerAdapter {

	...
	
}

여기까지 진행되면 Milonga에 대한 설치가 완료되었다.

5. Javascript 코드 작성

Javascript 파일을 생성하여 핸들러 코드를 작성해보자. WEB-INF/js 경로 아래에 sample.js 파일을 하나 생성하고 코드를 작성하여 저장한다.

6. 결과 확인

tc Server에 프로젝트를 배포하여 구동시킨다. 구동 시킨 후 브라우저에서 결과를 확인한다.