com.splunk
Class Entity

java.lang.Object
  com.splunk.Resource
      com.splunk.Entity

All Implemented Interfaces:

java.util.Map<java.lang.String,java.lang.Object>

Direct Known Subclasses:

Application, ApplicationArchive, ApplicationSetup, ApplicationUpdate, DataModel, DeploymentClient, DeploymentServer, DeploymentServerClass, DeploymentTenant, DistributedConfiguration, DistributedPeer, EventType, FiredAlert, FiredAlertGroup, Index, Input, Job, License, LicenseGroup, LicenseMessage, LicensePool, LicenseSlave, LicenseStack, Logger, Message, ModularInputKind, OutputDefault, OutputGroup, OutputServer, OutputServerAllConnections, OutputSyslog, Password, Role, SavedSearch, ServiceInfo, Settings, TcpConnections, UdpConnections, Upload, User

public class Entity
extends Resource
implements java.util.Map<java.lang.String,java.lang.Object>

The Entity class represents a Splunk entity.

Nested Class Summary

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

java.util.Map.Entry<K,V>

Field Summary

protected Record	content
protected java.util.HashMap<java.lang.String,java.lang.Object>	toUpdate

Fields inherited from class com.splunk.Resource

actions, path, refreshArgs, service, title

Constructor Summary

Entity(Service service, java.lang.String path)
Class constructor.

Method Summary

protected java.lang.String	actionPath(java.lang.String action) Returns the path that corresponds to the requested action.
void	clear()
boolean	containsKey(java.lang.Object key)
boolean	containsValue(java.lang.Object value)
void	disable() Disables the entity that is named by this endpoint.
void	enable() Enables the entity that is named by this endpoint.
java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>>	entrySet()
java.lang.Object	get(java.lang.Object key)
protected Record	getContent()
EntityMetadata	getMetadata() Returns the metadata (eai:acl) of this entity.
boolean	isDisabled() Indicates whether this entity is disabled.
boolean	isEmpty()
protected boolean	isNameChangeAllowed() Returns whether this entity's name can be changed via update(java.util.Map).
java.util.Set<java.lang.String>	keySet()
java.lang.Object	put(java.lang.String key, java.lang.Object value)
void	putAll(java.util.Map<? extends java.lang.String,? extends java.lang.Object> map)
Entity	refresh() Refreshes the local state of this resource.
void	remove() Removes this entity from its corresponding collection.
java.lang.Object	remove(java.lang.Object key)
int	size()
void	update() Updates the entity with the accumulated arguments, established by the individual setter methods for each specific entity class.
void	update(java.util.Map<java.lang.String,java.lang.Object> args) Updates the entity with the values you previously set using the setter methods, and any additional specified arguments.
Entity	validate() Ensures that the local state of the resource is current, calling refresh if necessary.
java.util.Collection<java.lang.Object>	values()

Methods inherited from class com.splunk.Resource

getName, getPath, getService, getTitle, invalidate

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

equals, hashCode

Field Detail

content

protected Record content

toUpdate

protected java.util.HashMap<java.lang.String,java.lang.Object> toUpdate

Constructor Detail

Entity

public Entity(Service service,
              java.lang.String path)

Class constructor.

Parameters:

service - The connected Service instance.

path - The entity's endpoint.

Method Detail

actionPath

protected java.lang.String actionPath(java.lang.String action)

Returns the path that corresponds to the requested action.

Parameters:

action - The requested action.

Returns:

The return path.

clear

public void clear()

Specified by:

clear in interface java.util.Map<java.lang.String,java.lang.Object>

containsKey

public boolean containsKey(java.lang.Object key)

Specified by:

containsKey in interface java.util.Map<java.lang.String,java.lang.Object>

containsValue

public boolean containsValue(java.lang.Object value)

Specified by:

containsValue in interface java.util.Map<java.lang.String,java.lang.Object>

disable

public void disable()

Disables the entity that is named by this endpoint. This method is available on almost every endpoint.

enable

public void enable()

Enables the entity that is named by this endpoint. This method is available on almost every endpoint.

entrySet

public java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>> entrySet()

Specified by:

entrySet in interface java.util.Map<java.lang.String,java.lang.Object>

get

public java.lang.Object get(java.lang.Object key)

Specified by:

get in interface java.util.Map<java.lang.String,java.lang.Object>

getContent

protected Record getContent()

getMetadata

public EntityMetadata getMetadata()

Returns the metadata (eai:acl) of this entity. This data includes permissions for accessing the resource, and values that indicate which resource fields are wildcards, required, and optional.

Returns:

The metadata of this entity, or null if none exist.

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface java.util.Map<java.lang.String,java.lang.Object>

isDisabled

public boolean isDisabled()

Indicates whether this entity is disabled. This method is available on almost every endpoint.

Returns:

true if this entity is disabled, false if enabled.

isNameChangeAllowed

protected boolean isNameChangeAllowed()

Returns whether this entity's name can be changed via update(java.util.Map). Most entity names cannot be changed in this way.

Returns:

false.

keySet

public java.util.Set<java.lang.String> keySet()

Specified by:

keySet in interface java.util.Map<java.lang.String,java.lang.Object>

put

public java.lang.Object put(java.lang.String key,
                            java.lang.Object value)

Specified by:

put in interface java.util.Map<java.lang.String,java.lang.Object>

putAll

public void putAll(java.util.Map<? extends java.lang.String,? extends java.lang.Object> map)

Specified by:

putAll in interface java.util.Map<java.lang.String,java.lang.Object>

refresh

public Entity refresh()

Refreshes the local state of this resource.

Specified by:

refresh in class Resource

Returns:

The current Resource instance.

remove

public java.lang.Object remove(java.lang.Object key)

Specified by:

remove in interface java.util.Map<java.lang.String,java.lang.Object>

size

public int size()

Specified by:

size in interface java.util.Map<java.lang.String,java.lang.Object>

update

public void update(java.util.Map<java.lang.String,java.lang.Object> args)

Updates the entity with the values you previously set using the setter methods, and any additional specified arguments. The specified arguments take precedent over the values that were set using the setter methods.

Parameters:

args - The arguments to update.

update

public void update()

Updates the entity with the accumulated arguments, established by the individual setter methods for each specific entity class.

remove

public void remove()

Removes this entity from its corresponding collection.

validate

public Entity 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 java.util.Collection<java.lang.Object> values()

Specified by:

values in interface java.util.Map<java.lang.String,java.lang.Object>