cz.gyarab.util

Class Utils

java.lang.Object

cz.gyarab.util.Utils

public final class Utils
extends java.lang.Object

Knihovna pomocných nástrojů.

Method Summary

Modifier and Type	Method and Description
static int	compare(java.lang.Comparable... comparables) Porovnává páry hodnot v zadaném pořadí tak dlouho, dokud jsou shodné.
static java.lang.String	ifEmpty(java.lang.String s, java.lang.String d) Zjistí, zda je poskytnutý řetězec prázdný, v takovém případě vrátí poskytnutou výchozí hodnotu, v opačném případě zkoumaný řetezec.
static boolean	isEmpty(java.lang.String s) Zjistí, zda je poskytnutý řetězec prázdný.
static java.lang.String	nonEmpty(java.lang.String s) Ověří, že poskytnutý řetězec není prázdný.
static java.lang.String	nonEmpty(java.lang.String s, java.lang.String m) Ověří, že poskytnutý řetězec není prázdný.
static void	runConcurrently(int count, boolean wait, java.util.function.IntConsumer run) Vytvoří poskytnutý počet vláken a nastartuje je.
static boolean	sleep(long ms) Přeruší chod běžícího vlákna na uvedenou dobu.

Methods inherited from class java.lang.Object

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

Method Detail

sleep

public static boolean sleep(long ms)

Přeruší chod běžícího vlákna na uvedenou dobu. Po tuto dobu není procesor nijak vytěžován. Doba, po kterou je vlákno uspáno, nemusí být přesná, záleží na mnoha faktorech, např. výkon hardwaru, aktuální zatížení jinými vlákny, přesnost vnitřních hodin apod.

Parameters:

ms - počet milisekund, po které má být vlákno uspáno

Returns:

true, pokud vlákno vydrželo spát celou dobu, false, pokud jiné vlákno spánek tomuto vláknu přerušilo, takže vlákno pokračuje ve své činnosti dříve, než jak bylo naplánováno

See Also:

Thread.sleep(long)

isEmpty

public static boolean isEmpty(java.lang.String s)

Zjistí, zda je poskytnutý řetězec prázdný. Řetězec je z pohledu této metody prázdný, pokud se jedná o prázdnou referenci (null), nebo pokud neprázdná reference má nulovou délku nebo obsahuje pouze bílé mezery.

Parameters:

s - zkoumaný řetězec

Returns:

false, pokud není zkoumaný řetězec null a obsahuje alespoň jeden znak jiný než bílou mezeru, jinak true

Since:

1.3.23

ifEmpty

public static java.lang.String ifEmpty(java.lang.String s,
                                       java.lang.String d)

Zjistí, zda je poskytnutý řetězec prázdný, v takovém případě vrátí poskytnutou výchozí hodnotu, v opačném případě zkoumaný řetezec.

Parameters:

s - zkoumaný řetězec, je-li neprázdný, metoda vrátí jeho instanci

d - výchozí řetězec, který metoda vrátí, pokud je zkoumaný prázdný

Returns:

referenci na s nebo d

Since:

1.4

nonEmpty

public static java.lang.String nonEmpty(java.lang.String s,
                                        java.lang.String m)
                                 throws java.lang.IllegalArgumentException

Ověří, že poskytnutý řetězec není prázdný.

Parameters:

s - zkoumaný řetězec

m - zpráva výjimky

Returns:

zkoumaný řetězec

Throws:

java.lang.IllegalArgumentException - pokud zkoumaný řetězec je prázdný

Since:

1.4.29

See Also:

isEmpty(java.lang.String)

nonEmpty

public static java.lang.String nonEmpty(java.lang.String s)
                                 throws java.lang.IllegalArgumentException

Ověří, že poskytnutý řetězec není prázdný.

Parameters:

s - zkoumaný řetězec

Returns:

zkoumaný řetězec

Throws:

java.lang.IllegalArgumentException - pokud zkoumaný řetězec je prázdný

Since:

1.4.29

See Also:

isEmpty(java.lang.String)

compare

public static int compare(java.lang.Comparable... comparables)
                   throws java.lang.NullPointerException,
                          java.lang.IllegalArgumentException

Porovnává páry hodnot v zadaném pořadí tak dlouho, dokud jsou shodné. Jakmile je zjištěna odlišnost, je porovnávání ukončeno a je vrácena hodnota posledního porovnání Comparable.compareTo(T). Při shodě všech párů hodnot je vrácena 0.

Parameters:

comparables - páry hodnot, které se mají porovnat

Returns:

0, pokud jsou všechny páry shodné, kladné číslo, pokud je levý prvek páru (na sudé pozici počítáno od 0) vetší, než pravý prvek tohoto páru (a všechny předhozí páry jsou shodné), záporné číslo v opačném případě (přesně podle definice Comparable.compareTo(T))

Throws:

java.lang.NullPointerException - pokud je kterýkoliv předaný parametr nullový

java.lang.IllegalArgumentException - pokud je předání pole o lichém počtu prvků nebo lichý počet parametrů

Since:

1.3.23

runConcurrently

public static void runConcurrently(int count,
                                   boolean wait,
                                   java.util.function.IntConsumer run)

Vytvoří poskytnutý počet vláken a nastartuje je. Všechna vlákna vykonávají stejný kód. Rozlišení vláken od sebe se realizuje pomocí celočíselného parametru (pořadové číslo od 0).

Parameters:

count - počet vláken

wait - je-li nastaveno na true, bude metoda čekat na dokončení posledního z vláken, teprve pak se ukončí volání, v opačném případě se metoda ihned ukončí a vlákna tak poběží na pozadí

run - spouštěný kod; na rozdíl od běžných zvyklostí (rozhraní Runnable) je zde rozhraní umožňující předat kódu pořadové číslo vlákna, navíc je možné volaný kód zapsat pomocí lambda výrazu