Nexacro APIs (X-APIs) are provided in the form of server modules, and serve the data processing between a server and clients. X-APIs simplify data processing by providing functions such as sending, receiving, and processing data.
Installation
X-APIs, provided in the form of JavaScript-based server modules, require JDK or JRE (version 1.4 or higher).
Copy the jar files included in the lib directory in the deployment file to the /WEB-INF/lib directory of WAS or to the defined classpath. The provided jar file is as follows.
File name | Necessity | Description | Reference |
---|---|---|---|
nexacro-xapi-java-x.x.x.jar nexacro-xapi-java-jakarta_x.x.x.jar | Y | X-API | Versions 1.0.11 and later provide an X-API that can be used in WAS implemented with the Jakarta EE specification. Download and use the file with ""_jakarta_” in the file name. https://jakarta.ee/compatibility |
commons-logging-x.x.x.jar | Y | X-API internal logging | |
json-simple-x.x.x.jar | Y | JSON data processing |
The jar file name includes the version information. If you have not deleted the old version of the file, then the incorrect version of the jar file may be applied. For example, if you are to update the 1.0.0 version to the 1.0.1 version, then you need to delete the 1.0.0 version.
nexacro-xapi-java-1.0.0.jar
(Delete)
nexacro-xapi-java-1.0.1.jar
(Add)
License Authentication
Users will copy the license file (NexacroN_server_license.xml) to the same directory or defined class path as the one that contains JAR files.
If one or more other license files are copied to different paths, the license file located in the same directory with JAR files is first to be applied.
Depending on the setup of the server, the WAS requires re-booting after JAR files and a license file are copied.
Version Check
If the jar file name is expressed in 2 digits like "1.x.x", then the "1.x.x" included in the file name is the version.
If the jar file name is "1.0", then check the "Implementation-Version" item with the following command for the X-API version. Nexacro-xeni
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: December 16 2019
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.java
Implementation-Version: 1.0.0.7805
Implementation-Vendor: TOBESOFT CO., LTD.
Confirming Installation
Whether the installation was successful can be confirmed by writing the sample JSP file presented below.
<%@ 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>
If successful, details of the X-API version and product license will be output.