Interface URLHandlerReadOnlyCheckerExtension


  • @API(type=EXTENDABLE,
         src=PUBLIC)
    public interface URLHandlerReadOnlyCheckerExtension
    This interface can be called to decide if an URL is read-only or not.
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      boolean canCheckReadOnly​(java.lang.String protocol)
      Returns true if the implementor should be asked about the read-only status for URL's of a certain protocol.
      boolean isReadOnly​(java.net.URL url)
      Decide if a given URL is read-only or writable to.
    • Method Detail

      • isReadOnly

        boolean isReadOnly​(java.net.URL url)
        Decide if a given URL is read-only or writable to. If an URL is marked as read-only Oxygen will present it with a read-only lock icon on the tab. The user will also be able to specify through the user interface that an opened editor over a read-only URL can be edited. Also when saving in Oxygen and the URL is marked as read-only the Save As dialog will be shown instead. This call back will usually be received often, each time focus is gained by the current editor. WARNING: It is advisable to cache the calls for recognized URLs as this method might be called quite often.
        Parameters:
        url - The URL for which the implementor will decide if it is read-only or not.
        Returns:
        true if a given URL should be regarded by Oxygen as read-only.
      • canCheckReadOnly

        boolean canCheckReadOnly​(java.lang.String protocol)
        Returns true if the implementor should be asked about the read-only status for URL's of a certain protocol. This call back will usually be received often, each time focus is gained by the current editor.
        Parameters:
        protocol - The URL protocol (like "http" or "file")
        Returns:
        true if the implementor should be asked about the read-only status for URL's of a certain protocol. For example if you want to decide if "http" URLs are read-only or not you should return true if the protocol is "http" Then, the other callback will be called and you will be able to decide the read-only status for the URL.