Package de.jakop.lotus.domingo.proxy

Proxy implementation of the contract in package de.jakop.lotus.domingo.

See: Description

Interface Summary

Interface	Description
NotesRecycler	Interface of recyclers of notes objects.

Class Summary

Class	Description
AgentContextProxy	Represents the agent environment of the current program, if an agent is running it.
AgentProxy	Represents a notes agent.
BaseCollectionProxy	Abstract base class for all implementations of interfaces derived from DBase.
BaseDocumentProxy	Represents a document in a database.
BaseItemProxy	This class represents the Domino-Class Item.
BaseProxy	Abstract base class for all implementations of interfaces derived from DBase.
BaseProxy.DocumentCollectionIterator	Iterator for collections of documents.
DatabaseProxy	Represents a Notes database.
DNotesThread	The NotesThread class extends java.lang.Thread to include special initialization and termination code for Domino.
DocumentCollectionProxy	Represents the Domino-Class DocumentCollection.
DocumentProxy	Represents a document in a database.
DxlExporterProxy	Represents a view entry.
EmbeddedObjectProxy	This class represents the Domino-Class EmbeddedObject.
FormProxy	A notes Form.
InternationalProxy	Proxy to the Notes international settings.
ItemProxy	This class represents the Domino-Class Item.
LogProxy	A notes Log.
NoRecycleStrategy	Implementation of interface NotesRecycler that does no recycling of any Notes objects.
NotesProxyFactory	Factory for sessions to Notes/Domino.
NotesRecycleQueue	Queue of Notes objects to be recycled.
ProfileDocumentProxy	Represents a document in a database.
RecycleStrategy	Implementation of interface NotesRecycler that explicitly recycles almost all Notes objects.
RichTextItemProxy	This class represents the Domino-Class RichTextItem.
RichTextItemProxy.EmbeddedObjectsIterator	A EmbeddedObjectsIterator allows iteration over a set of lotus.domino.EmbeddedObject.
SessionProxy	Notes session.
ViewColumnProxy	Represents the Domino-Class View.
ViewEntryProxy	Represents a view entry.
ViewProxy	Represents the Domino-Class View.

Exception Summary

Exception	Description
NotesProxyException	Class from which all exceptions in this project inherit.
NotesProxyRuntimeException	Class from which all runtime exceptions in this package inherit.

Package de.jakop.lotus.domingo.proxy Description

Proxy implementation of the contract in package de.jakop.lotus.domingo.

Design goals
A Client should have only one session, shared between all threads.
A Server should optionaly have many sessions (one session for each thread) for better performance.

A Notes Session could be shared between different threads, but objects created with one session should never be used with objects created with another session. This must be ensured on application level.

Sessions can be created via Corba or local call.

no recycle needed.

Multithreading issues
(from Notes Design Help)
You should avoid multithreading unless you have good reason to use it, such as proceeding while file input/output and Web requests are processing. Observe the following guidelines:

• Within a session, Domino Objects are shared, synchronized, and recycled across threads. Using a different session on each thread loses these capabilities; you must explicitly manage synchronization and recycle on a per-thread basis.
• Do not use DbDirectory across threads.
• Accessing an existing document on multiple threads is permissible, but accessing it on just one thread simplifies memory management. Restricting accesses to one thread allows you to recycle without checking the other threads. Creating documents across threads is always safe and these objects can be recycled without reference to the other threads.
• Profile documents are cached on a per-thread basis. In the event of an update contention, the last thread updating wins.
• Take care not to delete a document needed for navigation by a view or collection on another thread.
• When child objects are used on threads other than the parent, keep the parent thread alive until all child threads terminate. This is particularly important when using Domino Objects in AWT event handlers.