'Developing a Spring Framework MVC application step-by-step'에 해당되는 글 5

  1. 2010.01.10 [해석] Developing a Spring Framework MVC application step-by-step Chapter 2. Developing and Configuring the Views and the Controller
  2. 2010.01.10 Developing a Spring Framework MVC application step-by-step 테스트케이스
  3. 2010.01.10 Ant에서 Tomcat Application 실행시키키
  4. 2010.01.10 Developing a Spring Framework MVC application step-by-step 예제 실행하기
  5. 2010.01.09 [해석] Developing a Spring Framework MVC application step-by-step Chapter 1. Basic Application and Environment Setup

[해석] Developing a Spring Framework MVC application step-by-step Chapter 2. Developing and Configuring the Views and the Controller

http://web.archive.org/web/20161120010625/http://docs.spring.io/docs/Spring-MVC-step-by-step/part2.html

Chapter 2. Developing and Configuring the Views and the Controller.pdf


2장. 뷰와 컨트롤러 개발

[todo] 이 부분 빠졌음.

2.1. JSTL과 JSP 헤더 파일 작성

JSTL 관련 라이브러리인 jstl.jar, standard.jar를 WEB-INF/lib/에 복사한다.

앞으로 작성할 모든 JSP에 포함될 헤더파일을 작성한다.
헤더파일을 include해서 모든 JSP 파일에 동일한 구문을 간단하게 넣을수 있다.
모든 JSP 파일을 WEB-INF/jsp/에 넣는다.
URL을 통해서 직접 접근하지 못하고 컨트롤러를 통해서만 뷰에 접근 가능하도록 한다.
이 방법은 어떤 어플리케이션 서버에서는 작동하지 않을지도 모르는데 이 경우 jsp/를 위로 올린다.

우선 모든 JSP에 포함될 헤더파일을 만든다.
'springapp/war/WEB-INF/jsp/include.jsp':

헤더파일을 사용하도록 index.jsp를 수정하면 JSTL을 사용할 수 있으므로 Front Controller로 리다이렉트하는 <c:redirect/> 태그를 사용한다.
이것은 index.jsp에 대한 모든 요청을 어플리케이션 프레임워크로 통하도록 수정한다.
'springapp/war/index.jsp':

hello.jsp를 WEB-INF/jsp/로 옮기고 index.jsp와 동일한 directive를 추가한다.
model에서 가져와서 뷰에 전달된 현재 일자와 시간을 JSTL <c:out/> 태그를 사용하여 출력한다.
'springapp/war/WEB-INF/jsp/hello.jsp':

2.2. Controller 개선

Controller에서 JSP의 위치를 수정하기 전에 단위테스트부터 수정한다.
뷰에 대한 경로를 WEB-INF/jsp/hello.jsp로 수정해야 하고 모델에 now라는 키로 객체를 전달해야 한다.
'springapp/tests/HelloControllerTests.java':

이 상태에서 테스트를 실행하면 당연히 실패한다.
뷰에 대한 경로를 WEB-INF/jsp/hello.jsp로 수정하고 모델에 현재 일자와 시간에 대한 값을 now라는 문자열 키로 담는다.
'springapp/src/springapp/web/HelloController.java'
:

Controller는 springapp-servlet.xml에 이미 설정되어 있기 때문에 수정한 코드를 빌드하고 배포하는데 문제없다.
브라우저에 http://localhost:8080/springapp/를 치면 index.jsp를 호출하고 hello.htm으로 전달된다. 이것은 DispatcherServlet에 의해서 처리된뒤, 페이지 컨트롤러에서 모델에 날짜와 시간을 담고 hello.jsp에서 사용된다.

2.3. Controller에서 View 분리하기

현재 컨트롤러는 뷰에 대한 전체 경로를 명시하고 있는데 이것은 컨트롤러와 뷰 사이에 불필요한 종속성을 만들고 있다.
뷰에 대해 논리적인 이름을 매핑하면 컨트롤러를 수정하지 않고 뷰를 교체할수 있다
ResourceBundleViewResolver나 SimpleUrlHandlerMapping을 사용하면 프로퍼티파일에 이러한 매핑을 설정할수 있다
InternalResourceViewResolver에서는 뷰에 대한 매핑을 접두어, 접미어를 이용해서 간단하게 설정할수 있다
여기서는 두번째 방법으로 구현한다
springapp-servlet.xml에 viewResolver 엔트리를 추가한다.
JstlView를 설정하면 국제화를 지원하는 메세지 리소스 번들를 JSTL과 같이 사용할수 있다.
'springapp/war/WEB-INF/springapp-servlet.xml':

컨트롤러에서 뷰 이름을 수정하고 HelloControllerTests를 실행하면 실패할 것이다.
'springapp/test/springapp/web/HelloControllerTests.java':

컨트롤러에서 사용한 뷰이름에서 접두어와 접미어를 제거하면 컨트롤러는  hello라는  논리적인 이름으로 뷰를 참조하게 된다
이제는 테스트를 통과하게 되고 컴파일해서 배포해서 어플리케이션이 동작하는지 확인한다

2.4. 요약
 
2장에서 작성한 것을 살펴보면
우리가 사용할 JSP페이지에서 사용할 태그 라이브러리 디렉티브를 담고 있는 Include.jsp 헤더 파일을 작성했다.

여기에서 변경한 것은
컨트롤러가 뷰를 참조할때 하드코딩된 이름이 아닌 논리적인 이름으로 참조하도록 HelloControllerTests를 수정하였고
HelloController는 springapp-servlet.xml에 정의된 InternalResourceViewResolver를 사용한 논리적인 이름을 참조한다.

아래는 이런 작업을 한뒤의 프로젝트 디렉토리 구조 스크린샷이다.




Developing a Spring Framework MVC application step-by-step 테스트케이스

- Chapter 1
처음에는 단순히 리턴하는 모델의 뷰이름만 확인한다.

- Chapter 2.2
모델의 뷰이름이 제대로 되었는지 확인하고 모델 데이터가 있는지 확인한다.
- Chapter 2.3

- Chapter 3.2
도메인객체에 대한 테스트

서비스 클래스에 대한 테스트

Ant에서 Tomcat Application 실행시키키

- build.xml

- build.properties
appserver.home=E:/resources/programs/java/apache-tomcat-6.0.18
appserver.lib=${appserver.home}/lib
deploy.path=${appserver.home}/webapps

tomcat.manager.url=http://localhost:8080/manager
tomcat.manager.username=tomcat
tomcat.manager.password=s3cret

- appserver.home/conf/tomcat-users.xml

- 확인
$ ant list
Buildfile: build.xml

list:
     [list] OK - Listed applications for virtual host localhost
     [list] /springapp:running:0:springapp
     [list] /manager:running:0:manager
     [list] /:running:0:ROOT
     [list] /docs:running:0:docs
     [list] /examples:running:0:examples
     [list] /host-manager:running:0:host-manager

BUILD SUCCESSFUL
Total time: 3 seconds

출처 : Developing a Spring Framework MVC application step-by-step

Developing a Spring Framework MVC application step-by-step 예제 실행하기

이클립스에서 실행하기
- Dynamin Web Project로 만든다.
컴파일이 자동으로 되고, 클래스패스를 자동으로 잡아준다.

- Ant는 Outline View에서 실행시킨다.
[todo] 필요없는 target 지우기, 그러나 테스트서버에서는 필요하다. 필요한 target만 여기 적어놔.

- Tomcat은 Server View를 이용한다.

- Test는 단축키(@~x, t)를 이용한다.

IDE 사용하지 않고 실행하기
- Ant를 이용한다.

[해석] Developing a Spring Framework MVC application step-by-step Chapter 1. Basic Application and Environment Setup

http://web.archive.org/web/20161119155731/http://docs.spring.io/docs/Spring-MVC-step-by-step/part1.html

Chapter&nbsp;1.&nbsp;Basic Application and Environment Setup.pdf


1장. 기본 어플리케이션 및 환경설정

1.1. 프로젝트 디렉토리 생성

모든 소스와 작성할 파일을 저장할 디렉토리를 springapp/라고 하자.
자바소스를 저장할 src/를 만든다.
어플리케이션을 패키징하고 배포할 WAR에 들어갈 모든 파일을 저장할 war/를 만든다.
war/에는 자바소스를 제외한 JSP 소스, 설정파일이 저장된다.

1.2. index.jsp 작성하기

아주 간단한 index.jsp를 war/에 작성하자.
index.jsp는 우리가 만드는 어플리케이션의 시작점이 된다.
'springapp/war/index.jsp': war/에 WEB-INF/를 만들고 WEB-INF/ 아래에 web.xml을 만든다.
'springapp/war/WEB-INF/web.xml':
1.3. Tomcat에 배포하기

이 Tutorial에서 계속 사용될 Ant 빌드 스크립트를 만들자.
이 빌드 스크립트에는 컴파일, 빌딩, 배포하는 타겟이 있고, 일부는 특정 서버에만 사용되는 것도 있다.
'springapp/build.xml': Tomcat이 아닌 다른 WAS를 사용한다면 빌드 스크립트 마지막 부분은 지워도 된다.
WAS의 hot deploy 특성에 따르거나, 직접 서버를 내렸다 올려야 한다.

IDE를 사용한다면 build.xml의 Tomcat 타겟에 에러 표시가 보일지도 모르는데 무시해도 된다.

Ant 빌드 스크립트가 개발을 좀더 쉽게 할 수 있게 도와 줄것이다.
여기에 사용된 대부분의 내용은 Ant나 Tomcat의 기본적인 내용이므로 자세한 설명은 생략한다.
빌드 파일 내용을 springapp/에 build.xml에 넣기만 하면 된다.
그리고 같은 위치에 build.properties를 만들고 서버가 설치된 위치를 맞춘다.
'springapp/build.properties':
# Ant properties for building the springapp

appserver.home=${user.home}/apache-tomcat-6.0.14
# for Tomcat 5 use $appserver.home}/server/lib
# for Tomcat 6 use $appserver.home}/lib
appserver.lib=${appserver.home}/lib

deploy.path=${appserver.home}/webapps

tomcat.manager.url=http://localhost:8080/manager
tomcat.manager.username=tomcat
tomcat.manager.password=s3cret

당신이 시스템에 Tomcat을 설치하지 않았다면 Tomcat 소유주가 appserver.home/webapps/에 대해 모든 권한을 줘야 한다.
또는 소유주가 appserver.home/webapps/springapp/를 만들고 이 디렉토리에 모든 권한을 줘야 한다.
리눅스에서는 chmod a+rwx springapp 라는 명령어를 사용하면 모든 사용자에게 모든 권한을 줄수 있다.

'appserver.home/conf/tomcat-users.xml'에 사용자를 추가한다. 이제 모든 준비가 다 되었고 springapp/에서 ant 명령을 실행시킨다.
빌드하거나 배포하려면 deploy나 deploywar 타겟을 실행시킨다.

1.4. 어플리케이션 확인

${appserver.home}/bin/startup.bat 을 실행시켜서 Tomcat을 시작하자.
Tomcat이 우리가 만든 어플리케이션을 올렸는지 list 태스크로 확인할 수 있다.

브라우저로 http://localhost:8080/springapp/index.jsp을 열어보자.

1.5. Spring 프레임워크 다운로드

Spring Framework 2.5를 다운로드 받고 적당한 곳에 압축을 푼다.

1.6. web.xml 수정

springapp/war/WEB-INF/web.xml을 수정한다.
Front Controller인 DispatcherServlet을 설정한다.
나중에 설정할 정보에 기반하여 보내질 모든 요청을 처리한다.
이 서블릿 정의는 servlet-mapping 엔트리로 여기서 사용될 URL 패턴을 매핑한다.
우리는 htm 확장자를 가진 모든 URL을 springapp 서블릿으로 보내도록 설정한다.
'springapp/war/WEB-INF/web.xml':

springapp-servlet.xml을 springapp/war/WEB-INF/에 만든다.
이 파일은 DispatcherServlet에서 사용되는 빈에 대한 정의를 한다.
모든 웹 관련 컴포넌트가 사용할 WebApplicationContext이다. =-=> ???
이 파일의 이름은 web.xml 의 servlet-name 엘리먼트에 -servlet을 붙여서 만든다.
이것은 Spring Web MVC 프레임워크의 표준 명명법이다.
이제 /hello.htm 에 대한 빈을 설정하고 class는 springapp.web.HelloController로 하자.
이것은 /hello.htm 이라는 URL에 대한 요청을 controller가 처리하게 한다.
Spring Web MVC 프레임워크는 요청 URL과 처리할 객체를 매핑하는데 HandlerMapping 인터페이스 구현체를 사용한다.
DispatcherServlet과 달리 HelloController는 특정 페이지에 대한 요청을 처리한다.(Fowler는 이것을 Page Controller라고 한다.)
DispatcherServlet이 사용하는 기본적인 HandlerMapping은 BeanNameUrlHandlerMapping이다.
이 클래스는 빈이름을 요청의 URL과 매핑해서 DispatcherServlet이 어떤 컨트롤러를 호출할지 알려준다.
'springapp/war/WEB-INF/springapp-servlet.xml':

1.7. WEB-INF/lib에 라이브러리 복사하기

war/WEB-INF/lib/를 만들고 Spring 배포본에서 spring.jar, spring-webmvc.jar, commons-logging.jar를 복사해 넣는다.
이 라이브러리는 서버에 배포되고 빌드에 사용된다.

1.8. Controller 만들기

springapp.web 패키지에 HelloController를 만든다.
src/springapp/web/에 HelloController.java를 만든다.
'springapp/src/springapp/web/HelloController.java':

이것은 아주 기본적인 Controller 구현이다.
우리는 나중에 Spring에서 제공하는 Controller 구현체를 구현해서 확장할 것이다.
Spring Web MVC에서 Controller는 요청을 처리하고 ModelAndView를 리턴한다.
이 경우에는 hello.jsp이다.
이렇게 리턴한 모델은 ViewResolver에 의해서 수행된다.
우리는 명시적으로 ViewResolver를 지정하지 않았기 때문에 Spring에 기본적으로 제공된다.(view 이름에 해당하는 URL로 포워딩한다.)
이 핸들러로 실제로 요청이 왔는지 로거를 찍어본다.
Tomcat을 사용하면 로그가 appserver.home/log/catalina.out에 출력된다.

IDE를 사용하면 lib/의 jar파일을 빌드 패스에 추가해야 한다.
서블릿 컨테이너의 servlet-api.jar도 추가해야 HelloController.java가 제대로 컴파일된다.

1.9. Controller에 테스트 작성하기

테스트는 소프트웨어 개발에 있어서 필수적이다.
애자일 개발에 있어서도 핵심 practice이다.
controller에 복잡한 로직을 넣기 전에 테스트를 작성한다.
테스트는 개발이 진행됨에 따라 변경에 대한 신뢰를 줄수 있다.
springapp/ 아래에 test/를 만들어서 테스트를 작성한다.

HelloControllerTests 테스트 클래스를 만들고 JUnit의 TestCase를 상속한다.
단위 테스트는 handleRequest()가 리턴하는 뷰이름이 hello.jsp인지 확인한다.
'springapp/test/springapp/web/HelloControllerTests.java':

테스트를 실행시키려면, build.xml에 테스트 태스크를 추가한다.
우선 junit.jar를 복사해서 넣는다.
테스트를 컴파일하고 실행시키는 태스크를 하나로 두는 대신 buildtests와 tests로 나눈다.
springapp/resourcs/devlib/를 두고 여기에 junit.jar를 넣는다.

build.xml에 다음의 내용을 추가한다.
<property name="resources.dir" value="resources"/>
<property name="devlib.dir" value="${resources.dir}/devlib"/>
...
<path id="devlib-classpath">
    <fileset dir="${devlib.dir}">
        <include name="*.jar"/>
    </fileset>
</path>

buildtests, tests 타겟에 <classpath refid="devlib-classpath"/>를 추가한다.

IDE에서 테스트를 실행시키려면 junit.jar를 빌드 패스에 추가한다.
'springapp/build.xml':

애자일의 또다른 practice는 지속적인 통합이다.
빌드할 때마다 테스트를 실행시켜서 개발이 진행되면서 어플리케이션이 제대로 동작하는지 확인할 수 있다.

1.10. View 작성하기

이미 앞에 언급된대로 hello.jsp로 포워딩한다.
war/에 둔다.
'springapp/war/hello.jsp':

1.11. 어플리케이션 컴파일, 배포

depoy 타겟을 실행시키고 reload 타겟을 실행시키면 빌드하고 Tomcat을 리로드한다.
Ant 출력과 Tomcat 로그를 확인한다.

1.12. 어플리케이션 테스트

브라우저로 http://localhost:8080/springapp/hello.htm 으로 들어가본다.

1.13. 요약

  • 설정이 제대로 되었는지 확인하기 위해 index.jsp를 만들었다. 나중에 실제 링크가 있는 페이지로 만들것이다.
  • DispatcherServlet과 springapp-servlet.xml
  • 지금은 단순히 ModelAndView만 리턴하는 HelloController. 나중에 model을 구현한다.
  • 뷰이름을 검증하기 위한 HelloControllerTests
  • 아주 간단한 hello.jsp