Package ninja.leaping.configurate.loader

Enum CommentHandlers

java.lang.Object

java.lang.Enum<CommentHandlers>

ninja.leaping.configurate.loader.CommentHandlers

All Implemented Interfaces:

Serializable, Comparable<CommentHandlers>, CommentHandler

public enum CommentHandlers
extends Enum<CommentHandlers>
implements CommentHandler

Defines a number of default CommentHandlers.

Enum Constant Summary

Enum Constants

Enum Constant	Description
DOUBLE_SLASH	CommentHandler for comments prefixed by a // escape.
HASH	CommentHandler for comments prefixed by the # character.
SLASH_BLOCK	CommentHandler for comments delineated using /* *\.
XML_STYLE	CommentHandler for comments delineated using <!-- -->.

Method Summary

Modifier and Type	Method	Description
static @Nullable String	extractComment(@NonNull BufferedReader reader, @NonNull CommentHandler... allowedHeaderTypes)	Uses provided comment handlers to extract a comment from the reader.
@NonNull Optional<String>	extractHeader(@NonNull BufferedReader reader)	Defines the handlers behaviour for reading comments.
@NonNull Collection<String>	toComment(@NonNull Collection<String> lines)	Converts the given lines into a comment
static CommentHandlers	valueOf(String name)	Returns the enum constant of this type with the specified name.
static CommentHandlers[]	values()	Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

HASH

public static final CommentHandlers HASH

CommentHandler for comments prefixed by the # character.

DOUBLE_SLASH

public static final CommentHandlers DOUBLE_SLASH

CommentHandler for comments prefixed by a // escape.

SLASH_BLOCK

public static final CommentHandlers SLASH_BLOCK

CommentHandler for comments delineated using /* *\.

XML_STYLE

public static final CommentHandlers XML_STYLE

CommentHandler for comments delineated using <!-- -->.

Method Detail

values

public static CommentHandlers[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (CommentHandlers c : CommentHandlers.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static CommentHandlers valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

extractHeader

public @NonNull Optional<String> extractHeader(@NonNull BufferedReader reader)
                                        throws IOException

Description copied from interface: CommentHandler

Defines the handlers behaviour for reading comments.

Specified by:

extractHeader in interface CommentHandler

Parameters:

reader - The reader

Returns:

The comment

Throws:

IOException - If any IO error occurs in the process

toComment

public @NonNull Collection<String> toComment(@NonNull Collection<String> lines)

Description copied from interface: CommentHandler

Converts the given lines into a comment

Specified by:

toComment in interface CommentHandler

Parameters:

lines - The lines to make a comment

Returns:

The transformed lines

extractComment

public static @Nullable String extractComment(@NonNull BufferedReader reader,
                                              @NonNull CommentHandler... allowedHeaderTypes)
                                       throws IOException

Uses provided comment handlers to extract a comment from the reader.

Parameters:

reader - The reader

allowedHeaderTypes - The handlers to try

Returns:

The extracted comment, or null if a comment could not be extracted

Throws:

IOException - If an IO error occurs