org.kuali.rice.ksb.api.registry
Class ServiceDescriptor

java.lang.Object
  org.kuali.rice.ksb.api.registry.ServiceDescriptor

All Implemented Interfaces:

Serializable, Versioned, ModelObjectBasic, ModelObjectComplete, ServiceDescriptorContract

public final class ServiceDescriptor
extends Object
implements ModelObjectComplete, ServiceDescriptorContract

Immutable implementation of the ServiceDescriptorContract interface. Includes a serialized XML representation of the ServiceConfiguration for the service.

Author:

Kuali Rice Team (rice.collab@kuali.org)

See Also:

Serialized Form

Nested Class Summary

static class	ServiceDescriptor.Builder A builder which can be used to construct ServiceDescriptor instances.
(package private) static class	ServiceDescriptor.Constants Defines some internal constants used on this class.
(package private) static class	ServiceDescriptor.Elements A private class which exposes constants which define the XML element names to use when this object is marshalled to XML.

Field Summary

private Collection<Element>	_futureElements
private String	descriptor
private String	id
private static long	serialVersionUID
private Long	versionNumber

Constructor Summary

private	ServiceDescriptor() Private constructor used only by JAXB.
private	ServiceDescriptor(ServiceDescriptor.Builder builder)

Method Summary

boolean	equals(Object object) All "Complete" model object's should adhere to the ModelObjectComplete.equals(Object) contract.
String	getDescriptor() Returns an XML value which can be used to materialize the ServiceConfiguration for the service.
String	getId() Returns the id of this service descriptor.
Long	getVersionNumber() Returns the version number for this object.
int	hashCode() All "Complete" model object's should adhere to the ModelObjectComplete.hashCode() contract.
String	toString() This will return a proper string representation of the Model Object.

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

id

private final String id

descriptor

private final String descriptor

versionNumber

private final Long versionNumber

_futureElements

private final Collection<Element> _futureElements

Constructor Detail

ServiceDescriptor

private ServiceDescriptor()

Private constructor used only by JAXB.

ServiceDescriptor

private ServiceDescriptor(ServiceDescriptor.Builder builder)

Method Detail

getId

public String getId()

Description copied from interface: ServiceDescriptorContract

Returns the id of this service descriptor. This value should be unique across service descriptors. This value is generated when the service is published to the registry, so this value can be null if the service has not yet been published to the registry.

Specified by:

getId in interface ServiceDescriptorContract

Returns:

the id of this service descriptor, or null if the service and it's descriptor has not yet been published to the registry

getDescriptor

public String getDescriptor()

Description copied from interface: ServiceDescriptorContract

Returns an XML value which can be used to materialize the ServiceConfiguration for the service.

Specified by:

getDescriptor in interface ServiceDescriptorContract

Returns:

the XML representation of the ServiceConfiguration for the service, should never return a null or blank value

getVersionNumber

public Long getVersionNumber()

Description copied from interface: Versioned

Returns the version number for this object. In general, this value should only be null if the object has not yet been stored to a persistent data store. This version number is generally used for the purposes of optimistic locking.

Specified by:

getVersionNumber in interface Versioned

Returns:

the version number, or null if one has not been assigned yet

hashCode

public int hashCode()

Description copied from interface: ModelObjectComplete

All "Complete" model object's should adhere to the ModelObjectComplete.hashCode() contract.

Specified by:

hashCode in interface ModelObjectComplete

Overrides:

hashCode in class Object

Returns:

the hashCode value

equals

public boolean equals(Object object)

Description copied from interface: ModelObjectComplete

All "Complete" model object's should adhere to the ModelObjectComplete.equals(Object) contract.

Specified by:

equals in interface ModelObjectComplete

Overrides:

equals in class Object

Parameters:

object - to object to compare for equality

Returns:

if equal

toString

public String toString()

Description copied from interface: ModelObjectBasic

This will return a proper string representation of the Model Object. All of the fields comprising the "public" api should be represented in the return value.

Specified by:

toString in interface ModelObjectBasic

Overrides:

toString in class Object

Returns:

the string representation