Hitachi

uCosminexus Application Server Maintenance and Migration Guide


12.3.4 Changes in JAX-RS

Organization of this subsection

(1) Change in the JAX-RS engine

Application Server version 11 and Developer version 11 newly provide the JAX-RS 2.0 engine, which supports JAX-RS 2.0. This engine is stored in a different JAR file from the conventional JAX-RS engine of Application Server version 9 or earlier and of Developer version 9 or earlier. For this reason, the class path settings required to use the JAX-RS engine are different.

For Application Server version 9 or earlier and Developer version 9 or earlier

add.class.path=<cosminexus.home>\jaxrs\lib\cjjaxrs.jar

For Application Server version 11 or later and Developer version 11 or later

add.class.path=<cosminexus.home>\CC\javaee\1100\lib\jaxrs-impl.jar
add.class.path=<cosminexus.home>\CC\javaee\1100\lib\jaxrs-jackson.jar

If the JAX-RS engine (cjjaxrs.jar) of Application Server version 9 or earlier and of Developer version 9 or earlier is still set for the class path, the application will not operate normally. Be sure to revise the class path settings.

(2) Abolition of Cosminexus's original parameters for the JAX-RS engine

The JAX-RS 2.0 engine of Application Server version 11 and Developer version 11 does not support Cosminexus's self-defined files and parameters, which were supported by the JAX-RS engine of Application Server version 9 or earlier and of Developer version 9 or earlier. The definition files and parameters described in 13.1 Action definition file of the uCosminexus Application Server Web Service Development Guide cannot be used in Application Server version 11 or Developer version 11.

(3) Abolition of the client APIs for RESTful Web Services

The JAX-RS 2.0 specifications newly standardized the client APIs. As a result, Cosminexus's original client APIs for RESTful Web Services, which were supported by the JAX-RS engine of Application Server version 9 or earlier and of Developer version 9 or earlier, are not supported. The functions described in 25. Support Range of the Client APIs for RESTful Web Services of the uCosminexus Application Server Web Service Development Guide cannot be used in Application Server version 11 or Developer version 11.

For applications that use the client APIs of JAX-RS, replace those APIs with JAX-RS 2.0 standard APIs by following the JAX-RS 2.0 specifications and the JAX-RS 2.0 API specifications.

JAX-RS 2.0 API specifications (provided by Oracle)

https://docs.oracle.com/javaee/7/api/javax/ws/rs/client/package-summary.html