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

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

시스템 요구사항

JDK 설치하기

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

JDK 다운로드

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

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

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

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

5. 설치가 진행됩니다.

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

7. 설치가 진행됩니다.

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

환경변수 셋팅

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

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

• 변수이름=JAVA_HOME, 변수 값=[JDK설치경로]

• 변수이름=JRE_HOME, 변수 값=[JRE설치경로]

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

톰캣(WAS) 설치하기

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

톰캣 다운로드

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

Install

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

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

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

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

XPLATFORM HTML5의 설치

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

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

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

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

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

2. 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>

3. 3단계: Tomcat 시작

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

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

Jar 파일을 이용한 기존 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 파일들을 복사하였습니다.

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

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

3. 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>

4. 4단계: Tomcat 시작

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

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

설치용 파일들

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

1. XPLATFORM HTML5

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

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

2. XPLATFORM HTML5 Imagefilter

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

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

3. XPLATFORM HTML5 Exportexcel

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

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

4. 외부 옵션 라이브러리

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

License 파일들

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

X-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 경로가 됩니다.

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

• 톰캣 콘솔 화면

• UX-Studio에서의 에러 메시지

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

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

2. 라이선스 파일(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” 경로에 위치시킵니다.

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