pro.fessional.mirana.text

Class FormatUtil

java.lang.Object

pro.fessional.mirana.text.FormatUtil

public class FormatUtil
extends Object

 a thread-safe and low memory-fragmentation formatter, can handle
 - `{}` in slf4j
 - `%` in printf
 - `{0}` in Message
 

Since:

2017-02-11.

Author:

trydofor, Baoyi Chen

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	FormatUtil.V

Constructor Summary

Constructors

Constructor and Description
FormatUtil()

Method Summary

Modifier and Type	Method and Description
static int[]	count(CharSequence src, String... sub)
static int	count(CharSequence src, String sub)
static int[]	count(FormatUtil.V viz, CharSequence src, String... sub) Count string occurrences
static @NotNull Object[]	fixArgs(int size, Object... args) Completing and padding null parameters with empty string
static @NotNull String	format(CharSequence fmt, Object... args) handle `%` in printf,Involves copying arrays, with a small performance loss.
static @NotNull String	join(boolean skipNull, String joiner, Iterable<?> objs)
static @NotNull String	leftFix(@Nullable Object obj, int fix, char pad) Left padding or left truncation to ensure fixed length
static @NotNull String	logback(CharSequence fmt, Object... args) handle `{}` slf4j's placeholder, eg.
static String	message(CharSequence fmt, Object... args) handle `{0}` in MessageFormat, auto completes the parameter with empty string.
static @NotNull String	rightFix(@Nullable Object obj, int fix, char pad) Right padding or right truncation to ensure fixed length
static @NotNull String	sortParam(@NotNull Map<?,?> params) use `&` and `=` sort and join the string as http query string, sort by ascii asc
static @NotNull String	sortParam(@NotNull Map<?,?> param, @NotNull String join1, @NotNull String join2) use `join1` and `join2` sort and join the string as http query string.
static @NotNull String	toString(boolean[] arr)
static @NotNull String	toString(double[] arr)
static @NotNull String	toString(float[] arr)
static @NotNull String	toString(int[] arr)
static @NotNull String	toString(long[] arr)
static @NotNull String	toString(short[] arr)
static void	toString(StringBuilder buff, boolean[] arr)
static void	toString(StringBuilder buff, double[] arr)
static void	toString(StringBuilder buff, float[] arr)
static void	toString(StringBuilder buff, int[] arr)
static void	toString(StringBuilder buff, long[] arr)
static void	toString(StringBuilder buff, short[] arr)

Methods inherited from class java.lang.Object

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

Constructor Detail

FormatUtil

public FormatUtil()

Method Detail

join

@NotNull
public static @NotNull String join(boolean skipNull,
                                            String joiner,
                                            Iterable<?> objs)

See Also:

BuilderHelper.join(StringBuilder, boolean, String, Iterable)

sortParam

@NotNull
public static @NotNull String sortParam(@NotNull
                                                 @NotNull Map<?,?> params)

use `&` and `=` sort and join the string as http query string, sort by ascii asc

See Also:

sortParam(Map, String, String)

sortParam

@NotNull
public static @NotNull String sortParam(@NotNull
                                                 @NotNull Map<?,?> param,
                                                 @NotNull
                                                 @NotNull String join1,
                                                 @NotNull
                                                 @NotNull String join2)

 use `join1` and `join2` sort and join the string as http query string.
 sort by ascii asc by default, ignore param is its key is null.
 

logback

@NotNull
public static @NotNull String logback(CharSequence fmt,
                                               Object... args)

 handle `{}` slf4j's placeholder, eg.

 format(null, new Object[]{"a"}) return ""
 format("{} {} {a}", null) return "{null} {null} {a}"
 format("{} {} {a}", new Object[]{"b"}) return "{b} {null} {a}"
 format("{} {} {a}", new Object[]{"b", "c", "d"}) return "{b} {c} {a}"
 format("abc", new Object[]{"a"}) return "abc"
 format("{{}}", new Object[]{"a"}) return "{a}"
 format("\\{\\}", new Object[]{"a"}) return "{}"
 format("\\{}", new Object[]{"a"}) return "{}"
 format("\\\\", new Object[]{"a"}) return "\"
 format("{c", new Object[]{"a"}) return "{c"
 

message

public static String message(CharSequence fmt,
                             Object... args)

handle `{0}` in MessageFormat, auto completes the parameter with empty string.

See Also:

MessageFormat

format

@NotNull
public static @NotNull String format(CharSequence fmt,
                                              Object... args)

 handle `%` in printf,Involves copying arrays, with a small performance loss.
 Thread-safe, auto-complete String#format.
 A more elegant format suggests using java.text.MessageFormat.
 

See Also:

Formatter, String.format(String, Object...)

fixArgs

@NotNull
public static @NotNull Object[] fixArgs(int size,
                                                 Object... args)

Completing and padding null parameters with empty string

leftFix

@NotNull
public static @NotNull String leftFix(@Nullable
                                               @Nullable Object obj,
                                               int fix,
                                               char pad)

Left padding or left truncation to ensure fixed length

Parameters:

obj - the object

fix - the fixed length

pad - padding char

rightFix

@NotNull
public static @NotNull String rightFix(@Nullable
                                                @Nullable Object obj,
                                                int fix,
                                                char pad)

Right padding or right truncation to ensure fixed length

Parameters:

obj - the object

fix - the fixed length

pad - padding char

count

public static int count(CharSequence src,
                        String sub)

count

public static int[] count(CharSequence src,
                          String... sub)

count

public static int[] count(FormatUtil.V viz,
                          CharSequence src,
                          String... sub)

Count string occurrences

Parameters:

viz - callback

src - source

sub - substring to count

Returns:

subject count

toString

@NotNull
public static @NotNull String toString(boolean[] arr)

toString

public static void toString(StringBuilder buff,
                            boolean[] arr)

toString

@NotNull
public static @NotNull String toString(short[] arr)

toString

public static void toString(StringBuilder buff,
                            short[] arr)

toString

@NotNull
public static @NotNull String toString(int[] arr)

toString

public static void toString(StringBuilder buff,
                            int[] arr)

toString

@NotNull
public static @NotNull String toString(long[] arr)

toString

public static void toString(StringBuilder buff,
                            long[] arr)

toString

@NotNull
public static @NotNull String toString(float[] arr)

toString

public static void toString(StringBuilder buff,
                            float[] arr)

toString

@NotNull
public static @NotNull String toString(double[] arr)

toString

public static void toString(StringBuilder buff,
                            double[] arr)