Interface ContentResolver

All Known Implementing Classes:
ResolverForClasspath, ResolverForFilesystem, ResolverForNBIOCache, ResolverForURL, URIResolver

public interface ContentResolver
  • Method Details

    • resolve

      List<Content<?>> resolve(URI uri)
      Locate the content referenced by the specified name. Content is any URL or file path which contains data to be loaded.

      Implementors should take care to ensure the following conditions are met:

      • For URL style content, resolution is only successful if a stream to download the content is acquired.
      • For file paths, resolution is only successful if the filesystem does a standard access check for readability of a file that is present.
      A content resolver may be given a path which is fundamentally incompatible with the schemes supported by the resolver implementation. It is required that the resolver return null for such URI values.
      Parameters:
      uri - The URI of a content location, like a file name or URL.
      Returns:
      A content element which may then be used to access the content
    • resolve

      default List<Content<?>> resolve(String uri)
    • resolveDirectory

      List<Path> resolveDirectory(URI uri)
      Return a list of matching directory Paths for the URI which are accessible under the scheme of the implementing resolver. It is possible that a logical path can return more than one physical directory path, such as with jar files.
      Parameters:
      uri -
      Returns:
      A list of accessible paths matching the uri, or an empty list
    • resolveDirectory

      default List<Path> resolveDirectory(String uri)