alias

Opaque, stable identifier for this facet — the only identity exposed to the outside world. Used as the key in PagedList.saveState / PagedList.restoreState output and (in the stateless REST façade) as the key in filter / sort maps on the wire.

Defaults to the facet's index-at-creation as a string ("0", "1", …). Assign a stable, human-friendly value ("name", "total") if you plan to persist state across code changes or expose it over REST.

Never use field paths, SQL expressions, or anything derived from the database schema as an alias — that would leak the very internals the alias mechanism exists to hide.

Throws