Interface IRuntimeVersionSupport

  • All Superinterfaces:
    IManagedService

    public interface IRuntimeVersionSupport
    extends IManagedService
    Version support for 1C:Enterprise projects. Version is stored in project manifest.
    See Also:
    ProjectManifest
    Restriction:
    This interface is not intended to be extended by clients.
    Restriction:
    This interface is not intended to be implemented by clients.
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      Version getRuntimeVersion​(org.eclipse.core.resources.IProject project)
      Returns 1C:Enterprise runtime version specified for given project during project creation.
      Version getRuntimeVersion​(org.eclipse.emf.ecore.EObject eObject)
      Returns 1C:Enterprise runtime version specified for given EObject contained by project during project creation.
      Version getRuntimeVersion​(org.eclipse.emf.ecore.resource.Resource resource)
      Returns 1C:Enterprise runtime version specified for given Resource contained by project during project creation.
      Version getRuntimeVersionOrDefault​(org.eclipse.core.resources.IProject project, Version defaulVersion)
      Returns 1C:Enterprise runtime version specified for given project during project creation or defaulVersion
      Version getRuntimeVersionOrDefault​(org.eclipse.emf.ecore.EObject eObject, Version defaulVersion)
      Returns 1C:Enterprise runtime version specified for given EObject contained by project during project creation or defaultVersion if version is not specified for project corresponding to the EObject
      Version getRuntimeVersionOrDefault​(org.eclipse.emf.ecore.resource.Resource resource, Version defaulVersion)
      Returns 1C:Enterprise runtime version specified for given Resource contained by project during project creation or defaultVersion if version is not specified for project corresponding to the Resource
      List<Version> getSupportedVersions()
      Returns list of supported 1C:Enterprise runtime versions.
    • Method Detail

      • getRuntimeVersion

        Version getRuntimeVersion​(org.eclipse.core.resources.IProject project)
        Returns 1C:Enterprise runtime version specified for given project during project creation.
        Parameters:
        project - - the project (not null)
        Returns:
        the runtime version from manifest or Version.EMPTY_VERSION if version is not specified, never null
        Throws:
        IllegalArgumentException - if project is not 1C:Enterprise Configuration project
        ProjectManifestException - if the manifest has an invalid syntax or there is no manifest file
      • getRuntimeVersionOrDefault

        Version getRuntimeVersionOrDefault​(org.eclipse.core.resources.IProject project,
                                           Version defaulVersion)
        Returns 1C:Enterprise runtime version specified for given project during project creation or defaulVersion
        Parameters:
        project - the project (not null)
        defaulVersion - will be return if version is not specified for project, cannot be null
        Returns:
        the runtime version from manifest or defaulVersion if version is not specified, never null
      • getRuntimeVersion

        Version getRuntimeVersion​(org.eclipse.emf.ecore.resource.Resource resource)
        Returns 1C:Enterprise runtime version specified for given Resource contained by project during project creation.
        Parameters:
        resource - the Resource instance (not null)
        Returns:
        the runtime version from manifest or Version.EMPTY_VERSION if version is not specified, never null
        Throws:
        IllegalArgumentException - if
        • resource is not contained in project
        • project is not 1C:Enterprise Configuration project
        ProjectManifestException - if the manifest has an invalid syntax or there is no manifest file
      • getRuntimeVersionOrDefault

        Version getRuntimeVersionOrDefault​(org.eclipse.emf.ecore.resource.Resource resource,
                                           Version defaulVersion)
        Returns 1C:Enterprise runtime version specified for given Resource contained by project during project creation or defaultVersion if version is not specified for project corresponding to the Resource
        Parameters:
        resource - the Resource instance (not null)
        defaulVersion - will be return if version is not specified for project corresponding to the Resource, cannot be null
        Returns:
        the runtime version from manifest or defaultVersion if version is not specified, never null
      • getRuntimeVersion

        Version getRuntimeVersion​(org.eclipse.emf.ecore.EObject eObject)
        Returns 1C:Enterprise runtime version specified for given EObject contained by project during project creation.
        Parameters:
        eObject - the EObject instance (not null)
        Returns:
        the runtime version from manifest or Version.EMPTY_VERSION if version is not specified, never null
        Throws:
        IllegalArgumentException - if
        • eObject is not contained by resource in project
        • project is not 1C:Enterprise Configuration project
        ProjectManifestException - if the manifest has an invalid syntax or there is no manifest file
      • getRuntimeVersionOrDefault

        Version getRuntimeVersionOrDefault​(org.eclipse.emf.ecore.EObject eObject,
                                           Version defaulVersion)
        Returns 1C:Enterprise runtime version specified for given EObject contained by project during project creation or defaultVersion if version is not specified for project corresponding to the EObject
        Parameters:
        eObject - the EObject instance (not null)
        defaulVersion - will be return if version is not specified for project corresponding to the EObject, cannot be null
        Returns:
        the runtime version from manifest or defaultVersion if version is not specified, never null
      • getSupportedVersions

        List<Version> getSupportedVersions()
        Returns list of supported 1C:Enterprise runtime versions. Supported versions are based by extension point "com._1c.g5.v8.dt.platform.runtimes" definitions (see IRuntime).

        Returned collection is unmodifiable and sorted by version order.

        Returns:
        a list of supported 1C:Enterprise runtime versions or empty list, never null