# Package com.google.gwt.place.shared

A package for managing bookmarkable locations in an application.

Since:
  GWT 2.1

- Interface Summary
  Interface | Description
  --- | ---
  PlaceChangeEvent.Handler | Implemented by handlers of PlaceChangeEvent.
  PlaceChangeRequestEvent.Handler | Implemented by handlers of PlaceChangeRequestEvent.
  PlaceController.Delegate | Optional delegate in charge of Window-related events.
  PlaceHistoryHandler.Historian | Optional delegate in charge of History related events.
  PlaceHistoryMapper | Maps `Place`s to/from tokens, used to configure a `PlaceHistoryHandler`.
  PlaceHistoryMapperWithFactory<F> | A `PlaceHistoryMapper` that can get its `PlaceTokenizer` instances from a factory.
  PlaceTokenizer<P extends Place> | Implemented by objects responsible for text serialization and deserialization of Place objects.

- Class Summary
  Class | Description
  --- | ---
  Place | Represents a bookmarkable location in an app.
  PlaceChangeEvent | Event thrown when the user has reached a new location in the app.
  PlaceChangeRequestEvent | Event thrown when the user may go to a new place in the app, or tries to leave it.
  PlaceController | In charge of the user's location in the app.
  PlaceController.DefaultDelegate | Default implementation of `PlaceController.Delegate`, based on `Window`.
  PlaceHistoryHandler | Monitors `PlaceChangeEvent`s and `History` events and keep them in sync.
  PlaceHistoryHandler.DefaultHistorian | Default implementation of `PlaceHistoryHandler.Historian`, based on `History`.

- Annotation Types Summary
  Annotation Type | Description
  --- | ---
  Prefix | Indicates the prefix to use when the token written by `PlaceTokenizer.getToken(Place)` is written to `History.newItem(java.lang.String)`.
  WithTokenizers | Indicates `PlaceTokenizer` types used by an implementation of `PlaceHistoryMapper` generated by `com.google.gwt.place.rebind.PlaceHistoryMapperGenerator`.