Package de.bea.domingo

Interfaces and factory for access to Lotus Notes databases.

See:
Description

Interface Summary

DAgent	Represents notes agents.
DAgentContext	Represents the agent environment of the current program, if an agent is running it.
DBase	Base interface for all concrete notes interfaces.
DBaseDocument	Base interface for all concrete document interfaces.
DBaseItem	Base interface for all concrete item interfaces.
DDatabase	Represents a Notes database.
DDateRange	A date range, can be a range of date-only calendars or a range of time-only calendars.
DDocument	Represents a document in a database.
DDocumentCollection	Represents a collection of documents and provides access to documents within it.
DDxlExporter	Represents a Notes database.
DEmbeddedObject	Represents an embedded object.
DForm	Represents a form in a database.
DItem	Represents a discrete value or set of values in a document.
DLog	Enables you to record actions and errors that take place during a program's execution.
DNotesIterator	Base interface for iterating notes objects.
DNotesMonitor	Interface to monitor notes threads.
DProfileDocument	Represents a profile document in a database.
DRichTextItem	Represents an item of type rich text.
DRichTextStyle	Represents a Notes database.
DSession	Is the root of the Notes Objects containment hierarchy, providing access to the other Domino objects, and represents the Domino environment of the current program.
DView	Represents a view or folder of a database and provides access to documents within it.
DViewColumn	Represents a column in a view or folder.
DViewEntry	Represents a view entry.

Class Summary

DACL	Represents the access control list (ACL) of a database.
DAgentBase	Deprecated. use new class DAgentBase instead
DNotesError	Enumeration of notes errors.
DNotesFactory	Main entry point for applications to the domingo-API.
DNotesFactoryFinder	Implementation finder for the abstract factory DNotesFactory.
DNotesFactoryFinder.ClassLoaderFinderConcrete	Nested class that allows getContextClassLoader() to be called only on JDK 1.2 and yet run in older JDK 1.1 JVMs.

Exception Summary

DNotesException	Exception thrown from the domingo API.
DNotesRuntimeException	Runtime exception thrown from the domingo API.

Error Summary

DNotesFactoryFinder.ConfigurationError

Error class to indicate factory configuration errors.

Package de.bea.domingo Description

Interfaces and factory for access to Lotus Notes databases.

You can call the Domino Objects from a Java program by importing the de.bea.domingo package. The program can be coded as an application, a Domino agent or a servlet. Local calls access run-time code on the local computer, which must have Domino installed. CORBA-based remote (IIOP) calls access run-time code from a remote Domino server; in this case, the local computer need not have Domino installed.

Usage pattern

import de.bea.domingo.DNotesFactory;
import de.bea.domingo.DSession;
import de.bea.domingo.DDatabase;

factory = DNotesFactory.getInstance();
session = factory.getSession();
database = session.getDatabase("", "log.nsf");

You don't have to recycle these objects as in the Notes API. Instead Domingo about recycling all objects properly.

How the Factory finds an implementation of the API

The following strategy is used to find the implementation of the API:

1. At first the system property de.bea.domingo.factory is checked. If the property is available and contains non-empty string, it is interpreted as the name of the factory class of the implementation of the API.
2. It is checked if the resource file de/bea/domingo/domingo.properties exists and contains a non-empty property named de.bea.domingo.factory to be used as the name of the factory class
3. The default implementation is used with the factory class de.bea.domingo.proxy.NotesProxyFactory.