Unmaintained Repository

Unmaintained repository. Development moved to: https://github.com/nordic-institute/X-Road-test-service

X-Road Test Service is now actively developed by Nordic Institute for Interoperability Solutions (NIIS). The original X-Road Test Service codebase here will be kept for archive purposes.

X-Road Test Service

X-Road Test Service is a testing tool for X-Road v6.4 and above. The implementation is based on XRd4J library.

Test Service application provides a single service that takes as parameters the size of the response body and the size of the response attachment part. The size defines the number of characters in the response. For example, the below request generates a response which SOAP body contains 25 characters (see full request).

<request>
  <responseBodySize>25</responseBodySize>
  <responseAttachmentSize>0</responseAttachmentSize>
</request>

In addition to the characters specified in the request, the response alsp contains the time that was used for generating the requested string (see full response).

<response>
  <data>ibWHohGndjaJUJvyOBwmfqIZb</data>
  <processingTime>1</processingTime>
</response>

Try It Out

The fastest and easiest way to try out the application is to download the executable jar version (test-service-0.0.3.jar) and run it: java -jar test-service-0.0.3.jar. The application is accessible at:

http://localhost:8080/test-service-0.0.3/Endpoint

The WSDL description is accessible at:

http://localhost:8080/test-service-0.0.3/Endpoint?wsdl

Docker

Test Service version 0.0.2 is also available as Docker image.

docker run -p 8080:8080 petkivim/x-road-test-service

If you're using Docker on Linux natively, then the web app should now be listening on port 8080 on your Docker daemon host. If http://0.0.0.0:8080 doesn't resolve, you can also try http://localhost:8080.

On Windows use docker-machine ip command to get Docker host's IP address.

Software Requirements

• Java 7 or later
• Tomcat 7 or later

Development Environment

Setting up development environment is explained in wiki.

Installation

See instructions for building the code.

JAR

• Build the project and produce test-service-0.0.4-SNAPSHOT.jar file.
• Run the application: $ java -jar test-service-0.0.4-SNAPSHOT.jar.

WAR

• Build the project and produce test-service-0.0.4-SNAPSHOT.war file.
• Copy the file tomcat.home/webapps folder.
• Start/restart Tomcat.

Access the application

After installation (both JAR and WAR) the application is accessible at:

http://localhost:8080/test-service-0.0.4-SNAPSHOT/Endpoint

The WSDL description is accessible at:

http://localhost:8080/test-service-0.0.4-SNAPSHOT/Endpoint?wsdl

N.B. If you want to connect the services to X-Road Security Server you must update your server's IP address / host name to the WSDL file. Look for the below line and replace the default URL with your server's IP / host name.

<soap:address location="http://localhost:8080/test-service-0.0.4-SNAPSHOT/Endpoint" />

Usage

Calling the service after installation when Tomcat is running.

testService

SOAP request can be found in the examples folder.

curl -d @request-1.xml --header "Content-Type: text/xml" -X POST http://localhost:8080/test-service-0.0.3-SNAPSHOT/Endpoint

Example SOAP response can be found in the examples folder.