تولید پیش‌نمایش‌های بصری از داده‌های صفحه‌گسترده یک نیاز مکرر هنگام ساخت داشبوردهای گزارش‌گیری یا خلاصه‌های ایمیلی است. Conholdate.Total for Java یک SDK قدرتمند فراهم می‌کند که فرآیند تبدیل Excel به تصویر را در برنامه‌های Java ساده می‌سازد. در این راهنما خواهید دید که چگونه یک کتاب‌کار XLSX را بارگذاری کنید، خروجی JPEG را پیکربندی کنید، و صفحات ورق کاری را به فایل‌های تصویری رندر کنید. در پایان یک نمونه کد آماده‑به‑اجرا خواهید داشت که می‌توانید آن را برای پروژه‌های خود تطبیق دهید.

تبدیل فایل‌های Excel به تصویر چه نیازهایی از برنامه شما می‌طلبد

توسعه‌دهندگان اغلب نیاز دارند محتوای صفحات گسترده را به تصاویر ثابت برای پیش‌نمایش‌های وب، گزارش‌های PDF یا تصویرهای کوچک موبایل تبدیل کنند. این نیاز معمولاً شامل حفظ قالب‌بندی cell ، رندر دقیق محتوای برگه کاری و کنترل وضوح تصویر است. انجام این کارها به صورت دستی با باز کردن Excel، گرفتن اسکرین‌شات و ذخیره‌سازی آن‌ها، مقیاس‌پذیر نیست و می‌تواند به نتایج ناسازگار منجر شود.

محدودیت‌های فنی برای یک راه‌حل قابل اعتماد عبارتند از: پشتیبانی از فایل‌های XLSX، رندر دقیق چیدمان شیت‌ورک، قابلیت تنظیم وضوح تصویر، و توانایی پردازش شیت‌ورک‌هایی که در چند صفحه چاپی گسترده می‌شوند. تبدیل باید بر روی سرور یا محیط دسکتاپ اجرا شود بدون نیاز به Microsoft Office.

انتخاب Conholdate.Total برای Java برای کار

Conholdate.Total for Java یک API ساده ارائه می‌دهد که تمام قابلیت‌های مورد نیاز را پوشش می‌دهد. کلاس‌های Workbook و Worksheet دسترسی مستقیم به محتوای صفحه‌گسترده را فراهم می‌کنند، در حالی که ImageOrPrintOptions کنترل دقیق‌تری بر روی وضوح و فرمت تصویر می‌دهند، و SheetRender رندر صفحه به صفحه واقعی را مدیریت می‌کند. SDK بر روی هر محیط اجرایی Java کار می‌کند، فقط به وابستگی Maven نیاز دارد و کاربرگ‌های بزرگ را به‌صورت کارآمد مدیریت می‌کند.

برای استفاده دقیق از API به مستندات رسمی مراجعه کنید. مرجع کامل برای کلاس‌هایی مانند Workbook، Worksheet، ImageOrPrintOptions و SheetRender در مرجع API موجود است. می‌توانید آخرین کتابخانه را از صفحه انتشار دانلود کنید.

پیاده‌سازی تبدیل Excel به تصویر در Java

فرآیند تبدیل می‌تواند به چند مرحله واضح تقسیم شود. بخش‌های زیر شما را در هر قسمت راهنمایی می‌کنند، با قطعات کوتاه کد که مستقیماً از مثال کامل گرفته شده‌اند.

نصب Conholdate.Total for Java via Maven

مخزن Maven Conholdate و وابستگی SDK را به pom.xml خود اضافه کنید:

<repositories>
  <repository>
    <id>conholdate-repo</id>
    <name>Conholdate Maven Repository</name>
    <url>https://repository.conholdate.com/repo/</url>
  </repository>
</repositories>

<dependency>
  <groupId>com.conholdate</groupId>
  <artifactId>conholdate-total</artifactId>
  <version>24.9</version>
  <type>pom</type>
</dependency>

بارگذاری فایل Excel و دسترسی به برگه کاری

با کلاس Workbook کتاب‌کار را بارگذاری کنید، سپس مرجع برگه کاری که می‌خواهید تبدیل کنید را دریافت کنید:

// Load Excel file
com.aspose.cells.Workbook book = new com.aspose.cells.Workbook("input.xlsx");

// Get the reference of the desired worksheet
com.aspose.cells.Worksheet sheet = book.getWorksheets().get(0);

پیکربندی گزینه‌های خروجی تصویر برای JPEG

رزولوشن و فرمت تصویر مورد نظر را با استفاده از ImageOrPrintOptions تنظیم کنید:

// Set image options
com.aspose.cells.ImageOrPrintOptions options = new com.aspose.cells.ImageOrPrintOptions();
options.setHorizontalResolution(200);
options.setVerticalResolution(200);
options.setImageType(com.aspose.cells.ImageType.JPEG);

رندر کردن کاربرگ به تصاویر JPEG

یک SheetRender برای کاربرگ ایجاد کنید و بر روی صفحات آن حلقه بزنید، به‌طوری که هر یک را به‌عنوان یک فایل JPEG جداگانه ذخیره کنید. یک کاربرگ ممکن است بیش از یک صفحه چاپی را شامل شود، بنابراین getPageCount() به شما می‌گوید چه تعداد تصویر انتظار دارید:

// Convert sheet to JPG image
com.aspose.cells.SheetRender sr = new com.aspose.cells.SheetRender(sheet, options);
for (int j = 0; j < sr.getPageCount(); j++)
{
    sr.toImage(j, "excel-to-jpg" + (j + 1) + ".jpg");
}

مراحل بالا نشان می‌دهند که چگونه می‌توانید با استفاده از Conholdate.Total for Java SDK، تبدیل Excel به تصویر را انجام دهید در حالی که کنترل بر روی وضوح، فرمت و ورق‌های چندصفحه‌ای را در اختیار دارید.

مثال کامل کد: تبدیل Excel به تصویر با پشتیبانی از تمام صفحه

کد زیر پیاده‌سازی کامل و آماده برای اجرا را که در مراحل بالا توضیح داده شد، نشان می‌دهد.

public class ExcelToImageConverter {
    public static void main(String[] args) throws Exception {
        // Load Excel file
        com.aspose.cells.Workbook book = new com.aspose.cells.Workbook("input.xlsx");

// Get the reference of the desired worksheet
        com.aspose.cells.Worksheet sheet = book.getWorksheets().get(0);

// Set image options
        com.aspose.cells.ImageOrPrintOptions options = new com.aspose.cells.ImageOrPrintOptions();
        options.setHorizontalResolution(200);
        options.setVerticalResolution(200);
        options.setImageType(com.aspose.cells.ImageType.JPEG);

// Convert sheet to JPG image
        com.aspose.cells.SheetRender sr = new com.aspose.cells.SheetRender(sheet, options);
        for (int j = 0; j < sr.getPageCount(); j++)
        {
            sr.toImage(j, "excel-to-jpg" + (j + 1) + ".jpg");
        }

System.out.println("Excel to image conversion completed successfully.");
    }
}

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید مسیر فایل (input.xlsx) را به مکان واقعی فایل خود به‌روزرسانی کنید، اطمینان حاصل کنید تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند، و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه کنید.

نتیجه‌گیری

تبدیل Excel به تصویر در Java زمانی که از Conholdate.Total for Java استفاده کنید، ساده می‌شود. SDK رندر برگه‌های کاری و خروجی JPEG با کیفیت بالا را با حداقل کد انجام می‌دهد. با دنبال کردن راهنمای گام‌به‌گام می‌توانید این قابلیت را در ابزارهای گزارش‌گیری، تولیدکنندگان ایمیل یا هر برنامه‌ای که به نمایش تصویری صفحات گسترده نیاز دارد، یکپارچه کنید. به یاد داشته باشید که استقرارهای تولیدی به یک لایسنس تجاری نیاز دارند؛ می‌توانید گزینه‌های قیمت‌گذاری را در صفحه Conholdate.Total pricing بررسی کنید و در حین ارزیابی، لایسنس موقت را از صفحه لایسنس موقت دریافت کنید.

سوالات متداول

  • چگونه می‌توانم Excel را به تصویر در Java تبدیل کنم؟
    فایل را با Workbook بارگذاری کنید، صفحه کاری مورد نیاز را از book.getWorksheets() دریافت کنید، ImageOrPrintOptions را پیکربندی کنید و با SheetRender رندر کنید.

  • آیا می‌توانم یک برگه خاص Excel را به تصویر تبدیل کنم؟
    بله. از book.getWorksheets().get(index) برای انتخاب برگه استفاده کنید، سپس آن را به SheetRender برای تبدیل پاس دهید.

  • چرا از یک کاربرگ بیش از یک فایل تصویر دریافت می‌کنم؟
    یک کاربرگ می‌تواند چندین صفحه چاپ شده را در بر بگیرد. SheetRender.getPageCount() تعداد صفحات را برمی‌گرداند و حلقه برای هر صفحه یک تصویر ذخیره می‌کند.

  • برای استفاده در تولید چه مجوزی لازم است؟
    یک مجوز تجاری مورد نیاز است. هزینه‌ها را در صفحه Conholdate.Total pricing بررسی کنید و یک مجوز موقت را از صفحه temporary license page دریافت کنید.

بیشتر بخوانید