an HTTP bin in Java

Test it out at https://kara.rest

I made this for me an my colleagues, tailored to our needs.

• Websocket interface
• Custom response bodies
• REST api for retrieving bins, results or parts thereof (See the openApi definition)
• MQTT support
• docker container available at https://hub.docker.com/r/yunzlez/kara/

• Replace thymeleaf interface with React, or something
• Support custom headers & cookies in the response
• Support simple template responses (Some work already done, such as an ANTLR4 grammar)
• Statistics (With fancy graphs)
• Scriptable responses
• Externalize configuration
• Support for something else than MySQL

You need:

• Java 11
• MySQL 8

You do:

• mvn package
• just java -jar kara-bin-1.3.0.jar, although setting an XMX is a good idea. I found 128M to be a good value. I use:java -Xmx128M -XX:+UseG1GC -XX:+UseStringDeduplication -XX:-TieredCompilation -jar kara-bin-1.3.0.jar -Dspring.profiles.active=remote

You can pass the following options using -D :

• spring.datasource.url -> JDBC connections string. Use 'kara' as the schema, other names are not yet supported
• spring.datasource.username -> DB username
• spring.datasource.password -> DB Pass
• server.use-forward-headers -> true if running behind proxy (default). Kara needs this to detect the base URL.
• mqtt.broker.url -> broker to use if MQTT is enabled
• mqtt.enabled -> enable MQTT
• mqtt.clientid -> ClientId to use for publishing
• logging.level.be.zlz.kara -> The logging level

You can also run using -Dspring.profiles.active=docker, which allows you to use environment variables for some of these settings:

• DATABASE_URI -> The database URI (not a jdbc string, just the host)
• DATABASE_USR -> DB user
• DATABASE_PWD -> DB password
• MQTT_ENDPOINT -> The MQTT broker uri
• MQTT_ENABLED -> Whether to enable MQTT (default true)

Obviously, you can mix these up with the previous set of settings.