넥사크로 X-API는 서버모듈로 제공되며 서버와 클라이언트 간에 데이터 처리를 위해 필요한 기능을 제공합니다. 기본적인 데이터 송신, 수신 기능과 간단하게 필요한 데이터를 가공하는 기능을 제공해 데이터 처리 과정을 단순화합니다.

설치

X-API는 자바 기반 서버모듈로 제공되며 JDK 또는 JRE 1.4 이상 버전이 필요합니다.

배포 파일 내 lib 디렉터리에 포함된 jar 파일을 WAS의 /WEB-INF/lib 디렉토리 또는 정의된 클래스 경로에 복사합니다. 제공되는 jar 파일은 아래와 같습니다.

파일명	필수여부	설명	참조
nexacro-xapi-java-x.x.x.jar nexacro-xapi-java-jakarta_x.x.x.jar	Y	X-API	1.0.12 이후 버전은 Jakarta EE 스펙으로 구현된 WAS에서 사용할 수 있는 X-API를 제공합니다. 파일명에 "_jakarta_"가 포함된 파일을 내려받아 사용하세요. https://jakarta.ee/compatibility/
commons-logging-x.x.x.jar	Y	X-API 내부 로깅	Apache Commons Logging
json-simple-x.x.x.jar	Y	JSON 데이터 처리	json-simple

파일명

필수여부

설명

참조

nexacro-xapi-java-x.x.x.jar

nexacro-xapi-java-jakarta_x.x.x.jar

X-API

1.0.12 이후 버전은 Jakarta EE 스펙으로 구현된 WAS에서 사용할 수 있는 X-API를 제공합니다.

파일명에 "_jakarta_"가 포함된 파일을 내려받아 사용하세요.

https://jakarta.ee/compatibility/

commons-logging-x.x.x.jar

X-API 내부 로깅

Apache Commons Logging

json-simple-x.x.x.jar

JSON 데이터 처리

json-simple

jar 파일명은 버전정보를 포함하고 있습니다. 이전 버전의 파일을 삭제하지 않은 경우 잘못된 버전의 jar 파일이 적용될 수 있습니다. 예를 들어 1.0.0 버전을 1.0.1 버전으로 업데이트하는 경우에는 1.0.0 버전 파일은 삭제해줍니다.

nexacro-xapi-java-1.0.0.jar (삭제)

nexacro-xapi-java-1.0.1.jar (추가)

기술지원 사이트 메뉴 PRODUCT > Nexacro N> Download > Server [API, XENI]에서 jar 파일이 포함된 압축 파일을 내려받을 수 있습니다.

http://support.tobesoft.co.kr/Support/?menu=Download_N

라이선스 인증

라이선스 파일(NexacroN_server_license.xml)을 jar 파일과 같은 디렉토리 또는 정의된 클래스 경로에 복사합니다.

1개 이상의 라이선스 파일이 다른 경로로 복사된 경우에는 jar 파일과 같은 디렉토리에 있는 라이선스 파일을 먼저 적용합니다.

서버 환경 설정에 따라 jar 파일과 라이선스 파일을 복사하고 WAS 재시작이 필요할 수도 있습니다.

버전 확인

jar 파일명이 "1.x.x" 처럼 3자리로 작성된 경우에는 파일명에 포함된 "1.x.x"가 버전입니다.

jar 파일명이 "1.0"으로 작성된 경우 X-API 버전은 다음 명령어로 "Implementation-Version" 항목을 확인합니다.

java -jar nexacro-xapi-java-1.0.0.jar

--- Manifest ---
Manifest-Version: 1.0
Built-By: Server Team
Created-By: 1.5.0_22-b03 (Sun Microsystems Inc.)
Ant-Version: Apache Ant 1.7.1
Main-Class: com.nexacro.java.xapi.util.JarInfo
Built-Date: August 19 2021

Name: com.nexacro.java.xapi
Specification-Title: X-API
Implementation-Title: X-API
Specification-Version: 1.0
Specification-Vendor: TOBESOFT CO., LTD.
Implementation-Vendor-Id: com.nexacro
Implementation-Version: 1.0.0.7805
Implementation-Vendor: TOBESOFT CO., LTD.

설치 확인

X-API 정상 설치 여부는 간단하게 아래 샘플 JSP 파일을 작성해 확인할 수 있습니다.

<%@ page contentType="text/html; charset=UTF-8" %>

<html>
	<head>
	<title>JarInfo</title>
	<style>
		* { font-family: Verdana }
	</style>
	</head>
	<body>
		<pre>
<%
	new com.nexacro.java.xapi.util.JarInfo().info(out);
%>
		</pre>
	</body>
</html>

정상적으로 설치가 되었다면 X-API 버전 정보와 제품 라이선스 정보가 출력됩니다.