xPlusAgent 가이드
이 장에서는 xPlusAgent 에 대한 개요를 설명한다.
- xPlusAgent 개요
- 구성 파일 및 내용
- 전용 브라우저와 범용 브라우저 비교
xPlusAgent 개요
xPlusAgent 는 다음과 같은 기능 및 특징을 가지고 있다.
| 구분 | 설명 |
|---|---|
| 목적 | HTML5 환경에서 보안 및 기능의 제약사항으로 구현이 불가능한 기능을 지원하기 위한 확장기능을 제공한다. |
| 엔진 | xFrame5 RunTime 엔진을 기반으로 제공된다. 즉 xFrame5 RunTime 엔진 기반의 개발 환경 및 기능을 제공한다. (xPlusAgent 프로그램의 실제 파일 이름은 xFrameBrowser.exe 이다.) |
| 부가 컴포넌트 | HTML5 환경에서 XPlusAgent 와 통신을 수행하기 위해서 XPlusHttpSvr 와 XPlusWebSockSvr 컴포넌트를 제공한다. |
개발 아키텍처
개발 환경
HTML5 기반 업무 화면 표시 영역 및 XPlusAgent 에서 실행되는 XPlus5 기반 기능 확장 영역 부분에 대한 개발 진행이 모두 xFrame5-DevStudio 를 통해서 개발한다.
xPlus5 기반 기능 확장 영역
xPlus5 기반 기능 확장 영역은 xPlusAgent 엔진에서 실행되는 부가적인 기능을 의미한다. xPlus5 확장 영역에 기본적으로 제공되는 컴포넌트는 아래와 같다.
| 컴포넌트 | 주요 기능 | 템플릿 |
|---|---|---|
| XPlusWebSockSvr | Web Socket 프로토콜에 대한 서버 기능을 제공하는 컴포넌트이다. | /XPLUS5/xplus_websocksvr |
| XPlusHttpSvr | HTTP 프로토콜에 대한 서버 기능을 제공하는 컴포넌트이다. | /XPLUS5/xplus_httpsvr |
| XPlusTcpSvr | TCP 서버 소켓 기능을 제공하는 컴포넌트이다. | /XPLUS5/xplus_tcpsvr |
| XPlusTcpComm | TCP 클라이언트 소켓 기능을 제공하는 컴포넌트이다. | /XPLUS5/xplus_tcpcomm |
| XPlusLogger | XPlusAgent 용 화면에서 로그를 파일에 저장하기 위한 기능을 제공한다. | /XPLUS5/xplus_logger |
| xFrameViewer | xFrame 런타임 엔진에서 제공하는 컴포넌트이다. xFrame 런타임 엔진에서 제공하는 모든 UI 컴포넌트 및 API 를 제공한다. |
위의 기능 이외에도 프로젝트에서 사용하는 ActiveX 컴포넌트를 추가하여 기능을 확장할 수 있다.
실행 아키텍처
실행 아키텍처는 아래의 그림과 같이 구성된다. xPlus5 기반 기능 확장 영역을 사용하기 위해서는 사용자 PC에 버전 관리 프로그램에 대한 설치 작업이 필요하다.
xPlusAgent 와의 통신 수행시 WebSocket 방식은 프로토콜 표준에 의해서 비동기 통신 방식만을 제공한다. 동기식 통신을 꼭 해야하는 경우에는 xPlusAgent 에 제공되는 XPlusHttpSvr 컴포넌트를 배치하고, AJAX 의 동기통신 방식을 사용해야한다.
시작 아키텍처
xFrame5 브라우저 시작 흐름은 아래와 같다. xFame5 버전 관리 프로그램이 설치되어 있다는 것을 전제한다. 실행 아키텍처에 대한 흐름은 /XPLUS/xplus_agentmain 및 xplus_browsermain 템플릿 화면을 참조한다.
| 순서 | 단계 | 설명 | 주체 |
|---|---|---|---|
| 1 | 버전 관리 프로그램 시작 | 바탕화면에 표시된 버전 관리 프로그램 아이콘을 통해서 버전 관리 프로그램이 시작된다. 버전 관리 프로그램은 버전 관리 프로그램 자체에 대한 업데이트 작업도 수행한다 | 버전 관리 프로그램 |
| 2 | 변경된 파일 다운로드 | WEB 서버에 배포된 파일을 기준으로 변경된 파일에 대한 동기화 작업을 수행한다. | 버전 관리 프로그램 |
| 3 | XPlusAgent 프로그램 기동 | 버전 관리 프로그램이 바탕화면에 아이콘을 생성하고, XPlusAgent 프로그램을 시작하고, 자신은 종료한다. | 버전 관리 프로그램 |
| 4 | XPlusAgent 메인 화면 기동 | XPlusAgent 메인 화면에서 웹 소켓 서버를 기동하고, xFrame5Browser 를 시작한다. | xPlusAgent |
| 5 | xFrame5Browser 메인 화면 기동 | xFrame5Browser 메인 화면에서 웹 소켓 클라이언트 컴포넌트를 이용하여 xPlusAgent 에서 생성한 웹 소켓 서버와의 세션을 연결하고, UI 표시 작업을 수행한다. | xFrame5Browser |
| 종료 | xFrame5Browser 종료시 XPlusAgent 프로그램도 자동으로 종료된다. |
구성 파일 및 내용
구성 파일 개요
XPlusAgent 는 별도의 파라미터가 없는 경우, XPlusAgent 파일이 위치한 디렉토리의 “xFrameConfig.ini” 파일을 사용한다.
별도의 구성 파일을 지정할 필요가 있는 경우에는 구성 파일 경로를 파라미터로 전달한다. (예시: C:\xFrame5\bin\XPlusAgent.exe C:\xFrame5\bin\xFrameConfig_PROD.ini”)
구성 파일 주요 내용
구성파일은 일반적인 ini 파일의 구조를 가지며, “XFRAMEVIEWER” 섹션값을 사용한다. 구성 파일의 기본 내용은 xFrame5 RunTime 엔진에서 사용하는 값과 동일하다. 아래의 내용은 XPlusAgent 에 추가되거나 반드시 설정해야 할 내용이다.
| 키 | 설정값 예시 | 설명 |
|---|---|---|
| USE_TRAYICON | TRUE | XPlusAgent 기동시 트레이 아이콘에 표시 여부 |
| BROWSER_SHOW | TRUE | XPlusAgent 기동시 기본창 표시 여부 |
| MAINFRAMESCREEN | /xplus_agentmain | XPlusAgent 기동시 시작할 화면 URL 이다. 설정값의 내용은 반드시 프로젝트에서 생성된 화면에 대한 URL로 변경해야 한다. |