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.
The persistence object chooser requires the root folder (initial context) of the namespace. To provide this information, you can do either of the following:
Use the constructor that takes the root folder as an argument
Call the setInitialDirectory
method on the persistence object chooser after you instantiate it
You can display either an Open dialog box or a Save dialog box from the persistence object chooser:
To display the Open dialog box, call the showOpenDialog
method.
To display the Save dialog box, call the showSaveDialog
.
Each of these methods returns one of the following values:
OK_OPTION
-- If the user chooses the OK button to dismiss the dialog
CANCEL_OPTION
-- If the user chooses the Cancel button to dismiss the dialog