| Returns the binary root(s) for a given source root.
The returned BinaryForSourceQuery.Result must be a singleton. It means that for
repeated calling of this method with the same recognized root the method has to
return the same instance of BinaryForSourceQuery.Result.
The typical implemantation of the findBinaryRoots contains 3 steps:
- Look into the cache if there is already a result for the root, if so return it
- Check if the sourceRoot is recognized, if not return null
- Create a new BinaryForSourceQuery.Result for the sourceRoot, put it into the cache
and return it.
Any absolute URL may be used but typically it will use the file
protocol for directory entries and jar protocol for JAR entries
(e.g. jar:file:/tmp/foo.jar!/).
Parameters:
sourceRoot - the source path root a result object encapsulating the answer or null if the sourceRoot is not recognized |