OTA extension

AlpineBits is an open standard to exchange touristic data. This library provides functionality to implement AlpineBits server. Use it to build your own standalone AlpineBits server, or integrate parts of it into your existing code base.

License	MPLv2 License
Categories	Data
GroupId	it.bz.opendatahub.alpinebits
ArtifactId	ota-extension
Last Version	1.0.3
Release Date	May 21, 2020
Type	pom
Description	OTA extension AlpineBits is an open standard to exchange touristic data. This library provides functionality to implement AlpineBits server. Use it to build your own standalone AlpineBits server, or integrate parts of it into your existing code base.
Project Organization	IDM Südtirol - Alto Adige

Download ota-extension

Filename	Size
ota-extension-1.0.3.pom	733 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/it.bz.opendatahub.alpinebits/ota-extension/ -->
<dependency>
    <groupId>it.bz.opendatahub.alpinebits</groupId>
    <artifactId>ota-extension</artifactId>
    <version>1.0.3</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/it.bz.opendatahub.alpinebits/ota-extension/
implementation 'it.bz.opendatahub.alpinebits:ota-extension:1.0.3'

Gradle Kotlin

// https://jarcasting.com/artifacts/it.bz.opendatahub.alpinebits/ota-extension/
implementation ("it.bz.opendatahub.alpinebits:ota-extension:1.0.3")

Apache Buildr

'it.bz.opendatahub.alpinebits:ota-extension:pom:1.0.3'

Apache Ivy

<dependency org="it.bz.opendatahub.alpinebits" name="ota-extension" rev="1.0.3">
  <artifact name="ota-extension" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='it.bz.opendatahub.alpinebits', module='ota-extension', version='1.0.3')
)

Scala SBT

libraryDependencies += "it.bz.opendatahub.alpinebits" % "ota-extension" % "1.0.3"

Leiningen

[it.bz.opendatahub.alpinebits/ota-extension "1.0.3"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

• api
• impl

AlpineBits Server

AlpineBits is an open standard to exchange touristic data.

This repository provides a library to implement AlpineBits server functionality. Use it to build your own standalone AlpineBits server, or integrate parts of it into your existing code base.

Table of Contents

• Getting started
• Running the tests
• Deployment
• Docker environment
• Information

Getting started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. Take a look at the Deployment section for notes on how to deploy the project on a live system.

Prerequisites

To build the project, the following prerequisites must be met:

• Java JDK 1.8 or higher (e.g. OpenJDK)
• Maven 3.x

For a ready to use Docker environment with all prerequisites already installed and prepared, you can check out the Docker environment section.

Installing

Get a copy of the repository, e.g. by cloning it from the following location:

git clone https://github.com/idm-suedtirol/odh-alpinebits.git

Change directory:

cd odh-alpinebits/

Build the project:

mvn clean install

Examples

The examples folder contains modules with pre-configured AlpineBits server instances, that are easy to get up and running. The main point of the examples is to demonstrate the usage of the library to create a functioning AlpineBits server.

Example: Handshaking action (since 2020-10)

The handshaking example provides an AlpineBits server instance supporting the so called Handshaking action.

Change to the handshaking directory (assuming you are in the projects root folder):

cd examples/handshaking

Run the following maven command:

mvn clean install cargo:run

This command starts a local Tomcat 8 instance using Cargo and deploys the example war file, generated during the installation (see Installing).

The deployment contains an AlpineBits server instance supporting the Handshaking action and a simple website to facilitate the communication with the server.

After Tomcat started, Open the website at http://localhost:8080/examples-handshaking/index.html.

The website provides a set of links and an output area. If you click on any of the links, the website will issue a request against the deployed AlpineBits server instance and display the results.

Example: Housekeeping action (until 2018-10)

The housekeeping example provides an AlpineBits server instance supporting the so called Housekeeping actions.

Change to the housekeeping directory (assuming you are in the projects root folder):

cd examples/housekeeping

Run the following maven command:

mvn clean install cargo:run

This command starts a local Tomcat 8 instance using Cargo and deploys the example war file, generated during the installation (see Installing).

The deployment contains an AlpineBits server instance supporting the Housekeeping actions and a simple website to facilitate the communication with the server.

After Tomcat started, Open the website at http://localhost:8080/examples-housekeeping/index.html.

The website provides a set of links and an output area. If you click on any of the links, the website will issue a request against the deployed AlpineBits server instance and display the results.

Example: Inventory actions

The inventory example provides an AlpineBits server instance supporting the so called Inventory actions. A H2 instance is used for persistence (the database file is written with name alpinebits_inventory to current user's HOME folder).

Change to the inventory directory (assuming you are in the projects root folder):

cd examples/inventory

Run the following maven command:

mvn clean install cargo:run

This command starts a local Tomcat 8 instance using Cargo and deploys the example war file, generated during the installation (see Installing).

The deployment contains an AlpineBits server instance supporting the Inventory action. This example doesn't provide a UI, because its implementation would be rather demanding. At the moment, that effort is not justified.

You can use other tools like curl to perform requests against the running server.

Example: FreeRooms actions

The freerooms example provides an AlpineBits server instance supporting the so called FreeRooms actions. A H2 instance is used for persistence (the database file is written with name alpinebits_freerooms to current user's HOME folder).

Change to the freerooms directory (assuming you are in the projects root folder):

cd examples/freerooms

Run the following maven command:

mvn clean install cargo:run

This command starts a local Tomcat 8 instance using Cargo and deploys the example war file, generated during the installation (see Installing).

The deployment contains an AlpineBits server instance supporting the FreeRooms action. This example doesn't provide a UI, because its implementation would be rather demanding. At the moment, that effort is not justified.

You can use other tools like curl to perform requests against the running server.

Running the tests

The code in this repository provides unit and integration tests.

The unit tests can be run with the following command:

mvn clean verify

To run the unit and integration tests, use the following command, activating the maven it profile:

mvn clean verify -P it

You can also integrate sonarqube to check the code quality. Run the following command:

mvn clean verify sonar:sonar -P it,report

Generate source JARs

To generate the source JARs, use the sources maven profile, e.g. run the following command:

mvn clean install -P sources

Deployment

The project provides a servlet as entry point to the AlpineBits server. If you want, to use it, the following additional prerequisites must be met:

• Servlet Container 3.x (e.g. Tomcat 8)

Using the provided examples as template (see Examples), you should be able to configure your AlpineBits server and to deploy the result as a war onto a servlet container.

Docker environment

For the project a Docker environment is already prepared and ready to use with all necessary prerequisites.

These Docker containers are the same as used by the continuous integration servers.

Installation

Install Docker (with Docker Compose) locally on your machine.

Start and stop the containers

Before start working you have to start the Docker containers:

docker-compose up --build --detach

After finished working you can stop the Docker containers:

docker-compose stop

Running commands inside the container

When the containers are running, you can execute any command inside the environment. Just replace the dots ... in the following example with the command you wish to execute:

docker-compose exec java /bin/bash -c "..."

Some examples are:

docker-compose exec java /bin/bash -c "mvn clean install"

# or

docker-compose exec java /bin/bash -c "mvn clean verify"

# or

docker-compose exec java /bin/bash -c "mvn clean verify -P it"

To check the code quality, you can run the following command and then visit the results at http://localhost:9000/:

docker-compose exec java /bin/bash -c "mvn clean verify sonar:sonar -Dsonar.host.url=http://sonar:9000 -P it,report"

To server the example run the following command and then visit the website at http://localhost:8080/examples-housekeeping/index.html:

docker-compose exec java /bin/bash -c "cd examples/housekeeping && mvn cargo:run"

Information

Support

For support, please contact Christian Gapp or IDM Südtirol - Alto Adige.

Contributing

If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome.

Versioning

This project uses SemVer for versioning. For the versions available, see the tags on this repository.

License

The code in this project is licensed under the Mozilla Public License 2.0 license. See the LICENSE file for more information.

Authors

• Christian Gapp - Initial work - gappc

Acknowledgements

• IDM Südtirol - Alto Adige

NOI Techpark - Südtirol / Alto Adige

Versions

Version
1.0.3 May 21, 2020
1.0.2 Mar 11, 2020
1.0.1 Mar 10, 2020
1.0.0 Mar 2, 2020
0.9.0 Aug 28, 2019
0.8.0 Jul 24, 2019