io.jenkins.plugins.checks.api

Class TruncatedString

java.lang.Object

io.jenkins.plugins.checks.api.TruncatedString

public class TruncatedString
extends Object

Utility wrapper that silently truncates output with a message at a certain size.

The GitHub Checks API has a size limit on text fields. Because it also accepts markdown, it is not trivial to truncate to the required length as this could lead to unterminated syntax. The use of this class allows for adding chunks of complete markdown until an overflow is detected, at which point a message will be added and all future additions will be silently discarded.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TruncatedString.Builder Builder for TruncatedString.

Method Summary

Modifier and Type	Method and Description
String	build(int maxSize) Builds the string such that it does not exceed maxSize, including the truncation string.
String	toString() Builds the string without truncation.

Methods inherited from class java.lang.Object

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

Method Detail

toString

public String toString()

Builds the string without truncation.

Overrides:

toString in class Object

Returns:

A string comprising the joined chunks.

build

public String build(int maxSize)

Builds the string such that it does not exceed maxSize, including the truncation string.

Parameters:

maxSize - the maximum size of the resultant string.

Returns:

A string comprising as many of the joined chunks that will fit in the given size, plus the truncation string if truncation was necessary.