Events Development: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
Line 61: Line 61:


* The pipeline is initialized by the runtime, but there is no queue between the event processor and terminator. The command must install it.
* The pipeline is initialized by the runtime, but there is no queue between the event processor and terminator. The command must install it.
* The command executes on the main thread and might exit (and kill the JVM in the process) before the terminator had a chance to process its queue. Always register an EndOfStreamListerer with the terminator and wait on the main thread until that listener is notified.

Revision as of 07:02, 24 April 2016

Internal

Clone

git clone git@github.com:NovaOrdis/events.git

TODO

doc/Event Development.docx TODO section.

Development

Unnumbered Development Release

This will install a new unnumbered (same release number) "development" release locally:

cdesa
mvn clean install; ./bin/install -f

Numbered Release

1. Increment (or update) the version information from $PROJECT_HOME/pom.xml.

2. Build and install

-f is not necessary:

mvn clean install; ./bin/install

3. Check in

mvn clean
git add .
git commit -m "starting ... version"
git push

Individual Unit Test

mvn -Dmaven.surefire.debug="-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=5012" -Dtest=EventsApplicationRuntimeTest clean test

How to add New Commands

This is how you code new clad commands:

Clad User Manual

A few things to keep in mind:

  • The pipeline is initialized by the runtime, but there is no queue between the event processor and terminator. The command must install it.
  • The command executes on the main thread and might exit (and kill the JVM in the process) before the terminator had a chance to process its queue. Always register an EndOfStreamListerer with the terminator and wait on the main thread until that listener is notified.