org.revapi

Interface DifferenceAnalyzer

All Superinterfaces:

AutoCloseable

public interface DifferenceAnalyzer
extends AutoCloseable

An element analyzer is basically a visitor over matching elements of some language between the two API versions being compared.

Since:

0.1

Author:

Lukas Krejci

Method Summary

Modifier and Type	Method and Description
void	beginAnalysis(Element oldElement, Element newElement) Called when the analysis of the two corresponding elements begins.
Report	endAnalysis(Element oldElement, Element newElement) Called when the analysis of the two elements ends (i.e.
boolean	isDescendRequired(Element oldElement, Element newElement) Tells whether the analyzer needs to descend "into" the two provided elements.
void	open() Called right before the analysis starts.

Methods inherited from interface java.lang.AutoCloseable

close

Method Detail

open

void open()

Called right before the analysis starts. Can be used to "warm up" the analyzer. The corresponding AutoCloseable.close() method is provided through the AutoCloseable super interface.

beginAnalysis

void beginAnalysis(@Nullable
                   Element oldElement,
                   @Nullable
                   Element newElement)

Called when the analysis of the two corresponding elements begins. If those elements contain children, all the children will be analyzed before the endAnalysis(Element, Element) method will be called for these two elements.

Parameters:

oldElement - the element from the old archives

newElement - the element from the new archives

isDescendRequired

boolean isDescendRequired(@Nullable
                          Element oldElement,
                          @Nullable
                          Element newElement)

Tells whether the analyzer needs to descend "into" the two provided elements. This is called after beginAnalysis(Element, Element) and before endAnalysis(Element, Element) with the same pair of elements.

Note that this decision is made on the "filtered" trees. I.e. if the filters filter out children of an element, the analyzer cannot override that decision and try to include such elements in the analysis again.

Parameters:

oldElement - the element from the old archives

newElement - the element from the new archives

Returns:

true when the analysis should also include the children of the provided elements, false otherwise.

endAnalysis

Report endAnalysis(@Nullable
                   Element oldElement,
                   @Nullable
                   Element newElement)

Called when the analysis of the two elements ends (i.e. all the children have been visited).

Parameters:

oldElement - the element from the old archives

newElement - the element from the new archives

Returns:

a report detailing the difference found between these two elements