com.vmware.vapi.core

Class ExecutionContext.ApplicationData

java.lang.Object

com.vmware.vapi.core.ExecutionContext.ApplicationData

Enclosing class:

ExecutionContext

public static class ExecutionContext.ApplicationData
extends java.lang.Object

Immutable class representing additional application specific data associated with the request for method execution represented by this ExecutionContext.

The application data format is key-value pairs of Strings.

This application data is provided by the client initiating the execution, it is then transported as is over the wire and is available for the provider-side service implementations on the server. This extra data is completely opaque for the infrastructure, in other words it is a contract between the client and the service implementation only.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	USER_AGENT_KEY ApplicationData property key for user agent.

Constructor Summary

Constructors

Constructor and Description
ExecutionContext.ApplicationData() Constructs an empty instance.
ExecutionContext.ApplicationData(java.util.Map<java.lang.String,java.lang.String> data) Constructs an instance with the specified data as a source.
ExecutionContext.ApplicationData(java.lang.String key, java.lang.String value) Constructs an instance with a single property only.

Method Summary

Methods

Modifier and Type	Method and Description
java.util.Map<java.lang.String,java.lang.String>	getAllProperties()
java.lang.String	getProperty(java.lang.String key)
static ExecutionContext.ApplicationData	merge(ExecutionContext.ApplicationData source, java.util.Map<java.lang.String,java.lang.String> data) Merges the specified source and data into a newly created ApplicationData instance.
static ExecutionContext.ApplicationData	merge(ExecutionContext.ApplicationData source, java.lang.String key, java.lang.String value) Merges the specified source and property into a newly created ApplicationData instance.

Methods inherited from class java.lang.Object

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

Field Detail

USER_AGENT_KEY

public static final java.lang.String USER_AGENT_KEY

ApplicationData property key for user agent.

See Also:

Constant Field Values

Constructor Detail

ExecutionContext.ApplicationData

public ExecutionContext.ApplicationData()

Constructs an empty instance.

ExecutionContext.ApplicationData

public ExecutionContext.ApplicationData(java.util.Map<java.lang.String,java.lang.String> data)

Constructs an instance with the specified data as a source.

Parameters:

data - key-value entries

Throws:

java.lang.NullPointerException - if data is null

ExecutionContext.ApplicationData

public ExecutionContext.ApplicationData(java.lang.String key,
                                java.lang.String value)

Constructs an instance with a single property only.

Parameters:

key - the key of the property

value - the value of the property

Method Detail

getProperty

public java.lang.String getProperty(java.lang.String key)

Parameters:

key - of the property

Returns:

value for the specified key or null if it is unavailable

getAllProperties

public java.util.Map<java.lang.String,java.lang.String> getAllProperties()

Returns:

an immutable Map representing all the properties; cannot be null

merge

public static ExecutionContext.ApplicationData merge(ExecutionContext.ApplicationData source,
                                     java.util.Map<java.lang.String,java.lang.String> data)

Merges the specified source and data into a newly created ApplicationData instance. Any conflicts are resolved in favor of the specified data.

Parameters:

source - the source of data; may be null

data - a collection of properties to merge with the source

Returns:

a new instance of ApplicationData combining the specified source and data

Throws:

java.lang.NullPointerException - if data is null

merge

public static ExecutionContext.ApplicationData merge(ExecutionContext.ApplicationData source,
                                     java.lang.String key,
                                     java.lang.String value)

Merges the specified source and property into a newly created ApplicationData instance. The specified value will override the previous one, if a property with the specified key is already present in the source.

Parameters:

source - the source of data; may be null

key - the key of the property to merge with the source

value - the value of the property to merge with the source

Returns:

a new instance of ApplicationData combining the specified source and property