oracle.jdeveloper.audit.transform

Class TransformAdapter

java.lang.Object

oracle.jdeveloper.audit.transform.TransformAdapter

Direct Known Subclasses:

DirectoryTransformAdapter, 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
static class	TransformAdapter.ConstructRegion
static class	TransformAdapter.LocationRegion
static class	TransformAdapter.Region

Constructor Summary

Constructors

Constructor and Description
TransformAdapter()

Method Summary

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.
protected abstract TransformContext	createContext(TransformContext.Shape shape, Transform transform, Violation violation, Location location, java.net.URL pendingLocation, Project pendingProject, Workspace pendingWorkspace) Creates a context for a transform over a violation at a location.
TransformContext	createContext(Transform transform, Violation violation, Location location) Deprecated. Use newWriteContext(Transform, Violation, Location).
abstract void	endTransform(TransformContext context) Ends a transform of this type.
void	endTransformSequence(TransformSequenceContext sequenceContext) Ends a transform sequence.
boolean	equals(java.lang.Object object) Gets whether this adapter is equal to an object.
java.util.List<Command>	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.
int	hashCode() Gets the hash code value for this adapter.
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)
TransformContext	newCreateContext(Transform transform, Violation violation, Location location, java.net.URL pendingLocation) Creates a create context for a transform over a violation at a pending location.
TransformContext	newCreateContext(Transform transform, Violation violation, Location location, java.net.URL pendingLocation, Project pendingProject, Workspace pendingWorkspace) Creates a create context for a transform over a violation at a pending location.
TransformContext	newDeleteContext(Transform transform, Violation violation) Creates a delete context for a transform over a violation.
TransformContext	newDeleteContext(Transform transform, Violation violation, Location location) Creates a delete context for a transform over a violation at a location.
TransformContext	newMoveContext(Transform transform, Violation violation, Location location, java.net.URL pendingLocation) Creates a move context for a transform over a violation at a location.
TransformContext	newMoveContext(Transform transform, Violation violation, Location location, java.net.URL pendingLocation, Project pendingProject, Workspace pendingWorkspace) Creates a move context for a transform over a violation at a location.
TransformContext	newMoveContext(Transform transform, Violation violation, java.net.URL pendingLocation) Creates a move context for a transform over a violation.
TransformContext	newReadContext(Transform transform, Violation violation) Creates a read context for a transform over a violation.
TransformContext	newReadContext(Transform transform, Violation violation, Location location) Creates a read context for a transform over a violation at a location.
TransformContext	newWriteContext(Transform transform, Violation violation) Creates a write context for a transform over a violation.
TransformContext	newWriteContext(Transform transform, Violation violation, Location location) Creates a write context for a transform over a violation at a location.
TransformContext	newWriteContext(Transform transform, Violation violation, java.net.URL pendingLocation, Project pendingProject, Workspace pendingWorkspace) Creates a write context for a transform over a violation at a pending location.
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, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TransformAdapter

public TransformAdapter()

Method Detail

createContext

protected abstract TransformContext createContext(TransformContext.Shape shape,
                                                  Transform transform,
                                                  Violation violation,
                                                  Location location,
                                                  java.net.URL pendingLocation,
                                                  Project pendingProject,
                                                  Workspace pendingWorkspace)

Creates a context for a transform over a violation at a location.

createContext

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

Deprecated. Use newWriteContext(Transform, Violation, Location).

Creates a context for a transform over a violation at a location.

newReadContext

public TransformContext newReadContext(Transform transform,
                                       Violation violation,
                                       Location location)

Creates a read context for a transform over a violation at a location.

newReadContext

public TransformContext newReadContext(Transform transform,
                                       Violation violation)

Creates a read context for a transform over a violation.

newWriteContext

public TransformContext newWriteContext(Transform transform,
                                        Violation violation,
                                        Location location)

Creates a write context for a transform over a violation at a location.

newWriteContext

public TransformContext newWriteContext(Transform transform,
                                        Violation violation)

Creates a write context for a transform over a violation.

newWriteContext

public TransformContext newWriteContext(Transform transform,
                                        Violation violation,
                                        java.net.URL pendingLocation,
                                        Project pendingProject,
                                        Workspace pendingWorkspace)

Creates a write context for a transform over a violation at a pending location. This context is presumed to follow a create or move context for which the matching apply method creates a file at the pending location. The construct of an apply method that matches this context should match the root construct of the newly created file.

Throws:

java.lang.IllegalArgumentException - if (@code pendingLocation} exists.

newCreateContext

public TransformContext newCreateContext(Transform transform,
                                         Violation violation,
                                         Location location,
                                         java.net.URL pendingLocation)

Creates a create context for a transform over a violation at a pending location. The workspace and project of the location argument are used for the pending location.

Throws:

java.lang.IllegalArgumentException - if (@code pendingLocation} exists.

newCreateContext

public TransformContext newCreateContext(Transform transform,
                                         Violation violation,
                                         Location location,
                                         java.net.URL pendingLocation,
                                         Project pendingProject,
                                         Workspace pendingWorkspace)

Creates a create context for a transform over a violation at a pending location.

Throws:

java.lang.IllegalArgumentException - if (@code pendingLocation} exists.

newDeleteContext

public TransformContext newDeleteContext(Transform transform,
                                         Violation violation,
                                         Location location)

Creates a delete context for a transform over a violation at a location. The transform is expected to delete location.getModel().getUrl(location).

newDeleteContext

public TransformContext newDeleteContext(Transform transform,
                                         Violation violation)

Creates a delete context for a transform over a violation. The transform is expected to delete getViolation().getLocation().getModel().getUrl(getViolation().getLocation()).

newMoveContext

public TransformContext newMoveContext(Transform transform,
                                       Violation violation,
                                       Location location,
                                       java.net.URL pendingLocation,
                                       Project pendingProject,
                                       Workspace pendingWorkspace)

Creates a move context for a transform over a violation at a location. The transform is expected to move location.getModel().getUrl(location).

newMoveContext

public TransformContext newMoveContext(Transform transform,
                                       Violation violation,
                                       Location location,
                                       java.net.URL pendingLocation)

Creates a move context for a transform over a violation at a location. The transform is expected to move location.getModel().getUrl(location). The workspace and project of the location argument are used for the pending location.

newMoveContext

public TransformContext newMoveContext(Transform transform,
                                       Violation violation,
                                       java.net.URL pendingLocation)

Creates a move context for a transform over a violation. The transform is expected to delete getViolation().getLocation().getModel().getUrl(getViolation().getLocation()). The workspace and project of the violation location are used for the pending location.

Throws:

java.lang.IllegalArgumentException - if (@code pendingLocation} exists.

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 model is writable or is version-controlled and can be made writable.

Parameters:

model - The model to be be transformed.

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) returned true for that model.

The default TransformAdapter implementation returns true unless the location 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<Command> 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.

equals

public boolean equals(java.lang.Object object)

Gets whether this adapter is equal to an object. Typical TransformAdapter implementations will not need to override this method.

The default TransformAdapter implementation returns getClass().hashCode().

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Gets the hash code value for this adapter. Typical TransformAdapter implementations will not need to override this method.

The default TransformAdapter implementation returns getClass().hashCode().

Overrides:

hashCode in class java.lang.Object