<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>java xlsx to jpg on Document Processing REST APIs | GroupDocs Cloud</title>
    <link>https://blog-qa.groupdocs.cloud/ar/tag/java-xlsx-to-jpg/</link>
    <description>Recent content in java xlsx to jpg on Document Processing REST APIs | GroupDocs Cloud</description>
    <generator>Hugo -- gohugo.io</generator>
    <language>ar</language>
    <lastBuildDate>Fri, 17 Jul 2026 09:43:13 +0000</lastBuildDate><atom:link href="https://blog-qa.groupdocs.cloud/ar/tag/java-xlsx-to-jpg/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>دليل تحويل XLSX إلى JPG في Java</title>
      <link>https://blog-qa.groupdocs.cloud/ar/conversion/xlsx-to-jpg-conversion-tutorial-in-java/</link>
      <pubDate>Fri, 17 Jul 2026 09:43:13 +0000</pubDate>
      
      <guid>https://blog-qa.groupdocs.cloud/ar/conversion/xlsx-to-jpg-conversion-tutorial-in-java/</guid>
      <description>تحويل ملفات XLSX إلى صور JPG في Java باستخدام GroupDocs.Conversion Cloud SDK. اتبع الدليل خطوة بخطوة مع دعم غير متزامن ونصائح الأداء.</description>
      <content:encoded><![CDATA[<p>تحويل <a href="https://docs.fileformat.com/spreadsheet/xlsx/">XLSX</a> إلى <a href="https://docs.fileformat.com/image/jpg/">JPG</a> في Java هو حاجة شائعة عندما تريد عرض بيانات الجداول كصور. يقدم <a href="https://products.groupdocs.cloud/conversion/java/">GroupDocs.Conversion Cloud SDK for Java</a> مكتبة بسيطة تعتمد على REST تتيح لك تحويل أوراق Excel مباشرة إلى ملفات JPG. يوضح هذا الدليل الإعداد المطلوب، ويعرض مثالًا كاملاً للكود، ويظهر المعالجة غير المتزامنة باستخدام cURL، ويقدم نصائح أداء للتعامل مع دفاتر العمل الكبيرة.</p>
<h2 id="خطوات-تحويل-xlsx-إلى-jpg-في-java">خطوات تحويل XLSX إلى JPG في Java</h2>
<ol>
<li><strong>إضافة تبعية Maven</strong>: تضمين SDK في ملف <code>pom.xml</code> بحيث تكون المكتبة متاحة أثناء التجميع.
<!--[CODE_SNIPPET_START]-->
</li>
</ol>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-xml" data-lang="xml"><span style="display:flex;"><span><span style="color:#f92672">&lt;dependency&gt;</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">&lt;groupId&gt;</span>com.groupdocs<span style="color:#f92672">&lt;/groupId&gt;</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">&lt;artifactId&gt;</span>groupdocs-conversion-cloud<span style="color:#f92672">&lt;/artifactId&gt;</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">&lt;version&gt;</span>23.12<span style="color:#f92672">&lt;/version&gt;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">&lt;/dependency&gt;</span>
</span></span></code></pre></div><!--[CODE_SNIPPET_END]-->
<ol start="2">
<li><strong>تهيئة عميل التحويل</strong>: إنشاء مثال من <code>ConversionApi</code> باستخدام بيانات اعتماد العميل الخاصة بك.</li>
</ol>
<!--[CODE_SNIPPET_START]-->
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.api.ConversionApi<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.client.ApiClient<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.configuration.Configuration<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>Configuration config <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> Configuration<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>config<span style="color:#f92672">.</span><span style="color:#a6e22e">setClientId</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;YOUR_CLIENT_ID&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>config<span style="color:#f92672">.</span><span style="color:#a6e22e">setClientSecret</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;YOUR_CLIENT_SECRET&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>ConversionApi conversionApi <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> ConversionApi<span style="color:#f92672">(</span><span style="color:#66d9ef">new</span> ApiClient<span style="color:#f92672">(</span>config<span style="color:#f92672">));</span>
</span></span></code></pre></div><!--[CODE_SNIPPET_END]-->
<ol start="3">
<li><strong>تكوين خيارات التحويل</strong>: حدد تنسيق الإخراج إلى JPG، اختر دقةً، وقم بتمكين المعالجة غير المتزامنة إذا رغبت.
<!--[CODE_SNIPPET_START]-->
</li>
</ol>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.model.requests.ConvertDocumentRequest<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.model.ConvertOptions<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.model.JpgConvertOptions<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>JpgConvertOptions jpgOptions <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> JpgConvertOptions<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>jpgOptions<span style="color:#f92672">.</span><span style="color:#a6e22e">setResolution</span><span style="color:#f92672">(</span>300<span style="color:#f92672">);</span>          <span style="color:#75715e">// 300 DPI for high quality
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>jpgOptions<span style="color:#f92672">.</span><span style="color:#a6e22e">setQuality</span><span style="color:#f92672">(</span>90<span style="color:#f92672">);</span>              <span style="color:#75715e">// JPEG quality 0‑100
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>jpgOptions<span style="color:#f92672">.</span><span style="color:#a6e22e">setAsync</span><span style="color:#f92672">(</span><span style="color:#66d9ef">true</span><span style="color:#f92672">);</span>              <span style="color:#75715e">// Enable async conversion
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>
</span></span><span style="display:flex;"><span>ConvertOptions options <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> ConvertOptions<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>options<span style="color:#f92672">.</span><span style="color:#a6e22e">setOutputFormat</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;JPG&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>options<span style="color:#f92672">.</span><span style="color:#a6e22e">setJpgOptions</span><span style="color:#f92672">(</span>jpgOptions<span style="color:#f92672">);</span>
</span></span></code></pre></div><!--[CODE_SNIPPET_END]-->
<ol start="4">
<li><strong>تنفيذ التحويل</strong>: إنشاء <code>ConvertDocumentRequest</code> مع ملف XLSX المصدر والخيارات، ثم استدعاء API.
<!--[CODE_SNIPPET_START]-->
</li>
</ol>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#f92672">import</span> java.io.File<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>File sourceFile <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> File<span style="color:#f92672">(</span><span style="color:#e6db74">&#34;sample.xlsx&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>ConvertDocumentRequest request <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> ConvertDocumentRequest<span style="color:#f92672">(</span>sourceFile<span style="color:#f92672">,</span> options<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>String jobId <span style="color:#f92672">=</span> conversionApi<span style="color:#f92672">.</span><span style="color:#a6e22e">convertDocument</span><span style="color:#f92672">(</span>request<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>System<span style="color:#f92672">.</span><span style="color:#a6e22e">out</span><span style="color:#f92672">.</span><span style="color:#a6e22e">println</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;Conversion started, job ID: &#34;</span> <span style="color:#f92672">+</span> jobId<span style="color:#f92672">);</span>
</span></span></code></pre></div><!--[CODE_SNIPPET_END]-->
<ol start="5">
<li><strong>تنزيل النتيجة</strong>: استعلام حالة المهمة حتى تكتمل، ثم تنزيل كل ملف JPG تم إنشاؤه.
<!--[CODE_SNIPPET_START]-->
</li>
</ol>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.model.JobStatus<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.model.responses.JobStatusResponse<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">while</span> <span style="color:#f92672">(</span><span style="color:#66d9ef">true</span><span style="color:#f92672">)</span> <span style="color:#f92672">{</span>
</span></span><span style="display:flex;"><span>    JobStatusResponse statusResponse <span style="color:#f92672">=</span> conversionApi<span style="color:#f92672">.</span><span style="color:#a6e22e">getJobStatus</span><span style="color:#f92672">(</span>jobId<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>    JobStatus status <span style="color:#f92672">=</span> statusResponse<span style="color:#f92672">.</span><span style="color:#a6e22e">getStatus</span><span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>    <span style="color:#66d9ef">if</span> <span style="color:#f92672">(</span>status <span style="color:#f92672">==</span> JobStatus<span style="color:#f92672">.</span><span style="color:#a6e22e">COMPLETED</span><span style="color:#f92672">)</span> <span style="color:#66d9ef">break</span><span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span>    Thread<span style="color:#f92672">.</span><span style="color:#a6e22e">sleep</span><span style="color:#f92672">(</span>2000<span style="color:#f92672">);</span> <span style="color:#75715e">// wait 2 seconds before next poll
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span><span style="color:#f92672">}</span>
</span></span><span style="display:flex;"><span>conversionApi<span style="color:#f92672">.</span><span style="color:#a6e22e">downloadResult</span><span style="color:#f92672">(</span>jobId<span style="color:#f92672">,</span> <span style="color:#66d9ef">new</span> File<span style="color:#f92672">(</span><span style="color:#e6db74">&#34;output/&#34;</span><span style="color:#f92672">));</span>
</span></span><span style="display:flex;"><span>System<span style="color:#f92672">.</span><span style="color:#a6e22e">out</span><span style="color:#f92672">.</span><span style="color:#a6e22e">println</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;JPG files saved to output folder.&#34;</span><span style="color:#f92672">);</span>
</span></span></code></pre></div><!--[CODE_SNIPPET_END]-->
<p>لمزيد من التفاصيل حول كائنات الطلب، راجع <a href="https://reference.groupdocs.cloud/conversion/">مرجع API</a>.</p>
<h2 id="إنشاء-jpg-من-xlsx-في-java---مثال-كامل-للكود">إنشاء JPG من XLSX في Java - مثال كامل للكود</h2>
<p>يوضح هذا المثال تحويلًا كاملاً من البداية إلى النهاية يقوم بتحميل دفتر عمل XLSX، ويحول كل ورقة عمل إلى صورة JPG منفصلة، ويحفظ الصور محليًا.</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#f92672">package</span> com.example.conversion<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.api.ConversionApi<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.client.ApiClient<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.configuration.Configuration<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.model.requests.ConvertDocumentRequest<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.model.ConvertOptions<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.model.JpgConvertOptions<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.model.responses.JobStatusResponse<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.conversion.cloud.model.JobStatus<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> java.io.File<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">public</span> <span style="color:#66d9ef">class</span> <span style="color:#a6e22e">XlsxToJpgDemo</span> <span style="color:#f92672">{</span>
</span></span><span style="display:flex;"><span>    <span style="color:#66d9ef">public</span> <span style="color:#66d9ef">static</span> <span style="color:#66d9ef">void</span> <span style="color:#a6e22e">main</span><span style="color:#f92672">(</span>String<span style="color:#f92672">[]</span> args<span style="color:#f92672">)</span> <span style="color:#66d9ef">throws</span> Exception <span style="color:#f92672">{</span>
</span></span><span style="display:flex;"><span>        <span style="color:#75715e">// 1. Configure client
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>        Configuration config <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> Configuration<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>        config<span style="color:#f92672">.</span><span style="color:#a6e22e">setClientId</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;YOUR_CLIENT_ID&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>        config<span style="color:#f92672">.</span><span style="color:#a6e22e">setClientSecret</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;YOUR_CLIENT_SECRET&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>        ConversionApi api <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> ConversionApi<span style="color:#f92672">(</span><span style="color:#66d9ef">new</span> ApiClient<span style="color:#f92672">(</span>config<span style="color:#f92672">));</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e">// 2. Prepare conversion options
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>        JpgConvertOptions jpgOpts <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> JpgConvertOptions<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>        jpgOpts<span style="color:#f92672">.</span><span style="color:#a6e22e">setResolution</span><span style="color:#f92672">(</span>300<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>        jpgOpts<span style="color:#f92672">.</span><span style="color:#a6e22e">setQuality</span><span style="color:#f92672">(</span>90<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>        jpgOpts<span style="color:#f92672">.</span><span style="color:#a6e22e">setAsync</span><span style="color:#f92672">(</span><span style="color:#66d9ef">true</span><span style="color:#f92672">);</span> <span style="color:#75715e">// async conversion
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>
</span></span><span style="display:flex;"><span>ConvertOptions convOpts <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> ConvertOptions<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>        convOpts<span style="color:#f92672">.</span><span style="color:#a6e22e">setOutputFormat</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;JPG&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>        convOpts<span style="color:#f92672">.</span><span style="color:#a6e22e">setJpgOptions</span><span style="color:#f92672">(</span>jpgOpts<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e">// 3. Create request
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>        File source <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> File<span style="color:#f92672">(</span><span style="color:#e6db74">&#34;input/sample.xlsx&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>        ConvertDocumentRequest request <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> ConvertDocumentRequest<span style="color:#f92672">(</span>source<span style="color:#f92672">,</span> convOpts<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e">// 4. Start conversion
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>        String jobId <span style="color:#f92672">=</span> api<span style="color:#f92672">.</span><span style="color:#a6e22e">convertDocument</span><span style="color:#f92672">(</span>request<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>        System<span style="color:#f92672">.</span><span style="color:#a6e22e">out</span><span style="color:#f92672">.</span><span style="color:#a6e22e">println</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;Job started, ID: &#34;</span> <span style="color:#f92672">+</span> jobId<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e">// 5. Wait for completion
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>        <span style="color:#66d9ef">while</span> <span style="color:#f92672">(</span><span style="color:#66d9ef">true</span><span style="color:#f92672">)</span> <span style="color:#f92672">{</span>
</span></span><span style="display:flex;"><span>            JobStatusResponse statusResp <span style="color:#f92672">=</span> api<span style="color:#f92672">.</span><span style="color:#a6e22e">getJobStatus</span><span style="color:#f92672">(</span>jobId<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>            <span style="color:#66d9ef">if</span> <span style="color:#f92672">(</span>statusResp<span style="color:#f92672">.</span><span style="color:#a6e22e">getStatus</span><span style="color:#f92672">()</span> <span style="color:#f92672">==</span> JobStatus<span style="color:#f92672">.</span><span style="color:#a6e22e">COMPLETED</span><span style="color:#f92672">)</span> <span style="color:#66d9ef">break</span><span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span>            Thread<span style="color:#f92672">.</span><span style="color:#a6e22e">sleep</span><span style="color:#f92672">(</span>2000<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>        <span style="color:#f92672">}</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e">// 6. Download JPG files
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>        api<span style="color:#f92672">.</span><span style="color:#a6e22e">downloadResult</span><span style="color:#f92672">(</span>jobId<span style="color:#f92672">,</span> <span style="color:#66d9ef">new</span> File<span style="color:#f92672">(</span><span style="color:#e6db74">&#34;output/&#34;</span><span style="color:#f92672">));</span>
</span></span><span style="display:flex;"><span>        System<span style="color:#f92672">.</span><span style="color:#a6e22e">out</span><span style="color:#f92672">.</span><span style="color:#a6e22e">println</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;Conversion finished. JPG files are in the output folder.&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">}</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">}</span>
</span></span></code></pre></div><blockquote>
<p><strong>ملاحظة:</strong> هذا المثال البرمجي يوضح الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (<code>input/sample.xlsx</code>, <code>output/</code>) لتتناسب مع المواقع الفعلية لديك، وتحقق من أن جميع الاعتمادات المطلوبة مثبتة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى <a href="https://docs.groupdocs.cloud/conversion/">الوثائق الرسمية</a> أو التواصل مع <a href="https://forum.groupdocs.cloud/c/conversion/11">فريق الدعم</a> للحصول على المساعدة.</p>
</blockquote>
<h2 id="تحويل-excel-إلى-صورة-باستخدام-curl">تحويل Excel إلى صورة باستخدام cURL</h2>
<p>توضح أوامر cURL التالية كيفية إجراء نفس تحويل XLSX إلى JPG باستخدام REST API. استبدل القيم النائبة ببيانات الاعتماد الفعلية وأسماء الملفات الخاصة بك.</p>
<ol>
<li><strong>الحصول على رمز الوصول</strong>
<!--[CODE_SNIPPET_START]-->
</li>
</ol>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>curl -X POST <span style="color:#e6db74">&#34;https://api.groupdocs.cloud/v1.0/oauth/token&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -H <span style="color:#e6db74">&#34;Content-Type: application/json&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -d <span style="color:#e6db74">&#39;{&#34;client_id&#34;:&#34;YOUR_CLIENT_ID&#34;,&#34;client_secret&#34;:&#34;YOUR_CLIENT_SECRET&#34;}&#39;</span>
</span></span></code></pre></div><!--[CODE_SNIPPET_END]-->
<ol start="2">
<li><strong>تحميل ملف XLSX</strong>
<!--[CODE_SNIPPET_START]-->
</li>
</ol>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>curl -X POST <span style="color:#e6db74">&#34;https://api.groupdocs.cloud/v1.0/storage/file/upload&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -H <span style="color:#e6db74">&#34;Authorization: Bearer YOUR_ACCESS_TOKEN&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -F <span style="color:#e6db74">&#34;file=@sample.xlsx&#34;</span>
</span></span></code></pre></div><!--[CODE_SNIPPET_END]-->
<ol start="3">
<li><strong>بدء التحويل غير المتزامن</strong>
<!--[CODE_SNIPPET_START]-->
</li>
</ol>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>curl -X POST <span style="color:#e6db74">&#34;https://api.groupdocs.cloud/v1.0/conversion/convert&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -H <span style="color:#e6db74">&#34;Authorization: Bearer YOUR_ACCESS_TOKEN&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -H <span style="color:#e6db74">&#34;Content-Type: application/json&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -d <span style="color:#e6db74">&#39;{
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">           &#34;sourceFilePath&#34;: &#34;sample.xlsx&#34;,
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">           &#34;outputFormat&#34;: &#34;JPG&#34;,
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">           &#34;options&#34;: {
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">               &#34;resolution&#34;: 300,
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">               &#34;quality&#34;: 90,
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">               &#34;async&#34;: true
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">           }
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">         }&#39;</span>
</span></span></code></pre></div><!--[CODE_SNIPPET_END]-->
<ol start="4">
<li><strong>تحقق من حالة المهمة</strong> (استبدل <code>JOB_ID</code> بالقيمة التي تم إرجاعها من الخطوة السابقة)</li>
</ol>
<!--[CODE_SNIPPET_START]-->
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>curl -X GET <span style="color:#e6db74">&#34;https://api.groupdocs.cloud/v1.0/conversion/jobs/JOB_ID/status&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -H <span style="color:#e6db74">&#34;Authorization: Bearer YOUR_ACCESS_TOKEN&#34;</span>
</span></span></code></pre></div><!--[CODE_SNIPPET_END]-->
<ol start="5">
<li><strong>تنزيل ملفات JPG الناتجة</strong></li>
</ol>
<!--[CODE_SNIPPET_START]-->
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>curl -X GET <span style="color:#e6db74">&#34;https://api.groupdocs.cloud/v1.0/conversion/jobs/JOB_ID/result&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -H <span style="color:#e6db74">&#34;Authorization: Bearer YOUR_ACCESS_TOKEN&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>     -o output.zip
</span></span></code></pre></div><!--[CODE_SNIPPET_END]-->
<p>للحصول على قائمة كاملة بالمعلمات، راجع <a href="https://reference.groupdocs.cloud/conversion/">الوثائق الرسمية لواجهة برمجة التطبيقات</a>.</p>
<h2 id="تثبيت-وتكوين-groupdocsconversion-cloud-sdk-for-java">تثبيت وتكوين GroupDocs.Conversion Cloud SDK for Java</h2>
<p>أضف SDK إلى مشروعك باستخدام Maven، ثم قم بتكوين بيانات اعتماد العميل الخاصة بك.</p>
<!--[CODE_SNIPPET_START]-->
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#75715e"># Add the dependency (already shown in the Steps section)</span>
</span></span><span style="display:flex;"><span>mvn install com.groupdocs:groupdocs-conversion-cloud
</span></span></code></pre></div><!--[CODE_SNIPPET_END]-->
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#75715e">// Example configuration (same as in the Steps section)
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>Configuration config <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> Configuration<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>config<span style="color:#f92672">.</span><span style="color:#a6e22e">setClientId</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;YOUR_CLIENT_ID&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>config<span style="color:#f92672">.</span><span style="color:#a6e22e">setClientSecret</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;YOUR_CLIENT_SECRET&#34;</span><span style="color:#f92672">);</span>
</span></span></code></pre></div><p>يمكنك تنزيل أحدث ملفات JAR من <a href="https://releases.groupdocs.cloud/conversion/java/">صفحة التحميل</a>.</p>
<h2 id="خيارات-التحويل-من-xlsx-إلى-jpg">خيارات التحويل من XLSX إلى JPG</h2>
<p>تتيح لك عدة خيارات ضبط الصور المُولَّدة بدقة.</p>
<table>
<thead>
<tr>
<th>الخيار</th>
<th>الوصف</th>
<th>مثال</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>الدقة</strong></td>
<td>دقة الصورة (DPI) الناتجة. القيم الأعلى تحسن الجودة ولكنها تزيد حجم الملف.</td>
<td><code>jpgOpts.setResolution(300);</code></td>
</tr>
<tr>
<td><strong>الجودة</strong></td>
<td><a href="https://docs.fileformat.com/image/jpeg/">JPEG</a> مستوى ضغط (0‑100).</td>
<td><code>jpgOpts.setQuality(90);</code></td>
</tr>
<tr>
<td><strong>نطاق الصفحات</strong></td>
<td>تحويل أوراق العمل المحددة فقط.</td>
<td><code>jpgOpts.setPageRange(&quot;1-3&quot;);</code></td>
</tr>
<tr>
<td><strong>غير متزامن</strong></td>
<td>تشغيل التحويل في الخلفية والاستعلام عن الانتهاء.</td>
<td><code>jpgOpts.setAsync(true);</code></td>
</tr>
</tbody>
</table>
<p>كل خاصية هي جزء من <code>JpgConvertOptions</code> في SDK. راجع <a href="https://reference.groupdocs.cloud/conversion/">مرجع API</a> للحصول على القائمة الكاملة.</p>
<h2 id="تحسين-سرعة-التحويل-واستخدام-الذاكرة">تحسين سرعة التحويل واستخدام الذاكرة</h2>
<ol>
<li><strong>تدفق أوراق العمل</strong> - معالجة ورقة عمل واحدة في كل مرة عن طريق تمكين الوضع غير المتزامن؛ هذا يمنع تحميل المصنف بالكامل في الذاكرة.</li>
<li><strong>ضبط الدقة</strong> - استخدم أقل قيمة DPI مقبولة لحالتك؛ 150‑200 DPI غالبًا ما تكون كافية للمعاينات على الويب.</li>
<li><strong>طلبات الدفعات</strong> - عند تحويل العديد من الملفات، أرسلها في دفعات متوازية محدودة بقدرة وحدة المعالجة المركزية والشبكة في الخادم الخاص بك.</li>
<li><strong>إعادة استخدام ApiClient</strong> - أنشئ نسخة واحدة من <code>ConversionApi</code> وأعد استخدامها عبر تحويلات متعددة لتجنب عبء المصادقة المتكرر.</li>
</ol>
<p>يمكن أن يؤدي تطبيق هذه النصائح إلى تقليل وقت التحويل بنسبة تصل إلى 40 % لملفات Excel الكبيرة.</p>
<h2 id="الخلاصة">الخلاصة</h2>
<p>تحويل XLSX إلى JPG في Java يصبح بسيطًا مع <a href="https://products.groupdocs.cloud/conversion/java/">GroupDocs.Conversion Cloud SDK for Java</a>. باتباع الخطوات المذكورة أعلاه، يمكنك تصيير كل ورقة عمل كصورة JPG عالية الجودة، والاستفادة من المعالجة غير المتزامنة لتحسين القابلية للتوسع، وتطبيق تحسينات الأداء على دفاتر العمل الكبيرة. تذكر الحصول على ترخيص مناسب للنشر في بيئة الإنتاج؛ تفاصيل التسعير متوفرة على صفحة المنتج، ويمكنك البدء بـ <a href="https://purchase.groupdocs.cloud/temporary-license/">رخصة مؤقتة</a> لتقييم المكتبة. دمج هذه القدرة في تطبيقاتك لتوفير معاينات بصرية سريعة لبيانات Excel دون الاعتماد على تثبيتات Office على جانب العميل.</p>
<h2 id="الأسئلة-الشائعة">الأسئلة الشائعة</h2>
<p><strong>كيف يمكنني إجراء تحويل XLSX إلى JPG في Java باستخدام GroupDocs؟</strong><br>
استخدم الفئة <code>ConversionApi</code> لتحميل ملف XLSX، واضبط <code>JpgConvertOptions</code> (الدقة، الجودة، غير المتزامن)، ثم استدعِ <code>convertDocument</code>. تُعيد SDK معرف وظيفة يمكنك الاستعلام عنه حتى تصبح ملفات JPG جاهزة.</p>
<p><strong>هل يمكنني تحويل دفاتر Excel الكبيرة دون نفاد الذاكرة؟</strong><br>
نعم. قم بتمكين التحويل غير المتزامن وتعيين دقة معقولة. يقوم SDK بمعالجة أوراق العمل بشكل متسلسل، مما يحافظ على انخفاض استهلاك الذاكرة.</p>
<p><strong>هل يتم دعم التحويل غير المتزامن من XLSX إلى JPG؟</strong><br>
توفر الـ SDK علامة <code>async</code> في <code>JpgConvertOptions</code>. عند تعيينها إلى <code>true</code>، تُعيد الـ API معرف وظيفة (job ID)، مما يتيح لك التحقق من الحالة وتنزيل النتائج لاحقًا.</p>
<p><strong>هل أحتاج إلى ترخيص خاص لاستخدام ميزات التحويل في الإنتاج؟</strong><br>
يتطلب الاستخدام في الإنتاج ترخيصًا صالحًا لـ GroupDocs.Conversion Cloud. يمكنك البدء بترخيص مؤقت من صفحة <a href="https://purchase.groupdocs.cloud/temporary-license/">صفحة الترخيص المؤقت</a> قبل شراء اشتراك كامل.</p>
<h2 id="اقرأ-المزيد">اقرأ المزيد</h2>
<ul>
<li><a href="https://blog.groupdocs.cloud/ar/conversion/step-by-step-tutorial-docx-to-pdf-conversion-in-java/">دليل خطوة بخطوة - تحويل DOCX إلى PDF في Java</a></li>
<li><a href="https://blog.groupdocs.cloud/ar/conversion/convert-mpp-to-excel-in-java/">تحويل MPP إلى Excel باستخدام Java REST API - تحويل سهل من MPP إلى XLSX</a></li>
<li><a href="https://blog.groupdocs.cloud/ar/conversion/convert-word-to-jpg-using-java/">تحويل Word إلى JPG في Java - تحويل DOCX إلى JPG باستخدام Java REST API</a></li>
</ul>
]]></content:encoded>
    </item>
    
  </channel>
</rss>
