The supplied dates indicate when the API change was made, on the CVS trunk. From this you can generally tell whether the change should be present in a given build or not; for trunk builds, simply whether it was made before or after the change; for builds on a stabilization branch, whether the branch was made before or after the given date. In some cases corresponding API changes have been made both in the trunk and in an in-progress stabilization branch, if they were needed for a bug fix; this ought to be marked in this list.
Fuller descriptions of all changes can be found below (follow links).
Not all deprecations are listed here, assuming that the deprecated APIs continue to essentially work. For a full deprecation list, please consult the Javadoc.
These API specification versions may be used to indicate that a module requires a certain API feature in order to function. For example, if you see here a feature you need which is labelled 1.20, your manifest should contain in its main attributes the line:
OpenIDE-Module-Module-Dependencies: $codebase > 1.20
Added IndexingManager.refreshAllIndices(boolean fullRescan, boolean wait, File... filesOrFolders),
<T> T IndexingManager.runProtected(Callable<T> operation)
Added refreshAllIndices(boolean fullRescan, boolean wait, FileObject... folders).
Added methods IndexingSupport.createDocument(FileObject) and IndexResult.getIndexable()
in order to allow CustomIndexers and BinaryIndexers to use
IndexingSupport.
Added a method for checking an index validity. The method should be called by IndexerFactories to check the index integrity and prevent exceptions during the run on the IDE when the index is broken (for example the IDE was killed during write to the index).
Added scanStarted and scanFinished methods for notifying indexers about start and finish of the indexing of given root. Refactored EmbeddingIndexerFactory and CustomIndexerFactory to move up common methods into super class SourceIndexerFactory.
Modified CustomIndexerFactory, EmbeddingIndexerFactory and BinaryIndexerFactory
to have a method rootsRemoved(Iterable<? extends URL>).This method is used to notify indexers about unused roots.
Indexers may do a clean up of memory caches or close indexes.
Modified CustomIndexerFactory and EmbeddingIndexerFactory
to have methods filesDeleted(Iterable<? extends Indexable> deleted, Context context);
and filesDirty(Iterable<? extends Indexable> deleted, Context context);.
These two methods supersede thier older version, which accepted Collection rather
than Iterable. The new methods allow the infrastructure to optimize files crawling
and improve the overall performance of scanning.
Added Context.isSourceForBinaryRootIndexing() in order to further
optimize java indexing.
Added IndexingManager.refreshIndex(URL root, Collection<? extends URL> files, boolean forceRefresh)
and IndexingManager.refreshIndexAndWait(URL root, Collection<? extends URL> files, boolean forceRefresh).
Added Indexable.getMimeType(), Context.isCancelled().
Removed Indexabe.getName(), Indexable.getLastModified(),
Indexable.openInputStream().
Fixing typo in IndexingManager.refreshAllIndicies(String) method
name. Technically this method was removed and a new one called
IndexingManager.refreshAllIndices(String) was created. The same happened
for IndexingManager.refreshAllIndicies(FileObject...).
Adding Context.checkForEditorModifications() in order to
signal indexers whether they should or should not care about editor documents.
Adding IndexResult.getRoot() and IndexResult.getRelativePath()
methods.
Adding IndexingManager.refreshAllIndicies(String) method
for refreshing all indices created by a given indexer.
Adding two QuerySupport.findRoots(...) methods that can be used
for finding classpath roots from classpaths marked with specific IDs
and supplied by specific project.
Adding IndexingManager.refreshIndexAndWait(URL, Collection<? extends URL>)
for synchronous index refreshing.
Adding CustomIndexerFactory.filesDirty,
EmbeddingIndexerFactory.filesDirty and IndexingSupport.markDirtyDocuments
in order to support on-the-fly reindexing of files modified in the
editor.
Adding IndexingManager class, which allows requesting
to reindex a set of files. Also adding addSupplemntaryFiles
and isSupplementaryFilesIndexing methods to Context
class in order to allow indexers to request reindexing of additional files.
Adding Snapshot.getTokenHierarchy() in order to provide
effective way for accessing lexer tokens created from a Snapshot.
Creating Parsing API.
Built on November 22 2009. | Portions Copyright 1997-2009 Sun Microsystems, Inc. All rights reserved.