Module org.scijava.desktop
Package org.scijava.desktop

Class DefaultDesktopService

  • All Implemented Interfaces:
    Comparable<org.scijava.Prioritized>, org.scijava.Contextual, DesktopService, org.scijava.Disposable, org.scijava.Identifiable, org.scijava.Initializable, org.scijava.Locatable, org.scijava.log.Logged, org.scijava.plugin.HasPluginInfo, org.scijava.plugin.RichPlugin, org.scijava.plugin.SciJavaPlugin, org.scijava.Prioritized, org.scijava.service.SciJavaService, org.scijava.service.Service, org.scijava.Versioned
    public class DefaultDesktopService
extends org.scijava.service.AbstractService
implements DesktopService
    Default implementation of DesktopService.
    Author:
    Curtis Rueden

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void addFileType​(String extension, String mimeType, String description)
      Adds a single file type.
      void addFileTypes​(org.scijava.object.LazyObjects<FileType> fileTypes)
      Adds a batch of file types to be coelesced lazily at registration time.
      String getDescription​(String extension)
      Gets the description for a given file type extension, or null if none.
      Map<String,​String> getFileTypes()
      Gets the map of supported file types (extension → MIME type).
      boolean isDesktopIconPresent()
      TODO javadoc
      boolean isDesktopIconToggleable()
      TODO javadoc
      boolean isFileExtensionsEnabled()
      TODO javadoc
      boolean isFileExtensionsToggleable()
      TODO javadoc
      boolean isWebLinksEnabled()
      TODO javadoc
      boolean isWebLinksToggleable()
      TODO javadoc
      void onEvent​(org.scijava.event.ContextCreatedEvent event)  
      void syncDesktopIntegration​(boolean webLinks, boolean desktopIcon, boolean fileTypes)
      Applies desktop integration settings.

      • Methods inherited from class org.scijava.service.AbstractService

        getContext, setContext, toString

      • Methods inherited from class org.scijava.plugin.AbstractRichPlugin

        getInfo, getPriority, setInfo, setPriority

      • Methods inherited from class org.scijava.AbstractContextual

        context

      • Methods inherited from interface org.scijava.Contextual

        context, getContext, setContext

      • Methods inherited from interface org.scijava.Disposable

        dispose

      • Methods inherited from interface org.scijava.plugin.HasPluginInfo

        getInfo, setInfo

      • Methods inherited from interface org.scijava.Locatable

        getLocation

      • Methods inherited from interface org.scijava.Prioritized

        compareTo, getPriority, setPriority

      • Methods inherited from interface org.scijava.plugin.RichPlugin

        getIdentifier, log

      • Methods inherited from interface org.scijava.service.Service

        initialize, registerEventHandlers

      • Methods inherited from interface org.scijava.Versioned

        getVersion

    • Constructor Detail

      • DefaultDesktopService

        public DefaultDesktopService()

    • Method Detail

      • syncDesktopIntegration

        public void syncDesktopIntegration​(boolean webLinks,
                                   boolean desktopIcon,
                                   boolean fileTypes)
        Description copied from interface: DesktopService
        Applies desktop integration settings.

        The behavior of each setting is platform-specific; not all settings have an effect on every platform.

        Specified by:
        syncDesktopIntegration in interface DesktopService
        Parameters:
        webLinks - whether URI scheme handlers should be registered
        desktopIcon - whether the application launcher entry should be present
        fileTypes - whether file-extension associations should be registered

      • addFileType

        public void addFileType​(String extension,
                        String mimeType,
                        String description)
        Description copied from interface: DesktopService
        Adds a single file type.
        Specified by:
        addFileType in interface DesktopService
        Parameters:
        extension - File extension without leading dot (e.g. "png").
        mimeType - MIME type (e.g. "image/png"), or a wildcard of the form "category/*" (e.g. "image/*") if the specific type is unknown. Wildcard values are resolved against the bundled MIME database by extension; if still unresolved, the sentinel is preserved for platform-specific code to handle at OS registration time.
        description - Human-readable description of the file type (e.g. "Gatan Digital Micrograph image"), used as the label when registering a custom MIME type, or null to synthesize one from the extension.

      • addFileTypes

        public void addFileTypes​(org.scijava.object.LazyObjects<FileType> fileTypes)
        Description copied from interface: DesktopService
        Adds a batch of file types to be coelesced lazily at registration time.
        Specified by:
        addFileTypes in interface DesktopService
        Parameters:
        fileTypes - Lazy callback to be invoked later when file types are needed.

      • getFileTypes

        public Map<String,​String> getFileTypes()
        Description copied from interface: DesktopService
        Gets the map of supported file types (extension → MIME type).

        Values ending in "/*" (e.g. "image/*") are unresolved sentinels, meaning the specific MIME type is not yet known. Callers that write OS registrations should resolve these against the system MIME database and synthesize a concrete type (e.g. "image/x-dm3") if still unresolved.

        Specified by:
        getFileTypes in interface DesktopService

      • onEvent

        public void onEvent​(org.scijava.event.ContextCreatedEvent event)