[JCR-1418] Redesign NodeInfo.getReferences()

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 1.4
• Fix Version/s: 2.0-alpha3
• Component/s: jackrabbit-spi
• Assignee: Angela Schreiber
• Reporter: Marcel Reutegger
• Created: 26/Feb/08 10:05
• Updated: 08/Jul/09 11:35
• Resolved: 28/May/09 10:48

Description

The method returns an array of PropertyIds. When there are lots of references this may become an problem. As with any other return value that potentially is large we should return an iterator.

I suggest to redesign the handling of references in line with recent discussions how child infos are handled.

• A NodeInfo implementation must either return the complete list of PropertyIds or null if it does not want to return the PropertyIds at that time.
• Introduce a new method: Iterator<PropertyId> RepositoryService.getReferences(SessionInfo, NodeId)

This has the following advantages:

• loading of references can be delayed until it is really needed
• large collections of references can be streamed through the SPI