JDeveloper10g VCS Extension API Question

Question

Hi.
I wrote a VCS system for JDeveloper9.0.3 against Microsoft Visual Source Safe, which worked fine. We've now upgraded to 10g, and this system does no longer work, because the JDev's extension API has changed.
I'm therefore rewriting the system to support the 10g API. But I'm a bit overwhelmed by the changes made to the API. Where do I start?
1. I wish to implement a new panel in JDev's preferences screen under VersionControl systems which can configure my plugin.
2. I wish to present files in the Navigator window with overlay icons on files checked in, checked out, not present and such.
4. I wish to add my plugin to the context menu for the Navigator, so that users can be presented with the choice to perform file operations against VSS.
3. I wish to present one dialog for single file operations and one for multiple file operations.
Which classes do I need to extend? Which interfaces do I need to implement?
Can someone give me directions? The help file for the extension API does not give sufficient answers.

Answer 1

To answer your other questions:
The VCSPropertyCustomizer object I've written contains properties I need to use during any VSS operations. Does the IDE store these properties in an easily retrievable place, or do I need to handle this myself.
You can get a VCSPropertyMap from the Ide like this:
  ((VCSPropertyMap)Ide.getSettings().getData( YOUR_DATA_KEY );
And another thing, the example above does not describe dialogs on operations like checkin, checkout and so on.
Would this be implemented in the doitImpl() method in my implementation of VCSAbstractCommand?
Yes... Below is a snippet from the code for the ClearCase client.
FWIW, sorry it's so much work to do this. I'm working on an (optional, i.e won't break existing code) way of just writing a simple xml file to integrate version control clients into JDeveloper that should hopefully make everyone's life easier in the future :P
  protected int doitImpl() throws Exception
    final Collection nodes = getNodesToCheckIn();
    if ( nodes.size() <= 0 )
      return NOOP;
    if (! saveDirtyDocuments( nodes ))
      return Command.CANCEL;
    final Map timestampMap = VCSBufferUtils.storeTimestamps( nodes );
    final VCSDirectoryInvokableState invokableState =
        new VCSDirectoryInvokableState( VCSModelUtils.convertNodesToURLs(
            nodes ) );
    final VCSCommandState state = new VCSCommandState( invokableState,
        timestampMap );
    if ( context.getView() instanceof ClearCaseChangeListWindow &&
      !((ClearCaseChangeListWindow)context.getView()).isUsingCheckInDialog() )
      return checkInSilently( nodes, state,
        ClearCaseClient.getInstance().getChangeListCustomizer() );
    else
      return checkIn( nodes, state );
  protected void noOpImpl() throws ClearCaseValidationException
    throw new ClearCaseValidationException(
        ResourcePicker.get().getString( "ERROR_CHECKIN_FILTERED_TITLE" ), //NOTRANS
        ResourcePicker.get().getString( "ERROR_CHECKIN_FILTERED" ) ); //NOTRANS
  private int checkInSilently(
    final Collection nodes,
    final VCSCommandState state,
    final VCSOptionsCustomizer customizer )
    Ide.getWaitCursor().show();
    Runnable r = new Runnable()
      public void run()
        try
          doCommitOperationImpl( Ide.getMainWindow(), customizer.getOptions(),
            state );
        catch ( Exception e )
          getExceptionHandler().handleException( e, Ide.getMainWindow() );
        finally
          EventQueue.invokeLater( new Runnable()
            public void run()
              Ide.getWaitCursor().hide();
              postCheckIn( state );
    Thread t = new Thread( r, "ClearCase Check In Committer" ); // NOTRANS
    t.start();
    return OK;
  private int checkIn( final Collection nodes,
      final VCSCommandState state )
    throws Exception
    boolean multiCheckin = ( nodes.size() > 1 );
    final VCSOptionsCustomizer customizer =
        new VCSCommentsCustomizer( new ClearCaseCheckinCustomizer(),
        multiCheckin );
    if ( getContext().getView() instanceof ClearCaseChangeListWindow )
      customizer.setOptions(
        ClearCaseClient.getInstance().getChangeListCustomizer().getOptions()
    final JEWTDialog dialog = VCSComponents.createOperationDialog(
      VCSWindowUtils.getCurrentWindow(),
      ResourcePicker.get().getString( "CHECKIN_CAPTION" ), //NOTRANS
      ResourcePicker.get().getString( "CHECKIN_LONG_PROMPT" ), //NOTRANS
      VCSComponents.createFileListerComponent( nodes ),
      customizer.getComponent(),
      "f1_clearcasechkin_html", //NOTRANS
      customizer.getInitialFocusComponent()
    Map options = null;
    if ( ! multiCheckin )
      String checkoutComments = retrieveCheckoutComments( ((Locatable)nodes.
          iterator().next()).getURL() );
      // bug 3067323 - check in dialog does not prepopulate with check out comments
      if ( checkoutComments != null )
        customizer.setOptions( Collections.singletonMap( KEY_SETTING_COMMENTS,
            checkoutComments ) );
    else
      customizer.setOptions( Collections.singletonMap(
          KEY_SETTING_REUSE_COMMENTS, _optionReuseComments ) );
    dialog.addVetoableChangeListener( new VCSDialogCommitter()
      protected final boolean doCommitOperation() throws Exception
        return doCommitOperationImpl(
            dialog, customizer.getOptions(), state);
    boolean dialogSuccessful = ClearCaseDialogRunner.runDialog( dialog );
    postCheckIn( state );
    _optionReuseComments = (Boolean)customizer.getOptions().get(
        KEY_SETTING_REUSE_COMMENTS );
    return (! dialogSuccessful ? Command.CANCEL : Command.OK);
  private void postCheckIn( VCSCommandState state )
    Collection processedUrls = state.getInvokableState().getProcessedURLs();
    if ( processedUrls.size() > 0 )
      VCSBufferUtils.reloadBuffers( state.getTimestampMap() );
    URLFilter filter = VCSURLFilters.createSpecificURLFilter(
      (URL[])processedUrls.toArray( new URL[0] ) );
    ClearCaseClient.getInstance().getStatusCache().clear( filter );
  private boolean doCommitOperationImpl(
      Component dialog, Map options, VCSCommandState state )
      throws Exception
    DeterminateProgressMonitor monitor = new DeterminateProgressMonitor(
      dialog,
      ResourcePicker.get().getString( "CHECKIN_PROGRESS_TITLE" ), //NOTRANS
      ResourcePicker.get().getString( "CHECKIN_WATCHER_DESCRIPTION" ), //NOTRANS
      0,
      -1
    final ClearCaseShellRunner runner = new ClearCaseShellRunner();
    List cmd = new ArrayList();
    cmd.add( "ci" ); //NOTRANS
    Boolean b = (Boolean)options.get( KEY_SETTING_IDENTICAL_CHECKIN );
    if (b != null && b.booleanValue())
      cmd.add( "-ide" ); //NOTRANS
    b = (Boolean)options.get( KEY_SETTING_REUSE_COMMENTS );
    String s = null;
    if (b == null || ! b.booleanValue())
      s = (String)options.get( KEY_SETTING_COMMENTS );
    URL commentFile = writeCommentsFile( s, cmd );
    runner.setCmdList( cmd );
    VCSDirectoryInvokable invokable = new ClearCaseDirectoryInvokable(
        state.getInvokableState(), ClearCaseUtil.FILE_COMMAND_BATCH_SIZE )
      protected final boolean doInvocation2( URL parent, URL[] invokeUrls )
          throws Exception
        String[] filenames = VCSFileSystemUtils.getURLFileNames( invokeUrls );
        runner.setDirURL( parent );
        runner.setOptions( Arrays.asList( filenames ) );
        doInvocationImpl( runner );
        return true;
    invokable.setProgressMonitor( monitor );
    try
      if (! invokable.runInvokable())
        return false;
    finally
      if ( commentFile != null )
        URLFileSystem.delete( commentFile );
    return true;
  private void doInvocationImpl( ClearCaseShellRunner runner ) throws Exception
    runner.exec();
    String error = runner.getErrorText();
    if ( error != null &&
         error.indexOf( "The most recent version on branch" ) >= 0 && //NOTRANS
         error.indexOf( "is not the predecessor of this version" ) >= 0 ) //NOTRANS
      throw new ClearCaseOperationException(
        ResourcePicker.get().getString( "ERROR_CHECKIN_FAILED_TITLE" ), //NOTRANS
        ResourcePicker.getPicker( ClearCaseOperationCheckin.class ).getString(
            "ERROR_CHECKIN_FAILED_SUBSUMED" ) ); //NOTRANS
    if (runner.getExitCode() == null ||
        runner.getExitCode().intValue() != 0)
      throw new ClearCaseProcessException(
        ResourcePicker.get().getString( "ERROR_CHECKIN_FAILED_TITLE" ), //NOTRANS
        ResourcePicker.getPicker( ClearCaseOperationCheckin.class ).getString(
            "ERROR_CHECKIN_FAILED" ), runner.getErrorText() ); //NOTRANS
  private String retrieveCheckoutComments( URL url )
    // bug 3067323 - check in dialog does not prepopulate with check out comments
    String[] cmd = new String[] { "lsco", "-me", "-fmt", "%c", "-cvi", //NOTRANS
        URLFileSystem.getPlatformPathName( url ) };
    try
      ClearCaseShellRunner runner = new ClearCaseShellRunner();
      URL parent = URLFileSystem.getParent( url );
      if ( url == null )
        return null;
      runner.setCmdArray( cmd );
      runner.setDirURL( parent );
      runner.setQuiet( true );
      runner.exec();
      String output = runner.getOutputText();
      if ( output != null && output.equals( "" ) )
        return null;
      return output;
    catch ( Exception e )
      oracle.ide.util.Assert.printStackTrace( e );
      return null;