net.adamcin.oakpal.core

Class Util

java.lang.Object

net.adamcin.oakpal.core.Util

public final class Util
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Util.TryFunction<T,R> Deprecated. 1.3.0 use Fun.ThrowingFunction

Method Summary

Modifier and Type	Method and Description
static <T,I,R> Function<T,R>	compose(Function<T,I> before, Function<I,R> after) Deprecated. 1.3.0 use Fun.compose1(Function, Function) instead
static <M,T,R> Function<T,M>	composeTry(Function<R,M> monadUnit, Supplier<M> monadZero, Util.TryFunction<T,R> onElement, BiConsumer<T,Exception> onError) Deprecated. 1.3.0 use Fun.composeTry1(Function, Supplier, Fun.ThrowingFunction, BiConsumer)
static <T> Predicate<T>	debugFilter(org.slf4j.Logger logger, String format) Logger function to inject into a stream by way of filter() method.
static String	escapeManifestHeaderValue(String... values)
static String	escapeManifestHeaderValues(@NotNull List<String> values)
static List<String>	getManifestHeaderValues(Manifest manifest, String headerName)
static Map<URL,List<URL>>	mapManifestHeaderResources(String headerName, ClassLoader classLoader)
static Map<URL,List<URL>>	mapManifestHeaderResources(String headerName, List<File> files)
static Map<URL,List<URL>>	mapManifestHeaderResources(String headerName, URL manifestUrl)
static <T,R> Function<T,Optional<R>>	optFunc(Function<T,R> inputFunc) Deprecated. 1.3.0 use Fun.compose(Optional::ofNullable, inputFunc)
static List<URL>	resolveManifestResources(URL manifestUrl, List<String> resources)
static <T> Predicate<T>	traceFilter(org.slf4j.Logger logger, String format) Logger function to inject into a stream by way of filter() method.
static javax.jcr.Session	wrapSessionReadOnly(javax.jcr.Session session) Public utility method to wrap an existing session with a facade that blocks writes.

Methods inherited from class java.lang.Object

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

Method Detail

wrapSessionReadOnly

public static javax.jcr.Session wrapSessionReadOnly(javax.jcr.Session session)

Public utility method to wrap an existing session with a facade that blocks writes.

Parameters:

session - the existing session to wrap

Returns:

a read-only session

getManifestHeaderValues

public static List<String> getManifestHeaderValues(Manifest manifest,
                                                   String headerName)

escapeManifestHeaderValue

public static String escapeManifestHeaderValue(@NotNull
                                               String... values)

escapeManifestHeaderValues

public static String escapeManifestHeaderValues(@NotNull
                                                @NotNull List<String> values)

resolveManifestResources

public static List<URL> resolveManifestResources(URL manifestUrl,
                                                 List<String> resources)

mapManifestHeaderResources

public static Map<URL,List<URL>> mapManifestHeaderResources(String headerName,
                                                            ClassLoader classLoader)
                                                     throws IOException

Throws:

IOException

mapManifestHeaderResources

public static Map<URL,List<URL>> mapManifestHeaderResources(String headerName,
                                                            List<File> files)
                                                     throws IOException

Throws:

IOException

mapManifestHeaderResources

public static Map<URL,List<URL>> mapManifestHeaderResources(String headerName,
                                                            URL manifestUrl)
                                                     throws IOException

Throws:

IOException

debugFilter

public static <T> Predicate<T> debugFilter(org.slf4j.Logger logger,
                                           String format)

Logger function to inject into a stream by way of filter() method. Calls logger.debug() with the provided format string and the current stream element as a format argument.

Type Parameters:

T - the captured type parameter for the stream element

Parameters:

logger - the logger to use

format - the SLF4j format string (use curly braces for placeholders)

Returns:

a single-argument predicate for use in a Stream.filter() method

traceFilter

public static <T> Predicate<T> traceFilter(org.slf4j.Logger logger,
                                           String format)

Logger function to inject into a stream by way of filter() method. Calls logger.trace() with the provided format string and the current stream element as a format argument.

Type Parameters:

T - the captured type parameter for the stream element

Parameters:

logger - the logger to use

format - the SLF4j format string (use curly braces for placeholders)

Returns:

a single-argument predicate for use in a Stream.filter() method

composeTry

@Deprecated
public static <M,T,R> Function<T,M> composeTry(Function<R,M> monadUnit,
                                                           Supplier<M> monadZero,
                                                           Util.TryFunction<T,R> onElement,
                                                           BiConsumer<T,Exception> onError)

Deprecated. 1.3.0 use Fun.composeTry1(Function, Supplier, Fun.ThrowingFunction, BiConsumer)

Composes four lambdas into a single function for use with flatMap() defined by Stream, Optional, etc. Useful for eliminating clumsy try/catch blocks from lambdas.

Type Parameters:

M - The captured monad type, which must match the return types of the monadUnit and monadZero functions, but which is not involved in the onElement or onError functions.

T - The input type mapped by the monad, i.e. the String type in Stream<String>.

R - The output type mapped by the monad, i.e. the URL type in Stream<URL>.

Parameters:

monadUnit - the "unit" (or "single") function defined by the appropriate monad. I.E. Stream::of, Optional::of, or Optional::ofNullable.

monadZero - the "zero" (or "empty") function defined by the appropriate monad, as in Stream::empty, or Optional::empty

onElement - some function that produces type R when given an object of type T, or fails with an Exception.

onError - an optional consumer function to perform some logic when the parser function throws. Receives both the failing input element and the caught Exception.

Returns:

a flatMappable function

See Also:

Fun.composeTry1(Function, Supplier, Fun.ThrowingFunction, BiConsumer)

optFunc

@Deprecated
public static <T,R> Function<T,Optional<R>> optFunc(Function<T,R> inputFunc)

Deprecated. 1.3.0 use Fun.compose(Optional::ofNullable, inputFunc)

Compose a function with Optional::ofNullable to wrap the output type.

Type Parameters:

T - input type

R - input function return type

Parameters:

inputFunc - the input function

Returns:

a function returning an optional of the input function return type

compose

@Deprecated
public static <T,I,R> Function<T,R> compose(Function<T,I> before,
                                                        Function<I,R> after)

Deprecated. 1.3.0 use Fun.compose1(Function, Function) instead

Compose two functions, left-to-right.

Type Parameters:

T - the input type

I - the intermediate type

R - the output type

Parameters:

before - the left function

after - the right function

Returns:

a composed function from T to R