Berkeley DB XML
version 2.4.11

Deprecated API


Contents
Deprecated Classes
com.sleepycat.dbxml.XmlModify
          As of release 2.4.x, replaced by direct use of XQuery Update.

The XmlModify object and its methods are deprecated and will be dropped in some future release. XQuery Update syntax should be used for both in-place, and copy-based modifications. It is both simpler and more efficient.

The context within which a set of one or more documents specified by an XQuery query can be modified in place. The modification is performed using an XmlModify object, and a series of methods off that object that identify how the document is to be modified. Using these methods, the modification steps are identified. When the object is executed, these steps are performed in the order that they were specified.

XmlModify objects are created using XmlManager.createModify().

The modification steps are executed against one or more documents using XmlModify.execute(com.sleepycat.dbxml.XmlValue, com.sleepycat.dbxml.XmlQueryContext, com.sleepycat.dbxml.XmlUpdateContext). This method can operate on a single document stored in an XmlValue, or against multiple documents stored in an XmlResults set that was created as the result of a container or document query.

Document modifications are always written back to their respective containers. If this behavior is not desired, it is necessary to copy a document to a temporary location and modify it there.

Documents in containers using node storage are updated partially, and only affected nodes and indexes are modified, if possible. Documents in containers using whole-document storage are entirely rewritten and re-indexed.

During construction, XmlModify objects are not free-threaded. They must be constructed in a thread-safe manner. However, a single XmlModify object, once constructed, can be used simultaneously by multiple threads. 

 

Deprecated Fields
com.sleepycat.db.CursorConfig.DEGREE_2
          This has been replaced by CursorConfig.READ_COMMITTED to conform to ANSI database isolation terminology. 
com.sleepycat.db.LockMode.DEGREE_2
          This has been replaced by LockMode.READ_COMMITTED to conform to ANSI database isolation terminology. 
com.sleepycat.db.CursorConfig.DIRTY_READ
          This has been replaced by CursorConfig.READ_UNCOMMITTED to conform to ANSI database isolation terminology. 
com.sleepycat.db.LockMode.DIRTY_READ
          This has been replaced by LockMode.READ_UNCOMMITTED to conform to ANSI database isolation terminology. 
 

Deprecated Methods
com.sleepycat.db.EnvironmentConfig.addDataDir(String)
          replaced by EnvironmentConfig.addDataDir(java.io.File) 
com.sleepycat.collections.StoredCollections.dirtyReadCollection(Collection)
          This method has been replaced by StoredCollections.configuredCollection(java.util.Collection, com.sleepycat.db.CursorConfig) in order to conform to ANSI database isolation terminology. To obtain a dirty-read collection, pass CursorConfig.READ_UNCOMMITTED 
com.sleepycat.collections.StoredCollections.dirtyReadList(List)
          This method has been replaced by StoredCollections.configuredList(java.util.List, com.sleepycat.db.CursorConfig) in order to conform to ANSI database isolation terminology. To obtain a dirty-read list, pass CursorConfig.READ_UNCOMMITTED 
com.sleepycat.collections.StoredCollections.dirtyReadMap(Map)
          This method has been replaced by StoredCollections.configuredMap(java.util.Map, com.sleepycat.db.CursorConfig) in order to conform to ANSI database isolation terminology. To obtain a dirty-read map, pass CursorConfig.READ_UNCOMMITTED 
com.sleepycat.collections.StoredCollections.dirtyReadSet(Set)
          This method has been replaced by StoredCollections.configuredSet(java.util.Set, com.sleepycat.db.CursorConfig) in order to conform to ANSI database isolation terminology. To obtain a dirty-read set, pass CursorConfig.READ_UNCOMMITTED 
com.sleepycat.collections.StoredCollections.dirtyReadSortedMap(SortedMap)
          This method has been replaced by StoredCollections.configuredSortedMap(java.util.SortedMap, com.sleepycat.db.CursorConfig) in order to conform to ANSI database isolation terminology. To obtain a dirty-read map, pass CursorConfig.READ_UNCOMMITTED 
com.sleepycat.collections.StoredCollections.dirtyReadSortedSet(SortedSet)
          This method has been replaced by StoredCollections.configuredSortedSet(java.util.SortedSet, com.sleepycat.db.CursorConfig) in order to conform to ANSI database isolation terminology. To obtain a dirty-read set, pass CursorConfig.READ_UNCOMMITTED 
com.sleepycat.db.TransactionConfig.getDegree2()
          This has been replaced by TransactionConfig.getReadCommitted() to conform to ANSI database isolation terminology. 
com.sleepycat.db.CursorConfig.getDegree2()
          This has been replaced by CursorConfig.getReadCommitted() to conform to ANSI database isolation terminology. 
com.sleepycat.util.ExceptionWrapper.getDetail()
          replaced by ExceptionWrapper.getCause(). 
com.sleepycat.util.IOExceptionWrapper.getDetail()
          replaced by IOExceptionWrapper.getCause(). 
com.sleepycat.util.RuntimeExceptionWrapper.getDetail()
          replaced by RuntimeExceptionWrapper.getCause(). 
com.sleepycat.db.DatabaseConfig.getDirtyRead()
          This has been replaced by DatabaseConfig.getReadUncommitted() to conform to ANSI database isolation terminology. 
com.sleepycat.db.TransactionConfig.getDirtyRead()
          This has been replaced by TransactionConfig.getReadUncommitted() to conform to ANSI database isolation terminology. 
com.sleepycat.db.CursorConfig.getDirtyRead()
          This has been replaced by CursorConfig.getReadUncommitted() to conform to ANSI database isolation terminology. 
com.sleepycat.db.EnvironmentConfig.getTestAndSetSpins()
          replaced by EnvironmentConfig.getMutexTestAndSetSpins() 
com.sleepycat.db.EnvironmentConfig.getVerboseDeadlock()
          replaced by EnvironmentConfig.getVerbose(com.sleepycat.db.VerboseConfig) 
com.sleepycat.db.EnvironmentConfig.getVerboseRecovery()
          replaced by EnvironmentConfig.getVerbose(com.sleepycat.db.VerboseConfig) 
com.sleepycat.db.EnvironmentConfig.getVerboseRegister()
          replaced by EnvironmentConfig.getVerbose(com.sleepycat.db.VerboseConfig) 
com.sleepycat.db.EnvironmentConfig.getVerboseReplication()
          replaced by EnvironmentConfig.getVerbose(com.sleepycat.db.VerboseConfig) 
com.sleepycat.db.EnvironmentConfig.getVerboseWaitsFor()
          replaced by EnvironmentConfig.getVerbose(com.sleepycat.db.VerboseConfig) 
com.sleepycat.collections.StoredContainer.isDirtyRead()
          This method has been replaced by StoredContainer.getCursorConfig(). CursorConfig.isReadUncommitted may be called to determine whether dirty-read is enabled. 
com.sleepycat.collections.StoredContainer.isDirtyReadAllowed()
          This method is deprecated with no replacement in this class. In the DB product, DatabaseConfig.getReadUncommitted may be called. 
com.sleepycat.collections.StoredCollection.iterator(boolean)
          Please use StoredCollection.storedIterator() or StoredCollection.storedIterator(boolean) instead. Because the iterator returned must be closed, the method name iterator is confusing since standard Java iterators do not need to be closed. 
com.sleepycat.dbxml.XmlContainer.lookupIndex(XmlQueryContext, String, String, String)
          as of release 2.2. Use XmlManager.createIndexLookup(com.sleepycat.dbxml.XmlContainer, java.lang.String, java.lang.String, java.lang.String, com.sleepycat.dbxml.XmlValue, int) and XmlIndexLookup.execute(com.sleepycat.dbxml.XmlQueryContext) instead. 
com.sleepycat.dbxml.XmlContainer.lookupIndex(XmlQueryContext, String, String, String, String, String)
          as of release 2.2. Use XmlManager.createIndexLookup(com.sleepycat.dbxml.XmlContainer, java.lang.String, java.lang.String, java.lang.String, com.sleepycat.dbxml.XmlValue, int) and XmlIndexLookup.execute(com.sleepycat.dbxml.XmlQueryContext) instead. 
com.sleepycat.dbxml.XmlContainer.lookupIndex(XmlQueryContext, String, String, String, String, String, XmlValue)
          as of release 2.2. Use XmlManager.createIndexLookup(com.sleepycat.dbxml.XmlContainer, java.lang.String, java.lang.String, java.lang.String, com.sleepycat.dbxml.XmlValue, int) and XmlIndexLookup.execute(com.sleepycat.dbxml.XmlQueryContext) instead. 
com.sleepycat.dbxml.XmlContainer.lookupIndex(XmlQueryContext, String, String, String, String, String, XmlValue, XmlDocumentConfig)
          as of release 2.2. Use XmlManager.createIndexLookup(com.sleepycat.dbxml.XmlContainer, java.lang.String, java.lang.String, java.lang.String, com.sleepycat.dbxml.XmlValue, int) and XmlIndexLookup.execute(com.sleepycat.dbxml.XmlQueryContext) instead. 
com.sleepycat.dbxml.XmlContainer.lookupIndex(XmlQueryContext, String, String, String, XmlValue)
          as of release 2.2. Use XmlManager.createIndexLookup(com.sleepycat.dbxml.XmlContainer, java.lang.String, java.lang.String, java.lang.String, com.sleepycat.dbxml.XmlValue, int) and XmlIndexLookup.execute(com.sleepycat.dbxml.XmlQueryContext) instead. 
com.sleepycat.dbxml.XmlContainer.lookupIndex(XmlQueryContext, String, String, String, XmlValue, XmlDocumentConfig)
          as of release 2.2. Use XmlManager.createIndexLookup(com.sleepycat.dbxml.XmlContainer, java.lang.String, java.lang.String, java.lang.String, com.sleepycat.dbxml.XmlValue, int) and XmlIndexLookup.execute(com.sleepycat.dbxml.XmlQueryContext) instead. 
com.sleepycat.dbxml.XmlContainer.lookupIndex(XmlTransaction, XmlQueryContext, String, String, String)
          as of release 2.2. Use XmlManager.createIndexLookup(com.sleepycat.dbxml.XmlContainer, java.lang.String, java.lang.String, java.lang.String, com.sleepycat.dbxml.XmlValue, int) and XmlIndexLookup.execute(com.sleepycat.dbxml.XmlQueryContext) instead. 
com.sleepycat.dbxml.XmlContainer.lookupIndex(XmlTransaction, XmlQueryContext, String, String, String, String, String)
          as of release 2.2. Use XmlManager.createIndexLookup(com.sleepycat.dbxml.XmlContainer, java.lang.String, java.lang.String, java.lang.String, com.sleepycat.dbxml.XmlValue, int) and XmlIndexLookup.execute(com.sleepycat.dbxml.XmlQueryContext) instead. 
com.sleepycat.dbxml.XmlContainer.lookupIndex(XmlTransaction, XmlQueryContext, String, String, String, String, String, XmlValue)
          as of release 2.2. Use XmlManager.createIndexLookup(com.sleepycat.dbxml.XmlContainer, java.lang.String, java.lang.String, java.lang.String, com.sleepycat.dbxml.XmlValue, int) and XmlIndexLookup.execute(com.sleepycat.dbxml.XmlQueryContext) instead. 
com.sleepycat.dbxml.XmlContainer.lookupIndex(XmlTransaction, XmlQueryContext, String, String, String, String, String, XmlValue, XmlDocumentConfig)
          as of release 2.2. Use XmlManager.createIndexLookup(com.sleepycat.dbxml.XmlContainer, java.lang.String, java.lang.String, java.lang.String, com.sleepycat.dbxml.XmlValue, int) and XmlIndexLookup.execute(com.sleepycat.dbxml.XmlQueryContext) instead. 
com.sleepycat.dbxml.XmlContainer.lookupIndex(XmlTransaction, XmlQueryContext, String, String, String, XmlValue)
          as of release 2.2. Use XmlManager.createIndexLookup(com.sleepycat.dbxml.XmlContainer, java.lang.String, java.lang.String, java.lang.String, com.sleepycat.dbxml.XmlValue, int) and XmlIndexLookup.execute(com.sleepycat.dbxml.XmlQueryContext) instead. 
com.sleepycat.dbxml.XmlContainer.lookupIndex(XmlTransaction, XmlQueryContext, String, String, String, XmlValue, XmlDocumentConfig)
          as of release 2.2. Use XmlManager.createIndexLookup(com.sleepycat.dbxml.XmlContainer, java.lang.String, java.lang.String, java.lang.String, com.sleepycat.dbxml.XmlValue, int) and XmlIndexLookup.execute(com.sleepycat.dbxml.XmlQueryContext) instead. 
com.sleepycat.bind.tuple.TupleBase.newOutput()
          replaced by TupleBase.getTupleOutput(java.lang.Object) 
com.sleepycat.bind.tuple.TupleBase.newOutput(byte[])
          replaced by TupleBase.getTupleOutput(java.lang.Object) 
com.sleepycat.db.TransactionConfig.setDegree2(boolean)
          This has been replaced by TransactionConfig.setReadCommitted(boolean) to conform to ANSI database isolation terminology. 
com.sleepycat.db.CursorConfig.setDegree2(boolean)
          This has been replaced by CursorConfig.setReadCommitted(boolean) to conform to ANSI database isolation terminology. 
com.sleepycat.db.DatabaseConfig.setDirtyRead(boolean)
          This has been replaced by DatabaseConfig.setReadUncommitted(boolean) to conform to ANSI database isolation terminology. 
com.sleepycat.db.TransactionConfig.setDirtyRead(boolean)
          This has been replaced by TransactionConfig.setReadUncommitted(boolean) to conform to ANSI database isolation terminology. 
com.sleepycat.db.CursorConfig.setDirtyRead(boolean)
          This has been replaced by CursorConfig.setReadUncommitted(boolean) to conform to ANSI database isolation terminology. 
com.sleepycat.db.EnvironmentConfig.setTemporaryDirectory(String)
          replaced by EnvironmentConfig.setTemporaryDirectory(java.io.File) 
com.sleepycat.db.EnvironmentConfig.setTestAndSetSpins(int)
          replaced by EnvironmentConfig.setMutexTestAndSetSpins(int) 
com.sleepycat.db.EnvironmentConfig.setVerboseDeadlock(boolean)
          replaced by EnvironmentConfig.setVerbose(com.sleepycat.db.VerboseConfig, boolean) 
com.sleepycat.db.EnvironmentConfig.setVerboseRecovery(boolean)
          replaced by EnvironmentConfig.setVerbose(com.sleepycat.db.VerboseConfig, boolean) 
com.sleepycat.db.EnvironmentConfig.setVerboseRegister(boolean)
          replaced by EnvironmentConfig.setVerbose(com.sleepycat.db.VerboseConfig, boolean) 
com.sleepycat.db.EnvironmentConfig.setVerboseReplication(boolean)
          replaced by EnvironmentConfig.setVerbose(com.sleepycat.db.VerboseConfig, boolean) 
com.sleepycat.db.EnvironmentConfig.setVerboseWaitsFor(boolean)
          replaced by EnvironmentConfig.setVerbose(com.sleepycat.db.VerboseConfig, boolean) 
 


Berkeley DB XML
version 2.4.11

Copyright (c) 1996,2007 Oracle. All rights reserved.