flesh out java api