Component Lifecycle Callbacks

Sometimes the content of a component depends on resources that are not available during the construction of the component. You can postpone the content creation until the component is attached to the UI by overriding the onAttach() method from Component.

Java

@Tag("div")
public class UserNameLabel extends Component {
  @Override
  protected void onAttach(AttachEvent attachEvent) {
    // user name can be stored to session after login
    String userName = (String) attachEvent.getSession().getAttribute("username");
    getElement().setText("Hello " + userName + ", welcome back!");
  }
}

The onAttach method is invoked by the framework when the Component has been attached to the UI. Its counterpart, the onDetach method is invoked right before the component is detached from the UI. They are good places to reserve and release any resources used by the component.

Java

@Tag("div")
public class ShoppingCartSummaryLabel extends Component {
  private final Consumer<EventObject> eventHandler = this::onCartSummaryUpdate;
  @Override
  protected void onAttach(AttachEvent attachEvent) {
    ShopEventBus eventBus = attachEvent.getSession().getAttribute(ShopEventBus.class);
    // registering to event bus for updates from other components
    eventBus.register(eventHandler);
  }
  @Override
  protected void onDetach(DetachEvent detachEvent) {
    ShopEventBus eventBus = detachEvent.getSession().getAttribute(ShopEventBus.class);
    // after detaching don't need any updates
    eventBus.unregister(eventHandler);
  }
  private void onCartSummaryUpdate(EventObject event) {
    // update cart summary ...
  }
}
interface ShopEventBus {
  void register(Consumer<EventObject> eventHandler);
  void unregister(Consumer<EventObject> eventHandler);
}