This package provides a high level interface for working with digital objects. A Repository provides a service through which objects can be accessed. A Repository instance represents a connection to a digital object server and enables a client to create, access, delete and verify digital objects. The DigitalObject class provides an interface to interact with a digital object, its elements and attributes. The DataElement class provides the methods needed to access the data element contents and attributes.
To begin using this API you will need the do.jar and do_api.jar files which were likely included with this documentation. Make sure the do.jar and do_api.jar files are in your classpath within your development environment.
As this API is for client access to digital objects, you will need to have access to a repository or digital object server in which you have been granted rights to create and/or manipulate objects. You can contact your repository administrator in order to obtain access to a development repository or the software to run your own digital object server.
The first step to using the API is to instantiate your authentication information. There are two methods of authenticating your client with the repository system: secret key, and public key. Both methods use the same keys and verification methods as the handle system. The preferred method of authentication uses public keys and is provided by the PKAuthentication class. If you must revert to secret key authentication you can use the SecretKeyAuthentication class. Both are subclasses of DOAuthentication which is required by the Repository class to establish a connection.
Given an instance of DOAuthentication and the identifier for the digital object server you can instantiate a Repository object and use it to create or access objects within that server.