넥사크로플랫폼 앱을 실행하기 위해서는 실행 환경이 필요합니다. 별도의 실행 환경을 구축하지 않아도 넥사크로 스튜디오에서 Windows NRE, 에뮬레이터, 로컬 웹 서버로 테스트해볼 수 있습니다.
넥사크로플랫폼 앱 동작 뿐 아니라 실제 데이터를 조회하고 저장하는 데이터 트랜잭션까지 테스트해보고자 한다면 WAS(Web Application Server)를 설정해야 합니다. 이를 위해 WAS 설치를 위한 JDK 설치와 아파치 톰캣 설정에 대해 설명합니다.
로컬 웹서버, 아파치 톰캣은 아래와 같은 차이가 있습니다. 사용하려는 목적에 맞게 선택하세요.
로컬 웹서버 | Apache Tomcat | |
|---|---|---|
설치파일 | 없음 (넥사크로 스튜디오 설치에 포함) | 설치 파일 제공 (바이너리 소스로 받아서 직접 배치 파일을 실행시킬 수도 있음) |
JDK 설치 | 필요 없음 | JDK 설치 후 사용 가능 |
Context 설정 | 없음 (Generate 폴더가 웹서버 root로 지정) | 정해진 절차에 따라 컨텍스트를 추가하거나 war 파일을 디플로이해서 컨텍스트 생성 |
X-API 지원 | 사용할 수 없음 | 사용 가능 (별도 설정) |
로컬 웹서버는 넥사크로 스튜디오를 실행하는 중에만 사용할 수 있습니다. 넥사크로 스튜디오를 실행하지 않고 앱을 테스트하려면 직접 웹서버나 WAS를 설치해야 합니다.
이번 장에서 설명하는 각 서비스에 대한 문제나 세부적인 사용 방법은 해당 제품 프로젝트 사이트를 참조하세요.
로컬 웹서버 사용하기
넥사크로 스튜디오 설치 후 기본 옵션은 로컬 웹서버를 사용하도록 설정됩니다. 로컬 웹서버를 사용하는 경우에는 별도의 설정 없이 넥사크로 스튜디오에서 "Launch" 또는 "Quick View" 실행 시 웹브라우저를 선택한 경우에는 로컬 웹서버가 자동으로 실행되고 넥사크로 스튜디오를 종료하면 자동으로 로컬 웹서버도 종료됩니다.
로컬 웹서버 실행 시 서버에서 출력하는 메시지는 넥사크로 스튜디오 Output 창에서 확인할 수 있습니다.
WAS 사용하기
JDK(Java SE Development Kit)
WAS는 톰캣(Tomcat)이나 제티(Jetty), 윈스턴(Winstone)과 같이 무료로 공개된 것을 사용하거나 상용 제품을 사용할 수 있습니다. 여기에서는 간단하게 사용할 수 있는 톰캣을 설치하는 기준으로 설명하겠습니다.
톰캣은 자바 기반으로 만들어졌기 때문에 실행하기 위해서는 JDK(Java SE Development Kit) 환경이 설정되어 있어야 합니다. JDK는 무료로 제공되고 있으며 간단하게 설치할 수 있습니다.
내려받기
아래 사이트에서 시스템 환경에 맞는 JDK를 내려받을 수 있습니다.
http://www.oracle.com/technetwork/java/javase/downloads/index.html
이번 장에서는 jdk-9.0.1_windows-x64_bin.exe 파일을 내려받아 사용했습니다. JDK 버전이 다른 경우 설치 및 설정 내용이 다를 수 있습니다.
JDK나 톰캣 설치 파일은 윈도우 운영체제를 사용하는 경우 32비트와 64비트 설치 파일을 제공합니다. 운영체제 버전 확인은 아래 링크를 참고하세요.
설치 확인
내려받은 설치파일을 실행하면 자동으로 필요한 환경설정과 설치과정을 진행합니다. 설치가 완료되면 커멘드창에서 정상적으로 설치되었는지 확인합니다.
java -version
JDK 1.5 이상 버전을 설치하는 경우에는 실행에 필요한 환경 변수(JAVA_HOME)를 따로 설정해주지 않아도 시스템 경로에 자동으로 실행 파일을 복사해 접근할 수 있습니다.
아파치 톰캣(Apache Tomcat)
넥사크로플랫폼 앱을 웹브라우저에서 동작하게 하려면 웹서버 환경을 만들어주어야 합니다. 아파치 톰캣은 간단한 설치만으로 이런 환경을 만들 수 있습니다.
내려받기
아래 사이트에서 실행 환경에 맞는 톰캣을 내려받을 수 있습니다.
http://tomcat.apache.org
톰캣은 압축된 바이너리 파일을 내려받아 직접 실행하거나 별도로 제공되는 인스톨 파일을 사용할 수 있습니다. 여기에서는 인스톨 파일로 설치하도록 하겠습니다.
내려받은 파일을 실행하게 되면 설치 마법사가 필요한 설정 과정을 진행하며 JRE 경로도 자동으로 인식해 처리해줍니다.
이번 장에서는 apache-tomcat-8.5.23.exe 파일을 내려받아 사용했습니다. 해당 프로젝트 업데이트에 따라 일부 내용이 변경될 수 있습니다.
설치 확인
설치가 완료되면 윈도우 서비스로 등록되면서 자동으로 서버를 실행시켜줍니다. 윈도우 하단 트레이에서 오른쪽 마우스를 클릭해 컨텍스트 메뉴를 확인하면 서비스 상태 정보를 확인하거나 다른 설정을 할 수 있습니다.
웹브라우저에서 로컬 주소에 설정된 URL값을 입력해 정상 설치 여부를 확인합니다.
http://localhost:8080
컨텍스트 설정
톰캣에서 원하는 정보를 보여주려면 컨텍스트를 추가해주어야 합니다. 컨텍스트를 추가하는 방법은 몇 가지가 있지만, 이번 장에서는 컨텍스트 파일을 생성하고 임의의 폴더를 설정하는 방법을 살펴보겠습니다.
새로운 파일을 추가하거나 수정하기 위해 운영체제 설정에 따라 관리자 권한이 필요합니다.
컨텍스트 파일 생성
컨텍스트 파일은 넥사크로 스튜디오에서 Generate Path를 지정하고 해당 경로를 톰캣과 연결해주는 역할을 합니다. 톰캣이 설치된 경로 아래에 지정된 폴더에 XML 파일로 만든 컨텍스트 파일을 추가해줍니다.
C:\Program Files\Apache Software Foundation\Tomcat 8.5\conf\Catalina\localhost
XML 파일을 아래와 같이 생성합니다. path 항목에는 URL 주소에 포함될 문자열을 입력하고 docBase 항목에는 Generate Path로 지정된 경로를 입력합니다. 아래와 같이 path 항목을 지정한 경우에 연결되는 URL은 http://localhost:8080/Hello/... 형식이 됩니다. 생성하는 파일명은 path 항목에 입력한 이름과 같아야 합니다. 아래 예제에서는 Hello.xml 파일을 생성합니다.
$r_title(Hello.xml)
<Context path="/Hello" docBase="E:\88_TEST\02_BUILD\Hello"
debug="0" prvileged="true" reloadable="true">
<Logger className="org.apache.catalina.logger.FileLogger"
directory="logs" prefix="localhost_log." suffix=".txt"
timestame="true"/>
</Context>XML 파일은 윈도우 운영체제의 메모장이나 설치된 에디터 프로그램에서 새로 만들 수 있습니다. 넥사크로 스튜디오를 실행한 경우에는 넥사크로 스튜디오 메뉴에서 [File > New > XML(.xml)] 항목을 선택해 파일을 새로 만들 수 있습니다.
컨텍스트 파일은 프로젝트마다 따로 생성해주거나 하나의 컨텍스트 파일을 가지고 여러개의 프로젝트를 관리할 수도 있습니다. 이후 예제에서는 프로젝트마다 컨텍스트 파일을 생성하는 것으로 안내하고 있습니다.
넥사크로플랫폼 앱 확인
로컬 웹서버가 아닌 다른 웹서버 또는 WAS를 사용하는 경우에는 Web Server 설정을 해주어야 합니다. 메뉴[Tools > Options > Project > Launch > Web Server] 항목에 URL을 설정해주면 이후 실행 시 해당 경로 기준으로 실행이 됩니다.
윈도우 트레이 영역에서 'Exit' 항목을 선택해주면 톰캣 서비스가 종료됩니다.