org.openksavi.sponge.core.util

Class SpongeUtils

java.lang.Object

org.openksavi.sponge.core.util.SpongeUtils

public abstract class SpongeUtils
extends Object

This class defines a set of utility methods. It also wraps some of the external dependencies like Guava to avoid version conflicts in the client code. All Sponge projects except sponge-core should use only such wrapper methods defined here.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_SECURITY_ALGORITHM
static String	TAG_SECURITY_ALGORITHM
static String	TAG_SECURITY_KEY_PASSWORD
static String	TAG_SECURITY_KEY_STORE
static String	TAG_SECURITY_KEY_STORE_PASSWORD
protected static org.reflections.Reflections	TYPE_REFLECTIONS

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SpongeUtils()

Method Summary

Modifier and Type	Method and Description
static boolean	awaitUntil(Callable<Boolean> callable, long timeout, TimeUnit unit)
static int	calculateInitialDynamicThreadPoolSize(SpongeEngine engine, int maxPoolSize)
static void	close(InputStream stream)
static void	close(OutputStream stream)
static void	closeQuietly(Reader reader)
static boolean	containsException(Throwable exception, Class<?> type)
static String	createControlEventName(Class<? extends ControlEvent> controlEventClass)
static String	createGlobalLoggerName(KnowledgeBaseEngineOperations knowledgeBaseEngineOperations)
static <T> T	createInstance(String className, Class<T> javaClass)
static String	createLoggerName(KnowledgeBase knowledgeBase, String targetName)
static String	createNonScriptKnowledgeBaseName(KnowledgeBase knowledgeBase)
static String	createPluginLoggerName()
static SslConfiguration	createSecurityConfiguration(Configuration securityConfiguration)
static SSLContext	createSslContext(SslConfiguration security)
static <T extends Serializable> T	deepClone(T source)
static void	doInWrappedException(KnowledgeBase knowledgeBase, Runnable runnable, String sourceName)
static String	dumpConfiguration(org.apache.commons.configuration2.Configuration configuration) Dumps configuration to string.
static void	executeConcurrentlyOnce(SpongeEngine engine, Runnable runnable)
static String	getAbbreviatedEventSequenceString(BaseRule rule)
static Class<?>	getClass(String className)
static String	getConfigurationFileDir(SpongeEngine engine) Returns the configuration file directory or null if the configuration file is not present.
static KnowledgeBaseEngineOperations	getEps(KnowledgeBaseInterpreter interpreter)
static <T> T	getException(Throwable exception, Class<T> type)
static String	getLastSubdirectory(String dir)
static List<String>	getNameList(String namesSpec)
static String	getPackagePath(Class<?> cls)
static ProcessorQualifiedName	getProcessorQualifiedName(ProcessorOperations processorOperations)
static List<ProcessorQualifiedName>	getProcessorQualifiedNameList(String processorQualifiedNamesSpec)
static Reader	getReader(String fileName)
static Reader	getReader(String fileName, Charset charset)
static String	getRequiredConfigurationString(Configuration configuration, String key)
static ScriptKnowledgeBaseInterpreter	getScriptInterpreter(SpongeEngine engine, String kbName)
static String	getSourceName(Throwable exception)
static List<Class<? extends Type>>	getSupportedTypes()
static URL	getUrlFromClasspath(String resourceName)
static <K,V> Map<K,V>	immutableMapOf(K k1, V v1)
static <K,V> Map<K,V>	immutableMapOf(K k1, V v1, K k2, V v2)
static <K,V> Map<K,V>	immutableMapOf(K k1, V v1, K k2, V v2, K k3, V v3)
static <K,V> Map<K,V>	immutableMapOf(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4)
static <K,V> Map<K,V>	immutableMapOf(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5)
static Object	invokeMethod(Object target, String name, Object... args)
static boolean	isAbstract(Class<?> cls)
static boolean	isSystemEvent(Event event)
static void	registerShutdownHook(SpongeEngine engine)
static Object	searchConfigurationValueByAttributeValue(Configuration root, String parentKey, String attrName, String attrValue)
static void	shutdownExecutorService(SpongeEngine engine, Object named, ExecutorService executorService)
static List<String>	split(String text, char separator)
static <T> Stream<T>	stream(Iterator<T> iterator)
static int	toInt(Object value)
static String	toStringArrayEventSequence(Collection<Event> events, String attributeName)
static String	toStringEventSequence(Collection<Event> events)
static String	toStringEventSequence(Collection<Event> events, String attributeName)
static String	toUpperCamelCaseFromUnderscore(String s)
static void	trialRunEngine(SpongeEngine engine, int timeout) Trial run of the engine.
static void	validateType(Type type, String valueName)
static SpongeException	wrapException(KnowledgeBaseInterpreter interpreter, Throwable throwable)
static SpongeException	wrapException(Processor<?> processor, Throwable throwable)
static SpongeException	wrapException(String sourceName, KnowledgeBaseInterpreter interpreter, Throwable throwable)
static SpongeException	wrapException(String sourceName, Throwable throwable) Wraps or creates a new Sponge exception.
static SpongeException	wrapException(Throwable throwable) Wraps or creates a new Sponge exception.
static SpongeException	wrapInvokeException(Object target, String method, KnowledgeBaseInterpreter interpreter, Throwable throwable)

Methods inherited from class java.lang.Object

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

Field Detail

TAG_SECURITY_KEY_STORE_PASSWORD

public static final String TAG_SECURITY_KEY_STORE_PASSWORD

See Also:

Constant Field Values

TAG_SECURITY_KEY_PASSWORD

public static final String TAG_SECURITY_KEY_PASSWORD

See Also:

Constant Field Values

TAG_SECURITY_KEY_STORE

public static final String TAG_SECURITY_KEY_STORE

See Also:

Constant Field Values

TAG_SECURITY_ALGORITHM

public static final String TAG_SECURITY_ALGORITHM

See Also:

Constant Field Values

DEFAULT_SECURITY_ALGORITHM

public static final String DEFAULT_SECURITY_ALGORITHM

See Also:

Constant Field Values

TYPE_REFLECTIONS

protected static final org.reflections.Reflections TYPE_REFLECTIONS

Constructor Detail

SpongeUtils

protected SpongeUtils()

Method Detail

trialRunEngine

public static void trialRunEngine(SpongeEngine engine,
                                  int timeout)

Trial run of the engine. Shuts down after timeout seconds after startup.

Parameters:

engine - the engine.

timeout - timeout in seconds.

createInstance

public static <T> T createInstance(String className,
                                   Class<T> javaClass)

invokeMethod

public static Object invokeMethod(Object target,
                                  String name,
                                  Object... args)

deepClone

public static <T extends Serializable> T deepClone(T source)

getReader

public static Reader getReader(String fileName)

getReader

public static Reader getReader(String fileName,
                               Charset charset)

getUrlFromClasspath

public static URL getUrlFromClasspath(String resourceName)

dumpConfiguration

public static String dumpConfiguration(org.apache.commons.configuration2.Configuration configuration)

Dumps configuration to string.

Parameters:

configuration - a configuration.

Returns:

a configuration dump string.

searchConfigurationValueByAttributeValue

public static Object searchConfigurationValueByAttributeValue(Configuration root,
                                                              String parentKey,
                                                              String attrName,
                                                              String attrValue)

executeConcurrentlyOnce

public static void executeConcurrentlyOnce(SpongeEngine engine,
                                           Runnable runnable)

createGlobalLoggerName

public static String createGlobalLoggerName(KnowledgeBaseEngineOperations knowledgeBaseEngineOperations)

createPluginLoggerName

public static String createPluginLoggerName()

createLoggerName

public static String createLoggerName(KnowledgeBase knowledgeBase,
                                      String targetName)

createNonScriptKnowledgeBaseName

public static String createNonScriptKnowledgeBaseName(KnowledgeBase knowledgeBase)

shutdownExecutorService

public static void shutdownExecutorService(SpongeEngine engine,
                                           Object named,
                                           ExecutorService executorService)

getScriptInterpreter

public static ScriptKnowledgeBaseInterpreter getScriptInterpreter(SpongeEngine engine,
                                                                  String kbName)

getEps

public static KnowledgeBaseEngineOperations getEps(KnowledgeBaseInterpreter interpreter)

getAbbreviatedEventSequenceString

public static String getAbbreviatedEventSequenceString(BaseRule rule)

wrapException

public static SpongeException wrapException(Throwable throwable)

Wraps or creates a new Sponge exception.

Parameters:

throwable - source throwable.

Returns:

Sponge exception.

wrapException

public static SpongeException wrapException(String sourceName,
                                            Throwable throwable)

Wraps or creates a new Sponge exception.

Parameters:

sourceName - source name of the exception.

throwable - source throwable.

Returns:

Sponge exception.

wrapException

public static SpongeException wrapException(Processor<?> processor,
                                            Throwable throwable)

wrapException

public static SpongeException wrapException(KnowledgeBaseInterpreter interpreter,
                                            Throwable throwable)

wrapException

public static SpongeException wrapException(String sourceName,
                                            KnowledgeBaseInterpreter interpreter,
                                            Throwable throwable)

wrapInvokeException

public static SpongeException wrapInvokeException(Object target,
                                                  String method,
                                                  KnowledgeBaseInterpreter interpreter,
                                                  Throwable throwable)

containsException

public static boolean containsException(Throwable exception,
                                        Class<?> type)

getException

public static <T> T getException(Throwable exception,
                                 Class<T> type)

getSourceName

public static String getSourceName(Throwable exception)

toStringEventSequence

public static String toStringEventSequence(Collection<Event> events)

toStringEventSequence

public static String toStringEventSequence(Collection<Event> events,
                                           String attributeName)

toStringArrayEventSequence

public static String toStringArrayEventSequence(Collection<Event> events,
                                                String attributeName)

createControlEventName

public static String createControlEventName(Class<? extends ControlEvent> controlEventClass)

calculateInitialDynamicThreadPoolSize

public static int calculateInitialDynamicThreadPoolSize(SpongeEngine engine,
                                                        int maxPoolSize)

getPackagePath

public static String getPackagePath(Class<?> cls)

getLastSubdirectory

public static String getLastSubdirectory(String dir)

immutableMapOf

public static <K,V> Map<K,V> immutableMapOf(K k1,
                                            V v1)

immutableMapOf

public static <K,V> Map<K,V> immutableMapOf(K k1,
                                            V v1,
                                            K k2,
                                            V v2)

immutableMapOf

public static <K,V> Map<K,V> immutableMapOf(K k1,
                                            V v1,
                                            K k2,
                                            V v2,
                                            K k3,
                                            V v3)

immutableMapOf

public static <K,V> Map<K,V> immutableMapOf(K k1,
                                            V v1,
                                            K k2,
                                            V v2,
                                            K k3,
                                            V v3,
                                            K k4,
                                            V v4)

immutableMapOf

public static <K,V> Map<K,V> immutableMapOf(K k1,
                                            V v1,
                                            K k2,
                                            V v2,
                                            K k3,
                                            V v3,
                                            K k4,
                                            V v4,
                                            K k5,
                                            V v5)

stream

public static <T> Stream<T> stream(Iterator<T> iterator)

split

public static List<String> split(String text,
                                 char separator)

close

public static void close(InputStream stream)

close

public static void close(OutputStream stream)

closeQuietly

public static void closeQuietly(Reader reader)

getRequiredConfigurationString

public static String getRequiredConfigurationString(Configuration configuration,
                                                    String key)

toInt

public static int toInt(Object value)

registerShutdownHook

public static void registerShutdownHook(SpongeEngine engine)

toUpperCamelCaseFromUnderscore

public static String toUpperCamelCaseFromUnderscore(String s)

isAbstract

public static boolean isAbstract(Class<?> cls)

awaitUntil

public static boolean awaitUntil(Callable<Boolean> callable,
                                 long timeout,
                                 TimeUnit unit)

isSystemEvent

public static boolean isSystemEvent(Event event)

getProcessorQualifiedNameList

public static List<ProcessorQualifiedName> getProcessorQualifiedNameList(String processorQualifiedNamesSpec)

getNameList

public static List<String> getNameList(String namesSpec)

createSslContext

public static SSLContext createSslContext(SslConfiguration security)

createSecurityConfiguration

public static SslConfiguration createSecurityConfiguration(Configuration securityConfiguration)

getProcessorQualifiedName

public static ProcessorQualifiedName getProcessorQualifiedName(ProcessorOperations processorOperations)

getClass

public static Class<?> getClass(String className)

doInWrappedException

public static void doInWrappedException(KnowledgeBase knowledgeBase,
                                        Runnable runnable,
                                        String sourceName)

validateType

public static void validateType(Type type,
                                String valueName)

getSupportedTypes

public static List<Class<? extends Type>> getSupportedTypes()

getConfigurationFileDir

public static String getConfigurationFileDir(SpongeEngine engine)

Returns the configuration file directory or null if the configuration file is not present.

Parameters:

engine - the engine.

Returns:

the configuration file directory.