| File: Installer\UpdateResult.cs | Web Access |
| Project: src\sdk\src\TemplateEngine\Microsoft.TemplateEngine.Abstractions\Microsoft.TemplateEngine.Abstractions.csproj (Microsoft.TemplateEngine.Abstractions) |
// Licensed to the .NET Foundation under one or more agreements. // The .NET Foundation licenses this file to you under the MIT license. using Microsoft.TemplateEngine.Abstractions.TemplatePackage; namespace Microsoft.TemplateEngine.Abstractions.Installer { /// <summary> /// Represents the result of template package update using <see cref="IInstaller.UpdateAsync"/>. /// </summary> public sealed class UpdateResult : InstallerOperationResult { private UpdateResult(UpdateRequest request, IManagedTemplatePackage templatePackage, IReadOnlyList<VulnerabilityInfo> vulnerabilities) : base(templatePackage) { UpdateRequest = request; Vulnerabilities = vulnerabilities; } private UpdateResult(UpdateRequest request, InstallerErrorCode error, string errorMessage, IReadOnlyList<VulnerabilityInfo> vulnerabilities) : base(error, errorMessage) { UpdateRequest = request; Vulnerabilities = vulnerabilities; } private UpdateResult(UpdateRequest request, InstallResult installResult) : base(installResult.Error, installResult.ErrorMessage, installResult.TemplatePackage) { UpdateRequest = request; Vulnerabilities = installResult.Vulnerabilities; } /// <summary> /// <see cref="UpdateRequest"/> processed by <see cref="IInstaller.UpdateAsync"/> operation. /// </summary> public UpdateRequest UpdateRequest { get; private set; } /// <summary> /// Gets vulnerabilities from installed package. /// </summary> public IReadOnlyList<VulnerabilityInfo> Vulnerabilities { get; private set; } /// <summary> /// Creates successful result for the operation. /// </summary> /// <param name="request">the processed <see cref="UpdateRequest"/>.</param> /// <param name="templatePackage">the updated <see cref="IManagedTemplatePackage"/>.</param> /// <param name="vulnerabilities">Package vulnerabilities associated with the update request.</param> /// <returns></returns> public static UpdateResult CreateSuccess(UpdateRequest request, IManagedTemplatePackage templatePackage, IReadOnlyList<VulnerabilityInfo> vulnerabilities) { return new UpdateResult(request, templatePackage, vulnerabilities); } /// <summary> /// Creates failure result for the operation. /// </summary> /// <param name="request">the processed <see cref="UpdateRequest"/>.</param> /// <param name="error">error code, see <see cref="InstallerErrorCode"/> for details.</param> /// <param name="localizedFailureMessage">detailed error message.</param> /// <param name="vulnerabilities">Package vulnerabilities associated with the update request.</param> /// <returns></returns> public static UpdateResult CreateFailure(UpdateRequest request, InstallerErrorCode error, string localizedFailureMessage, IReadOnlyList<VulnerabilityInfo> vulnerabilities) { return new UpdateResult(request, error, localizedFailureMessage, vulnerabilities); } /// <summary> /// Creates <see cref="UpdateResult"/> from <see cref="InstallResult"/>. /// </summary> /// <param name="request">the processed <see cref="UpdateRequest"/>.</param> /// <param name="installResult"><see cref="InstallResult"/> to be converted to <see cref="UpdateResult"/>.</param> /// <returns></returns> public static UpdateResult FromInstallResult(UpdateRequest request, InstallResult installResult) { return new UpdateResult(request, installResult); } } }