Skip to content

Latest commit

 

History

History
107 lines (85 loc) · 3.86 KB

JAVA_SUPPORT.md

File metadata and controls

107 lines (85 loc) · 3.86 KB
Raw

Quarks Java support

As documented in (DEVELOPMENT.md) Quarks development is performed using Java 8 but Java 7 and Android is supported through use of retrolambda to build specific jars.

Building a release ant release produces three sets of Jars under

  • target/java8 - Java 8 SE
  • target/java7 - Java 7 SE
  • target/android - Android

This page documents which jars are expected to work in each environment.

Core

Jar Java 8 Java 7 SE Android Notes
quarks.api.execution.jar yes yes yes
quarks.api.function.jar yes yes yes
quarks.api.graph.jar yes yes yes
quarks.api.oplet.jar yes yes yes
quarks.api.topology.jar yes yes yes
quarks.api.window.jar yes yes yes
quarks.providers.development.jar yes no Uses JMX, For development only, not deployment
quarks.providers.direct.jar yes yes yes
quarks.providers.iot.jar yes yes yes
quarks.runtime.appservice.jar yes yes yes
quarks.runtime.etiao.jar yes yes yes
quarks.runtime.jmxcontrol.jar yes yes no Uses JMX
quarks.runtime.jobregistry.jar yes
quarks.runtime.jsoncontrol.jar yes yes yes
quarks.spi.graph.jar yes yes yes
quarks.spi.topology.jar yes yes yes

Connectors

Jar Java 8 SE Java 7 SE Android Notes
quarks.connectors.common.jar yes yes yes
quarks.connectors.file.jar yes
quarks.connectors.http.jar yes yes yes
quarks.connectors.iotf.jar yes yes yes
quarks.connectors.iot.jar yes yes yes
quarks.connectors.jdbc.jar yes
quarks.connectors.kafka.jar yes
quarks.connectors.mqtt.jar yes
quarks.connectors.pubsub.jar yes yes yes
quarks.connectors.serial.jar yes
quarks.connectors.wsclient.jar yes
quarks.connectors.wsclient-javax.websocket.jar yes
quarks.javax.websocket.jar yes

Applications

Jar Java 8 SE Java 7 SE Android Notes
quarks.apps.iot.jar yes yes yes
quarks.apps.runtime.jar yes yes yes

Analytics

Jar Java 8 SE Java 7 SE Android Notes
quarks.analytics.math3.jar yes
quarks.analytics.sensors.jar yes

Utilities

Jar Java 8 SE Java 7 SE Android Notes
quarks.utils.metrics.jar yes

Development Console

Jar Java 8 SE Java 7 SE Android Notes
quarks.console.servlets.jar yes no Uses JMX, Servlet
quarks.console.server.jar yes no Uses JMX, Servlet

Android

Jar Java 8 SE Java 7 SE Android Notes
quarks.android.topology.jar no no yes
quarks.android.hardware.jar no no yes

Adding Jars to Java 7 & Android

Java 7 jars are created using platform/java7/build.xml. Adding a Java just requires:

  • Adding it to target retro7.quarks - Copy entry for an existing jar.
  • Adding any tests for it to targets test7.setup and test7.run - Copy entry for an existing jar.

Any Java 7 jar is automatically included in Android unless it is explictly excluded in platform/android/build.xml.

Java API Usage

Documented use of Java packages outside of the Java core packages. Java core has a number of definitions, but at least those outside of the Java 8 compact1 definition.

Feature Packages Quarks Usage Notes
JMX java.lang.management, javax.managment* JMX not supported on Android
JMX utils/metrics Optional utility methods
JMX console/servlets, runtime/jmxcontrol
Servlet javax.servlet* console/servlets
Websocket javax.websocket connectors/quarks.javax.websocket, connectors/wsclient-javax-websocket, connectors/javax.websocket-client
JDBC java.sql, javax.sql connectors/jdbc