Interface IRuntimeInstallationDiscriminator

  • All Known Subinterfaces:
    IRuntimeInstallationManager
    All Known Implementing Classes:
    DpkgInstallationDiscriminator, FolderNameBasedInstallationDiscriminator, RuntimeInstallationManager

    public interface IRuntimeInstallationDiscriminator
    1C:Enterprise runtime installation discriminator describes an 1C:Enterprise runtime installation. Discriminators are defined by extensions. An 1C:Enterprise runtime installation discriminator extension is defined in plugin.xml.

    Following is an example definition of an 1C:Enterprise runtime installation discriminator extension:

     <extension point="com._1c.g5.v8.dt.platform.services.core.runtimeInstallationDiscriminators">
       <discriminator
          class="com.example.ExampleInstallationDiscriminatorClass">
          runtimeType="com._1c.g5.v8.dt.platform.services.core.runtimeType.EnterprisePlatform"
       </discriminator>
     </extension>
     

    Defined 1C:Enterprise runtime installation discriminators are automatically used to resolve 1C:Enterprise runtime installations for added or searched installations with the registered 1C:Enterprise runtime type.

    This interface is intended to be implemented and registered by clients.

    Instances are not intended to be explicitly used by client. Clients may use IRuntimeInstallationManager instead.

    See Also:
    Version, IRuntimeInstallationManager
    • Method Detail

      • discriminate

        Optional<RuntimeInstallationDescription> discriminate​(URI location)
                                                       throws org.eclipse.core.runtime.CoreException
        Tries to discriminate the 1C:Enterprise runtime installation by the provided location. Returns an optional description of the 1C:Enterprise runtime installation:
        • The version of the target 1C:Enterprise runtime installation (e.g. 8.3.8)
        • The build number of the target 1C:Enterprise runtime installation (e.g. 1945)
        • The architectire of the target 1C:Enterprise runtime installation (e.g. x86)
        Parameters:
        location - the 1C:Enterprise runtime install location to get version from, cannot be null
        Returns:
        an optional description of the 1C:Enterprise runtime installation
        Throws:
        org.eclipse.core.runtime.CoreException - if description resolve failed with some reason
        See Also:
        RuntimeInstallationDescription