com.partnersoft.core
Interface Identifiable

All Known Subinterfaces:

RoverLayer

All Known Implementing Classes:

AbstractRoverLayer, Cog, RoverData, RoverImageFile

public interface Identifiable

General contract for things that have names, numeric IDs, and UUIDs. These are very common for nontrivial objects.

Names may not be unique for any given set of Identifiables. They are generally human-oriented.

Numeric IDs may only be unique for a set of Identifiables in a specific context (e.g. a single computer or database). They are generally small enough to be human-legible but may be automatically generated (e.g. auto incremented).

GUIDs should be globally unique for all of a specific kind of identifiable - in fact they should generally follow the UUID design and be unique for all things in the universe. GUIDs are represented as a single String; this interface does not require a required format. GUIDs are generally too long to be very human-legible.

Copyright 2008 Partner Software, Inc.

Version:

$Id$

Author:

Paul Reavis

Method Summary

java.lang.String	getGuid() Globally-unique ID (GUID) for this object.
int	getId() Numeric ID for this object.
java.lang.String	getName() Name of this object.

Method Detail

getName

java.lang.String getName()

Name of this object. Names may not be unique for any given set of Identifiables. They are generally human-oriented.

getId

int getId()

Numeric ID for this object. Numeric IDs may only be unique for a set of Identifiables in a specific context (e.g. a single computer or database). They are generally small enough to be human-legible but may be automatically generated (e.g. auto incremented).

getGuid

java.lang.String getGuid()

Globally-unique ID (GUID) for this object. GUIDs should be globally unique for all of a specific kind of identifiable - in fact they should generally follow the UUID design and be unique for all things in the universe. They are used for synchronization in long-transaction, multiple-machine systems. GUIDs are represented as a single String; this interface does not require a required format. GUIDs are generally too long to be very human-legible.