8.샘플 프로젝트 (로컬 실행 환경 설정)

로컬에서의 실행 환경은 반드시 필요한 것은 아닙니다만 로컬에서 실행하면 서버의 자원을 절약하고 테스트시의 타 개발자와의 간섭을 최소화 할 수 있습니다.

참고로 샘플 프로젝트의 로컬 실행 환경 설정은 Windows XP 기준입니다.

8.1시스템 요구사항

Setup 파일명


Java

1.4 이상

Memory

제한없음. 1M 이상 권장

Web Application Server

제한없음

OS

제한없음. Windows, Linux에서 테스트 되었음

8.2JDK 설치하기

샘플 프로젝트에서는 JDK6 버전을 사용합니다.

8.2.1JDK 다운로드

  1. URL = http://java.sun.com/javase/downloads/index.jsp

  2. “Java SE Development Kit (JDK)” 항목을 찾아 다운로드 해 주십시오.

  1. 다운로드한 JDK(jdk-6u16-windows-i586.exe)를 실행합니다.

  1. 다음과 같은 화면에서 JDK를 설치할 경로를 선택하고 Next버튼을 클릭합니다.

  1. 설치가 진행됩니다.

  1. 자동으로 JRE를 설치하게 됩니다. 다음과 같은 화면에서 JRE를 설치할 경로를 선택하고 Next버튼을 클릭합니다.

  1. 설치가 진행됩니다.

  1. Finish버튼을 누르면 설치가 완료됩니다.

8.2.2환경변수 셋팅

  1. “시스템 등록 정보” > “고급”탭 > “환경변수”버튼 > 시스템 변수란의 “새로 만들기” 버튼을 클릭하세요.

  1. 새 시스템 변수 입력 창이 뜨면 다음과 같이 입력합니다.

  1. 입력을 마치면 다음과 같이 시스템 변수란에 출력됩니다.

8.3톰캣(WAS) 설치하기

샘플 프로젝트에서는 5.5.28 버전을 사용합니다.

8.3.1톰캣 다운로드

  1. URL = http://tomcat.apache.org/download-55.cgi

8.3.2Install

  1. 적당한 디렉토리로 다운로드 후 압축을 해제합니다.

  1. 해제한 폴더를 적당한 위치로 이동합니다.

    샘플 프로젝트에서는 “C:\apache-tomcat-5.5.28” 로 하였습니다.

  1. 이것으로 WAS가 설치되었습니다.

8.4XPLATFORM HTML5의 설치

8.4.1war 파일을 이용한 신규 Context 설치

XPLATFORM HTML5의 war 파일을 이용하여 설치하는 방법을 설명합니다. 다음의 설명은Apache Tomcat을 기준으로 한 설명입니다. 다른 Web Application Server는 해당 WAS의 매뉴얼을 참조하시기 바랍니다.

Context 설정 파일을 작성해 설치하는 방법은 Tomcat 버전에 따라 지원되지 않을 수 있습니다. Tomcat 7.2 이상 버전에서는 정상적인 배포가 되지 않습니다.

  1. 1단계 : XPLATFORM HTML5의 war 파일 복사

    XPLATFORM HTML5의 war 파일을 적당한 디렉토리에 복사합니다. war 파일은 XPLATFORM HTML5 배포판에 포함된 xplatform9-ajax.war 입니다.

    샘플 프로젝트에서는 “C:\XAE\xplatform9-ajax.war” 경로입니다.

  1. 2단계 : Tomcat의 Context 설정 파일 작성

    <Tomcat Home>/conf/Catalina/localhost/xplatform9-ajax.xml 파일을 다음과 같은 내용으로 작성합니다.

    예를 들어 War 파일을 “C:\XAE\xplatform9-ajax.war”로 복사하였다면 다음과 같이 작성하세요.

<?xml version="1.0" encoding="UTF-8"?>
<Context path="/xplatform9-ajax" docBase="C:/XAE/xplatform9-ajax.war">
</Context>
  1. 3단계: Tomcat 시작

    Tomcat의 시작은 “<Tomcat Home>/bin/startup.bat” 파일을 실행시키면 됩니다.

    Tomcat의 종료는 “<Tomcat Home>/bin/shutdown.bat” 파일을 실행시키면 됩니다.

8.4.2Jar 파일을 이용한 기존 Context 설치

XPLATFORM HTML5의 jar 파일들을 이용하여 설치하는 방법을 설명합니다. 기존의 Context를 유지한 채로 XPLATFORM HTML5 라이브러 파일(jar)들을 복사하여 설치할 수 있습니다.
예를 들어, 이미 설치된 웹 어플리케이션의 이름을 “myajax” 로 하고 설치 경로를 “<Tomcat Home>/webapps/myajax” 으로 합니다.
  1. 1단계 : XPLATFORM HTML5의 jar 파일들 복사

    XPLATFORM HTML5의 jar 파일들을 기존 Context의 라이브러리 디렉토리에 복사합니다. 예제의 프로젝트에서는 <Tomcat Home>/webapps/myajax/WEB-INF/lib 디렉토리에 XPLATFORM HTML5 jar 파일들을 복사하였습니다.

  1. 2단계 : 외부 의존 라이브러리 복사

    XPLATFORM HTML5의 외부 의존 라이브러리들을 기존 Context의 라이브러리 디렉토리에 복사합니다. 예제의 프로젝트에서는 <Tomcat Home>/webapps/myajax/WEB-INF/lib 디렉토리에 XPLATFORM HTML5의 외부 의존 라이브러리들을 복사합니다. 외부 라이브러리 목록은 하단의 “4.4.3 설치용 파일들”을 참조하시기 바랍니다.

  1. 3단계 : web.xml 변경

    Web.xml의 내용에 다음과 같은 Servlet 설정을 추가합니다.

    예제의 프로젝트에서는 <Tomcat Home>/webapps/myajax/WEB-INF/web.xml 경로에 위치해 있습니다.

<servlet>
</servlet>
<servlet>
<servlet-name>LoadResource</servlet-name>
<servlet-class>com.tobesoft.xplatform.HTML5.service.LoadResourceServlet</servlet-class>
<init-param>
<!-- StreamLog 을 출력할지 여부-->
<param-name>streamLog</param-name> 
<param-value>false</param-value> 
</init-param>
<init-param>
<!-- 서비스의 실행시간을 출력할지 여부 -->
<param-name>elapsedTime</param-name>
<param-value>false</param-value> 
</init-param>
</servlet>
<servlet>
<servlet-name>ImageFilter</servlet-name>
<servlet-class>com.tobesoft.xplatform.service.ImageFilterServlet</servlet-class>
<init-param><param-name>cacheDir</param-name>
</init-param>
</servlet>
<servlet>
<servlet-name>ForwardRequest</servlet-name>
<servlet-class>com.tobesoft.xplatform.service.ForwardRequestServlet</servlet-class>
</servlet>

<!-- 이미지를 가공하여 새로운 이미지를 반환합니다.(Stretch대응) -->
<servlet-mapping>
<servlet-name>ImageFilter</servlet-name>
<url-pattern>/services/ImageFilter</url-pattern>
</servlet-mapping>

<!-- 요청된 데이터를 다른 서비스(url)에 전송하고, 다른 서비스(url)로 부터 수신된 데이터에 대응하는 중간전송자의 역할인 HttpServlet 입니다. -->
<servlet-mapping>
<servlet-name>ForwardRequest</servlet-name>
<url-pattern>/services/ForwardRequest</url-pattern>
</servlet-mapping>
</web-app>
  1. 4단계: Tomcat 시작

    Tomcat의 시작은 “<Tomcat Home>/bin/startup.bat” 파일을 실행시키면 됩니다.

    Tomcat의 종료는 “<Tomcat Home>/bin/shutdown.bat” 파일을 실행시키면 됩니다.

8.4.3설치용 파일들

XPLATOFRM HTML5 서버 설치를 위한 파일들은 다음과 같습니다.

  1. XPLATFORM HTML5

    다음은 XPLATOFRM HTML5의 설치 파일들입니다.

파일명

필수

주요기능

Xplatform-xapi-x.x.jar

필수

XPLATFORM X-API

Xplatform9-ajax-x.x.jar

필수

XPLATFORM HTML5

다음은 XPLATFORM HTML5의 외부 의존 라이브러리들입니다.

모듈명

필수

주요기능

Commons-logging-x.x.jar

필수


Commons-collections-x.x.jar

필수


Commons-beanutils-x.x.jar

필수


Commons-digester-x.x.jar

필수


Commons-codec-x.x.jar

필수


xpp3_min-1.1.4c.jar

필수


xstream-1.3.1.jar

필수


  1. XPLATFORM HTML5 Imagefilter

    다음은 XPLATOFRM HTML5 Imagefilter의 설치 파일들입니다.

파일명

필수

주요기능

Xplatform9-imagefilter-x.x.jar

필수

Image Filtering

다음은 XPLATFORM HTML5 Imagefilter의 외부 의존 라이브러리들입니다.

모듈명

필수

주요기능

com.springsource.org.apache.batik.ext.awt-x.x.x.jar

필수


commons-logging -x.x.x.jar

필수


Commons-codec-x.x.jar

필수


gif4j_pro_x.x.jar

필수


imagefilter-x.x.jar

필수


  1. XPLATFORM HTML5 Exportexcel

    다음은 XPLATOFRM HTML5 Exportexcel의 설치 파일들입니다.

파일명

필수

주요기능

xplatform9-exportexcel-x.x.jar

필수

Export Excel

xplatform-xapi-x.x.jar

필수


다음은 XPLATFORM HTML5 Exportexcel의 외부 의존 라이브러리들입니다.

모듈명

필수

주요기능

commons-beanutils-x.x.x.jar

필수


commons-logging -x.x.x.jar

필수


Commons-collections-x.x.x.jar

필수


Commons-digester-x.x.x.jar

필수


Poi-x.x.jar

필수


  1. 외부 옵션 라이브러리

    다음은 XPLATFORM HTML5의 외부 옵션 라이브러리입니다.

모듈명

필수

주요기능

Log4j-x.x.jar

선택


필수로 설치해야 jar는 개발, 운영 시 모두 필요합니다.

8.4.4License 파일들

다음은 License 파일의 종류입니다.

Setup 파일명


XPLATFORM_Server_License.xml

XML 형태로 파일로 제공합니다.

X-API jar 파일과 동일 위치 또는 classes 폴더에 위치합니다.

X-API, HTML5 실행 시 체크합니다.

XPLATFORM_Client_License.xml

XML 형태로 파일로 제공합니다.

Web으로 접근가능한 경로에 위치합니다.

ADL의 licenseurl에 해당 파일경로와 파일명을 설정합니다.

Runtime, Widget 실행 시 체크합니다.

Tool License

Product Key 형태로 문서로 제공

UX-Studio 의 Help – About UX-Studio 에서 등록합니다.

8.4.5X-API 라이선스 등록

프로젝트 컴파일 및 배포를 위하여 X-API 라이선스를 등록해야만 합니다.
X-API의 라이선스 파일명은 “XPLATFORM_Server_License.xml”입니다.

X-API 사용에 대한 라이선스 적용은 두 가지 방법이 있습니다.

  1. 라이선스 파일을 jar파일과 동일한 위치에 포함시킵니다.

  2. 라이선스 파일을 클래스 경로에 포함시킵니다.

만일 두 위치에 동시에 라이선스 파일이 존재하는 경우 1) 에 위치한 라이선스가 우선 적용됩니다.
jar파일과 동일한 위치에 포함시킬 경우 일반적으로 Web Application의 /WEB-INF/lib 경로가 됩니다.
클래스 경로에 포함시킬 경우 일반적으로 Web Application의 /WEB-INF/classes 경로가 됩니다.

라이선스가 등록되지 않은 경우의 컴파일 에러 메세지

라이선스 파일을 jar파일과 동일한 위치에 포함시키는 경우

  1. 샘플 프로젝트에서 “C:\XAE\xplatform9-ajax.war” 를 배치하여 톰캣을 실행하였다면 “<Tomcat Home>/webapps/xplatform9-ajax” 경로가 생성되어 있을것입니다.

  1. 라이선스 파일(XPLATFORM_Server_License.xml)을

    “<Tomcat Home>/webapps/xplatform9-ajax/WEB-INF/lib” 경로에 위치시킵니다.

라이선스 파일을 클래스 경로에 포함시키는 경우

  1. 라이선스 파일(XPLATFORM_Server_License.xml)을 “<Tomcat Home>/webapps/xplatform9-ajax/WEB-INF/classes” 경로에 위치시킵니다.

    만일 해당 경로가 존재하지 않는다면 해당경로에 맞춰 폴더를 생성하십시요.