Package com.djrapitops.plan.extension.builder

Interface ValueBuilder

public interface ValueBuilder

Used for building DataValues for ExtensionDataBuilder.addValue(Class, DataValue).

Requires Capability DATA_EXTENSION_BUILDER_API

Obtain an instance with ExtensionDataBuilder.valueBuilder(String).

Method Summary

Modifier and Type	Method	Description
DataValue<Boolean>	buildBoolean(boolean value)	Build a Boolean.
DataValue<Boolean>	buildBoolean(Supplier<Boolean> value)	Lambda version for conditional return or throwing NotReadyException.
DataValue<Boolean>	buildBooleanProvidingCondition(boolean value, String providedCondition)	Build a Boolean that provides a value for Conditional.
DataValue<Boolean>	buildBooleanProvidingCondition(Supplier<Boolean> value, String providedCondition)	Lambda version for conditional return or throwing NotReadyException.
DataValue<Component>	buildComponent(Component value)	Build a Component.
DataValue<Component>	buildComponent(Supplier<Component> value)	Lambda version for conditional return or throwing NotReadyException.
DataValue<Double>	buildDouble(Double value)	Build a Floating point number.
DataValue<Double>	buildDouble(Supplier<Double> value)	Lambda version for conditional return or throwing NotReadyException.
DataValue<String[]>	buildGroup(String[] groups)	Build a list of groups.
DataValue<String[]>	buildGroup(Supplier<String[]> groups)	Lambda version for conditional return or throwing NotReadyException.
default DataValue<Long>	buildNumber(Double value)	Build a Number.
default DataValue<Long>	buildNumber(Integer value)	Build a Number.
DataValue<Long>	buildNumber(Long value)	Build a Number.
DataValue<Long>	buildNumber(Supplier<Long> value)	Lambda version for conditional return or throwing NotReadyException.
DataValue<Double>	buildPercentage(Double percentage)	Build a Percentage.
DataValue<Double>	buildPercentage(Supplier<Double> percentage)	Lambda version for conditional return or throwing NotReadyException.
DataValue<String>	buildString(String value)	Build a String.
DataValue<String>	buildString(Supplier<String> value)	Lambda version for conditional return or throwing NotReadyException.
DataValue<Table>	buildTable(Table table, Color tableColor)	Build a table.
DataValue<Table>	buildTable(Supplier<Table> table, Color tableColor)	Lambda version for conditional return or throwing NotReadyException.
ValueBuilder	conditional(Conditional conditional)	Implementation detail - for abstracting annotations with the builder API.
ValueBuilder	description(String description)	Description about the value that is shown on hover.
ValueBuilder	format(FormatType formatType)	buildNumber(Long) specific method, format the value with FormatType
default ValueBuilder	formatAsDateWithSeconds()	buildNumber(Long) specific method, format the value as a epoch ms timestamp.
default ValueBuilder	formatAsDateWithYear()	buildNumber(Long) specific method, format the value as a epoch ms timestamp.
default ValueBuilder	formatAsTimeAmount()	buildNumber(Long) specific method, format the value as milliseconds of time.
ValueBuilder	hideFromUsers(BooleanProvider annotation)	Implementation detail - for abstracting annotations with the builder API.
ValueBuilder	icon(Icon icon)	Icon displayed next to the value.
default ValueBuilder	icon(String iconName, Family iconFamily, Color iconColor)	Icon displayed next to the value.
ValueBuilder	methodName(ExtensionMethod method)	Implementation detail - for abstracting annotations with the builder API.
ValueBuilder	priority(int priority)	Display-priority of the value, highest value is placed top most.
ValueBuilder	showAsPlayerPageLink()	buildString(String) specific method, link the value to a player page.
default ValueBuilder	showAsPlayerPageLink(StringProvider annotation)	Implementation detail - for abstracting annotations with the builder API.
ValueBuilder	showInPlayerTable()	Show this value in the players table.
default ValueBuilder	showInPlayerTable(boolean show)	Implementation detail - for abstracting annotations with the builder API.
default ValueBuilder	showOnTab(Tab annotation)	Implementation detail - for abstracting annotations with the builder API.
ValueBuilder	showOnTab(String tabName)	Show the value on a specific tab.

Method Details

description

ValueBuilder description(String description)

Description about the value that is shown on hover.

Parameters:

description - Describe what the value is about, maximum 150 characters.

Returns:

This builder.

priority

ValueBuilder priority(int priority)

Display-priority of the value, highest value is placed top most.

Two values with same priority may appear in a random order.

Parameters:

priority - Priority between 0 and Integer.MAX_VALUE.

Returns:

This builder.

showInPlayerTable

ValueBuilder showInPlayerTable()

Show this value in the players table.

Returns:

This builder.

icon

default ValueBuilder icon(String iconName,
 Family iconFamily,
 Color iconColor)

Icon displayed next to the value.

See https://fontawesome.com/icons (select 'free')) for icons

Parameters:

iconName - Name of the icon

iconFamily - Family of the icon

iconColor - Color of the icon

Returns:

This builder.

icon

ValueBuilder icon(Icon icon)

Icon displayed next to the value.

See https://fontawesome.com/icons (select 'free')) for icons

Parameters:

icon - Icon built using the methods in Icon.

Returns:

This builder.

showOnTab

ValueBuilder showOnTab(String tabName)

Show the value on a specific tab.

Remember to define TabInfo annotation.

Parameters:

tabName - Name of the tab.

Returns:

This builder.

formatAsDateWithYear

default ValueBuilder formatAsDateWithYear()

buildNumber(Long) specific method, format the value as a epoch ms timestamp.

Returns:

This builder.

formatAsDateWithSeconds

default ValueBuilder formatAsDateWithSeconds()

buildNumber(Long) specific method, format the value as a epoch ms timestamp.

Returns:

This builder.

formatAsTimeAmount

default ValueBuilder formatAsTimeAmount()

buildNumber(Long) specific method, format the value as milliseconds of time.

Returns:

This builder.

format

ValueBuilder format(FormatType formatType)

buildNumber(Long) specific method, format the value with FormatType

Returns:

This builder.

showAsPlayerPageLink

ValueBuilder showAsPlayerPageLink()

buildString(String) specific method, link the value to a player page.

Returns:

This builder.

buildBoolean

DataValue<Boolean> buildBoolean(boolean value)

Build a Boolean. Displayed as "Yes/No" on the page.

Parameters:

value - true/false

Returns:

a data value to give to ExtensionDataBuilder.

buildBooleanProvidingCondition

DataValue<Boolean> buildBooleanProvidingCondition(boolean value,
 String providedCondition)

Build a Boolean that provides a value for Conditional. Displayed as "Yes/No" on the page.

Parameters:

value - true/false

Returns:

a data value to give to ExtensionDataBuilder.

buildString

DataValue<String> buildString(String value)

Build a String.

Parameters:

value - any string. Limited to 50 characters.

Returns:

a data value to give to ExtensionDataBuilder.

buildComponent

DataValue<Component> buildComponent(Component value)

Build a Component.

Parameters:

value - a Component made by ComponentService

Returns:

a data value to give to ExtensionDataBuilder.

buildNumber

DataValue<Long> buildNumber(Long value)

Build a Number.

Parameters:

value - a non-floating point number.

Returns:

a data value to give to ExtensionDataBuilder.

buildNumber

default DataValue<Long> buildNumber(Integer value)

Build a Number.

Parameters:

value - a non-floating point number.

Returns:

a data value to give to ExtensionDataBuilder.

buildNumber

default DataValue<Long> buildNumber(Double value)

Build a Number.

Parameters:

value - a non-floating point number.

Returns:

a data value to give to ExtensionDataBuilder.

buildDouble

DataValue<Double> buildDouble(Double value)

Build a Floating point number.

Parameters:

value - a floating point number.

Returns:

a data value to give to ExtensionDataBuilder.

buildPercentage

DataValue<Double> buildPercentage(Double percentage)

Build a Percentage.

Parameters:

percentage - value between 0.0 and 1.0

Returns:

a data value to give to ExtensionDataBuilder.

buildGroup

DataValue<String[]> buildGroup(String[] groups)

Build a list of groups.

Parameters:

groups - names of groups a player is in.

Returns:

a data value to give to ExtensionDataBuilder.

buildTable

DataValue<Table> buildTable(Table table,
 Color tableColor)

Build a table.

Parameters:

table - Table built using Table.builder()

tableColor - Color of the table

Returns:

a data value to give to ExtensionDataBuilder.

buildBoolean

DataValue<Boolean> buildBoolean(Supplier<Boolean> value)

Lambda version for conditional return or throwing NotReadyException.

buildBoolean(boolean)

buildBooleanProvidingCondition

DataValue<Boolean> buildBooleanProvidingCondition(Supplier<Boolean> value,
 String providedCondition)

Lambda version for conditional return or throwing NotReadyException.

buildBooleanProvidingCondition(boolean, String)

buildString

DataValue<String> buildString(Supplier<String> value)

Lambda version for conditional return or throwing NotReadyException.

buildString(String)

buildComponent

DataValue<Component> buildComponent(Supplier<Component> value)

Lambda version for conditional return or throwing NotReadyException.

buildComponent(Component)

buildNumber

DataValue<Long> buildNumber(Supplier<Long> value)

Lambda version for conditional return or throwing NotReadyException.

buildNumber(Long)

buildDouble

DataValue<Double> buildDouble(Supplier<Double> value)

Lambda version for conditional return or throwing NotReadyException.

buildDouble(Double)

buildPercentage

DataValue<Double> buildPercentage(Supplier<Double> percentage)

Lambda version for conditional return or throwing NotReadyException.

buildPercentage(Double)

buildGroup

DataValue<String[]> buildGroup(Supplier<String[]> groups)

Lambda version for conditional return or throwing NotReadyException.

buildGroup(String[])

buildTable

DataValue<Table> buildTable(Supplier<Table> table,
 Color tableColor)

Lambda version for conditional return or throwing NotReadyException.

buildTable(Table, Color)

hideFromUsers

ValueBuilder hideFromUsers(BooleanProvider annotation)

Implementation detail - for abstracting annotations with the builder API.

Parameters:

annotation - BooleanProvider annotation.

Returns:

This builder.

conditional

ValueBuilder conditional(Conditional conditional)

Implementation detail - for abstracting annotations with the builder API.

Parameters:

conditional - Conditional annotation.

Returns:

This builder.

showAsPlayerPageLink

default ValueBuilder showAsPlayerPageLink(StringProvider annotation)

Implementation detail - for abstracting annotations with the builder API.

Parameters:

annotation - StringProvider annotation.

Returns:

This builder.

methodName

ValueBuilder methodName(ExtensionMethod method)

Implementation detail - for abstracting annotations with the builder API.

Parameters:

method - Method this value is from.

Returns:

This builder.

showInPlayerTable

default ValueBuilder showInPlayerTable(boolean show)

Implementation detail - for abstracting annotations with the builder API.

Parameters:

show - true/false

Returns:

This builder.

showOnTab

default ValueBuilder showOnTab(Tab annotation)

Implementation detail - for abstracting annotations with the builder API.

Parameters:

annotation - Tab annotation.

Returns:

This builder.