[LUCENE-8415] Clean up Directory contracts (write-once, no reads-before-write-completed)

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 7.5
• Lucene Fields: New
• Assignee: Dawid Weiss
• Reporter: Dawid Weiss
• Created: 19/Jul/18 13:30
• Updated: 28/Aug/22 15:33
• Resolved: 03/Aug/18 19:58

Description

Created a PR here for early review.

https://github.com/apache/lucene-solr/pull/424

I changed:

• the wording in Directory documentation to be a bit more formalized about what rules a Directory should obey (and users expect).
• modified the test framework to verify the above in mock classes.

Currently a number of Directory implementations fail the testReadFileOpenForWrites test that I added, so I'll keep working on that.

Issue Links

• links to: GitHub Pull Request #424
• links to: GitHub Pull Request #424