dev.dejvokep.boostedyaml.block

Class Comments

java.lang.Object

dev.dejvokep.boostedyaml.block.Comments

public class Comments
extends Object

Comment manager for blocks, providing additional methods on top of those already provided by Block.

Please note that the methods provided here add possibilities for all implemented positions. However, using positions other than Comments.Position.BEFORE might lead to comment de-alignment and errors. Please read more information at the enum constants.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Comments.NodeType Represents to which node the comments are attached in a mapping.
static class	Comments.Position Comment position relative to the node (scalar; see Comments.NodeType) to which the comment is attached.

Field Summary

Fields

Modifier and Type	Field and Description
static org.snakeyaml.engine.v2.comments.CommentLine	BLANK_LINE Comment representing a blank line.

Constructor Summary

Constructors

Constructor and Description
Comments()

Method Summary

Modifier and Type	Method and Description
static void	add(Block<?> block, Comments.NodeType node, Comments.Position position, org.snakeyaml.engine.v2.comments.CommentLine comment) Adds the given comment to already existing comments at the given position.
static void	add(Block<?> block, Comments.NodeType node, Comments.Position position, List<org.snakeyaml.engine.v2.comments.CommentLine> comments) Adds the given comments to already existing comments at the given position.
static org.snakeyaml.engine.v2.comments.CommentLine	create(String comment, Comments.Position position) Creates a comment.
static List<org.snakeyaml.engine.v2.comments.CommentLine>	get(Block<?> block, Comments.NodeType node, Comments.Position position) Returns comments at the given position.
static void	remove(Block<?> block, Comments.NodeType node, Comments.Position position) Removes all comments at the given position.
static void	set(Block<?> block, Comments.NodeType node, Comments.Position position, List<org.snakeyaml.engine.v2.comments.CommentLine> comments) Sets the given comments at the given position.

Methods inherited from class java.lang.Object

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

Field Detail

BLANK_LINE

public static final org.snakeyaml.engine.v2.comments.CommentLine BLANK_LINE

Comment representing a blank line.

Constructor Detail

Comments

public Comments()

Method Detail

get

@Nullable
public static List<org.snakeyaml.engine.v2.comments.CommentLine> get(@NotNull
                                                                                Block<?> block,
                                                                                @NotNull
                                                                                Comments.NodeType node,
                                                                                @NotNull
                                                                                Comments.Position position)

Returns comments at the given position.

Please expect null or an empty List, representing there are no comments at the position.

Parameters:

block - the block used to retrieve comments

node - node from which to retrieve comments

position - position of the retrieved comments

Returns:

the comments

set

public static void set(@NotNull
                       Block<?> block,
                       @NotNull
                       Comments.NodeType node,
                       @NotNull
                       Comments.Position position,
                       @Nullable
                       List<org.snakeyaml.engine.v2.comments.CommentLine> comments)

Sets the given comments at the given position.

To remove comments, use remove(Block, NodeType, Position) instead. Alternatively, pass either null or an empty List as the parameter.

Parameters:

block - the block for which to set

node - node to attach to

position - position at which to set

comments - the comments to set

remove

public static void remove(@NotNull
                          Block<?> block,
                          @NotNull
                          Comments.NodeType node,
                          @NotNull
                          Comments.Position position)

Removes all comments at the given position.

Parameters:

block - the block for which to remove

node - node to which the comments are attached

position - position of the comments to remove

add

public static void add(@NotNull
                       Block<?> block,
                       @NotNull
                       Comments.NodeType node,
                       @NotNull
                       Comments.Position position,
                       @NotNull
                       List<org.snakeyaml.engine.v2.comments.CommentLine> comments)

Adds the given comments to already existing comments at the given position.

Parameters:

block - the block to add to

node - node to which the comments should be added

position - position at which the comments should be added

comments - the comments to add

add

public static void add(@NotNull
                       Block<?> block,
                       @NotNull
                       Comments.NodeType node,
                       @NotNull
                       Comments.Position position,
                       @NotNull
                       org.snakeyaml.engine.v2.comments.CommentLine comment)

Adds the given comment to already existing comments at the given position.

Parameters:

block - the block to add to

node - node to which the comments should be added

position - position at which the comments should be added

comment - the comment to add

create

@NotNull
public static org.snakeyaml.engine.v2.comments.CommentLine create(@NotNull
                                                                            String comment,
                                                                            @NotNull
                                                                            Comments.Position position)

Creates a comment. For blank lines, please use BLANK_LINE.

Parameters:

comment - the actual comment

position - position at which the block will be placed

Returns:

the comment line