Javadoc for the adapters public API