Interface IResolvableRuntimeInstallationManager


  • public interface IResolvableRuntimeInstallationManager
    Manages resolvable 1C:Enterprise runtime installations.

    Can provide resolvable installations, serialize or deserialize them to String and get resolvable installation defaults for the 1C:Enterprise runtime type or infobase for initial selections.

    See Also:
    IResolvableRuntimeInstallation
    • Method Detail

      • getAll

        Collection<IResolvableRuntimeInstallation> getAll​(String runtimeTypeId)
        Returns the collection of all resolvable 1C:Enterprise runtime installations. Returned collection will be sorted.
        Parameters:
        runtimeTypeId - the 1C:Enterprise runtime type id, cannot be null
        Returns:
        the collection of all resolvable 1C:Enterprise runtime installations, never null, can be empty
      • getAll

        Collection<IResolvableRuntimeInstallation> getAll​(String runtimeTypeId,
                                                          org.eclipse.core.resources.IProject project,
                                                          InfobaseReference infobase,
                                                          InfobaseAccessType accessType)
        Returns the collection of all resolvable 1C:Enterprise runtime installations. Returned collection will be sorted.

        Also checks infobase and accessType to get appropriate 1C:Enterprise runtime installations.

        Parameters:
        runtimeTypeId - the 1C:Enterprise runtime type id, cannot be null
        project - the project to get all matching resolvable 1C:Enterprise runtime installations, cannot be null
        infobase - the infobase to get appropriate resolvable installation for or null if client has no information about infobase
        accessType - the type of infobase access to get appropriate resolvable installation for, cannot be null
        Returns:
        the collection of all resolvable 1C:Enterprise runtime installations, never null, can be empty
        See Also:
        InfobaseAccessType
      • getDefault

        IResolvableRuntimeInstallation getDefault​(String runtimeTypeId,
                                                  String versionMask)
        Returns the default resolvable 1C:Enterprise runtime installation for the given 1C:Enterprise runtime type.

        Can return null if cannot get default resolvable installation.

        Parameters:
        runtimeTypeId - the 1C:Enterprise runtime type id, cannot be null
        versionMask - the version mask of 1C:Enterprise runtime, can be null if not needed
        Returns:
        the resolvable 1C:Enterprise runtime installation or null if cannot get default resolvable installation
        See Also:
        VersionMask
      • getDefault

        IResolvableRuntimeInstallation getDefault​(String runtimeTypeId,
                                                  InfobaseReference infobase)
        Returns the default resolvable 1C:Enterprise runtime installation for the given 1C:Enterprise runtime type.

        Can return null if cannot get default resolvable installation.

        Parameters:
        runtimeTypeId - the 1C:Enterprise runtime type id, cannot be null
        infobase - infobase to get appropriate resolvable installation, cannot be null
        Returns:
        the resolvable 1C:Enterprise runtime installation or null if cannot get default resolvable installation
      • getDefault

        IResolvableRuntimeInstallation getDefault​(String runtimeTypeId,
                                                  org.eclipse.core.resources.IProject project,
                                                  InfobaseReference infobase,
                                                  InfobaseAccessType accessType)
        Returns appropriate resolvable 1C:Enterprise runtime installation for the given 1C:Enterprise runtime type and infobase. Also checks accessType.

        Can return null if cannot find appropriate resolvable installation for the given infobase.

        Parameters:
        runtimeTypeId - the 1C:Enterprise runtime type id, cannot be null
        project - the project to get all matching resolvable 1C:Enterprise runtime installations, cannot be null
        infobase - the infobase to get appropriate resolvable installation for, cannot be null
        accessType - the type of infobase access to get appropriate resolvable installation for, cannot be null
        Returns:
        the resolvable 1C:Enterprise runtime installation or null if cannot find appropriate resolvable installation for the given infobase
        See Also:
        InfobaseAccessType
      • serialize

        String serialize​(IResolvableRuntimeInstallation resolvable)
        Seralize resolvable 1C:Enterprise runtime installation to String.

        Can be used to store and load resolvable 1C:Enterprise runtime installation in preferences or launch configurations.

        Parameters:
        resolvable - the resolvable installation to serialize, cannot be null
        Returns:
        serialized resolvable 1C:Enterprise runtime installation, never null
      • deserialize

        IResolvableRuntimeInstallation deserialize​(String string)
        Deserialize resolvable 1C:Enterprise runtime installation from String.

        Can be used to store and load resolvable 1C:Enterprise runtime installation in preferences or launch configurations.

        Parameters:
        string - the string to deserialize, cannot be null
        Returns:
        deserialized resolvable 1C:Enterprise runtime installation, never null