Package org.apache.hadoop.registry.client.types

Class ServiceRecord

java.lang.Object

org.apache.hadoop.registry.client.types.ServiceRecord

All Implemented Interfaces:

java.lang.Cloneable

@Public
@Evolving
public class ServiceRecord
extends java.lang.Object
implements java.lang.Cloneable

JSON-marshallable description of a single component. It supports the deserialization of unknown attributes, but does not support their creation.

Field Summary

Fields

Modifier and Type	Field	Description
java.lang.String	description	Description string
java.util.List<Endpoint>	external	List of endpoints intended for use to external callers
java.util.List<Endpoint>	internal	List of endpoints for use within an application.
static java.lang.String	RECORD_TYPE	A type string which MUST be in the serialized json.
java.lang.String	type	The type field.

Constructor Summary

Constructors

Constructor	Description
ServiceRecord()	Create a service record with no ID, description or registration time.
ServiceRecord(ServiceRecord that)	Deep cloning constructor

Method Summary

Modifier and Type	Method	Description
void	addExternalEndpoint(Endpoint endpoint)	Add an external endpoint
void	addInternalEndpoint(Endpoint endpoint)	Add an internal endpoint
java.util.Map<java.lang.String,java.lang.String>	attributes()	The map of "other" attributes set when parsing.
protected java.lang.Object	clone()	Shallow clone: all endpoints will be shared across instances
boolean	equals(java.lang.Object obj)
java.lang.String	get(java.lang.String key)	Get the "other" attribute with a specific key
java.lang.String	get(java.lang.String key, java.lang.String defVal)	Get the "other" attribute with a specific key.
Endpoint	getExternalEndpoint(java.lang.String api)	Look up an external endpoint
Endpoint	getInternalEndpoint(java.lang.String api)	Look up an internal endpoint
int	hashCode()
void	set(java.lang.String key, java.lang.Object value)	Handle unknown attributes by storing them in the attributes map
java.lang.String	toString()

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

RECORD_TYPE

public static final java.lang.String RECORD_TYPE

A type string which MUST be in the serialized json. This permits fast discarding of invalid entries

See Also:

Constant Field Values

type

public java.lang.String type

The type field. This must be the string RECORD_TYPE

description

public java.lang.String description

Description string

external

public java.util.List<Endpoint> external

List of endpoints intended for use to external callers

internal

public java.util.List<Endpoint> internal

List of endpoints for use within an application.

Constructor Detail

ServiceRecord

public ServiceRecord()

Create a service record with no ID, description or registration time. Endpoint lists are set to empty lists.

ServiceRecord

public ServiceRecord(ServiceRecord that)

Deep cloning constructor

Parameters:

that - service record source

Method Detail

addExternalEndpoint

public void addExternalEndpoint(Endpoint endpoint)

Add an external endpoint

Parameters:

endpoint - endpoint to set

addInternalEndpoint

public void addInternalEndpoint(Endpoint endpoint)

Add an internal endpoint

Parameters:

endpoint - endpoint to set

getInternalEndpoint

public Endpoint getInternalEndpoint(java.lang.String api)

Look up an internal endpoint

Parameters:

api - API

Returns:

the endpoint or null if there was no match

getExternalEndpoint

public Endpoint getExternalEndpoint(java.lang.String api)

Look up an external endpoint

Parameters:

api - API

Returns:

the endpoint or null if there was no match

set

public void set(java.lang.String key,
                java.lang.Object value)

Handle unknown attributes by storing them in the attributes map

Parameters:

key - attribute name

value - attribute value.

attributes

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

The map of "other" attributes set when parsing. These are not included in the JSON value of this record when it is generated.

Returns:

a map of any unknown attributes in the deserialized JSON.

get

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

Get the "other" attribute with a specific key

Parameters:

key - key to look up

Returns:

the value or null

get

public java.lang.String get(java.lang.String key,
                            java.lang.String defVal)

Get the "other" attribute with a specific key.

Parameters:

key - key to look up

defVal - default value

Returns:

the value as a string, or defval if the value was not present

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

clone

protected java.lang.Object clone()
                          throws java.lang.CloneNotSupportedException

Shallow clone: all endpoints will be shared across instances

Overrides:

clone in class java.lang.Object

Returns:

a clone of the instance

Throws:

java.lang.CloneNotSupportedException

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object