====== 데이터소스 설정관리 ======

===== 1. 개요 ======
데이터 소스 서비스 설정관리는 전자정부표준프레임워크 실행환경에서 제공하는 테이터 소스 서비스를 이용하기 위한 설정 파일을 관리할 수 있는 기능을 제공한다.
데이터 소스 서비스에 대한 자세한 내용은 [[https://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte:psl:data_source]] 참고한다.


===== 2. 설명 ======
==== 데이터소스 설정관리 ====
기본적으로 설정관리 도구의 데이터 소스설정관리는 외부 프로퍼티(egovsms.properties) 파일에 선언해 놓은 프로퍼티 서비스 설정파일을 읽어서 Bean ID 별(데이터 소스) 목록으로 조회 할 수 있다.
전자정부 표준 프레임워크에서 제공하는 데이터 소스 서비스의 설정은 JDBCDataSource, DBCPDataSource, C3P0DataSource, JNDIDataSource 를 이용할 수 있으며
위의 경우 모두 데이터 소스 설정관리를 통해 해당 설정 파일을 관리 할 수 있다.

=== 데이터 소스 설정관리 목록 조회 ===
설정관리 도구 메인화면 >> 좌측 메뉴 >> 데이터소스 설정관리 선택


== 데이터 소스 설정파일 과 설정관리 화면 비교 ==
    * context-dataSource.xml
<code xml>
<!-- mysql -->
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
      <property name="driverClassName" value="com.mysql.jdbc.Driver"/>
      <property name="url" value="jdbc:mysql://192.168.200.24:1621/oe1"/>
      <property name="username" value="oe1"/>
      <property name="password" value="oe1dev"/>
</bean>
</code>

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

{{:egovframework:oe1:설정관리:가이드:데이터소스설정관리목록.jpg|}}
    * 버튼 설명
    - 신규빈등록 : 기존 데이터소스 설정이 존재 할 경우, 다른 데이터소스 설정을 추가 할 때 사용
    - 신규등록 : 데이터소스 서비스 설정이 아예 존재하지 않거나 기존 설정이 있다 하더라도 삭제하고 재작성 할 경우 사용

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

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

== 프로퍼티 추가 ==
프로퍼티 추가 버튼을 눌러서 ROW 를 하나 추가한 다음 관리하고자 하는 프로퍼티 명을 Select box 에서 선택한 후 프로퍼티에 맞도록 값을 셋팅한다.

{{:egovframework:oe1:설정관리:가이드:데이터소스설정관리추가.jpg|}}

== 프로퍼티 삭제 ==
삭제할 프로퍼리를 체크 박스로 선택하여 일괄 삭제 한다.

{{:egovframework:oe1:설정관리:가이드:데이터소스설정관리삭제.jpg|}}

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

{{:egovframework:oe1:설정관리:가이드:데이터소스설정관리미리보기.jpg|}}

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

===== 3. 참고자료 =====
[[http://static.springsource.org/spring/docs/2.0.x/reference/jdbc.html|JDBCDataSource]] \\
[[http://www.mchange.com/projects/c3p0/index.html#c3p0-config.xml|C3P0 Configuration]]