oracle.jdeveloper.audit.analyzer

Interface IssueReport

All Superinterfaces:

ViolationReport

public interface IssueReport
extends ViolationReport

An interface for setting additional properties of a reported Audit violation. The violation reporting methods in AuditContext only allow a client to specify the rule and location properties of a violation. To allow a client to specify additional properties--variation, parameters, transforms, recommended transforms, focus location, and related location--the AuditContext report methods return an instance of this interface to the client.

Method Summary

Modifier and Type	Method and Description
void	addConstructParameter(java.lang.String name, ModelAdapter model, java.lang.Object construct) Adds a construct in a model as a parameter to the issue.
void	addConstructParameter(java.lang.String name, java.lang.Object construct) Adds a construct as a parameter to the issue.
void	addParameter(java.lang.String name, java.lang.Object value) Adds a parameter to the issue.
void	hideAllTransforms() Hides all the transforms for this issue.
void	hideTransform(Transform transform) Hides a transform for this issue.
void	setDefaultTransform(Transform transform) Sets the default transform for this issue.
void	setFocusLocation(Location location) Sets the location at the focus of the issue.
void	setFocusLocation(java.lang.Object construct) Sets the construct at the focus of the issue.
void	setVariation(java.lang.String name) Sets the name of the rule variation which applies to this issue.
void	showTransform(Transform transform) Shows a transform for this violation.

Method Detail

addParameter

void addParameter(java.lang.String name,
                  java.lang.Object value)

Adds a parameter to the issue. Parameters are numbered in the order they are added, starting at 0. In the message template string associated with the rule, a parameter can be referred to by index or by name.

Specified by:

addParameter in interface ViolationReport

Parameters:

name - the name of the parameter

value - the value of the parameter

See Also:

ViolationReport.addConstructParameter(java.lang.String, java.lang.Object)

addConstructParameter

void addConstructParameter(java.lang.String name,
                           java.lang.Object construct)

Adds a construct as a parameter to the issue. Adding constructs directly as a parameter to a issue typically pins the entire model in memory so Audit uses Locations to track constructs over time. This method is convenience method for:

 addParameter(name, context.getModel().getLocation(construct));

Specified by:

addConstructParameter in interface ViolationReport

Parameters:

name - the name of the parameter.

construct - the construct that is the intended parameter value.

See Also:

addParameter(java.lang.String, java.lang.Object)

addConstructParameter

void addConstructParameter(java.lang.String name,
                           ModelAdapter model,
                           java.lang.Object construct)

Adds a construct in a model as a parameter to the issue. Adding constructs directly as a parameter to a issue typically pins the entire model in memory so Audit uses Locations to track constructs over time. This method is convenience method for:

 
 model.beginRead(true);
 try
 {
   addParameter(name, model.getLocation(construct));
 }
 finally
 {
   model.endRead(true);
 }
 

 

Specified by:

addConstructParameter in interface ViolationReport

Parameters:

name - the name of the parameter.

model - the model containing the construct

construct - the construct that is the intended parameter value.

See Also:

addParameter(java.lang.String, java.lang.Object)

setFocusLocation

void setFocusLocation(java.lang.Object construct)

Sets the construct at the focus of the issue. Typically, this is contained by the location of the issue, and typically does not span a line boundary. If not specified, the framework uses Violation.getLocation().

Specified by:

setFocusLocation in interface ViolationReport

setFocusLocation

void setFocusLocation(Location location)

Sets the location at the focus of the issue. Typically, this is contained by the location of the issue, and typically does not span a line boundary. If not specified, the framework uses Violation.getLocation().

Specified by:

setFocusLocation in interface ViolationReport

setVariation

void setVariation(java.lang.String name)

Sets the name of the rule variation which applies to this issue. If not specified, the framework uses the default variation.

Specified by:

setVariation in interface ViolationReport

Parameters:

name - The name of the variation: one of the names returned by Rule.variations().

hideAllTransforms

void hideAllTransforms()

Hides all the transforms for this issue.

Specified by:

hideAllTransforms in interface ViolationReport

showTransform

void showTransform(Transform transform)

Shows a transform for this violation.

Specified by:

showTransform in interface ViolationReport

hideTransform

void hideTransform(Transform transform)

Hides a transform for this issue.

Specified by:

hideTransform in interface ViolationReport

setDefaultTransform

void setDefaultTransform(Transform transform)

Sets the default transform for this issue. This overrides the default fix set by the user and inherited from the rule, so the rule help should make clear that this will happen.

Specified by:

setDefaultTransform in interface ViolationReport