com.levigo.jadice.document.render

Class RenderControlsInventory

java.lang.Object

com.levigo.jadice.document.render.RenderControlsInventory

All Implemented Interfaces:

Inventory<RenderControls,RenderSettings>

public abstract class RenderControlsInventory
extends Object
implements Inventory<RenderControls,RenderSettings>

Implementations of RenderControlsInventory handle document and page specific render controls belonging to a certain document instance.

Instances of this interface allow to get access to document and page specific render settings which is especially useful when the keep render settings mode is enabled.

This interface allows to get access to document and page specific render settings. With that it allows to change the render settings, too. To support multi viewer usage of one single document instance, viewers always works on snapshots of document render control inventories. As a consequence changes may not be reflected by any viewer which holds this document currently.

Therefore it is strongly recommended that developers do not change any of the render settings while the associated document is hold by any viewer instance, if and only if the render control instance is retrieved by a call of get(Document) or get(Document, boolean). Ignoring this recommendation would cause undesirable failures and inconsistencies may happen.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	RenderControlsInventory.Synchronizer

Constructor Summary

Constructors

Constructor and Description
RenderControlsInventory()

Method Summary

Modifier and Type	Method and Description
abstract void	addInventoryRenderSettingsListener(InventoryRenderSettingsListener listener) Adds a InventoryRenderSettingsListener for receiving render settings change events.
static RenderControlsInventory	bindInventoryToDocument(Document doc, RenderControlsInventory inv) Binds the given inventory to the document.
static RenderControlsInventory.Synchronizer	createDefaultSynchronizer() Returns a default synchronizer which reflects document render settings changes into all page render controls.
abstract RenderControlsInventory	createSnapshot() Creates a snapshot copy of this inventory instance.
static RenderControlsInventory	get() Creates and returns an empty RenderControlsInventory.
static RenderControlsInventory	get(Document document) Returns the RenderControlsInventory for the given document.
static RenderControlsInventory	get(Document document, boolean create) Creates and returns a RenderControlsInventory for given document.
abstract RenderControls	getDocumentRenderControls() Return the documents render control
abstract List<InventoryRenderSettingsListener>	getInventoryRenderSettingsListeners() Returns a list of the registered InventoryRenderSettingsListener.
abstract RenderControls	getPageRenderControls(Page page) Return the page render control for the given page.
abstract RenderControls	getPageRenderControls(Page page, boolean create) Return the page render control for the given page.
abstract boolean	hasPageRenderControls(Page page) Return whether the page has specific render control settings.
abstract void	removeInventoryRenderSettingsListener(InventoryRenderSettingsListener listener) Removes a InventoryRenderSettingsListener.
abstract void	setSettingsSynchronizer(RenderControlsInventory.Synchronizer handler) The default synchronizer reflects document render settings changes into all page render controls.
static RenderControlsInventory	unbindInventoryFromDocument(Document doc) Unbinds any inventory from the document.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RenderControlsInventory

public RenderControlsInventory()

Method Detail

get

public static RenderControlsInventory get(Document document)

Returns the RenderControlsInventory for the given document. If no RenderControlsInventory exists for given document, null will be returned.

Parameters:

document - the document for which the RenderControlsInventory is demanded

Returns:

RenderControlsInventory for given document or null if not available.

See Also:

get(), get(Document, boolean)

get

public static RenderControlsInventory get(Document document,
                                          boolean create)

Creates and returns a RenderControlsInventory for given document. If no RenderControlsInventory exists for given document, the boolean parameter decides whether a new one will be created, will be bound to the document and will be returned.

Parameters:

document - the document for which the RenderControlsInventory is demanded

create - if no inventory exist for given document:

• true creates a new inventory, bind it to the document and return it,
• false null will be returned

Returns:

RenderControlsInventory for given document or null.

See Also:

get(), get(Document), bindInventoryToDocument(Document, RenderControlsInventory)

get

public static RenderControlsInventory get()

Creates and returns an empty RenderControlsInventory. This inventory is not bound to any document. It can be used to store render controls settings temporarily.

Returns:

an empty RenderControlsInventory

See Also:

get(Document), get(Document, boolean), bindInventoryToDocument(Document, RenderControlsInventory)

createDefaultSynchronizer

public static RenderControlsInventory.Synchronizer createDefaultSynchronizer()

Returns a default synchronizer which reflects document render settings changes into all page render controls.

Returns:

RenderControlsInventory.Synchronizer

bindInventoryToDocument

public static RenderControlsInventory bindInventoryToDocument(Document doc,
                                                              RenderControlsInventory inv)

Binds the given inventory to the document. If the document is already bound to another inventory, the older binding is replaced with the new one.

Returns:

Returns the previous inventory the document was bound to or null if the document was not bind to another inventory before

See Also:

get(Document), unbindInventoryFromDocument(Document)

unbindInventoryFromDocument

public static RenderControlsInventory unbindInventoryFromDocument(Document doc)

Unbinds any inventory from the document.

Returns:

Returns the previous inventory the document was bound to or null if the document was not bind to another inventory before

See Also:

get(Document), bindInventoryToDocument(Document, RenderControlsInventory)

getDocumentRenderControls

public abstract RenderControls getDocumentRenderControls()

Return the documents render control

Specified by:

getDocumentRenderControls in interface Inventory<RenderControls,RenderSettings>

Returns:

document specific render control

getPageRenderControls

public abstract RenderControls getPageRenderControls(Page page)

Return the page render control for the given page. If no page render control exist, null will be returned.

Specified by:

getPageRenderControls in interface Inventory<RenderControls,RenderSettings>

Parameters:

page - the page for which the page render control lookup is demanded

Returns:

the page specific render control or null if no page render control is available

getPageRenderControls

public abstract RenderControls getPageRenderControls(Page page,
                                                     boolean create)

Return the page render control for the given page. If no page render control exist, the value of the create parameter decides whether a page render control should be created.

Specified by:

getPageRenderControls in interface Inventory<RenderControls,RenderSettings>

Parameters:

page - the page for which the page render control lookup is demanded

create - boolean flag. If no page render control for given page is available, true means a new one will be created and returned otherwise if the create parameter is false, null will be returned.

Returns:

the page specific render control, or null if no page render control is available and the create parameter is false.

hasPageRenderControls

public abstract boolean hasPageRenderControls(Page page)

Return whether the page has specific render control settings.

Parameters:

page - the page for which the page render control lookup is demanded

Returns:

whether the page has specific render control settings

createSnapshot

public abstract RenderControlsInventory createSnapshot()

Creates a snapshot copy of this inventory instance. As a snapshot the returned copy presents the current state of this inventory, but is not bound to an inventory or to a document. This means changes of this inventory made after the snapshot creation are not reflected in the snapshot copy and vice versa. The copy just store the current settings state at the moment of snapshot creation.

Returns:

a snapshot copy of this inventory

setSettingsSynchronizer

public abstract void setSettingsSynchronizer(RenderControlsInventory.Synchronizer handler)

The default synchronizer reflects document render settings changes into all page render controls. To change this default behavior use this method to register a customized handler. The handler have to be a RenderControlsInventory.Synchronizer which will be called whenever a change of the document render control happened.

To restore the default behavior use a default synchronizer which can be obtained by a call of createDefaultSynchronizer().

If no synchronization should happen set null as RenderControlsInventory.Synchronizer.

Parameters:

handler - to synchronize document render settings changes into page render settings

addInventoryRenderSettingsListener

public abstract void addInventoryRenderSettingsListener(InventoryRenderSettingsListener listener)

Adds a InventoryRenderSettingsListener for receiving render settings change events.

Parameters:

listener - the listener to register

removeInventoryRenderSettingsListener

public abstract void removeInventoryRenderSettingsListener(InventoryRenderSettingsListener listener)

Removes a InventoryRenderSettingsListener.

Parameters:

listener - the listener to remove

getInventoryRenderSettingsListeners

public abstract List<InventoryRenderSettingsListener> getInventoryRenderSettingsListeners()

Returns a list of the registered InventoryRenderSettingsListener.

It is up to the implementation whether to return the internal listener collection or a copy of this. Therefore changes made to the returned list must not be reflected in the internal listener collection. Addition or removal of listeners should always be done with a call of addInventoryRenderSettingsListener(InventoryRenderSettingsListener) or removeInventoryRenderSettingsListener(InventoryRenderSettingsListener).