org.xmlBlaster.util.queue
Interface I_EntryFactory

All Known Implementing Classes:

ClientEntryFactory

public interface I_EntryFactory

The Interface which can be used to convert an object which implements the interface I_Entry to a byte[] object and back. This is useful for example if you want to store such entries in persistent storage like a database or a file system. It might however be used even for other purposes.

Author:

michele@laghi.eu, xmlBlaster@marcelruff.info

Method Summary

I_Entry	createEntry(int priority, long timestamp, java.lang.String type, boolean persistent, long sizeInBytes, java.io.InputStream is, StorageId storageId) Parses back the raw data to a I_Entry (deserializing)
java.lang.Object	getProperties() Access the current Parser configuration
void	initialize(Global glob) Is called after the instance is created.
void	setProperties(java.lang.Object userData) Allows to overwrite properties which where passed on initialize() The properties which support hot configuration are depending on the used implementation
byte[]	toBlob(I_Entry entry) Parses the specified entry to a byte array (serializing).

Method Detail

toBlob

public byte[] toBlob(I_Entry entry)
              throws XmlBlasterException

Parses the specified entry to a byte array (serializing).

Throws:

XmlBlasterException

createEntry

public I_Entry createEntry(int priority,
                           long timestamp,
                           java.lang.String type,
                           boolean persistent,
                           long sizeInBytes,
                           java.io.InputStream is,
                           StorageId storageId)
                    throws XmlBlasterException

Parses back the raw data to a I_Entry (deserializing)

Parameters:

priority - The priority of the entry (the queues first sort criteria)

timestamp - The queues second sort criteria

type - The type of the entry, used to know how to parse it

persistent - true: the entry is persistent, false: the entry is swapped from cache (no more RAM memory)

sizeInBytes - The approximate, immutable size that the entry occupies in RAM, this can be totally different to the size the entry occupies on storage

storageId - A unique identifier of the queue

Throws:

XmlBlasterException

initialize

public void initialize(Global glob)

Is called after the instance is created.

setProperties

public void setProperties(java.lang.Object userData)

Allows to overwrite properties which where passed on initialize() The properties which support hot configuration are depending on the used implementation

getProperties

public java.lang.Object getProperties()

Access the current Parser configuration