Additional javadoc information is needed for getInputStream in the DataHandler(Object,String) case:

Returns an InputStream representing the object's content by piping the writeTo method of the DataContentHandler. The resulting input stream will be empty unless a custom DataContenHandler is provided which accesses the writes out the object's content in it's writeTo method.

Without this information, users, of Jaf won't know what will be required to get a useful InputStream in the Object case. The documentation may also need to distinguish between the description of the behavior of the reference implementation, and the required semantics for every implementation.

Note that the behavior of returning an empty stream is the subject of another bug. If that is corrected, then this documentation should reflect the improved behavior, rather than what is stated above.