[FTPSERVER-181] The UserManager#authenticate() method lacks of documentation

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.0.0-M3
• Fix Version/s: 1.0.0-M4
• Component/s: Ftplets
• Assignee: Niklas Therning
• Reporter: Andrea Francia
• Created: 21/Sep/08 21:48
• Updated: 06/Oct/08 21:45
• Resolved: 06/Oct/08 21:45

Description

The UserManager interface documentation should be a form of contract between the implementor and the user of the interface.
After reading the documentation the implementor still has these question:

• when I should throw a AuthenticationFailedException?
• when I should return a null as a result?
• if the object receive two subsequent calls withe the same arguments the objects returned should be the same (same reference), only equals, or they can be different?