User Manual

Contents

• User Manual
• Contents
• Introduction
• Logbook
• Installing the module
• Example of adding the module
• Example of cloning the module
• API methods
• Exports
• createSubscriber
• updateSubscriber
• createPublisher
• updatePublisher
• subscribe
• unsubscribe
• createMessage
• updateMessage
• sendMessage
• Infrastructure methods
• Exports
• connect
• create
• gather (read)
• update
• Examples
• Domain Items
• Subscriber
• SubscriberType
• Publisher
• PublisherType
• Message
• Examples
• test.jl
• make.jl
• doc.jl
• Julia Notebook
• References

Introduction

I like to master the Julia programming language. To get more experience, I created the project 'rbontekoe/RbO.jl.'

Also, I decided to use Documenter.jl to create the documentation for the project, after looking at a video that explains its features. I was impressed when Morton Phiibleht told about the possibility to test the code example automatically during the creation of the manual. The result is this manual.

For the creation of the Julia notebook, I used Literate.jl, after watching this video.

Logbook

9/17/2019

Reading Think Julia I discovered the package Serialization. While playing with it, I realized that it could solve my CQRS and Event Sourcing problem. With the method serialize, you can create a text representation of an object, that you can store. With deserialize, you do the reverse. Serialize writes to an IOStream, and deserialize reads from it. An IOStream can be an IOBuffer or a file. It makes Event Sourcing easier.

I also looked at channels. You can use channels to communicate between processes. For the time being, I will use inter CPU-core communication. Later on, I extend it to remote nodes. I only have to expand the methods of createSubscriber and createPublisher.

9/10/2019

Last week I was busy implementing the database methods. I realized that the domain objects I wanted to keep must have an identification code. So Subscriber, Publisher, and Message got an id. To create the id, I used the hash function with a name and time as a parameter. It had consequences for the documentation. In the example code, I used the tag 'jldoctest,' so Documenter could test the example code during the generation of the manual. Because the ids keep changing, I had to give up. Too bad, because I found that a strong point of Documenter.jl. I replaced the test tag 'jldoctest' with the language tag 'julia.' Maybe there is something to do against continually changing values.

Infected by the CQRS thought, I decided to add changed domain objects to the database instead of modifying an existing record.