[RFC 216/ PushStream] Inconsistency between JavaDoc/Spec Section 706.7.14.6 and the reference implementation

[bjhargrave]

Original bug ID: BZ#228
From: Clément Delgrange <cl.delgrange@protonmail.com>
Reported version: R7

[bjhargrave]

Comment author: Clément Delgrange <cl.delgrange@protonmail.com>

Overview:

The JavaDoc of the SimplePushEventSource.publish method (section 706.7.14.6) indicates that the method throws an IllegalStateException if the source is closed. However, the reference implementation org.osgi:org.osgi.util.pushstream:1.0.0 return immediately and does not throw the exception when the source is closed.

Actual Results:

The user cannot decide which of the specification or the implementation is right. This may lead to bugs in the client code.

Expected Results:

Either the specification should remove the "throws" clause or the implementation should throw the exception.