Class ISourceFileImplSupport.ReconcileOperation
- Direct Known Subclasses:
ISourceFileImplSupport.NotifyingReconcileOperation
- Enclosing interface:
- ISourceFileImplSupport
This class or a subclass of this class are not intended to be used by
clients for purposes other than extension or instance creation;
instances of this class or a subclass of this class are not intended
to be used by clients for purposes other than returning from an
implementation of ISourceFileImplSupport.getReconcileOperation_()
.
-
Field Summary
Modifier and TypeFieldDescriptionprotected final ISourceFileImplSupport
This operation's source file. -
Constructor Summary
ModifierConstructorDescriptionprotected
ReconcileOperation
(ISourceFileImplSupport sourceFile) Constructs a reconcile operation for the given source file. -
Method Summary
Modifier and TypeMethodDescriptionprotected static boolean
isInitialReconcile
(IContext context) Returns whether this is initial reconcile.protected static boolean
isReconcilingForced
(IContext context) Returns whether reconciling is forced, i.e., the working copy buffer has not been modified since the last time the working copy was reconciled.protected void
Reconciles the working copy according to options specified in the given context.protected void
reconcileStructure
(IContext context, org.eclipse.core.runtime.IProgressMonitor monitor) Reconciles the structure of the working copy by rebuilding it according to options specified in the given context.protected boolean
shouldReconcileStructure
(IContext context) Returns whether the structure of the working copy needs to be reconciled by rebuilding it according to options specified in the given context.
-
Field Details
-
sourceFile
This operation's source file.
-
-
Constructor Details
-
ReconcileOperation
Constructs a reconcile operation for the given source file.- Parameters:
sourceFile
- notnull
-
-
Method Details
-
reconcile
protected void reconcile(IContext context, org.eclipse.core.runtime.IProgressMonitor monitor) throws org.eclipse.core.runtime.CoreException Reconciles the working copy according to options specified in the given context.The following context options, if simultaneously present, must be mutually consistent:
-
ISourceFileImplSupport.SOURCE_AST
- Specifies the AST to use when reconciling. The AST is safe to read in the dynamic context of this method call, but must not be modified. -
ISourceFileImplSupport.SOURCE_CONTENTS
- Specifies the source string to use when reconciling.
At least one of
SOURCE_AST
orSOURCE_CONTENTS
must have a non-null value in the given context.The given context may provide additional data that this method can use, including the following:
-
ISourceFileImplSupport.SOURCE_SNAPSHOT
- Specifies the source snapshot from whichSOURCE_AST
was created orSOURCE_CONTENTS
was obtained. The snapshot may expire.
Subclasses may override this method, but must make sure to call the super implementation.
This implementation calls
reconcileStructure
if, and only if,shouldReconcileStructure
returnstrue
.- Parameters:
context
- the operation context (notnull
)monitor
- a progress monitor, ornull
if progress reporting is not desired. The caller must not rely onIProgressMonitor.done()
having been called by the receiver- Throws:
org.eclipse.core.runtime.CoreException
- if the working copy could not be reconciledorg.eclipse.core.runtime.OperationCanceledException
- if this method is canceled
-
-
shouldReconcileStructure
Returns whether the structure of the working copy needs to be reconciled by rebuilding it according to options specified in the given context.Subclasses may override this method, but must return
true
whenever the super implementation returnstrue
; they may returntrue
when the super implementation returnsfalse
.- Parameters:
context
- the operation context (notnull
)- Returns:
true
if the working copy structure needs to be reconciled, andfalse
otherwise- See Also:
-
isInitialReconcile
Returns whether this is initial reconcile.- Parameters:
context
- the operation context (notnull
)- Returns:
true
if this is initial reconcile, andfalse
otherwise- See Also:
-
isReconcilingForced
Returns whether reconciling is forced, i.e., the working copy buffer has not been modified since the last time the working copy was reconciled.- Parameters:
context
- the operation context (notnull
)- Returns:
true
if reconciling is forced, andfalse
otherwise- See Also:
-
reconcileStructure
protected void reconcileStructure(IContext context, org.eclipse.core.runtime.IProgressMonitor monitor) throws org.eclipse.core.runtime.CoreException Reconciles the structure of the working copy by rebuilding it according to options specified in the given context.The following context options, if simultaneously present, must be mutually consistent:
-
ISourceFileImplSupport.SOURCE_AST
- Specifies the AST to use when reconciling. The AST is safe to read in the dynamic context of this method call, but must not be modified. -
ISourceFileImplSupport.SOURCE_CONTENTS
- Specifies the source string to use when reconciling.
At least one of
SOURCE_AST
orSOURCE_CONTENTS
must have a non-null value in the given context.The given context may provide additional data that this method can use, including the following:
-
ISourceFileImplSupport.SOURCE_SNAPSHOT
- Specifies the source snapshot from whichSOURCE_AST
was created orSOURCE_CONTENTS
was obtained. The snapshot may expire.
Subclasses may override this method, but must make sure to call the super implementation.
- Parameters:
context
- the operation context (notnull
)monitor
- a progress monitor, ornull
if progress reporting is not desired. The caller must not rely onIProgressMonitor.done()
having been called by the receiver- Throws:
org.eclipse.core.runtime.CoreException
- if the working copy could not be reconciledorg.eclipse.core.runtime.OperationCanceledException
- if this method is canceled- See Also:
-
-