インストール

nexacro X-APIは、サーバーモジュールとしてサーバーとクライアント間でのデータ処理のために必要な機能を提供します。基本的なデータ送信、受信機能と簡単に必要なデータを処理する機能を提供してデータ処理を簡素化します。

インストール

X-APIはJavaベースのサーバモジュールとして提供され、JDKまたはJRE1.4以上（2.X.X以上のバージョンではJDKまたはJRE1.8以上）のバージョンが必要になります。

配布ファイル内のnexacro-xapi/libディレクトリに含まれているjarファイルをWASの/WEB-INF/libディレクトリまたは定義されたクラスパスにコピーします。提供されるjarファイルは次のとおりです。

ファイル名

必須

説明

参照

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

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

nexacro-xapi-java-main-2.x.x.jar

Y

X-API

1.0.12以降のバージョンはJakarta EEスペックで実装されたWASで利用できるX-APIを別途提供します。ファイル名に「_jakarta_」が含まれるファイルをダウンロードしてください。


Jakarta EEについては以下のページをご参照ください。

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

common-lang-x.x.jar

Y

脆弱性対策

1.2.X以降のバージョンでサポートします。

nexacro-xapi-java-compatible-2.X.X.jar



DataConvertProviderの拡張時に既存バージョンとの互換性のサポート機能です。

使用時にはCWE-73、80、470の脆弱性が生じる可能性があります。

nexacro-xapi-java-debug-2.X.X.jar



stream logの滋養時に既存バージョンとの互換性のサポート機能です。

使用時にはCWE-73、80、470の脆弱性が生じる可能性があります。

nexacro-xapi-java-miplatform-2.X.X.jar



MiPlatformの通信のサポート機能です。

使用時にCWE-73、80の脆弱性が生じる可能性があります。

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 （追加）

ライセンス認証

ライセンスファイル(NexacroN_server_license.xml)をjarファイルと同じディレクトリ、または定義されたクラスパスにコピーします。

複数のライセンスファイルが別のパスにコピーされた場合には、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: NEXAWEB
Implementation-Vendor-Id: com.nexacro
Implementation-Version: 1.0.0.7805
Implementation-Vendor: NEXAWEB

インストール確認

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のバージョン情報と製品ライセンス情報が出力されます。