====== 접속 통계 ======

===== 개요 =====
사용자가 접속한 현황에 대한 통계자료를 서비스, 개인별에 따라 기간별(연도별, 월별, 일별)로 그래프와 텍스트 형태 두가지 방식으로 제공한다.

  * 기능흐름 

^기능명^기능 흐름^
|접속통계 집계|//**시스템접속정보 요약 배치수행**// -> //**시스템접속요약정보 집계**//|
|접속통계 검색|검색조건 입력 -> 조건별 접속 통계 검색|

===== 설명 =====
시스템 접속 통계 수치를 특정 검색 조건에 따라 정보를 조회하는 기능이다.

==== 패키지 참조 관계 ====

접속통계 패키지는 요소기술의 공통(cmm) 패키지와 리포팅 공통(sts.com) 패키지에 대해서 직접적인 함수적 참조 관계를 가진다. 하지만, 컴포넌트 배포 시 오류 없이 실행되기 위하여 패키지 간의 참조관계에 따라 달력 패키지와 함께 배포 파일을 구성한다. 


  * 패키지 간 참조 관계 : [[egovframework:com:v2:init_pkg_dependency#통계/리포팅|통계/리포팅 Package Dependency]]


==== 관련소스 ====
^유형^대상소스명^비고^
|Controller|egovframework.com.sts.cst.web.EgovConectStatsController.java|접속 통계를 위한 컨트롤러 클래스|
|Service|egovframework.com.sts.cst.service.EgovConectStatsService.java|접속 통계를 위한 서비스 인터페이스|
|ServiceImpl|egovframework.com.sts.cst.service.impl.EgovConectStatsServiceImpl.java|접속 통계를 위한 서비스 구현 클래스|
|Model|egovframework.com.sts.cst.service.SysLogSummary.java|접속 통계를 위한 모델 클래스|
|DAO|egovframework.com.sts.cst.service.impl.ConectStatsDAO.java|접속 통계를 위한 데이터 처리 클래스|
|Schduling|egovframework.com.sym.log.lgm.service.EgovLogManageScheduling.java|시스템 로그 집계를 위한 스케줄 클래스|
|JSP|WEB_INF/jsp/egovframework/com/sts/cst/EgovConectStats.jsp|접속 통계 페이지|
|Query XML|resources/egovframework/mapper/com/sts/cst/EgovConectStats_SQL_mysql.xml|접속 통계를 위한 MySQL용 Query XML|
|Query XML|resources/egovframework/mapper/com/sts/cst/EgovConectStats_SQL_cubrid.xml|접속 통계를 위한 Cubrid용 Query XML|
|Query XML|resources/egovframework/mapper/com/sts/cst/EgovConectStats_SQL_oracle.xml|접속 통계를 위한 Oracle용 Query XML|
|Query XML|resources/egovframework/mapper/com/sts/cst/EgovConectStats_SQL_tibero.xml|접속 통계를 위한 Tibero용 Query XML|
|Query XML|resources/egovframework/mapper/com/sts/cst/EgovConectStats_SQL_altibase.xml|접속 통계를 위한 Altibase용 Query XML|
|Query XML|resources/egovframework/mapper/com/sts/cst/EgovConectStats_SQL_maria.xml|접속 통계를 위한 Maria용 Query XML|
|Query XML|resources/egovframework/mapper/com/sts/cst/EgovConectStats_SQL_postgres.xml|접속 통계를 위한 Postgres용 Query XML|
|Message properties|resources/egovframework/message/com/sts/cst/message_ko.properties|접속 통계 Message properties(한글)|
|Message properties|resources/egovframework/message/com/sts/cst/message_en.properties|접속 통계 Message properties(영문)|
==== 클래스 다이어그램 ====

{{:egovframework:com:sts:sts4.gif?740|}}

==== 관련테이블 ====
^테이블명^테이블명(영문)^비고^
|시스템로그요약|COMTSSYSLOGSUMMARY|시스템로그 요약 정보를 관리한다.|

==== 환경설정 ====
하루에 한번씩 시스템 접속로그 정보를 모두 조회하여 요약하는 작업이 배치형태로 구성되어야 한다. \\
본 기능은 전자정부 표준프레임워크 실행환경의 **[[egovframework:rte:fdl:scheduling]]** 기능을 활용하여 구성되어있다. \\
  * 작업 클래스 생성(src/main/java/egovframework/com/sym/log/lgm/service/EgovSysLogScheduling.java)
<code java>
@Service("egovSysLogScheduling")
public class EgovSysLogScheduling {

	@Resource(name="EgovSysLogService")
	private EgovSysLogService sysLogService;

	/**
	 * 시스템 로그정보를 요약한다.
	 * 전날의 로그를 요약하여 입력하고, 일주일전의 로그를 삭제한다.
	 *
	 * @param
	 * @return
	 * @throws Exception
	 */
	public void sysLogSummary() throws Exception {
		sysLogService.logInsertSysLogSummary();
	}

}</code>
  * 작업 수행 Bean 설정(src/main/resources/egovframework/spring/com/context-scheduling-sym-log-lgm.xml)
<code xml>
<bean id="sysLogging" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
    <property name="targetObject" ref="egovSysLogScheduling" />
    <property name="targetMethod" value="sysLogSummary" />
    <property name="concurrent" value="false" />
</bean>
</code>
  * 트리거 Bean 설정(src/main/resources/egovframework/spring/com/context-scheduling-sym-log-lgm.xml)
<code xml>
<bean id="sysLogTrigger" class="org.springframework.scheduling.quartz.SimpleTriggerBean">
    <property name="jobDetail" ref="sysLogging" />
    <property name="startDelay" value="60000" />
    <property name="repeatInterval" value="3600000" />
</bean>
</code>
  * 스케줄러 Bean 설정(src/main/resources/egovframework/spring/com/context-scheduling-sym-log-lgm.xml)
<code xml>
<bean id="logSummaryScheduler" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
    <property name="triggers">
        <list>
            <ref bean="sysLogTrigger" />
        </list>
    </property>
</bean>
</code>

===== 관련기능 =====

==== 접속 통계 ====

=== 비즈니스 규칙 ===
하루 단위로 집계되는 시스템 접속로그 요약 정보를 통해 서비스(메소드), 개인별 접속 통계 자료를 조회한다.


=== 관련코드  ===
N/A

=== 관련화면 및 수행메뉴얼 ===

^Action^URL^Controller method^QueryID^
|접속 통계검색|/sts/cst/selectConectStats.do|selectUserStats|"ConectStatsDAO.selectConectStats"|

{{:egovframework:com:v3.9:sts:stats4.png|}}

기간: 통계 검색을 할 시작-종료 기간을 입력한다. \\
기간구분: 연도별, 월별, 일별 기간별 통계 형태를 선택한다. \\
통계구분: 서비스, 개인별 구분을 선택한다. \\
서비스명입력: 시스템 접속통계를 위해 메소드명을 입력한다. \\ 
초기화: 검색 조건을 초기화한다. \\

===== 참고자료 =====
  * 실행환경 참조 : [[egovframework:rte:fdl:scheduling]]