Remove JsonParser#iterator() method and replace with hasNext() and next(). The problem with iterator is not returning self-contained events. One has to go back forth between iterator and parser objects. One proposal was to use advance() (instead of hasNext()) and getEvent() (instead of next()), but most users preferred hasNext()/next().
Some of the discussion is at: