com.madara

Class KnowledgeBase

java.lang.Object

com.madara.MadaraJNI

com.madara.KnowledgeBase

public class KnowledgeBase
extends MadaraJNI

This class provides a distributed knowledge base to users

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	KnowledgeBase.CompiledExpression Compiled, optimized KaRL logic.
class	KnowledgeBase.KnowledgeBaseLockedException KnowledgeBaseLockedException will be thrown if methods are called from inside a MadaraFunction

Constructor Summary

Constructors

Constructor and Description
KnowledgeBase() Creates a KnowledgeBase with default settings
KnowledgeBase(KnowledgeBase original) Copy constructor
KnowledgeBase(java.lang.String host, TransportSettings config) Creates a KnowledgeBase
KnowledgeBase(java.lang.String host, TransportType transport, java.lang.String domain) Creates a KnowledgeBase

Method Summary

Modifier and Type	Method and Description
void	attachLogger(Logger logger) Attaches a logger that will manage all output from the KnowledgeBase
void	attachTransport(java.lang.String id, TransportSettings settings) Attaches a new transport to the Knowledge Base
void	clear() Clears the knowledge base.
void	clearModifieds() Clears all modified variables that were going to be sent with next call to sendModifieds (also a part of eval, set, wait and similar functions)
void	closeTransports() Closes any transports attached to the Knowledge Base
KnowledgeBase.CompiledExpression	compile(java.lang.String expression) Compiles a KaRL expression into an expression tree.
java.lang.String	debugModifieds() Retrieves a stringified list of all modified variables that are ready to send over transport on next send_modifieds call
void	defineFunction(java.lang.String name, MadaraFunction function) Currently unsupported Defines a function.
void	defineFunction(java.lang.String name, java.lang.String expression) Defines a MADARA KaRL function.
KnowledgeRecord	evaluate(KnowledgeBase.CompiledExpression expression) Evaluates an expression.
KnowledgeRecord	evaluate(KnowledgeBase.CompiledExpression expression, EvalSettings evalSettings) Evaluates an expression.
KnowledgeRecord	evaluate(java.lang.String expression) Evaluates an expression.
KnowledgeRecord	evaluate(java.lang.String expression, EvalSettings evalSettings) Evaluates an expression.
void	evaluateNoReturn(KnowledgeBase.CompiledExpression expression) Evaluates an expression.
void	evaluateNoReturn(KnowledgeBase.CompiledExpression expression, EvalSettings evalSettings) Evaluates an expression.
void	evaluateNoReturn(java.lang.String expression) Evaluates an expression.
void	evaluateNoReturn(java.lang.String expression, EvalSettings evalSettings) Evaluates an expression.
boolean	exists(java.lang.String name) Checks to see if record exists
protected void	finalize() Cleans up underlying C resources
void	free() Deletes the C++ instantiation.
static KnowledgeBase	fromPointer(long cptr) Creates a java object instance from a C/C++ pointer
static KnowledgeBase	fromPointer(long cptr, boolean shouldManage) Creates a java object instance from a C/C++ pointer
KnowledgeRecord	get(java.lang.String name) Retrieves a knowledge value.
java.lang.String	getID() Get KnowledgeBase ID
Logger	getLogger() Returns the logger that manages all output from the KnowledgeBase
long	loadContext(java.lang.String filename, boolean useId, EvalSettings settings) Loads the knowledge base from a file
void	print() Prints all knowledge in knowledge base
void	print(java.lang.String statement) Prints a statement with variable expansion
long	saveAsKarl(java.lang.String filename) Saves the knowledge base to a file in a human-readable format that can be read in with evaluate or wait statements.
long	saveCheckpoint(java.lang.String filename, boolean resetModifieds) Saves a snapshot of changes to the context since the last saveContext, saveCheckpoint, or sendModifieds.
long	saveContext(java.lang.String filename) Saves the knowledge base to a file
void	sendModifieds() Sends all modifications to global variables since last send modifieds, eval, wait, or set statement.
void	sendModifieds(EvalSettings settings) Sends all modifications to global variables since last send modifieds, eval, wait, or set statement.
void	set(java.lang.String name, double value) Sets a knowledge value to a specified value.
void	set(java.lang.String name, double[] value) Sets a knowledge value to a specified value.
void	set(java.lang.String name, double[] value, EvalSettings settings) Sets a knowledge value to a specified value.
void	set(java.lang.String name, double value, EvalSettings settings) Sets a knowledge value to a specified value.
void	set(java.lang.String name, long value) Sets a knowledge value to a specified value.
void	set(java.lang.String name, long[] value) Sets a knowledge variable to a specified long array.
void	set(java.lang.String name, long[] value, EvalSettings settings) Sets a knowledge value to a specified value.
void	set(java.lang.String name, long value, EvalSettings settings) Sets a knowledge value to a specified value.
void	set(java.lang.String name, java.lang.String value) Sets a knowledge value to a specified value.
void	set(java.lang.String name, java.lang.String value, EvalSettings settings) Sets a knowledge value to a specified value.
void	setFile(java.lang.String name, byte[] value) Sets a knowledge variable to a specified byte array.
void	setFile(java.lang.String name, byte[] value, EvalSettings settings) Sets a knowledge variable to a specified file byte array.
void	setImage(java.lang.String name, byte[] value) Sets a knowledge variable to a specified byte array.
void	setImage(java.lang.String name, byte[] value, EvalSettings settings) Sets a knowledge variable to a specified image byte array.
static void	setLogLevel(MadaraLog.MadaraLogLevel logLevel) Sets the log level to dictate the detail of MADARA logging.
KnowledgeList	toKnowledgeList(java.lang.String subject, int start, int end) Fills a KnowledgeList with KnowledgeRecords that begin with a common subject and have a finite range of integer values.
KnowledgeMap	toKnowledgeMap(java.lang.String expression) Fills a KnowledgeMap with KnowledgeRecords that match an expression.
KnowledgeMap	toKnowledgeMap(java.lang.String prefix, java.lang.String suffix) Fills a KnowledgeMap with KnowledgeRecords that match a prefix and suffix.
java.lang.String	toString() Prints the knowledge base to a string for debugging purposes
java.lang.String	toString(java.lang.String arrayDelimiter, java.lang.String recordDelimiter, java.lang.String keyvalDelimiter) Prints the knowledge base to a string for debugging purposes
KnowledgeRecord	wait(KnowledgeBase.CompiledExpression expression) Waits for an expression to be non-zero.
KnowledgeRecord	wait(KnowledgeBase.CompiledExpression expression, WaitSettings settings) Waits for an expression to be non-zero.
KnowledgeRecord	wait(java.lang.String expression) Waits for an expression to be non-zero.
KnowledgeRecord	wait(java.lang.String expression, WaitSettings settings) Waits for an expression to be non-zero.
void	waitNoReturn(KnowledgeBase.CompiledExpression expression) Waits for an expression to be non-zero.
void	waitNoReturn(KnowledgeBase.CompiledExpression expression, WaitSettings settings) Waits for an expression to be non-zero.
void	waitNoReturn(java.lang.String expression) Waits for an expression to be non-zero.
void	waitNoReturn(java.lang.String expression, WaitSettings settings) Waits for an expression to be non-zero.

Methods inherited from class com.madara.MadaraJNI

getCPtr, setCPtr

Methods inherited from class java.lang.Object

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

Constructor Detail

KnowledgeBase

public KnowledgeBase()

Creates a KnowledgeBase with default settings

KnowledgeBase

public KnowledgeBase(java.lang.String host,
                     TransportType transport,
                     java.lang.String domain)

Creates a KnowledgeBase

Parameters:

host - hostname/ip of this machine

transport - to use for knowledge dissemination

domain - knowledge domain we want to join

KnowledgeBase

public KnowledgeBase(java.lang.String host,
                     TransportSettings config)

Creates a KnowledgeBase

Parameters:

host - hostname/ip of this machine

config - transport settings to use for dissemination

KnowledgeBase

public KnowledgeBase(KnowledgeBase original)

Copy constructor

Parameters:

original - knowledge base to copy from

Method Detail

fromPointer

public static KnowledgeBase fromPointer(long cptr)

Creates a java object instance from a C/C++ pointer

Parameters:

cptr - C pointer to the object

Returns:

a new java instance of the underlying pointer

fromPointer

public static KnowledgeBase fromPointer(long cptr,
                                        boolean shouldManage)

Creates a java object instance from a C/C++ pointer

Parameters:

cptr - C pointer to the object

shouldManage - if true, manage the pointer

Returns:

a new java instance of the underlying pointer

getID

public java.lang.String getID()

Get KnowledgeBase ID

Returns:

KnowledgeBase ID

evaluate

public KnowledgeRecord evaluate(java.lang.String expression)

Evaluates an expression.
The returned KnowledgeRecord must be freed (() KnowledgeRecord.free ()) at some point. If it is to be ignored, consider using (String)

Parameters:

expression - KaRL expression to evaluate

Returns:

value of expression

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

evaluateNoReturn

public void evaluateNoReturn(java.lang.String expression)

Evaluates an expression.

Parameters:

expression - KaRL expression to evaluate

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

evaluate

public KnowledgeRecord evaluate(java.lang.String expression,
                                EvalSettings evalSettings)

Evaluates an expression. The returned KnowledgeRecord must be freed (() KnowledgeRecord.free ()) at some point. If it is to be ignored, consider using (String,EvalSettings)

Parameters:

expression - KaRL expression to evaluate

evalSettings - Settings for evaluating and printing

Returns:

value of expression

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

evaluateNoReturn

public void evaluateNoReturn(java.lang.String expression,
                             EvalSettings evalSettings)

Evaluates an expression.

Parameters:

expression - KaRL expression to evaluate

evalSettings - evalSettings Settings for evaluating and printing

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

evaluate

public KnowledgeRecord evaluate(KnowledgeBase.CompiledExpression expression)

Evaluates an expression. The returned KnowledgeRecord must be freed (() KnowledgeRecord.free ()) at some point. If it is to be ignored, consider using (CompiledExpression)

Parameters:

expression - KaRL expression to evaluate (result of (String))

Returns:

value of expression

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

evaluateNoReturn

public void evaluateNoReturn(KnowledgeBase.CompiledExpression expression)

Evaluates an expression.

Parameters:

expression - KaRL expression to evaluate (result of (String))

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

evaluate

public KnowledgeRecord evaluate(KnowledgeBase.CompiledExpression expression,
                                EvalSettings evalSettings)

Evaluates an expression. The returned KnowledgeRecord must be freed (() KnowledgeRecord.free ()) at some point. If it is to be ignored, consider using (CompiledExpression,EvalSettings)

Parameters:

expression - KaRL expression to evaluate (result of (String))

evalSettings - Settings for evaluating and printing

Returns:

value of expression

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

evaluateNoReturn

public void evaluateNoReturn(KnowledgeBase.CompiledExpression expression,
                             EvalSettings evalSettings)

Evaluates an expression.

Parameters:

expression - KaRL expression to evaluate (result of (String))

evalSettings - Settings for evaluating and printing

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

compile

public KnowledgeBase.CompiledExpression compile(java.lang.String expression)

Compiles a KaRL expression into an expression tree.

Parameters:

expression - expression to compile

Returns:

CompiledExpression: compiled, optimized expression tree

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

defineFunction

public void defineFunction(java.lang.String name,
                           MadaraFunction function)

Currently unsupported
Defines a function.

Parameters:

name - name of the function

function - Implementation of MadaraFunction

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

attachLogger

public void attachLogger(Logger logger)

Attaches a logger that will manage all output from the KnowledgeBase

Parameters:

logger - a logger to use for managing information and debugging

attachTransport

public void attachTransport(java.lang.String id,
                            TransportSettings settings)

Attaches a new transport to the Knowledge Base

Parameters:

id - unique identifier for this agent

settings - settings for the new transport

getLogger

public Logger getLogger()

Returns the logger that manages all output from the KnowledgeBase

Returns:

the logger being used for managing information and debugging

debugModifieds

public java.lang.String debugModifieds()

Retrieves a stringified list of all modified variables that are ready to send over transport on next send_modifieds call

Returns:

stringified list of the modified knowledge records

closeTransports

public void closeTransports()

Closes any transports attached to the Knowledge Base

defineFunction

public void defineFunction(java.lang.String name,
                           java.lang.String expression)

Defines a MADARA KaRL function.

Parameters:

name - name of the function

expression - KaRL function body

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

clear

public void clear()

Clears the knowledge base.

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

exists

public boolean exists(java.lang.String name)

Checks to see if record exists

Parameters:

name - name of record to check

Returns:

true if the record exists, false otherwise

get

public KnowledgeRecord get(java.lang.String name)

Retrieves a knowledge value.

Parameters:

name - knowledge name

Returns:

value of knowledge

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

set

public void set(java.lang.String name,
                long value)

Sets a knowledge value to a specified value.

Parameters:

name - knowledge name

value - value to set

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

set

public void set(java.lang.String name,
                double value)

Sets a knowledge value to a specified value.

Parameters:

name - knowledge name

value - value to set

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

set

public void set(java.lang.String name,
                java.lang.String value)

Sets a knowledge value to a specified value.

Parameters:

name - knowledge name

value - value to set

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

set

public void set(java.lang.String name,
                double[] value)

Sets a knowledge value to a specified value.

Parameters:

name - knowledge name

value - value to set

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

set

public void set(java.lang.String name,
                long[] value)

Sets a knowledge variable to a specified long array.

Parameters:

name - knowledge name

value - value to set

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

setFile

public void setFile(java.lang.String name,
                    byte[] value)

Sets a knowledge variable to a specified byte array.

Parameters:

name - knowledge name

value - value to set

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

setImage

public void setImage(java.lang.String name,
                     byte[] value)

Sets a knowledge variable to a specified byte array.

Parameters:

name - knowledge name

value - value to set

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

set

public void set(java.lang.String name,
                long value,
                EvalSettings settings)

Sets a knowledge value to a specified value.

Parameters:

name - knowledge name

value - value to set

settings - settings for evaluating the set command

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

set

public void set(java.lang.String name,
                double value,
                EvalSettings settings)

Sets a knowledge value to a specified value.

Parameters:

name - knowledge name

value - value to set

settings - settings for evaluating the set command

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

set

public void set(java.lang.String name,
                java.lang.String value,
                EvalSettings settings)

Sets a knowledge value to a specified value.

Parameters:

name - knowledge name

value - value to set

settings - settings for evaluating the set command

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

set

public void set(java.lang.String name,
                double[] value,
                EvalSettings settings)

Sets a knowledge value to a specified value.

Parameters:

name - knowledge name

value - value to set

settings - settings for evaluating the set command

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

set

public void set(java.lang.String name,
                long[] value,
                EvalSettings settings)

Sets a knowledge value to a specified value.

Parameters:

name - knowledge name

value - value to set

settings - settings for evaluating the set command

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

setFile

public void setFile(java.lang.String name,
                    byte[] value,
                    EvalSettings settings)

Sets a knowledge variable to a specified file byte array.

Parameters:

name - knowledge name

value - value to set

settings - settings for evaluating the set command

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

setImage

public void setImage(java.lang.String name,
                     byte[] value,
                     EvalSettings settings)

Sets a knowledge variable to a specified image byte array.

Parameters:

name - knowledge name

value - value to set

settings - settings for evaluating the set command

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

sendModifieds

public void sendModifieds()

Sends all modifications to global variables since last send modifieds, eval, wait, or set statement.

clearModifieds

public void clearModifieds()

Clears all modified variables that were going to be sent with next call to sendModifieds (also a part of eval, set, wait and similar functions)

sendModifieds

public void sendModifieds(EvalSettings settings)

Sends all modifications to global variables since last send modifieds, eval, wait, or set statement.

Parameters:

settings - settings to use for considering records to send

print

public void print(java.lang.String statement)

Prints a statement with variable expansion

Parameters:

statement - The statement to print

print

public void print()

Prints all knowledge in knowledge base

free

public void free()

Deletes the C++ instantiation. To prevent memory leaks, this must be called before an instance of KnowledgeBase gets garbage collected

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

finalize

protected void finalize()
                 throws java.lang.Throwable

Cleans up underlying C resources

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable - necessary for override but unused

wait

public KnowledgeRecord wait(java.lang.String expression)

Waits for an expression to be non-zero.

The returned KnowledgeRecord must be freed (() KnowledgeRecord.free ()) at some point. If it is to be ignored, consider using (String)

Parameters:

expression - KaRL expression to evaluate

Returns:

value of expression

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

wait

public KnowledgeRecord wait(KnowledgeBase.CompiledExpression expression)

Waits for an expression to be non-zero.

The returned KnowledgeRecord must be freed (() KnowledgeRecord.free ()) at some point. If it is to be ignored, consider using (CompiledExpression)

Parameters:

expression - KaRL expression to evaluate (result of (String))

Returns:

value of expression

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

wait

public KnowledgeRecord wait(java.lang.String expression,
                            WaitSettings settings)

Waits for an expression to be non-zero.
Provides additional settings for fine-tuning the time to wait and atomic print statements.

The returned KnowledgeRecord must be freed (() KnowledgeRecord.free ()) at some point. If it is to be ignored, consider using (String,WaitSettings)

Parameters:

expression - KaRL expression to evaluate

settings - Settings for waiting

Returns:

value of expression

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

wait

public KnowledgeRecord wait(KnowledgeBase.CompiledExpression expression,
                            WaitSettings settings)

Waits for an expression to be non-zero.
Provides additional settings for fine-tuning the time to wait and atomic print statements.

The returned KnowledgeRecord must be freed (() KnowledgeRecord.free ()) at some point. If it is to be ignored, consider using (CompiledExpression,WaitSettings)

Parameters:

expression - KaRL expression to evaluate (result of (String))

settings - Settings for waiting

Returns:

value of expression

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

waitNoReturn

public void waitNoReturn(java.lang.String expression)

Waits for an expression to be non-zero.

Parameters:

expression - KaRL expression to evaluate

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

waitNoReturn

public void waitNoReturn(KnowledgeBase.CompiledExpression expression)

Waits for an expression to be non-zero.

Parameters:

expression - KaRL expression to evaluate (result of (String))

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

waitNoReturn

public void waitNoReturn(java.lang.String expression,
                         WaitSettings settings)

Waits for an expression to be non-zero.

Parameters:

expression - KaRL expression to evaluate

settings - Settings for waiting

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

waitNoReturn

public void waitNoReturn(KnowledgeBase.CompiledExpression expression,
                         WaitSettings settings)

Waits for an expression to be non-zero.

Parameters:

expression - KaRL expression to evaluate (result of (String))

settings - Settings for waiting

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

toKnowledgeList

public KnowledgeList toKnowledgeList(java.lang.String subject,
                                     int start,
                                     int end)

Fills a KnowledgeList with KnowledgeRecords that begin with a common subject and have a finite range of integer values.

The returned KnowledgeList must be freed using KnowledgeList.free () before the object goes out of scope.

Parameters:

subject - The common subject of the variable names. For instance, if we are looking for a range of vars like "var0", "var1", "var2", then the common subject would be "var".

start - An inclusive start index

end - An inclusive end index

Returns:

KnowledgeList containing the requested KnowledgeRecords

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

saveContext

public long saveContext(java.lang.String filename)

Saves the knowledge base to a file

Parameters:

filename - the file to save the knowledge base to

Returns:

the number of bytes written to the file

saveAsKarl

public long saveAsKarl(java.lang.String filename)

Saves the knowledge base to a file in a human-readable format that can be read in with evaluate or wait statements.

Parameters:

filename - the file to save the knowledge base to

Returns:

the number of bytes written to the file

loadContext

public long loadContext(java.lang.String filename,
                        boolean useId,
                        EvalSettings settings)

Loads the knowledge base from a file

Parameters:

filename - the file to load the knowledge base from

useId - if true, read the unique ID from the file. If false, do not use the unique ID from the file.

settings - the settings for updating values in the context from file

Returns:

the number of bytes read

saveCheckpoint

public long saveCheckpoint(java.lang.String filename,
                           boolean resetModifieds)

Saves a snapshot of changes to the context since the last saveContext, saveCheckpoint, or sendModifieds. This is an incremental snapshot from last time the modification list was cleared and can be much faster than a saveContext.

Parameters:

filename - the file to save the knowledge base changes to

resetModifieds - if true, clear the modification list (this is a bad idea if you should be sending modifications over a transport as well as saving them to a file.

Returns:

the number of bytes written to the file

toKnowledgeMap

public KnowledgeMap toKnowledgeMap(java.lang.String expression)

Fills a KnowledgeMap with KnowledgeRecords that match an expression.

The returned KnowledgeMap must be freed using KnowledgeMap.free () before the object goes out of scope.

Parameters:

expression - An expression that matches the variable names that are of interest. Wildcards may only be at the end

Returns:

KnowledgeMap containing the requested KnowledgeRecords

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

toKnowledgeMap

public KnowledgeMap toKnowledgeMap(java.lang.String prefix,
                                   java.lang.String suffix)

Fills a KnowledgeMap with KnowledgeRecords that match a prefix and suffix.

The returned KnowledgeMap must be freed using KnowledgeMap.free () before the object goes out of scope.

Parameters:

prefix - the prefix of the variables (e.g., in "{prefix}*{suffix}")

suffix - the suffix of the variables (e.g., in "{prefix}*{suffix}")

Returns:

KnowledgeMap containing the requested KnowledgeRecords

Throws:

KnowledgeBase.KnowledgeBaseLockedException - If called from a MadaraFunction

toString

public java.lang.String toString()

Prints the knowledge base to a string for debugging purposes

Overrides:

toString in class MadaraJNI

Returns:

string representation of the knowledge base

See Also:

()

toString

public java.lang.String toString(java.lang.String arrayDelimiter,
                                 java.lang.String recordDelimiter,
                                 java.lang.String keyvalDelimiter)

Prints the knowledge base to a string for debugging purposes

Parameters:

arrayDelimiter - delimiter to use between array elements

recordDelimiter - delimiter to use in between records

keyvalDelimiter - delimiter to use in between keys and values

Returns:

string representation of the knowledge base

setLogLevel

public static void setLogLevel(MadaraLog.MadaraLogLevel logLevel)

Sets the log level to dictate the detail of MADARA logging.

Parameters:

logLevel - The log level to set