Package org.graylog2.plugin.lookup

Class LookupResult

java.lang.Object

org.graylog2.plugin.lookup.LookupResult

public abstract class LookupResult
extends Object

The result of looking up a key in a lookup table (i. e. lookup data adapter or lookup cache).

For convenience, this class can be serialized and deserialized with Jackson (see ObjectMapper, but we strongly recommend implementing your own serialization and deserialization logic if you're implementing a lookup cache.

There are no guarantees about binary compatibility of this class across Graylog releases!

See Also:

• LookupDataAdapter.get(Object)
• LookupCache.get(LookupCacheKey, java.util.concurrent.Callable)
• LookupCacheKey

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	LookupResult.Builder

Field Summary

Fields

Modifier and Type	Field	Description
static final String	SINGLE_VALUE_KEY

Constructor Summary

Constructors

Constructor	Description
LookupResult()

Method Summary

Modifier and Type	Method	Description
static LookupResult.Builder	addDefaults(LookupDefaultSingleValue singleValue, LookupDefaultMultiValue multiValue)
static LookupResult.Builder	builder()
abstract long	cacheTTL()	The time to live (in milliseconds) for a LookupResult instance.
static LookupResult	createFromJSON(Object singleValue, Map<Object,Object> multiValue, List<String> stringListValue, boolean hasError, long cacheTTL)
static LookupResult	empty()
abstract boolean	hasError()
boolean	hasTTL()
boolean	isEmpty()
static LookupResult	multi(Boolean singleValue, Map<Object,Object> multiValue)
static LookupResult	multi(CharSequence singleValue, Map<Object,Object> multiValue)
static LookupResult	multi(Number singleValue, Map<Object,Object> multiValue)
abstract Map<Object,Object>	multiValue()
static LookupResult	single(Boolean singleValue)
static LookupResult	single(CharSequence singleValue)
static LookupResult	single(Number singleValue)
abstract Object	singleValue()
abstract List<String>	stringListValue()
static LookupResult	withDefaults(LookupDefaultSingleValue singleValue, LookupDefaultMultiValue multiValue)
static LookupResult	withError()
static LookupResult	withError(long errorTTL)
static LookupResult	withError(String errorMsg)
static LookupResult.Builder	withoutTTL()

Methods inherited from class java.lang.Object

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

Field Details

SINGLE_VALUE_KEY

public static final String SINGLE_VALUE_KEY

See Also:

• Constant Field Values

Constructor Details

LookupResult

public LookupResult()

Method Details

singleValue

@Nullable
public abstract Object singleValue()

multiValue

@Nullable
public abstract Map<Object,Object> multiValue()

stringListValue

@Nullable
public abstract List<String> stringListValue()

hasError

public abstract boolean hasError()

cacheTTL

public abstract long cacheTTL()

The time to live (in milliseconds) for a LookupResult instance. Prevents repeated lookups for the same key during the time to live period. Depending on the LookupCache implementation this might be ignored.

isEmpty

public boolean isEmpty()

hasTTL

public boolean hasTTL()

empty

public static LookupResult empty()

withError

public static LookupResult withError()

withError

public static LookupResult withError(String errorMsg)

withError

public static LookupResult withError(long errorTTL)

single

public static LookupResult single(CharSequence singleValue)

single

public static LookupResult single(Number singleValue)

single

public static LookupResult single(Boolean singleValue)

multi

public static LookupResult multi(CharSequence singleValue,
 Map<Object,Object> multiValue)

multi

public static LookupResult multi(Number singleValue,
 Map<Object,Object> multiValue)

multi

public static LookupResult multi(Boolean singleValue,
 Map<Object,Object> multiValue)

withDefaults

public static LookupResult withDefaults(LookupDefaultSingleValue singleValue,
 LookupDefaultMultiValue multiValue)

addDefaults

public static LookupResult.Builder addDefaults(LookupDefaultSingleValue singleValue,
 LookupDefaultMultiValue multiValue)

createFromJSON

public static LookupResult createFromJSON(Object singleValue,
 Map<Object,Object> multiValue,
 List<String> stringListValue,
 boolean hasError,
 long cacheTTL)

withoutTTL

public static LookupResult.Builder withoutTTL()

builder

public static LookupResult.Builder builder()