m4_comment([$Id: java.so,v 1.3 2006/09/18 14:45:52 bostic Exp $])m4_ref_title(Upgrading m4_db Applications,    Release 4.3: Java,,    upgrade.4.3/intro, upgrade.4.3/err)m4_p([dnlThe m4_db Java API has changed significantly in the 4.3 release, in waysincompatible with previous releases.  This has been done to provide aconsistent Java-like API for m4_db as well as to make the m4_db Java APImatch the API in m4_db Java Edition, to ease application-porting betweenthe two libraries.])m4_p([dnlHere is a summary of the major changes:])m4_nlistbeginm4_nlist([dnlThe low-level wrapper around the C API has been moved into a packagecalled com.sleepycat.db.internal.])m4_nlist([dnlThere is a new public API in the package com.sleepycat.db.])m4_nlist([dnlAll flags and error numbers have been eliminated from the public API.All configuration is done through method calls on configuration objects.])m4_nlist([dnlAll classes and methods are named to Java standards, matching m4_db JavaEdition.  For example:])m4_indent([dnlm4_bulletbeginm4_bullet([Db -__GT__ Database])m4_bullet([Dbc -__GT__ Cursor])m4_bullet([Dbt -__GT__ DatabaseEntry])m4_bullet([DbEnv -__GT__ Environment])m4_bullet([DbTxn -__GT__ Transaction])m4_bullet([Db.cursor -__GT__ Database.openCursor])m4_bullet([Dbc.get(..., DbConstants.DB_CURRENT) -__GT__ Cursor.getCurrent(...)])m4_bulletend])m4_nlist([dnlThe statistics classes have "getter" methods for all fields.])m4_nlist([dnlIn transactional applications, the Java API infers whether toauto-commit operations: if an update is performed on a transactionaldatabase without supplying a transaction, it is implicitlyauto-committed.])m4_nlist([dnlThe com.sleepycat.bdb.* packages have been reorganized so that the bindingclasses can be used with the base API in the com.sleepycat.db package.  Thebind and collection classes are now essentially the same in m4_db and m4_dbJava Edition.  The former com.sleepycat.bdb.bind.* packages are now thecom.sleepycat.bind.* packages.  The former com.sleepycat.bdb,com.sleepycat.bdb.collections, and com.sleepycat.bdb.factory packages are nowcombined in the new com.sleepycat.collections package.])m4_nlist([dnlA layer of the former collections API has been removed to simplify the API andto remove the redundant implementation of secondary indices.  The formerDataStore, DataIndex, and ForeignKeyIndex classes have been removed.  Insteadof wrapping a Database in a DataStore or DataIndex, the Database object is nowpassed directly to the constructor of a StoredMap, StoredList, etc.])m4_nlistendm4_page_footer