Displaying the Persistence Object Chooser

The persistence object chooser is a user interface for saving and retrieving objects in the BI Beans Catalog. The persistence object chooser can display either an Open dialog box or a Save dialog box.

For opening and saving objects, the persistence object chooser does not call the methods of the persistence service. Instead, the persistence object chooser captures input from users and provides the information to you, and you call the methods of the persistence service to open (lookup) or save (bind or rebind) objects.

Users can also do other operations in the dialog box that the persistence object chooser displays, such as creating a new folder, deleting a folder, moving objects, and copying objects. For these operations, the persistence object chooser calls methods of the persistence service to accomplish the user's desired task. You do not need to write code for actions that occur before the user chooses OK in the dialog box.

Initializing the persistence object chooser

The persistence object chooser requires the root folder (initial context) of the namespace. To provide this information, you can do either of the following:

Displaying the dialog box

You can display either an Open dialog box or a Save dialog box from the persistence object chooser:

Each of these methods returns one of the following values: