Expose a REST API to Watermark Word Documents

Ako pridať vodoznaky do dokumentov Word prostredníctvom ASP.NET Core REST API

Tento tutoriál vás vedie ako vystaviť REST API na pridávanie vodoznakov do dokumentov Word v ASP.NET Core. Obsahuje podrobné postupy krok za krokom, podrobnosti o nastavení a nasadzovacie pokyny pre hlavné platformy.

Kroky na pridanie vodoznakov do dokumentov Word prostredníctvom REST API

  1. Nastavte projekt ASP.NET Core Web API na pridávanie vodoznakov.
  2. Inštalovať Aspose.Words for .NET prostredníctvom NuGet Package Manager.
  3. Vytvorte kontrolér s koncovým bodom, ktorý prijíma súbory Word a parametre textu alebo obrázka vodoznaku.
  4. Napíšte kód na pridanie textových alebo obrázkových vodoznakov do dokumentov Word.
  5. Otestujte API lokálne pomocou nástrojov ako Postman alebo cURL.
  6. Nasadiť API v prostrediach Windows, Linux alebo macOS.
  7. Nakonfigurujte Nginx alebo IIS pre produkčné nasadenie.

Tieto kroky poskytujú podrobný prístup na vytvorenie a vystavenie vodoznakového API.

Príklad kódu: REST API pre pridávanie vodoznakov

Nižšie je spustiteľný úryvok kódu na zverejnenie REST API, ktoré pridáva textové vodoznaky do dokumentov Word:

using System.IO;
using System.Threading.Tasks;
using Aspose.Words;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

namespace WatermarkAPI.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    public class WatermarkController : ControllerBase
    {
        [HttpPost("add-watermark")]
        public async Task<IActionResult> AddWatermark(IFormFile file, [FromQuery] string watermarkText)
        {
            if (file == null || file.Length == 0 || string.IsNullOrWhiteSpace(watermarkText))
                return BadRequest("Please upload a valid Word document and provide a watermark text.");

            try
            {
                var tempFilePath = Path.GetTempFileName();
                using (var stream = new FileStream(tempFilePath, FileMode.Create))
                {
                    await file.CopyToAsync(stream);
                }

                Document doc = new Document(tempFilePath);

                TextWatermarkOptions options = new TextWatermarkOptions
                {
                    FontFamily = "Arial",
                    FontSize = 40,
                    Color = System.Drawing.Color.LightGray,
                    Layout = WatermarkLayout.Diagonal,
                    IsSemitrasparent = true
                };
                doc.Watermark.SetText(watermarkText, options);

                var outputStream = new MemoryStream();
                doc.Save(outputStream, SaveFormat.Docx);

                outputStream.Position = 0;
                return File(outputStream, "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "watermarked.docx");
            }
            catch (System.Exception ex)
            {
                return StatusCode(500, $"Internal server error: {ex.Message}");
            }
        }
    }
}

Nasadenie na hlavné platformy

Windows

  1. Nainštalujte IIS a nakonfigurujte stránku tak, aby smerovala na priečinok s publikovanou aplikáciou.
  2. Zverejnite aplikáciu:

Linux

  1. Nainštalujte runtime ASP.NET Core:
  2. Zverejnite aplikáciu:
  3. Nakonfigurujte Nginx na proxyovanie prevádzky na server Kestrel.

macOS

  1. Inštalujte runtime .NET z oficiálnej stránky .
  2. Zverejnite a spustite:

Bežné problémy a riešenia

  1. Chyby neplatného vstupu: Uistite sa, že nahraný súbor je platný dokument Word a text vodoznaku nie je prázdny.
  2. Chyby odmietnutého prístupu: V systéme Linux/macOS udeľte správne oprávnenia priečinku aplikácie.
  3. Problémy s výkonom: Pre veľké súbory optimalizujte využitie pamäte spracovaním súborov priamo z disku namiesto streamov.

Tento návod vám ukázal, ako vytvoriť REST API na pridávanie vodoznakov do dokumentov Word pomocou Aspose.Words for .NET a nasadiť ho na všetky hlavné platformy.

 Slovenčina