Skip to main content
Jump to: navigation, search

SMILA/Documentation/Usage of Blackboard Service

< SMILA‎ | Documentation
Revision as of 04:10, 12 August 2008 by (Talk | contribs) (New page: == What is Blackboard == Purpose of the Blackboard Service is management of EILF record data during processing in EILF component (Connectivity, Workflow Processor). Complete record data is...)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

What is Blackboard

Purpose of the Blackboard Service is management of EILF record data during processing in EILF component (Connectivity, Workflow Processor). Complete record data is stored only on a Blackboard which is not pushed through the workflow engine itself. Blackboard service hides handling of record persistence from the services. Clients should generally manipulate records using Blackboard API methods in most cases so records will be completely under control of the Blackboard.

Usage of Blackboard Service

Record lifecycle on the Blackboard

Record can be put onto Blackboard with one of the following operations:

  • create(Id);
    Creates a new record with a given Id. No data is loaded from persistence. If record with this Id already exists in the storages it will be overwritten when the created record will be committed. E.g. used by Connectivity to initialize the record from incoming data.
  • load(Id);
    Loads record data for the given Id from persistence. Used by a client to indicate that it wants to process this record.
  • split(Id, String);
    Creates a fragment of a given record, i.e. the record content is copied to a new Id derived from the given by adding a frament name (see Id Concept for details).
  • setRecord(Record);
    Puts record on the Blackboard, saves record attachments to BinStorage and replaces actual record attachments values with null.
  • synchronize(Record);
    Assumes that record with the same Id as of given record already exists on Blackboard or in storage. Loads record from the storage if needed and updates it's properties with properties of the given record.

Record is removed from the blackboard with one of these operations:

  • commit(Id);
    Saves record and attachments to storages and removes record from the Blackboard.
  • invalidate(Id);
    Record is removed from the Blackboard. If the record was created new (not overwritten) on the Blackboard it will be removed completely.

Attachments management

There are following methods for working with Record attachments in the Blackboard:

  • setAttachment(id, name, byte[]);
  • setAttachmentFromStream(id, name, InputStream);
  • byte[] getAttachment(id, name);
  • InputStream getAttachmentAsStream(id, name);
  • boolean hasAttachment(id, name);

Attachments are not stored anywhere in the Blackboard, they are saved to BinStorage directly and the actual attachment value in the corresponding Record is replaced with Template:Null. It is highly recommended to use only Stream methods to manage attachments because loading the whole attachments in memory will cause great memory consumption and can be cause for application crash.

Usage of Blackboard Notes

Notes is additional temporary data created by pipelets to be used in later pipelets in the same workflow, but not to be persisted in the storages. Notes can be either global or record specific (associated with a record Id). Record specific notes are copied on record splits and removed when the associated record is removed from the Blackboard. Each Note has a String name and Serialaizable value. There are following methods for working with Notes:

  • boolean hasGlobalNote(name);
  • Serializable getGlobalNote(name);
  • setGlobalNote(name, value);
  • boolean hasRecordNote(id, name);
  • getRecordNote(id, name);
  • setRecordNote(id, name, value);

Back to the top