seralf / daf-semantic-katalod

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

katalod

This module is designed to offer support for parsing ontologies and vocabularies, eventually exposing the minimum set of metadata to the other components.

For simplicity it is designed re-using jersey and swagger with jetty, using RDF4J as the main interface to RDF.

NOTE: the application should be considered an early (alpha) release, as it is still work-in-progress: all the endpoints and functions are still constantly evolving.

[last update: 2018-08-06]

maven build / install

mvn clean install

CHECK: in order to use the library as an sbt dependency, we should create a proper naming convention for the artifact, such as: {artifact}_{scalaVersion}.jar

maven test

in order to run the application locally after a mvan build, for easy testing, we can:

mvn clean package

# WIN
java -cp "target/kataLOD-0.0.11.jar;target/libs/*" it.almawave.kb.http.MainHTTP

# linux
java -cp "target/kataLOD-0.0.11.jar:target/libs/*" it.almawave.kb.http.MainHTTP

dockerization

After the maven artifact was built: ```bash mvn clean package ```

It's possible to create a docker image directly using the drafted Dockefile .

sudo docker build . -t katalod:0.0.11

In order to run a new container from the generated build, we can use the following command:

sudo docker run -p 7777:7777 katalod:0.0.11

NOTE: currently the port 7777 is used as the default port


TODO / CHECK

  • proper test converage (with JerseyTest, JUnit, Mockito, etc.)
  • improve of configuration handling, using the external file
  • check: creating Dockerfile / docker image directly from maven build
  • enable the generation of resources list (ontologies / vocabularies) directly from github (see tests)
  • add detail API for vocabularies (with DCAT, see tests)
  • add detail API for ontologies (with VOWL, see tests)
  • enable solr for improve API performance, filtering, navigations (see tests)
  • check: simple HTML pages for testing?
  • check: netty instead of jetty?
  • check: replace maven with sbt? - [ ] check: rewrite with play?
  • check: better handling / mapping of swagger port when using docker

NOTE: we could think about changing jetty with play! for the endpoints

About

License:Apache License 2.0


Languages

Language:Scala 89.2%Language:HTML 5.1%Language:Roff 4.0%Language:Dockerfile 1.7%