스프링부트 Spring Boot, HelloWorld, Spring Starter Project, spring-boot-starter-web, 자바교육, 스프링교육,JAVA학원, 스프링학원, 자바학원
http://ojc.asia/bbs/board.php?bo_table=LecJpa&wr_id=360
ojc.asia
https://www.youtube.com/watch?v=cOH-DVAuBes&list=PLxU-iZCqT52Bihgf3v1bg5xEYeCwFQ_Zz&index=1
https://www.youtube.com/watch?v=7ZDW5gOIJKs&list=PLxU-iZCqT52Bihgf3v1bg5xEYeCwFQ_Zz&index=2
https://www.youtube.com/watch?v=PKO-e2mgQfc&list=PLxU-iZCqT52Bihgf3v1bg5xEYeCwFQ_Zz&index=3
https://www.youtube.com/watch?v=sgJUROeXIWg&list=PLxU-iZCqT52Bihgf3v1bg5xEYeCwFQ_Zz&index=4
Spring Boot
기본적인 프로젝트 스캐폴딩 도구로 빠른개발을 위한 스프링 프레임워크 서브 프로젝트 중에 하나인 Spring Boot를 사용하겠습니다. 스프링 부트는 Convention over Configuration개념을 적용하여 개발자가 처리해야 하는 반복적인 성격의 설정작업을 대신 수행하여 개발자의 수고를 덜어주는 기술입니다.
최근 개발 초기단계에서부터 코드작성을 하지는 않습니다. 처음부터 코드를 작성하면 나중에 소스 코드 덩치가 커지거나 협업을 해야 하거나 배포를 해야 할 때 관리상의 문제가 많이 생긴다는 것을 개발자들은 이미 경험으로 알고 있기 때문입니다. 그러한 이유로 코드를 작성하기 전에 먼저 코드, 리소스, 디펜던시, 연동환경 및 테스트를 거친 후 배포작업을 미리 염두에 두고 구조적으로 프로젝트를 구분하는 스캐폴딩 작업을 선행합니다.
프로젝트 관점에서 살펴보면 실제 코드를 작성하기 전에 해야 할 여러 설정 작업들이 도출 됩니다. 스프링부트는 여러 설정작업들 중 개발자를 대신해 관습을 적용하여 자동화 할 수 있는 부분들을 제공하는 기술로써, 개발자의 수고를 덜어 보다 빠른 개발이 진행될 수 있도록 해줍니다.
여러분이 Querydsl 학습에 집중할 수 있도록 스프링 부트를 스캐폴딩 툴로 사용하겠습니다.
프로젝트 생성
먼저 스프링 부트에 익숙해지기 위해서 간단한 프로젝트를 하나 만들어 보겠습니다. 전통적인 방법에 따라 브라우저가 서버에 요청하면 "Hello World" 메시지를 브라우저에게 보내주는 웹서비스를 만들어 보겠습니다.
File > New > Spring Starter Project
프로젝트명: chapter1-1
화면의 정보를 살펴봅니다. Maven을 디펜던시 및 빌드 도구로 사용하고 Jar로 패키징해서 배포합니다. 자바버전은 1.8이고 프로젝트 구성 시 패키지가 com.example로 만들어진다는 것을 알 수 있습니다. 기본 설정을 그대로 두고 "Next" 버튼을 클릭합니다.
디펜던시 선택
다음 화면에서 왼쪽부분 ▶ 대분류 메뉴를 클릭하면 선택할 수 있는 상세 메뉴가 표시됩니다.
선택 디펜던시 : Web
"Finish" 버튼을 눌러서 스프링 부트로 프로젝트를 생성하는 작업을 마칩니다.
처음에는 로컬 저장소의 디펜던시들이 없을것이므로 첫 프로젝트는 생성완료까지 시간이 다소 걸릴 수 있습니다.
디펜던시 확인
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>com.example</groupId>
<artifactId>boot</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.4.1.RELEASE</version>
<relativePath /> <!-- lookup parent from repository -->
</parent>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
스프링 부트는 web 개발의 필요한 여러 디펜던시들을 하나의 대표 디펜던시 "spring-boot-starter-web"로 한번에 모두 설정할 수 있게 해 줍니다. 더불어 디펜던시들의 버전관리도 스프링 부트가 <parent> 태그설정으로 직접 관리하므로 따로 명기할 필요가 없습니다. 스프링 부트가 디펜던시들의 버전을 관리함으로써 더 이상 개발자가 디펜던시의 충돌현상으로 머리 아플 일은 없을 것입니다.
<artifactId>spring-boot-starter-test</artifactId>
개발 시 테스트는 항상 수행되어야 하는 업무이므로 자동으로 테스트 디펜던시가 추가됩니다.
<artifactId>spring-boot-maven-plugin</artifactId>
Maven이 빌드작업을 수행함으로써 메이븐에서 스프링 부트를 다룰 수 있는 플러그인이 자동으로 추가되었습니다.
Dependency Hierarchy
pom.xml의 Dependency Hierarchy 화면을 보면 spring-boot-starter-web, spring-boot-starter-test 2개의 대표 디펜던시 밑으로 해당 개발 카테고리에 필요한 수십 개의 디펜던시들이 설정되어 있는 것을 알 수 있습니다. spring-core 디펜던시 옆에 버전 부분을 살펴보면 사용하는 스프링 버전은 4.3.3.RELEASE라는 것을 알 수 있습니다.
프로젝트 환경설정
스프링 부트는 기본적으로 XML파일을 사용하지 않습니다. 스프링 부트는 Java-config와 어노테이션 방식의 설정을 선호합니다. 스프링 부트는 application.properties 파일이나 application.yml 파일을 자주 사용하는 기술의 설정작업을 위한 설정파일로 제공합니다.
application.properties
프로퍼티 파일에서 #은 주석기호 입니다.
#java -jar yourapp.jar -Dserver.contextPath=/your/path/here
server.contextPath=/chapter1-1
server.port=8080
server.port 를 지정하지 않으면 디폴트로 8080 포트를 사용하므로 위 설정은 하든 안하든 결과가 같습니다. server.contextPath를 지정했으므로 웹서비스에 접속할 때 사용할 URL은 다음처럼 컨텍스트 패스까지 사용해야 합니다.
http://localhost:8080/chapter-1
컨텍스트 패스를 명시적으로 설정하지 않는다면 도메인만 사용해서 접근해야 합니다. Jar 파일을 사용하여 기동 시 "-Dserver.contextPath=/your/path/here" 옵션을 사용하여 컨텍스트 패스를 변경할 수 있고 웹서버의 포트를 변경하고자 한다면
"-Dserver.port=8090"처럼 사용하면 됩니다.
Presentation Layer
사용자의 요청 URL을 처리할 URL Handler인 컨트롤러 클래스를 작성합니다. 스프링 프레임워크를 사용한다면 개발자는 URL에 따라 대응하는 메소드를 작성하는 작업에만 신경쓰고 나머지는 모두 스프링이 미리 만들어 놓은 로직을 그대로 이용하는 방식으로 개발이 진행됩니다. 여기서는 컨트롤러가 환영메시지 문자열을 브라우저에게 전달하는 기능을 추가합니다.
HomeRestController.java
package com.example.common.controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HomeRestController {
@RequestMapping("/")
public String home(){
return "welcome home";
}
}
컨트롤러 클래스에 @RestController 어노테이션을 붙였으므로 해당 클래스는 빈 컨테이너에 등록되고 URL Handler 역할을 수행합니다. @RequestMapping("/") 어노테이션 설정으로 서버에 루트("/")로 접근 시 "welcome home" 문자열을 브라우저에 전달합니다.
테스트
스프링 부트로 프로젝트 생성 시 자동으로 만들어진 클래스 Chapter11Application.java 파일을 살펴보면 자바의 기동메소드인 main메소드가 존재합니다.
이 main메소드가 전체 애플리케이션의 엔트리 포인트입니다. 즉 프로젝트 시작을 담당하는 클래스가 노출되어 있으므로 웹서비스 시작 시 수행이 필요한 로직을 여기에 추가할 수 있습니다. 부트(Boot)라는 용어 자체가 시작이라는 의미를 갖고 있습니다.
"Run As > Java Application" 메뉴를 선택하여 웹서비스 프로그램을 기동합니다. 자바의 main 기동 메소드를 사용해 커다란 애플리케이션을 부트하는 것입니다.
http://localhost:8080/chapter1-1/ 으로 접근하여 다음 메시지를 볼 수 있는지 확인합니다.
실제로 개발자가 작업한 부분은 application.properties와 HomeRestController.java가 전부이므로 스프링 부트로 개발하면 빠르게 웹 서비스를 구축할 수 있다는 것을 알 수 있습니다.
부트 프로젝트를 기동하는 방법이 하나 더 있습니다.
"프로젝트 선택 > 마우스 오른쪽 클릭 > Run As > Spring Boot App" 메뉴를 선택해서 부트 프로젝트를 시작할 수도 있습니다.
JSP 연동
최근에는 JSP를 대체할 수 있는 기술들이 많이 나와 있어서 JSP 사용비율이 점점 떨어지고 있는 추세입니다. 그러나 JSP가 자바표준 HTML 템플릿 엔진임에는 틀림이 없으므로 학습적인 차원에서는 여전히 중요하다고 볼 수 있습니다.
스프링 부트에서 JSP 연동작업을 해 보도록 하겠습니다.
pom.xml
다음 디펜던시 2개를 설정파일에 추가합니다. 버전은 스프링 부트 프로젝트인 경우 명시하지 않아도 됩니다.
<!-- JSP를 처리한다. -->
<dependency>
<groupId>org.apache.tomcat.embed</groupId>
<artifactId>tomcat-embed-jasper</artifactId>
<scope>provided</scope>
</dependency>
<!-- JSP 내에서 JSTL 확장 태그 라이브러리를 사용한다. -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
</dependency>
다음 작업으로 JSP 뷰와의 연동처리를 위한 컨트롤러를 하나 추가합니다.
HomeController.java
package com.example.common.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class HomeController {
@RequestMapping("/")
public String home(){
return "welcome";
}
}
뷰의 실제 위치는 웹 루트 밑으로 여러 폴더들을 두고 그 아래에 배치하는 것이 일반적입니다. 따라서 컨트롤러에서 리턴하는 뷰의 이름은 컨텍스트 루트 다음 패스부터 view.jsp까지 명기해야 합니다. 이를 뷰의 이름만으로 짧게 리턴해도 되도록 스프링 컨트롤러가 리턴하는 문자열로 된 뷰이름을 가지고 뷰의 위치를 뷰 리졸버(View resolver)에게 문의하면 뷰의 위치를 가리키는 문자열을 완성하여 알려주는 역할을 수행하는 뷰 리졸버(View resolver) 설정을 추가합니다.
application.properties
spring.mvc.view.prefix=/WEB-INF/jsp/
spring.mvc.view.suffix=.jsp
하나의 URL 요청에 대응하는 메소드가 두 개인 경우, 어느 메소드가 처리해야 할지 판단할 수 없습니다. 현재까지 작업으로 보면 HomeController와 HomeRestController 에 각각 루트("/") 요청에 대응하는 코드가 설정되어 있습니다. 따라서 어느 하나를 수정해야 합니다.
기존 HomeRestController.java 파일을 수정 합니다.
HomeRestController.java
package com.example.common.controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HomeRestController {
@RequestMapping(value={"/"}, params="plain")
public String homeForPlain(){
return "welcome home";
}
@RequestMapping(value={"/"}, params="json")
public String homeForJson(){
return "{\"message\" : \"welcome home\"}";
}
}
스프링의 강력한 URL 매핑 기능 중에 전달되는 파라미터에 따라서 대응하는 메소드를 지정할 수 있는 기능을 사용합니다.
다음 작업으로 뷰에 역할을 수행하는 JSP 파일을 작성합니다.
welcome.jsp
파일위치 : src/main/webapp/WEB-INF/jsp/welcome.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Welcome Home</title>
</head>
<body>
<h2>welcome.jsp</h2>
</body>
</html>
테스트
컨텍스트 패스까지 URL로 사용해서 서버에 접속하면 JSP 파일과 연동됩니다.
이 요청은 @RequestMapping("/") 설정이 붙어 있는 메소드가 처리합니다.
파라미터로 "json" 문자열을 추가하면 결과로 JSON 포맷의 문자열을 받습니다.
@RequestMapping(value={"/"}, params="json") 설정이 붙어 있는 메소드가 처리합니다.
파라미터로 "plain" 문자열을 사용하면 결과로 평범한 문자열을 받습니다.
@RequestMapping(value={"/"}, params="plain") 설정이 붙어 있는 메소드가 처리합니다.
지금까지 스프링 부트로 프로젝트를 만들어서 사용하는 방법을 간단히 살펴 보았습니다.
#스프링부트, #SpringBoot, #HelloWorld, 스프링부트, SpringBoot, HelloWorld
