oracle.jdeveloper.audit.transform

Class TransformAdapter

java.lang.Object

oracle.jdeveloper.audit.transform.TransformAdapter

Direct Known Subclasses:

NullTransformAdapter, ProjectTransformAdapter, TextTransformAdapter

public abstract class TransformAdapter
extends java.lang.Object

An adapter between the Audit framework and transforms of a specific type. It allows the framework to create a transform context and to invoke type-specific setup and teardown code (e.g., for a model which requires that a transaction be created).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	TransformAdapter.ConstructRegion
class	TransformAdapter.LocationRegion
class	TransformAdapter.Region

Constructor Summary

Constructors

Constructor and Description
TransformAdapter()

Method Summary

Methods

Modifier and Type	Method and Description
void	addHighlight(ModelAdapter model, java.lang.Object construct) Adds a highlight region for a construct for this context.
void	addRemovedHighlight(ModelAdapter model, java.lang.Object construct) Adds a highlight region for an about-to-be-removed construct in the model for this context.
abstract void	beginTransform(TransformContext context) Begins a transform of this type.
void	beginTransform(TransformContext context, TransformSequenceContext sequenceContext) Begins a transform of this type within a sequence of transforms of this type.
void	beginTransformSequence(TransformSequenceContext sequenceContext) Begins a transform sequence.
abstract void	cancelTransform(TransformContext context) Cancels a transform of this type.
void	cancelTransformSequence(TransformSequenceContext sequenceContext) Cancels a transform sequence of this type.
abstract TransformContext	createContext(Transform transform, Violation violation, Location location) Creates a context for a transform over a violation.
abstract void	endTransform(TransformContext context) Ends a transform of this type.
void	endTransformSequence(TransformSequenceContext sequenceContext) Ends a transform sequence.
abstract java.lang.Class	getContextClass() Gets the class of the context created by createContext(oracle.jdeveloper.audit.transform.Transform, oracle.jdeveloper.audit.service.Violation, oracle.jdeveloper.audit.model.Location).
java.util.List	getDeferredCommands() Gets the commands deferred by the apply method of a transform, or an empty list if none.
java.util.Collection<Location>	getHighlightRegions(TransformContext context) Gets the highlight regions set by the apply method of a transform for its model, or an empty list if none.
Location	getSelection() Gets the selection set by the apply method of a transform, or null if none.
void	invokeLater(Command command) Invokes a command after the command currently being executed by the Audit framework completes.
boolean	isTransformable(Location location) Gets whether a location is transformable by this transform adapter.
boolean	isTransformable(ModelAdapter model) Gets whether a model is transformable by this transform adapter.
java.lang.Boolean	makeTransformable(TransformContext context) Makes a transform location transformable if not already so.
protected java.lang.Boolean	makeWritable(Node node, Project project, Workspace workspace)
void	setPredecessorApplyData(TransformContext context, java.lang.Object applyData) Sets the predecessor apply data for a transform.
void	setSelection(Location location, int margin, int endMargin) Sets the selection to be set after a transform is applied.
void	setSelection(ModelAdapter model, java.lang.Object construct, int margin, int endMargin) Sets the selection to be set after a transform is applied.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TransformAdapter

public TransformAdapter()

Method Detail

getContextClass

public abstract java.lang.Class getContextClass()

Gets the class of the context created by createContext(oracle.jdeveloper.audit.transform.Transform, oracle.jdeveloper.audit.service.Violation, oracle.jdeveloper.audit.model.Location).

createContext

public abstract TransformContext createContext(Transform transform,
                             Violation violation,
                             Location location)

Creates a context for a transform over a violation.

isTransformable

public boolean isTransformable(ModelAdapter model)

Gets whether a model is transformable by this transform adapter. The framework ensures the following before invoking this method:

• the calling thread holds a read lock on the model.

  The default TransformAdapter implementation returns true if the location is writable or is version-controlled and can be made writable.

Parameters:

model - The model to be be tr.

isTransformable

public boolean isTransformable(Location location)

Gets whether a location is transformable by this transform adapter. The framework ensures the following before invoking this method:

• the calling thread holds a read lock on the model for the location, and
• isTransformable(ModelAdapter) on the model for the location is true.

  The default TransformAdapter implementation returns true unless the region is guarded.

Parameters:

location - The location to be transformed.

makeTransformable

public java.lang.Boolean makeTransformable(TransformContext context)
                                    throws java.lang.Exception

Makes a transform location transformable if not already so. The framework ensures the following before invoking this method:

• CommandProcessor.beginTrans(java.lang.String) has been invoked to start a command processor batch operation;
• the calling thread holds a read lock on the model to which the transforms in the sequence apply.

  The default TransformAdapter implementation uses the VCSManager to check out the file containing the location if it is read-only and version controlled.

Parameters:

context - A transform context created by this adapter.

Returns:

whether the location is writable after checking out, or null if the location was already writable.

Throws:

java.lang.Exception

makeWritable

protected java.lang.Boolean makeWritable(Node node,
                             Project project,
                             Workspace workspace)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

beginTransformSequence

public void beginTransformSequence(TransformSequenceContext sequenceContext)
                            throws java.lang.InterruptedException,
                                   java.lang.Exception

Begins a transform sequence. A transform sequence is a sequence of transforms which use the same TransformAdapter subclass and are applied in sequence to the same model. The sequence context allows the transform adapters to share state through the sequence, typically to allow optimization (e.g., to coalesce multiple transactions into a single transaction). The framework ensures the following before invoking this method:

• CommandProcessor.beginTrans(java.lang.String) has been invoked to start a command processor batch operation;
• the calling thread holds a read lock on the model to which the transforms in the sequence apply.

  The default TransformAdapter implementation does nothing.

Parameters:

sequenceContext - The sequence context for the current sequence.

Throws:

java.lang.InterruptedException

java.lang.Exception

beginTransform

public abstract void beginTransform(TransformContext context)
                             throws java.lang.InterruptedException,
                                    java.lang.Exception

Begins a transform of this type. The framework ensures the following before invoking this method:

• CommandProcessor.beginTrans(java.lang.String) has been invoked to start a command processor batch operation;
• the calling thread holds a read lock on the model containing the transform location;
• the beginTransformSequence(oracle.jdeveloper.audit.transform.TransformSequenceContext) method has been invoked;
• the transform class has an apply method that matches the construct at the violation location;
• if the transform class has an isApplicable method that matches the construct at the violation location, it has been invoked and has returned true;
• if the transform class has a query method that matches the construct at the violation location, it has been invoked and has returned non-null data.

Parameters:

context - A transform context created by this adapter.

Throws:

java.lang.InterruptedException

java.lang.Exception

beginTransform

public void beginTransform(TransformContext context,
                  TransformSequenceContext sequenceContext)
                    throws java.lang.InterruptedException,
                           java.lang.Exception

Begins a transform of this type within a sequence of transforms of this type. The framework ensures the following before invoking this method:

• CommandProcessor.beginTrans(java.lang.String) has been invoked to start a command processor batch operation;
• the calling thread holds a read lock on the model containing the transform location;
• the beginTransformSequence(oracle.jdeveloper.audit.transform.TransformSequenceContext) method has been invoked;
• the transform class has an apply method that matches the construct at the violation location;
• if the transform class has an isApplicable method that matches the construct at the violation location, it has been invoked and has returned true;
• if the transform class has a query method that matches the construct at the violation location, it has been invoked and has returned non-null data.

  The default TransformAdapter) implementation delegates to beginTransform(TransformContext). Adapters that are aware of transform sequences shoould override this method rather than that one. See beginTransformSequence(oracle.jdeveloper.audit.transform.TransformSequenceContext).

Parameters:

context - A transform context created by this adapter.

sequenceContext - A context for a sequence of transforms created by this adapter.

Throws:

java.lang.InterruptedException

java.lang.Exception

endTransform

public abstract void endTransform(TransformContext context)
                           throws java.lang.Exception

Ends a transform of this type. The framework ensures the following before invoking this method:

• beginTransform(oracle.jdeveloper.audit.transform.TransformContext) has been invoked (its preconditions still hold);
• the apply method that matches this construct has been invoked and has returned normally.

Parameters:

context - A transform context created by this adapter.

Throws:

java.lang.Exception

cancelTransform

public abstract void cancelTransform(TransformContext context)
                              throws java.lang.Exception

Cancels a transform of this type. The framework ensures the following before invoking this method:

• beginTransform(oracle.jdeveloper.audit.transform.TransformContext) has been invoked (its preconditions still hold);
• the apply method that matches this construct has been invoked;
• the apply method has thrown an exception or the apply method has completed normally and the endTransform(oracle.jdeveloper.audit.transform.TransformContext) method has thrown an exception.

Parameters:

context - A transform context created by this type.

Throws:

java.lang.Exception

setPredecessorApplyData

public void setPredecessorApplyData(TransformContext context,
                           java.lang.Object applyData)

Sets the predecessor apply data for a transform. The framework invokes this method before invoking the second and subsequent apply methods in a multiple context transform.

Parameters:

context -

applyData -

endTransformSequence

public void endTransformSequence(TransformSequenceContext sequenceContext)
                          throws java.lang.Exception

Ends a transform sequence. Before invoking this method, the framework ensures that beginTransformSequence(oracle.jdeveloper.audit.transform.TransformSequenceContext) has been invoked and its preconditions still hold.

The default TransformAdapter implementation does nothing.

Parameters:

sequenceContext - The sequence context for the current sequence.

Throws:

java.lang.Exception

cancelTransformSequence

public void cancelTransformSequence(TransformSequenceContext sequenceContext)
                             throws java.lang.Exception

Cancels a transform sequence of this type. The framework ensures the following before invoking this method:

• beginTransformSequence(oracle.jdeveloper.audit.transform.TransformSequenceContext) has been invoked (its preconditions still hold);
• the apply method that matches this construct has been invoked;
• the apply method has thrown an exception or the apply method has completed normally and the endTransformSequence(oracle.jdeveloper.audit.transform.TransformSequenceContext) method has thrown an exception.

  The default TransformAdapter implementation does nothing.

Parameters:

sequenceContext - The sequence context for the current sequence.

Throws:

java.lang.Exception

invokeLater

public void invokeLater(Command command)

Invokes a command after the command currently being executed by the Audit framework completes. This command is invoked inside a CommandProcessor batch command.

getDeferredCommands

public java.util.List getDeferredCommands()

Gets the commands deferred by the apply method of a transform, or an empty list if none. The framework invokes this method after successfully invoking endTransform(oracle.jdeveloper.audit.transform.TransformContext) and invokes the commands returned in order.

Returns:

a List of Commands.

setSelection

public void setSelection(ModelAdapter model,
                java.lang.Object construct,
                int margin,
                int endMargin)

Sets the selection to be set after a transform is applied. Transforms invoke this method indirectly by invoking TransformContext.setSelection(java.lang.Object, int, int).

Parameters:

model - The model containing the construct to select.

construct - The construct at which to place the caret.

margin - Margin from start of construct to start of selection.

endMargin - Margin from end of construct to end of selection.

setSelection

public void setSelection(Location location,
                int margin,
                int endMargin)

Sets the selection to be set after a transform is applied. Transforms invoke this method indirectly by invoking TransformContext.setSelection(java.lang.Object, int, int).

Parameters:

location - The location to select.

margin - Margin from start of construct to start of selection.

endMargin - Margin from end of construct to end of selection.

getSelection

public Location getSelection()

Gets the selection set by the apply method of a transform, or null if none. The framework invokes this method after successfully invoking endTransform(oracle.jdeveloper.audit.transform.TransformContext).

Returns:

a Location of length 0.

addHighlight

public void addHighlight(ModelAdapter model,
                java.lang.Object construct)

Adds a highlight region for a construct for this context.

Parameters:

construct - The construct to highlight.

addRemovedHighlight

public void addRemovedHighlight(ModelAdapter model,
                       java.lang.Object construct)

Adds a highlight region for an about-to-be-removed construct in the model for this context.

Parameters:

construct - The construct to be removed.

getHighlightRegions

public java.util.Collection<Location> getHighlightRegions(TransformContext context)

Gets the highlight regions set by the apply method of a transform for its model, or an empty list if none. The framework invokes this method after successfully invoking endTransform(oracle.jdeveloper.audit.transform.TransformContext).

Parameters:

context - A transform context created by this adapter.

Returns:

a Collection of {#link Location}s.