| org.eclipse.ui.texteditor.IDocumentProvider
All known Subclasses: org.eclipse.ui.texteditor.AbstractDocumentProvider,
| IDocumentProvider | | public interface IDocumentProvider (Code) | | A document provider maps between domain elements and documents. A document provider has the
following responsibilities:
- create an annotation model of a domain model element
- create and manage a textual representation, i.e., a document, of a domain model element
- create and save the content of domain model elements based on given documents
- update the documents this document provider manages for domain model elements to changes
directly applied to those domain model elements
- notify all element state listeners about changes directly applied to domain model elements
this document provider manages a document for, i.e. the document provider must know which changes
of a domain model element are to be interpreted as element moves, deletes, etc.
Text editors use document providers to bridge the gap between their input elements and the
documents they work on. A single document provider may be shared between multiple editors; the
methods take the editors' input elements as a parameter.
This interface may be implemented by clients; or subclass the standard abstract base class
AbstractDocumentProvider.
In order to provided backward compatibility for clients of IDocumentProvider,
extension interfaces are used to provide a means of evolution. The following extension interfaces
exist:
See Also: org.eclipse.jface.text.IDocument
See Also: org.eclipse.ui.texteditor.AbstractDocumentProvider
See Also: org.eclipse.ui.texteditor.IDocumentProviderExtension
See Also: org.eclipse.ui.texteditor.IDocumentProviderExtension2
See Also: org.eclipse.ui.texteditor.IDocumentProviderExtension3
See Also: org.eclipse.ui.texteditor.IDocumentProviderExtension4
See Also: org.eclipse.ui.texteditor.IDocumentProviderExtension5 |
| Method Summary | |
| void | aboutToChange(Object element)
Informs this document provider about upcoming changes of the given element.
The changes might cause change notifications specific for the type of the given element.
If this provider manages a document for the given element, the document provider
must not change the document because of the notifications received after
aboutToChange has been and before changed is called. | | void | addElementStateListener(IElementStateListener listener)
Adds the given element state listener to this document provider. | | boolean | canSaveDocument(Object element)
Returns whether the document provided for the given element differs from
its original state which would required that it be saved. | | void | changed(Object element)
Informs this document provider that the given element has been changed.
All notifications have been sent out. | | void | connect(Object element)
Connects the given element to this document provider. | | void | disconnect(Object element)
Disconnects the given element from this document provider. | | IAnnotationModel | getAnnotationModel(Object element)
Returns the annotation model for the given element. | | IDocument | getDocument(Object element)
Returns the document for the given element. | | long | getModificationStamp(Object element)
Returns the modification stamp of the given element. | | long | getSynchronizationStamp(Object element)
Returns the time stamp of the last synchronization of
the given element and it's provided document. | | boolean | isDeleted(Object element)
Returns whether the given element has been deleted. | | boolean | mustSaveDocument(Object element)
Returns whether the document provided for the given element must be saved. | | void | removeElementStateListener(IElementStateListener listener)
Removes the given element state listener from this document provider. | | void | resetDocument(Object element)
Resets the given element's document to its last saved state. | | void | saveDocument(IProgressMonitor monitor, Object element, IDocument document, boolean overwrite)
Saves the given document provided for the given element. |
| aboutToChange | | void aboutToChange(Object element)(Code) | | Informs this document provider about upcoming changes of the given element.
The changes might cause change notifications specific for the type of the given element.
If this provider manages a document for the given element, the document provider
must not change the document because of the notifications received after
aboutToChange has been and before changed is called. In this case,
it is assumed that the document is already up to date, e.g., a save operation is a
typical case.
The concrete nature of the change notification depends on the concrete type of the
given element. If the element is, e.g., an IResource the notification
is a resource delta.
Parameters:
element - the element, or null |
| addElementStateListener | | void addElementStateListener(IElementStateListener listener)(Code) | | Adds the given element state listener to this document provider.
Has no effect if an identical listener is already registered.
Parameters:
listener - the listener |
| canSaveDocument | | boolean canSaveDocument(Object element)(Code) | | Returns whether the document provided for the given element differs from
its original state which would required that it be saved.
Parameters:
element - the element, or null true if the document can be saved, andfalse otherwise (including the element is null) |
| changed | | void changed(Object element)(Code) | | Informs this document provider that the given element has been changed.
All notifications have been sent out. If this provider manages a document
for the given element, the document provider must from now on change the
document on the receipt of change notifications. The concrete nature of the change
notification depends on the concrete type of the given element. If the element is,
e.g., an IResource the notification is a resource delta.
Parameters:
element - the element, or null |
| connect | | void connect(Object element) throws CoreException(Code) | | Connects the given element to this document provider. This tells the provider
that caller of this method is interested to work with the document provided for
the given domain model element. By counting the invocations of this method and
disconnect(Object) this provider can assume to know the
correct number of clients working with the document provided for that
domain model element.
The given element must not be null.
Parameters:
element - the element
exception:
CoreException - if the textual representation or the annotation modelof the element could not be created |
| disconnect | | void disconnect(Object element)(Code) | | Disconnects the given element from this document provider. This tells the provider
that the caller of this method is no longer interested in working with the document
provided for the given domain model element. By counting the invocations of
connect(Object) and of this method this provider can assume to
know the correct number of clients working with the document provided for that
domain model element.
The given element must not be null.
Parameters:
element - the element |
| getAnnotationModel | | IAnnotationModel getAnnotationModel(Object element)(Code) | | Returns the annotation model for the given element.
Parameters:
element - the element, or null the annotation model, or null if none |
| getDocument | | IDocument getDocument(Object element)(Code) | | Returns the document for the given element. Usually the document contains
a textual presentation of the content of the element, or is the element itself.
Parameters:
element - the element, or null the document, or null if none |
| getModificationStamp | | long getModificationStamp(Object element)(Code) | | Returns the modification stamp of the given element.
Parameters:
element - the element the modification stamp of the given element |
| getSynchronizationStamp | | long getSynchronizationStamp(Object element)(Code) | | Returns the time stamp of the last synchronization of
the given element and it's provided document.
Parameters:
element - the element the synchronization stamp of the given element |
| isDeleted | | boolean isDeleted(Object element)(Code) | | Returns whether the given element has been deleted.
Parameters:
element - the element true if the element has been deleted |
| mustSaveDocument | | boolean mustSaveDocument(Object element)(Code) | | Returns whether the document provided for the given element must be saved.
Parameters:
element - the element, or null true if the document must be saved, andfalse otherwise (including the element is null) |
| removeElementStateListener | | void removeElementStateListener(IElementStateListener listener)(Code) | | Removes the given element state listener from this document provider.
Has no affect if an identical listener is not registered.
Parameters:
listener - the listener |
| resetDocument | | void resetDocument(Object element) throws CoreException(Code) | | Resets the given element's document to its last saved state.
Element state listeners are notified both before (elementContentAboutToBeReplaced)
and after (elementContentReplaced) the content is changed.
Parameters:
element - the element, or null
exception:
CoreException - if document could not be reset for the given element |
| saveDocument | | void saveDocument(IProgressMonitor monitor, Object element, IDocument document, boolean overwrite) throws CoreException(Code) | | Saves the given document provided for the given element.
Parameters:
monitor - a progress monitor to report progress and request cancelation
Parameters:
element - the element, or null
Parameters:
document - the document
Parameters:
overwrite - indicates whether overwrite should be performedwhile saving the given element if necessary
exception:
CoreException - if document could not be stored to the given element |
|
|