SiteMesh를 이용한 레이아웃 템플릿 처리, 설치 및 세팅, 데코레이터 설정 방법 학습!!

2020-04-22 15:37:19
프로그래밍
By 초이

가이드문구

SiteMesh를 이용한 레이아웃 템플릿 처리, 설치 및 데코레이터 설정 방법

- SiteMesh란?

웹 어플리케이션은 수십에서 수백 개의 화면으로 구성되는데 이 화면들 중 상당수는 동일한 레이아웃과 공통된 영역을 갖는다.

모든 JSP 페이지가 공통된 영역에 대한 코드를 갖고 있을 경우 아주 작은 변화만으로도 전체 JSP 페이를 변경해주어야 하는 문제가 발생할 수 있다. 이런 문제를 해소하기 위해 <jsp:include>를 사용해서 공통된 부분을 별도의 JSP로 분리해 내기도 하지만, 레이아웃 자체를 변경하거나 새로운 공통 영역을 추가해야 할 경우 전체 JSP 페이지를 변경해주어야 하는 부담이 남게 된다.

레이아웃 자체를 템플릿으로 만들어 적용하는 방법을 많이 사용하고 있는데, 레이아웃 템플릿을 만들어주는 기술 중의 하나로 SiteMesh가 있다.

SiteMesh는 공통으로 적용될 레이아웃과 구성 요소를 정의하고 있는 데코레이터를 응답 결과에 적용하는 방식으로 동작한다.

데코레이터는 레이아웃 코드 및 헤더와 몸체가 삽입될 위치 정보로 구성된다. 어떤 생성 화면이든지 데코레이터를 적용하기만 하면 데코레이터에 정의된 레이아웃과 공통 영역이 적용된 응답 결과를 볼 수 있게 된다.

1. SiteMesh 설치

http://wiki.sitemesh.org/display/sitemesh/Download 에서 jar 파일을 받은 뒤에 WEB-INF/lib 폴더에 복사한다.

- SiteMesh를 사용한 템플릿 구현 기초

1. web.xml 파일에 SiteMeshFilter 설정 추가

2. SiteMesh 설정 파일 작성

3. 데코레이터 설정 파일 작성

4. 데코레이터JSP 작성

1. web.xml 파일에 SiteMeshFilter 설정 추가

SiteMesh는 필터라는 것을 이용해서 응답 결과에 데코레이터를 적용한다. 따라서 필터를 web.xml 파일에 설정해주어야 한다.

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="chap19" version="3.0">
 <filter>
  <filter-name>sitemesh</filter-name>
 <filter-class>
    com.opensymphony.sitemesh.webapp.SiteMeshFilter
</filter-class>
 </filter>
 <filter-mapping>
  <filter-name>sitemesh</filter-name>
  <url-pattern>/*</url-pattern>
 </filter-mapping>
</web-app>

2. sitemesh.xml 파일 설정

sitemesh.xml 파일은 SiteMesh 자체의 설정 파일이다. 이 파일에서는 데코레이터 설정 정보를 관리하기 위한 DecoratorMapper 설정을 하게 된다.

설정 파일에 대한 별도 설정이 없을 경우, SiteMesh가 사용하는 설정 파일의 경로는 /WEB-INF/sitemesh.xml이다.

<sitemesh>
	<property name="decorators-file" value="/WEB-INF/decorators.xml" />
	<excludes file="${decorators-file}" />
	<page-parsers>
		<parser content-type="text/html" class="com.opensymphony.module.sitemesh.parser.HTMLPageParser" />
	</page-parsers>
	<decorator-mappers>
	 <mapper
	  class="com.opensymphony.module.sitemesh.mapper.ConfigDecoratorMapper">
	  <param name="config" value="${decorators-file}" />
	 </mapper>
	</decorator-mappers>
</sitemesh>

11 라인의 ConfigDecoratorMapper는 파일을 이용해서 데코레이터를 설정한다.

설정 파일의 경로를 변경하고 싶다면 2라인의 decorators-file 프로퍼티의 값을 변경하거나 12라인에서 value 속성의 값을 직접 변경하면 된다.

3라인의 <exclude> 태그는 데코레이터를 적용하지 않을 경로 정보를 담고 있는 파일을 지정할 때 사용된다.

3. 데코레이터 설정 파일

<?xml version="1.0" encoding="euc-kr" ?>
	<decorators defaultdir="/decorator">
	<decorator name="main" page="hello_decorator.jsp">
		<pattern>/hello.jsp</pattern>
		<pattern>/hello/*</pattern>
	</decorator>
	<decorator name="news" page="/decorator2/news_decorator.jsp">
		<pattern>/news/*</pattern>
	</decorator>
	<excludes>
		<pattern>/hello/exclude.jsp</pattern>
		<pattern>/news/exclude.jsp</pattern>
	</excludes>
</decorators>

<decorator> 태그의 name 속성과 page 속성은 각각 데코레이터의 이름과 데코레이터로 사용할 JSP 파일을 지정한다. 데코레이터 파일의 경로가 "/"로 시작하지 않을 경우 3번 라인의 defaultdir 속성으로 지정한 경로를 기준으로 데코레이터 파일 경로가 설정된다.

4. 데코레이터 파일 작성

데코레이터는 일반적인 JSP와 동일하게 구현하는데, 차이점이 있다면 SiteMesh가 제공하는 커스텀 태그를 이용해서 문서 제목, <head> 내용, <body> 내용의 삽입할 위치를 지정한다는 것이다.

EX) <%@ taglib prefix="decorator" uri="http://www.opensymhony.com/sitemesh/decorator" %>

는 데코레이터 기능을 제공하는 커스텀 태그를 설정한다. 커스텀 태그를 설정하면 아래의 커스텀 태그를 이용해서 데코레이터 기능을 넣을 수 있다.

<decorator:title> : 데코레이터가 적용될 응답 화면의 <title> 태그의 값이 삽입된다.

<decorator:head> : 데코레이터가 적용될 응답 화면의 <head> 태그의 (title을 제외한) 내용이 삽입된다.

<decorator:body> : 데코레이터가 적용될 응답 화면의 <body> 태그의 내용이 삽입된다.