com.ibm.ftt.ui.resources.core.editor
Interface IEditorOpener

All Known Implementing Classes:
EditorOpener

public interface IEditorOpener

Interface for utility classes used to open resources in an edit session.


 try {
         EditorOpener.getInstance().open(selectedItem);
 } catch (Exception e) {
         // Exception handling code
 }
 
Each utility class implementing this interface would be responsible for a particular subtype of resources (e.g. MVS Physical Resources, USS Logical Resources, etc). Additional implementations for new resource types can be contributed through the com.ibm.ftt.ui.resources.editorOpener extension point. All classes declared in the com.ibm.ftt.ui.resources.editorOpener extension point should implement the IEditorOpener interface.

Note: Each class implementing IEditorOpener must provide a static method getInstance, returning a singleton instance for the class.

Caller should invoke EditorOpener instead of the resource type specific IEditorOpener implementations directly.


Field Summary
static String COPY_RIGHT
           
 
Method Summary
 void browse(Object resource)
          Opens the specified resource in read only mode.
 boolean canBrowse(Object resource)
          Returns whether the resource can be browsed or not
 void gotoLine(Object resource, int lineNumber, int charStart, int charEnd)
          Opens the resource and goes to the specified line, highlighting the section from charStart to charEnd.
 void open(Object resource)
          Opens an edit session for the specified resource.
 void open(Object resource, IEditorDescriptor editorDescriptor)
          Opens an edit session for the specified resource using the specified editor.
 

Field Detail

COPY_RIGHT

static final String COPY_RIGHT
See Also:
Constant Field Values
Method Detail

open

void open(Object resource)
          throws Exception
Opens an edit session for the specified resource. The default editor will be used.

Parameters:
resource - resource to open
Throws:
Exception - if the resource cannot be opened.

open

void open(Object resource,
          IEditorDescriptor editorDescriptor)
          throws Exception
Opens an edit session for the specified resource using the specified editor.

Parameters:
resource - resource to open
editorDescriptor - descriptor object for the editor to use
Throws:
Exception - if the resource cannot be opened.

browse

void browse(Object resource)
            throws Exception
Opens the specified resource in read only mode.

Parameters:
resource - resource to browse
Throws:
Exception - if the resource cannot be browsed

gotoLine

void gotoLine(Object resource,
              int lineNumber,
              int charStart,
              int charEnd)
              throws Exception
Opens the resource and goes to the specified line, highlighting the section from charStart to charEnd.

Parameters:
resource - resource to open
lineNumber - line number to go to (line 1 is the first line)
charStart - start of the highlighted section (char 0 is the first character)
charEnd - end of the highlighted section (char 0 is the first character)
Throws:
Exception - if goto line operation fails

canBrowse

boolean canBrowse(Object resource)
Returns whether the resource can be browsed or not

Parameters:
resource - resource to check for browse
Returns:
true if the resource can be browsed, or false if not.