com.atlassian.bitbucket.content

Interface Diff

All Superinterfaces:

PropertySupport

public interface Diff
extends PropertySupport

See Also:

DiffContentCallback

Method Summary

Modifier and Type	Method and Description
Path	getDestination() Retrieves the path for the changed file.
List<DiffHunk>	getHunks() Retrieves a list containing zero or more hunks describing the changed lines within the file.
Path	getSource() Retrieves the path for the file before it was changed.
boolean	isBinary() Retrieves a flag indicating whether the changed file is binary.
boolean	isTruncated() Retrieves a flag indicating whether the list of hunks had to be truncated.

Methods inherited from interface com.atlassian.bitbucket.property.PropertySupport

getProperties

Method Detail

getDestination

@Nullable
Path getDestination()

Retrieves the path for the changed file.

This value has three categories:

• The same as the source, indicating the file was modified in-place
• Different from the getSource() source}, indicating the file was copied, moved or renamed, potentially with or without content changes
• null, indicating the file was deleted

Note: While the destination and the source may each be null, they will never both be null.

Returns:

the path to the file after the change

getHunks

@Nonnull
List<DiffHunk> getHunks()

Retrieves a list containing zero or more hunks describing the changed lines within the file. The list may be empty, but never null.

Returns:

zero or more hunks describing changed lines

getSource

@Nullable
Path getSource()

Retrieves the path for the file before it was changed.

This value has three categories:

• The same as the destination, indicating the file was modified in-place
• Different from the destination, indicating the file was copied, moved or renamed, potentially with or without content changes
• null, indicating the file is new

Note: While the destination and the source may each be null, they will never both be null.

Returns:

the path to the file before the change

isBinary

boolean isBinary()

Retrieves a flag indicating whether the changed file is binary. Binary files cannot be diffed.

Note: When this flag is true, the hunks list will always be empty.

Returns:

true if the changed file is binary, indicating there is no diff; otherwise, false

isTruncated

boolean isTruncated()

Retrieves a flag indicating whether the list of hunks had to be truncated.

To manage resource consumption, the system may impose a limit on the size of diffs it is willing to render. This flag is set to inform callers when such limits are exceeded. Diffs may be truncated at many different levels. Additional truncation flags exist for hunks, segments and lines, allowing callers to know exactly how the diff was truncated.

Note: If this flag is true but no hunks are truncated, it means at least one hunk was entirely omitted.

Returns:

true if the diff was truncated, removing one or more