com.splunk

Class ResourceCollection<T extends Resource>

java.lang.Object

com.splunk.Resource

com.splunk.ResourceCollection<T>

Type Parameters:

T - The type of members of the collection.

All Implemented Interfaces:

Map<String,T>

Direct Known Subclasses:

ConfCollection, EntityCollection

public class ResourceCollection<T extends Resource>
extends Resource
implements Map<String,T>

The ResourceCollection abstract base class represents a collection of Splunk resources.

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Field Summary

Fields

Modifier and Type	Field and Description
protected Class	itemClass
protected LinkedHashMap<String,LinkedList<T>>	items

Fields inherited from class com.splunk.Resource

actions, path, refreshArgs, service, title, updated

Method Summary

Modifier and Type	Method and Description
void	clear()
boolean	containsKey(Object key)
boolean	containsKey(Object key, Args namespace) Determines whether a scoped, namespace-constrained key exists within this collection.
boolean	containsValue(Object value)
protected T	createItem(AtomEntry entry) Creates a collection member corresponding to a given Atom entry.
protected T	createItem(Class itemClass, String path, Args namespace) Creates a collection member.
Set<Map.Entry<String,T>>	entrySet()
boolean	equals(Object o)
T	get(Object key) Gets the value of a given key, if it exists within this collection.
T	get(Object key, Args namespace) Gets a the value of a scoped, namespace-constrained key, if it exists within this collection.
int	hashCode()
boolean	isEmpty()
protected String	itemKey(AtomEntry entry) Returns the value to use as the key from a given Atom entry.
protected String	itemPath(AtomEntry entry) Returns the value to use as the member's path from a given Atom entry.
Set<String>	keySet()
ResponseMessage	list() Issues an HTTP request to list the contents of the collection resource.
T	put(String key, T value)
void	putAll(Map<? extends String,? extends T> map) Copies all mappings from a given map to this map (unsupported).
ResourceCollection	refresh() Refreshes the local state of this resource.
T	remove(Object key)
int	size()
ResourceCollection<T>	validate() Ensures that the local state of the resource is current, calling refresh if necessary.
Collection<T>	values()
int	valueSize(Object key) Returns the number of values that a specific key represents.

Methods inherited from class com.splunk.Resource

getName, getPath, getService, getTitle, getUpdated, invalidate

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Field Detail

items

protected LinkedHashMap<String,LinkedList<T extends Resource>> items

itemClass

protected Class itemClass

Method Detail

clear

public void clear()

Specified by:

clear in interface Map<String,T extends Resource>

containsKey

public boolean containsKey(Object key)

Specified by:

containsKey in interface Map<String,T extends Resource>

containsKey

public boolean containsKey(Object key,
                           Args namespace)

Determines whether a scoped, namespace-constrained key exists within this collection.

Parameters:

key - The key to look up.

namespace - The namespace to constrain the search to.

Returns:

true if the key exists, false if not.

containsValue

public boolean containsValue(Object value)

Specified by:

containsValue in interface Map<String,T extends Resource>

createItem

protected T createItem(Class itemClass,
                       String path,
                       Args namespace)

Creates a collection member.

Parameters:

itemClass - The class of the member to create.

path - The path to the member resource.

namespace - The namespace.

Returns:

The new member.

createItem

protected T createItem(AtomEntry entry)

Creates a collection member corresponding to a given Atom entry. This base implementation uses the class object that was passed in when the generic ResourceCollection was created. Subclasses may override this method to provide alternative means of instantiating collection members.

Parameters:

entry - The AtomEntry corresponding to the member to instantiate.

Returns:

The new member.

entrySet

public Set<Map.Entry<String,T>> entrySet()

Specified by:

entrySet in interface Map<String,T extends Resource>

equals

public boolean equals(Object o)

Specified by:

equals in interface Map<String,T extends Resource>

Overrides:

equals in class Object

get

public T get(Object key)

Gets the value of a given key, if it exists within this collection.

Specified by:

get in interface Map<String,T extends Resource>

Parameters:

key - The key to look up.

Returns:

The value indexed by the key, or null if it doesn't exist.

Throws:

SplunkException - The exception to throw if there is more than one value represented by this key.

get

public T get(Object key,
             Args namespace)

Gets a the value of a scoped, namespace-constrained key, if it exists within this collection.

Parameters:

key - The key to look up.

namespace - The namespace to constrain the search to.

Returns:

The value indexed by the key, or null if it doesn't exist.

hashCode

public int hashCode()

Specified by:

hashCode in interface Map<String,T extends Resource>

Overrides:

hashCode in class Object

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Map<String,T extends Resource>

itemKey

protected String itemKey(AtomEntry entry)

Returns the value to use as the key from a given Atom entry. Subclasses may override this value for collections that use something other than "title" as the key.

Parameters:

entry - The AtomEntry corresponding to the collection member.

Returns:

The value to use as the member's key.

itemPath

protected String itemPath(AtomEntry entry)

Returns the value to use as the member's path from a given Atom entry. Subclasses may override this value to support alternative methods of determining a member's path.

Parameters:

entry - The AtomEntry corresponding to the collection member.

Returns:

The value to use as the member's path.

keySet

public Set<String> keySet()

Specified by:

keySet in interface Map<String,T extends Resource>

list

public ResponseMessage list()

Issues an HTTP request to list the contents of the collection resource.

Returns:

The list response message.

put

public T put(String key,
             T value)

Specified by:

put in interface Map<String,T extends Resource>

putAll

public void putAll(Map<? extends String,? extends T> map)

Copies all mappings from a given map to this map (unsupported).

Specified by:

putAll in interface Map<String,T extends Resource>

Parameters:

map - The set of mappings to copy into this map.

refresh

public ResourceCollection refresh()

Refreshes the local state of this resource.

Specified by:

refresh in class Resource

Returns:

The current Resource instance.

remove

public T remove(Object key)

Specified by:

remove in interface Map<String,T extends Resource>

size

public int size()

Specified by:

size in interface Map<String,T extends Resource>

validate

public ResourceCollection<T> validate()

Ensures that the local state of the resource is current, calling refresh if necessary.

Overrides:

validate in class Resource

Returns:

The current Resource instance.

values

public Collection<T> values()

Specified by:

values in interface Map<String,T extends Resource>

valueSize

public int valueSize(Object key)

Returns the number of values that a specific key represents.

Parameters:

key - The key to look up.

Returns:

The number of entity values represented by the key.