Доступные мне источники (1.8.0_172) содержат этот «внутренний» комментарий:
// one or many? Up to language spec; currently only one, but this API
// allows for generalization.
Таким образом, создается впечатление, что API предназначен для случая, когда вбудущее.
Редактировать:
Вот ссылка на источники 1.8.0_181 , которая показывает, что этот комментарий все еще присутствует.( Вот та же ссылка для OpenJDK 10.0.2 )
Почему это обобщение, даже если оно не нужно?Предположим, что вы позже измените API, и весь существующий код нужно будет изменить с Type
на Type[]
. Нам нужно будет добавить новые методы, что затруднит объяснение, почему существует два метода.