spring boot 소개및 JSP 연동 실습예제

spring boot 소개및 JSP 연동 실습예제

http://ojc.asia/bbs/board.php?bo_table=LecSpring&wr_id=838

1.2.1. 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") 설정이 붙어 있는 메소드가 처리합니다.

지금까지 스프링 부트로 프로젝트를 만들어서 사용하는 방법을 간단히 살펴 보았습니다. 다음으로 데이터베이스 처리기술의 발전역사를 코드를 살펴보면서 설명하겠습니다.

"Let there be code!"​

왜 Querydsl인가?

왜 Querydsl인가?

http://ojc.asia/bbs/board.php?bo_table=LecJpa&wr_id=334

 

왜 Querydsl인가?

왜 Querydsl인가? 자바 JDBC부터 JPA, Querydsl까지 데이터베이스를 다루기 위한 기술은 변천을 거듭했습니다. 최근 JPA에 대한 사용이 늘어가는 추세에 맞춰 오픈소스 JPQL Builder인 Querydsl의 사용이 늘어나고 있죠, 기존 SQL문을 문자열로 직접 입력하거나 XML등으로 빼서 매퍼 형태로 처리하는 방식을 벗어나 자바 개발자들…

ojc.asia

자바 JDBC부터 JPA, Querydsl까지 데이터베이스를 다루기 위한 기술은 변천을 거듭했습니다.

최근 JPA에 대한 사용이 늘어가는 추세에 맞춰 오픈소스 JPQL Builder인 Querydsl의 사용이 늘어나고 있죠, 기존 SQL문을 문자열로 직접 입력하거나 XML등으로 빼서 매퍼 형태로 처리하는 방식을 벗어나 자바 개발자들이 편하게 쿼리를 작성할 수 있도록 지원하고, 유지보수 또한 유리한 Querydsl은 개발의 새로운 쿼리작성의 트랜드로 자리매김 하고 있습니다.

Querydsl은 다음과 같은 장점이 있습니다.

JPA, JDO, MongoDB, Java Collection, Hibernate Search등에서 지원하며 Spring Data 프로젝트에서 지원하는 오픈소스 프로젝트 입니다.

Criteria와 비슷하지만 훨씬 사용하기 편한 JPQL을 위한 빌더이며 쿼리 작성시 타입 세이프(Type Safe)한 방식의 메소드 기반으로 SQL구문을 만들 수 있으므로 컴파일 시점에 기본 문법오류에 대한 디버깅이 가능하며 작성되어진 쿼리에 대한 해석 역시 쉬워 유지보수 역시 편리 합니다.

이런 분들에게 추천 합니다.

Spring Framework 환경에서 개발을 하는 분들 중 기존의 Spring JDBC, MyBatis 사용 방식을 벗어나 새로운 방식의 데이터베이스 접근법을 원하시거나, JPA, Spring Data JPA에 관심이 있는 분들에게 자바의 메소드 기반으로 쿼리를 만들 수 있는 Querydsl 사용을 추천 합니다. 그리고 기존 개발된 스프링 프레임워크, 마이바티스 환경을 새로운 JPA 환경으로 변환하고자 하는 모든 분들에게 새로운 쿼리 작성방법인 Querydsl을 강력히 추천 합니다. 특히 기존 Legacy 시스템을 그대로 운영하면서 JPA 환경으로 전환하고자 할 때 데이터베이스 테이블을 엔티티나 Qtype으로 역으로 변환하여 편리하게 Spring Data JPA, Querydsl로 개발을 할 수 있는 장점을 제공 합니다.