Interface PathResolver

All Known Implementing Classes:
ShadingPathResolver, StandardPathResolver

public interface PathResolver
This interface is intended to establish correspondence between relative path and absolute URL in context of plug-in or plug-in fragment.
Version:
$Id$
See Also:
  • Method Details

    • configure

      void configure(ExtendedProperties config) throws Exception
      Configures this resolver instance. Usually this method is called from object factory implementation.
      Parameters:
      config - path resolver configuration data
      Throws:
      Exception - if any error has occurred
    • registerContext

      void registerContext(Identity idt, URL url)
      Registers "home" URL for given plug-in element.
      Parameters:
      idt - plug-in element
      url - "home" URL for a given plug-in element
    • unregisterContext

      void unregisterContext(String id)
      Unregisters plug-in element from this path resolver.
      Parameters:
      id - plug-in element identifier
    • getRegisteredContext

      URL getRegisteredContext(String id)
      Returns URL of registered plug-in element context. If context for plug-in element with given ID not registered, this method should throw an IllegalArgumentException. In other words, this method shouldn't return null.
      Parameters:
      id - plug-in element identifier
      Returns:
      registered context "home" location
    • isContextRegistered

      boolean isContextRegistered(String id)
      Parameters:
      id - plug-in element identifier
      Returns:
      true if context for plug-in element with given ID registered
    • resolvePath

      URL resolvePath(Identity identity, String path)
      Should resolve given path to URL for a given identity.
      Parameters:
      identity - plug-in element for which to resolve path
      path - path to be resolved
      Returns:
      resolved absolute URL