RosaeNLG Java Server
Java Server for RosaeNLG, based on Java Wrapper.
War and jar run
Download
The war file is published on maven.
Run the server
RosaeNLG Java Server is packaged in an executable war file. You can:
-
run it in a plain Java Servlet server like Tomcat - see their documentation
-
run it directly using embedded server with
java:java -jar java-server-VERSION.war
By default, templates are not saved permanently: the server is empty when it starts, you can upload templates and render them, but they are lost when the server is shut down.
To save templates, you must provide a path to the disk. Templates will be saved when uploaded (as json files), and reloaded when the server restarts. You can also push new templates directly on the disk (using CI or whatever) and ask the server to reload them, without having to restart the server.
To set the templates path:
-
Use the environment variable
rosaenlg.homedirto set the path. For instance usejava -Drosaenlg.homedir="C:/some_folder" -jar target/java-server-VERSION.warwhen using the embedded server. -
Alternatively, you can also set the environment variable
ROSAENLG_HOMEDIR.
The server is provided without any security so you should only use it in a microservice architecture, and never make it publicly visible.
Docker version
A docker version (distroless, OpenJDK based) is available on docker hub and called rosaenlg/server-java:
-
to run with a path for templates, use
ROSAENLG_HOMEDIRenvironment variable, and map that folder using-v -
Java Heap Space can be an issue, raise it
Some commands:
-
download:
docker pull rosaenlg/server-java:latest -
run without saving templates on the disk:
docker run -p 8080:8080 -e "JAVA_TOOL_OPTIONS=-Xmx2048m" rosaenlg/server-java:latest -
saving templates on the disk:
docker run -p 8080:8080 --env "JAVA_TOOL_OPTIONS=-Xmx2048m" --env "ROSAENLG_HOMEDIR=/templates" -v /home/ec2-user/templates:/templates rosaenlg/server-java:latest
Documentation, swagger, OpenAPI
When running the server, the documentation is directly available:
-
swagger UI: http://HOST/swagger-ui.html
-
yaml file: http://HOST/v3/api-docs.yaml
Packaging the templates
RosaeNLG templates are typically developed on a node.js environment, as RosaeNLG is primarly a JavaScript library. Once the templates are developed, you can package them in a JSON package (instead of having multiple .pug files, which is not practical), deploy them on RosaeNLG Java Server and render texts.
To package the templates, use the RosaeNLG Packager.
Use the API - Exemple using cURL
Register a template
curl -X PUT \
http://localhost:8080/templates \
-H 'Accept: */*' \
-H 'Accept-Encoding: gzip, deflate' \
-H 'Connection: keep-alive' \
-H 'Content-Type: application/json' \
-d '{
"templateId": "chanson",
"entryTemplate": "chanson.pug",
"compileInfo": {
"activate": false,
"compileDebug": false,
"language": "fr_FR"
},
"templates": {
"chanson.pug": "p\n | il #[+verb(getAnonMS(), {verb: '\''chanter'\'', tense:'\''FUTUR'\''} )]\n | \"#{chanson.nom}\"\n | de #{chanson.auteur}\n"
}
}
'You should get:
{
"templateId":"chanson",
"status":"CREATED"
}Render the template with some input data:
curl -X POST \
http://localhost:8080/templates/chanson/render \
-H 'Accept: */*' \
-H 'Accept-Encoding: gzip, deflate' \
-H 'Connection: keep-alive' \
-H 'Content-Type: application/json' \
-d '{
"language": "fr_FR",
"chanson": {
"auteur": "Édith Piaf",
"nom": "Non, je ne regrette rien"
}
}'You should get:
{
"templateId":"chanson",
"renderedText":"<p>Il chantera \"Non, je ne regrette rien\" d'Édith Piaf</p>",
"renderOptions":{
"language":"fr_FR"
},
"counter":7,
"timestamp":"2019-11-01T18:49:33.216+0000"
}Misc
Do not use the Pug cache parameter, as:
-
anyway the
renderfunction of Pug is not used, so it is useless -
the server already caches the compiled functions