====== 캐시 설정관리 ======

===== 1. 개요 ======
캐시 설정관리는 전자정부표준프레임워크 실행환경에서 제공하는 캐시서비스를 이용하기 위한 설정 파일을 관리할 수 있는 기능을 제공한다.
전자정부 표준 프레임워크에서의 캐시 서비스는 EhCache 를 이용하여 서비스 되고 있으며 캐시 설정관리 부분에서는 Spring과 EhCache를 
Integration 하기 위한 설정을 관리하며 EhCache 세부 설정은 EhCache 설정 메뉴에서 다시 다룬다.

전자정부 표준프레임워크의 캐시서비스에 대한 자세한 내용은 [[https://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte:fdl:cache]] 참고한다.

===== 2. 설명 ======
==== 캐시 설정관리 ====
설정관리에서 캐시 관리는 실제 EhCache 에 대한 설정을 읽어 들여서 Spring 이 처리할 수록 도와주는 Integration 관련된 설정이다.
관련 프로퍼티는 클래스 패스 내에 있는 EhCache 설정 파일의 위치를 명시하는 ConfigLocation 이 있다.
=== 캐시 설정관리 목록 조회 ===
설정관리 도구 메인화면 >> 좌측 메뉴 >> 캐시 설정관리 >> 캐시 설정


== 캐시 설정파일 과 설정관리 화면 비교 ==
    * context-Cache.xml
<code xml>
	<bean id="ehcache" class="org.springframework.cache.ehcache.EhCacheFactoryBean">
      <property name="cacheManager">
         <bean class="org.springframework.cache.ehcache.EhCacheManagerFactoryBean">
            <property name="configLocation" value="classpath:ehcache-default.xml"/>
         </bean>
      </property>    
   </bean>
</code>

    * 설정관리 도구 표현
아래와 같이 설정파일에 표현된 Bean Name 별로 목록을 보여주며 해당 Bean 명을 클릭하면 각 빈의 상세 설정을 조회 할 수 있다.

{{:egovframework:oe1:설정관리:가이드:캐시설정목록.jpg|}}    
    * 버튼 설명
캐시 설정은 신규빈등록은 존재 하지 않으며, 설정 자체가 오직 하나이기 때문에 신규 등록만 존재한다.
    - 신규등록 : 캐시 서비스 설정이 아예 존재하지 않거나 기존 설정이 있다 하더라도 삭제하고 재작성 할 경우 사용

=== 캐시 설정관리 상세 조회 ===
설정관리 도구 메인화면 >> 좌측 메뉴 >> 캐시 설정관리 >> 캐시 설정 >> 조회된 목록에서 Bean id 선택
아래와 같이 선택한 Bean 의 상세 설정을 HTML Table 을 이용하여 조회 할 수 있다.
각 체크 박스를 이용하여 프로퍼티삭제가 가능하며, 삭제 후 저장을 통해 화면에서 수정사항을 반영할 수 있다.

{{:egovframework:oe1:설정관리:가이드:캐시설정상세.jpg|}}
    * 버튼 설명
    - 미리보기: 현재 상세조회 되고 있는 Bean을 포함하여 저장되지 않은 변경 사항을 포함하여 XML 파일을 팝업창으로 미리 볼 수 있다.
    - 저장: 현재 화면에서 수정된 사항을 파일에 반영할때 사용
    - 삭제: 현재 상세조회 하고 있는 Bean 설정을 설정파일에서 삭제함
    - 목록: 목록 화면으로 이동


== 미리보기 ==
화면에서 변경할 사항을 실제 설정파일을 수정하기 전에 미리보기로 볼 수 있다.

{{:egovframework:oe1:설정관리:가이드:캐시설정미리보기.jpg|}}

==== EhCache 설정관리 ====
설정관리에서 EhCache 설정은 실제 캐시의 상세 프로퍼티를 관리하는 파일이다.
설정관리 도구에서는 EhCache 설정 중 중요하고, 많이 사용되는 프로퍼티에 대하여 관리 기능을 제공한다.

=== EhCache 설정관리 목록 조회 ===
설정관리 도구 메인화면 >> 좌측 메뉴 >> 캐시 설정관리 >> EhCache 설정


== 캐시 설정파일 과 설정관리 화면 비교 ==
    * ehcache-default.xml
<code xml>
<ehcache>
<diskStore path="user.dir/second"/>
   <cache name="sampleMem"
           maxElementsInMemory="3"
           eternal="false"
           timeToIdleSeconds="360"
           timeToLiveSeconds="1000"
           overflowToDisk="false"
           diskPersistent="false"  
           memoryStoreEvictionPolicy="LRU">
   </cache>
</ehcache>
</code>

    * 설정관리 도구 표현
아래와 같이 설정파일에 표현된 캐시별로 목록을 보여준다.

{{:egovframework:oe1:설정관리:가이드:이에이치캐시목록.jpg|}} 
    * 버튼 설명
     - 신규캐시등록 : 기존 설정에 캐시를 추가할 경우 사용
    - 신규등록 : EhCache 설정이 아예 존재하지 않거나 기존 설정이 있다 하더라도 삭제하고 재작성 할 경우 사용

=== EhCache 설정관리 상세 조회 ===
설정관리 도구 메인화면 >> 좌측 메뉴 >> 캐시 설정관리 >> EhCache 설정 >> 조회된 목록에서 캐시명 선택
아래와 같이 선택한 Bean 의 상세 설정을 HTML Table 을 이용하여 조회 할 수 있다.
각 체크 박스를 이용하여 프로퍼티삭제가 가능하며, 삭제 후 저장을 통해 화면에서 수정사항을 반영할 수 있다.

{{:egovframework:oe1:설정관리:가이드:이에이치캐시상세.jpg|}}
    * 버튼 설명
    - 미리보기: 현재 상세조회 되고 있는 Bean을 포함하여 저장되지 않은 변경 사항을 포함하여 XML 파일을 팝업창으로 미리 볼 수 있다.
    - 저장: 현재 화면에서 수정된 사항을 파일에 반영할때 사용
    - 삭제: 현재 상세조회 하고 있는 Bean 설정을 설정파일에서 삭제함
    - 목록: 목록 화면으로 이동


== 미리보기 ==
화면에서 변경할 사항을 실제 설정파일을 수정하기 전에 미리보기로 볼 수 있다.
EhCache 설정은 전자정부표준프레임워크 상의 설정이 아닌, 일반 XML 파일로 구성되기 때문에
미리보기 및 설정관리 도구 상에서 설정파일을 수정하거나 신규 생성하게 될 때, 다른 서비스의 설정파일 처럼 정렬되어 표현되지 않는다.

{{:egovframework:oe1:설정관리:가이드:이에이치캐시미리보기.jpg|}}

=== 비지니스 규칙 ===
설정관리 도구의 EhCache 설정관리는 아래와 같은 비지니스 규칙을 갖는다. 규칙에 위반 될 경우, Validation 체크를 통해 저장이 방지 된다.
    - 특수문자의 경우,  파일 경로 및 Cron Expression 등 (/ * : . - _ ?)만 입력 가능하며 한글 입력은 불가하다.


===== 참고자료 =====
[[http://ehcache.sourceforge.net/|EhCache]]