org.hd.d.pg2k.webSvr.threeD
Interface LightweightMetaDataFetchInterface

All Known Implementing Classes:

ThreeDLogic

interface LightweightMetaDataFetchInterface

This interface is used for light-weight, incremental fetching of Gallery metadata, eg for an interactive 3D walkthrough.

MAX_NAMES_REQUEST

static final int MAX_NAMES_REQUEST

Maximum number of names that can be requested at once with getExhibitNames(); strictly positive. High enough to help overcome network latency, but not large enough to take significant CPU time or response size.

See Also:

Constant Field Values

getGalleryBasicMetaData

LightweightMetaDataFetchInterface.GalleryBasicMetaData getGalleryBasicMetaData()
                                                                               throws java.io.IOException

Fetch the current exhibit-set hash and exhibit count; never null. A change in the hash is a signal that cached data may be invalid and need to be purged or revalidated.

Throws:

java.io.IOException

getExhibitName

Name.ExhibitFull getExhibitName(int ordinal)

Fetch the full name of the given numbered exhibit; null if no such exhibit or not currently available. The range is 0 to numberOfExhibits-1.

This assumes that there is a sensible stable ordering of exhibits, probably in "smart-sorted" order or similar.

This ordering is fixed from one exhibit set to the next, ie is stable while the exhibit set hash remains unchanged.

getExhibitNames

Name.ExhibitFull[] getExhibitNames(int[] ordinals)

Fetch the full name of the given numbered exhibits; each entry null if no such exhibit or not currently available, overall result never null. The range for each item is 0 to numberOfExhibits-1.

This assumes that there is a sensible stable ordering of exhibits, probably in "smart-sorted" order or similar.

This ordering is fixed from one exhibit set to the next, ie is stable while the exhibit set hash remains unchanged.