การแปลง XLSX เป็น JPG ใน Java เป็นความต้องการทั่วไปเมื่อคุณต้องการแสดงข้อมูลสเปรดชีตเป็นภาพ. GroupDocs.Conversion Cloud SDK for Java ให้ไลบรารีแบบ REST‑based ที่ง่ายซึ่งช่วยให้คุณเรนเดอร์เวิร์กชีต Excel โดยตรงเป็นไฟล์ JPG. คู่มือนี้จะพาคุณผ่านการตั้งค่าที่จำเป็น, แสดงตัวอย่างโค้ดเต็มรูปแบบ, สาธิตการประมวลผลแบบอะซิงโครนัสด้วย cURL, และให้เคล็ดลับประสิทธิภาพสำหรับการจัดการเวิร์กบุ๊กขนาดใหญ่.
ขั้นตอนการแปลง XLSX เป็น JPG ใน Java
- เพิ่มการพึ่งพา Maven: รวม SDK ในไฟล์
pom.xmlของคุณเพื่อให้ไลบรารีพร้อมใช้งานในระหว่างการคอมไพล์.
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-conversion-cloud</artifactId>
<version>23.12</version>
</dependency>
- เริ่มต้น Conversion Client: สร้างอินสแตนซ์ของ
ConversionApiด้วยข้อมูลประจำตัวของคุณ.
import com.groupdocs.conversion.cloud.api.ConversionApi;
import com.groupdocs.conversion.cloud.client.ApiClient;
import com.groupdocs.conversion.cloud.configuration.Configuration;
Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
ConversionApi conversionApi = new ConversionApi(new ApiClient(config));
- กำหนดค่าตัวเลือกการแปลง: ตั้งค่ารูปแบบเอาต์พุตเป็น JPG, เลือกความละเอียด, และเปิดใช้งานการประมวลผลแบบอะซิงค์หากต้องการ.
import com.groupdocs.conversion.cloud.model.requests.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertOptions;
import com.groupdocs.conversion.cloud.model.JpgConvertOptions;
JpgConvertOptions jpgOptions = new JpgConvertOptions();
jpgOptions.setResolution(300); // 300 DPI for high quality
jpgOptions.setQuality(90); // JPEG quality 0‑100
jpgOptions.setAsync(true); // Enable async conversion
ConvertOptions options = new ConvertOptions();
options.setOutputFormat("JPG");
options.setJpgOptions(jpgOptions);
- ดำเนินการแปลง: สร้าง
ConvertDocumentRequestด้วยไฟล์ XLSX ต้นฉบับและตัวเลือก, จากนั้นเรียกใช้ API.
import java.io.File;
File sourceFile = new File("sample.xlsx");
ConvertDocumentRequest request = new ConvertDocumentRequest(sourceFile, options);
String jobId = conversionApi.convertDocument(request);
System.out.println("Conversion started, job ID: " + jobId);
- ดาวน์โหลดผลลัพธ์: ตรวจสอบสถานะงานจนกว่าจะเสร็จสิ้น จากนั้นดาวน์โหลด JPG แต่ละไฟล์ที่สร้างขึ้น
import com.groupdocs.conversion.cloud.model.JobStatus;
import com.groupdocs.conversion.cloud.model.responses.JobStatusResponse;
while (true) {
JobStatusResponse statusResponse = conversionApi.getJobStatus(jobId);
JobStatus status = statusResponse.getStatus();
if (status == JobStatus.COMPLETED) break;
Thread.sleep(2000); // wait 2 seconds before next poll
}
conversionApi.downloadResult(jobId, new File("output/"));
System.out.println("JPG files saved to output folder.");
สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับอ็อบเจ็กต์คำขอ ดูที่ อ้างอิง API.
สร้าง JPG จาก XLSX ใน Java - ตัวอย่างโค้ดเต็ม
ตัวอย่างนี้แสดงการแปลงแบบ end‑to‑end อย่างเต็มที่ซึ่งโหลดเวิร์กบุ๊ก XLSX, แปลงแต่ละแผ่นงานเป็น JPG แยกกัน และบันทึกภาพลงในเครื่องท้องถิ่น.
package com.example.conversion;
import com.groupdocs.conversion.cloud.api.ConversionApi;
import com.groupdocs.conversion.cloud.client.ApiClient;
import com.groupdocs.conversion.cloud.configuration.Configuration;
import com.groupdocs.conversion.cloud.model.requests.ConvertDocumentRequest;
import com.groupdocs.conversion.cloud.model.ConvertOptions;
import com.groupdocs.conversion.cloud.model.JpgConvertOptions;
import com.groupdocs.conversion.cloud.model.responses.JobStatusResponse;
import com.groupdocs.conversion.cloud.model.JobStatus;
import java.io.File;
public class XlsxToJpgDemo {
public static void main(String[] args) throws Exception {
// 1. Configure client
Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
ConversionApi api = new ConversionApi(new ApiClient(config));
// 2. Prepare conversion options
JpgConvertOptions jpgOpts = new JpgConvertOptions();
jpgOpts.setResolution(300);
jpgOpts.setQuality(90);
jpgOpts.setAsync(true); // async conversion
ConvertOptions convOpts = new ConvertOptions();
convOpts.setOutputFormat("JPG");
convOpts.setJpgOptions(jpgOpts);
// 3. Create request
File source = new File("input/sample.xlsx");
ConvertDocumentRequest request = new ConvertDocumentRequest(source, convOpts);
// 4. Start conversion
String jobId = api.convertDocument(request);
System.out.println("Job started, ID: " + jobId);
// 5. Wait for completion
while (true) {
JobStatusResponse statusResp = api.getJobStatus(jobId);
if (statusResp.getStatus() == JobStatus.COMPLETED) break;
Thread.sleep(2000);
}
// 6. Download JPG files
api.downloadResult(jobId, new File("output/"));
System.out.println("Conversion finished. JPG files are in the output folder.");
}
}
หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลัก ก่อนนำไปใช้ในโครงการของคุณ ให้ตรวจสอบและอัปเดตเส้นทางไฟล์ (
input/sample.xlsx,output/) ให้ตรงกับตำแหน่งจริงของคุณ ตรวจสอบว่าขึ้นตอนการพึ่งพาที่จำเป็นทั้งหมดได้ถูกติดตั้งอย่างถูกต้อง และทำการทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากพบปัญหาใด ๆ โปรดดูที่ เอกสารอย่างเป็นทางการ หรือ ติดต่อทีม ฝ่ายสนับสนุน เพื่อขอความช่วยเหลือ.
แปลง Excel เป็นภาพโดยใช้ cURL
คำสั่ง cURL ด้านล่างแสดงวิธีการทำการแปลง XLSX เป็น JPG ด้วย REST API. แทนที่ค่าตัวแปรด้วยข้อมูลประจำตัวและชื่อไฟล์จริงของคุณ.
- รับ Access Token
curl -X POST "https://api.groupdocs.cloud/v1.0/oauth/token" \
-H "Content-Type: application/json" \
-d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
- อัปโหลดไฟล์ XLSX
curl -X POST "https://api.groupdocs.cloud/v1.0/storage/file/upload" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@sample.xlsx"
- เริ่มการแปลงแบบอะซิงโครนัส
curl -X POST "https://api.groupdocs.cloud/v1.0/conversion/convert" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"sourceFilePath": "sample.xlsx",
"outputFormat": "JPG",
"options": {
"resolution": 300,
"quality": 90,
"async": true
}
}'
- ตรวจสอบสถานะงาน (แทนที่
JOB_IDด้วยค่าที่ได้จากขั้นตอนก่อนหน้า)
curl -X GET "https://api.groupdocs.cloud/v1.0/conversion/jobs/JOB_ID/status" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
- ดาวน์โหลดไฟล์ JPG ที่ได้ผลลัพธ์
curl -X GET "https://api.groupdocs.cloud/v1.0/conversion/jobs/JOB_ID/result" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.zip
สำหรับรายการพารามิเตอร์ทั้งหมด โปรดดูที่ เอกสาร API อย่างเป็นทางการ.
การติดตั้งและกำหนดค่า GroupDocs.Conversion Cloud SDK for Java
เพิ่ม SDK ไปยังโครงการของคุณด้วย Maven แล้วกำหนดค่าใบรับรองของไคลเอนต์ของคุณ
# Add the dependency (already shown in the Steps section)
mvn install com.groupdocs:groupdocs-conversion-cloud
// Example configuration (same as in the Steps section)
Configuration config = new Configuration();
config.setClientId("YOUR_CLIENT_ID");
config.setClientSecret("YOUR_CLIENT_SECRET");
คุณสามารถดาวน์โหลดไฟล์ JAR ล่าสุดได้จาก หน้าดาวน์โหลด.
ตัวเลือกการแปลงจาก XLSX เป็น JPG
หลายตัวเลือกช่วยให้คุณปรับแต่งภาพที่สร้างขึ้นได้อย่างละเอียด
| Option | Description | Example |
|---|---|---|
| Resolution | ความละเอียด DPI ของภาพผลลัพธ์ ค่าที่สูงขึ้นจะเพิ่มคุณภาพแต่ขนาดไฟล์ก็จะเพิ่มขึ้น | jpgOpts.setResolution(300); |
| Quality | ระดับการบีบอัด JPEG (0‑100) | jpgOpts.setQuality(90); |
| Page Range | แปลงเฉพาะ worksheets ที่ระบุเท่านั้น | jpgOpts.setPageRange("1-3"); |
| Async | ทำการแปลงในพื้นหลังและตรวจสอบสถานะจนเสร็จ | jpgOpts.setAsync(true); |
แต่ละคุณสมบัติเยมือนเป็นส่วนหนึ่งของ JpgConvertOptions ใน SDK. ดูที่ อ้างอิง API เพื่อดูรายการทั้งหมด.
ปรับปรุงความเร็วในการแปลงและการใช้หน่วยความจำ
- สตรีมแผ่นงาน - ประมวลผลแผ่นงานหนึ่งครั้งโดยเปิดใช้งานโหมด async; นี้จะป้องกันไม่ให้สมุดงานทั้งหมดโหลดเข้าสู่หน่วยความจำ
- ปรับความละเอียด - ใช้ DPI ที่ต่ำที่สุดที่ยอมรับได้สำหรับกรณีการใช้งานของคุณ; 150‑200 DPI มักเพียงพอสำหรับการแสดงตัวอย่างบนเว็บ
- คำขอแบบเป็นชุด - เมื่อแปลงไฟล์จำนวนมาก, ส่งคำขอเป็นชุดแบบขนานโดยจำกัดตาม CPU และความจุเครือข่ายของเซิร์ฟเวอร์ของคุณ
- ใช้ ApiClient ซ้ำ - สร้างอินสแตนซ์
ConversionApiเพียงหนึ่งตัวและใช้ซ้ำในหลายการแปลงเพื่อหลีกเลี่ยงภาระการรับรองความถูกต้องที่ทำซ้ำ
การใช้เคล็ดลับเหล่านี้สามารถลดเวลาในการแปลงได้สูงสุดถึง 40 % สำหรับไฟล์ Excel ขนาดใหญ่.
สรุป
การแปลง XLSX เป็น JPG ใน Java กลายเป็นเรื่องง่ายด้วย GroupDocs.Conversion Cloud SDK for Java. โดยทำตามขั้นตอนข้างต้น คุณสามารถเรนเดอร์แต่ละแผ่นงานเป็น JPG คุณภาพสูง ใช้การประมวลผลแบบอะซิงโครนัสเพื่อความสามารถในการขยายที่ดียิ่งขึ้น และใช้การปรับประสิทธิภาพสำหรับสมุดงานขนาดใหญ่. อย่าลืมขอรับใบอนุญาตที่เหมาะสมสำหรับการใช้งานในสภาพแวดล้อมการผลิต; รายละเอียดราคาอยู่บนหน้าผลิตภัณฑ์ และคุณสามารถเริ่มต้นด้วย ใบอนุญาตชั่วคราว เพื่อประเมินไลบรารี. ผสานความสามารถนี้เข้ากับแอปพลิเคชันของคุณเพื่อให้การแสดงตัวอย่างภาพของข้อมูล Excel อย่างรวดเร็วโดยไม่ต้องพึ่งพาการติดตั้ง Office ฝั่งไคลเอนต์.
FAQs
ฉันจะทำการแปลงไฟล์ XLSX เป็น JPG ใน Java โดยใช้ GroupDocs อย่างไร?
ใช้คลาส ConversionApi เพื่ออัปโหลดไฟล์ XLSX, ตั้งค่า JpgConvertOptions (ความละเอียด, คุณภาพ, แบบอะซิงโครนัส), และเรียก convertDocument. SDK จะคืนค่า ID ของงานที่คุณสามารถตรวจสอบได้จนกว่าไฟล์ JPG จะพร้อมใช้งาน.
ฉันสามารถแปลงสมุดงาน Excel ขนาดใหญ่โดยไม่หมดหน่วยความจำได้หรือไม่?
ใช่. เปิดใช้งานการแปลงแบบอะซิงโครนัสและตั้งค่าความละเอียดที่เหมาะสม SDK จะประมวลผลแผ่นงานแบบต่อเนื่องเพื่อรักษาการใช้หน่วยความจำให้ต่ำ.
การแปลงแบบอะซิงโครนัสรองรับสำหรับ XLSX เป็น JPG หรือไม่?
SDK มีแฟล็ก async ใน JpgConvertOptions. เมื่อกำหนดเป็น true API จะคืนค่า job ID ให้คุณตรวจสอบสถานะและดาวน์โหลดผลลัพธ์ในภายหลัง.
ฉันต้องการใบอนุญาตพิเศษเพื่อใช้ฟีเจอร์การแปลงในสภาพแวดล้อมการผลิตหรือไม่?
จำเป็นต้องมีใบอนุญาต GroupDocs.Conversion Cloud ที่ถูกต้องสำหรับการใช้งานในสภาพแวดล้อมการผลิต คุณสามารถเริ่มต้นด้วยใบอนุญาตชั่วคราวจาก หน้าใบอนุญาตชั่วคราว ก่อนที่จะซื้อการสมัครสมาชิกเต็มรูปแบบ
