sszuev commented on PR #1994: URL: https://github.com/apache/jena/pull/1994#issuecomment-1694338069
@afs Would it be a good idea to add a mention to the factory-method and directly to the particular implementations documentation that the `ConcurrentModificationException` may not occur in some cases? A client application (such as `ReadWriteLockingGrapg`) may use this circumstance for its own purposes. For example, for optimization purposes (see issues https://github.com/apache/jena/issues/1992 and https://github.com/sszuev/concurrent-rdf-graph/issues/1) For factory-method docs could look like this: ```html <strong>Note</strong>: Interrupting Graph Iterators with modification operations may result in a `ConcurrentModificationException` due to structural changes. It is <strong>strictly</strong> not recommended in the client code violate this rule. However, in some cases, interruption is possible in some cases, but it depends on the implementation. See the documentation for the specific GraphMem implementation. This behavior can be changed at any time, so please read the documentation of specific implementations if your code still requires interrupting iterations contrary to the recommendations. ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
