Description
MicroKernel.getNode(String path, String revisionId, int depth, long offset, int count, String filter)
the semantics of depth as currently documented in the javadoc is inconsistent:
- depth=0 returns empty child node objects
- depth=1 OTOH doesn't return empty grand children objects
the amount of information returned on the deepest level should IMO be independent of the depth value.
count as currently documented is only applied to the root of the returned subtree. this would imply that the implementation has to always return all child nodes on deeper levels, even for potentially very large child node sets.
i suggest we rename count to maxChildNodes and apply it on every level of the returned subtree.
Attachments
Issue Links
- is part of
-
OAK-11 Document and tighten contract of Microkernel API
-
- Resolved
-