[HADOOP-9993] FileSystem#close JavaDoc should state that the implementation must be idempotent.

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Component/s: documentation, fs
• Target Version/s: 1-win, 1.3.0
• Assignee: Unassigned
• Reporter: Chris Nauroth
• Created: 24/Sep/13 05:50
• Updated: 22/Apr/14 05:51

Description

In discussion during MAPREDUCE-5508, we realized that any FileSystem subclass must implement an idempotent close method, due to potential multi-threaded interactions with the FileSystem#Cache. We should state this in the JavaDoc for FileSystem#close, so that subclass implementers are aware.

Issue Links

• relates to: MAPREDUCE-5508 JobTracker memory leak caused by unreleased FileSystem objects in JobInProgress#cleanupJob