Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference
11g Release 1 (11.1.1.5.0)

E13403-06


Package oracle.jdeveloper.compare

contains classes nbsp;that can be used to invoke and control the integrated compare (diff) viewer in JDeveloper and hook into the Compare With menu.

See:
          Description

Interface Summary
IdeCompareContributor A supplementary interface to a CompareContributor with IDE integration.
PatchCompareContributor Interface to a compare contributor that provides information for patch creation.

 

Class Summary
BinaryCompareContributor  
CompareConstants  
CompareContext Provides typesafe getter and setter methods for Context properties specific to the compare viewer.
CompareManager The CompareManager provides a mechanism for extensions to register CompareMethod instances for handling a custom compare type.
CompareMethod Base class for a compare/merge method as registered through the CompareManager.
CompareViewer Public API to the standalone compare viewer.
IdeTextCompareContributor A TextCompareContributor specialization with contextual node support.
InputStreamTextContributor A TextCompareContributor that uses an InputStream.
PatchCompareDescriptor Class representing compare contributor information used in the creation of a patch.
Stream  
StreamDecoder This class handles the vagarities of decoding .xml, .html and text files using the correct encoding.
StreamDecoderHelper  
TextNodeContributor A TextCompareContributor based on the current contents of an editor buffer.
URLContributor A contributor to compare based on a URL

 

Enum Summary
StreamType  

 

Exception Summary
FileNotComparableException  
FileTooLargeException  

 

Package oracle.jdeveloper.compare Description

contains classes nbsp;that can be used to invoke and control the integrated compare (diff) viewer in JDeveloper and hook into the Compare With menu.

To use most of the functionality in this package, you need to obtain an instance of CompareViewer. The easiest way to do this is using the static CompareViewer#get() method. Alternatively, you can retrieve the CompareViewer using the JNDI namespace "jdeveloper/compareviewer" as follows:

    import javax.naming.InitialContext;
    ...
    InitialContext ic = new InitialContext();
    CompareViewer viewer = (CompareViewer) ic.lookup( "jdeveloper/compareviewer" );
  

Once you have obtained an instance of CompareViewer, you can use its APIs to install menu items into the Compare With submenu or programmatically display the compare viewer.

Installing Items into the "Compare With" Menu

To install a menu item into the Compare With submenu, call CompareViewer#getMainCompareMenu() or CompareViewer#getContextCompareMenu()

You can use the constant float values defined on CompareViewer to position menu items relative to the default ones using JDeveloper's standard menu APIs in Ide.getMenubar().

Overriding Compare Items

You can override the default behavior of the three pre-installed compare menu items by installing a chained controller for these actions using setController(). To obtain the actions, use the three constants CompareViewer#COMPARE_FILE_ON_DISK_COMMAND, CompareViewer#COMPARE_OTHER_FILE_COMMAND or CompareViewer#COMPARE_EACH_OTHER_COMMAND.

Programmatically Displaying Compare

To programmatically display compare, use the CompareViewer.show( URL, URL ) method. A new compare viewer will be opened for the two specified URLs. The CompareViewer.show( Resource, Resource) method is intended only for use by version control extensions distributed by Oracle, and its use in third party extensions is currently unsupported.


Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference
11g Release 1 (11.1.1.5.0)

E13403-06


Copyright © 1997, 2011, Oracle. All rights reserved.