Represents a range of unique datastore identifiers from
getStart().getId()
to
getEnd().getId()
inclusive. If an instance of this class is the result of a call to
DatastoreService.allocateIds()
, the
Keys
returned by this instance have been
consumed in the datastore's id-space and are guaranteed never to be reused.
This class can be used to construct
Entities
with
Keys
that have
specific id values without fear of the datastore creating new records with those same ids at a
later date. This can be helpful as part of a data migration or large bulk upload where you may
need to preserve existing ids and relationships between entities.
This class is threadsafe but the
Iterators
returned by
iterator()
are
not.