<?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/fa/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>fa</language>
    <lastBuildDate>Fri, 17 Jul 2026 09:43:13 +0000</lastBuildDate><atom:link href="https://blog-qa.groupdocs.cloud/fa/tag/java-xlsx-to-jpg/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>آموزش تبدیل XLSX به JPG در جاوا</title>
      <link>https://blog-qa.groupdocs.cloud/fa/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/fa/conversion/xlsx-to-jpg-conversion-tutorial-in-java/</guid>
      <description>فایل‌های XLSX را به تصاویر JPG در Java با GroupDocs.Conversion Cloud SDK تبدیل کنید. راهنمای گام به گام را با پشتیبانی از async و نکات عملکردی دنبال کنید.</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-در-جاوا">مراحل تبدیل XLSX به JPG در جاوا</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> را با اعتبارهای مشتری خود ایجاد کنید.
<!--[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.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/">مستندات رسمی API</a> مراجعه کنید.</p>
<h2 id="نصب-و-پیکربندی-groupdocsconversion-cloud-sdk-for-java">نصب و پیکربندی GroupDocs.Conversion Cloud SDK for Java</h2>
<p>SDK را با Maven به پروژه خود اضافه کنید، سپس اعتبارهای مشتری خود را پیکربندی کنید.</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-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><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>Resolution</strong></td>
<td>DPI تصویر خروجی. مقادیر بالاتر کیفیت را بهبود می‌بخشند اما حجم فایل را افزایش می‌دهند.</td>
<td><code>jpgOpts.setResolution(300);</code></td>
</tr>
<tr>
<td><strong>Quality</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>Page Range</strong></td>
<td>فقط ورق‌های کاری خاص را تبدیل کنید.</td>
<td><code>jpgOpts.setPageRange(&quot;1-3&quot;);</code></td>
</tr>
<tr>
<td><strong>Async</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>Stream Worksheets</strong> - پردازش یک worksheet در هر بار با فعال‌سازی حالت async؛ این کار از بارگذاری کل workbook در حافظه جلوگیری می‌کند.</li>
<li><strong>Adjust Resolution</strong> - استفاده از کمترین DPI قابل قبول برای مورد استفاده شما؛ 150‑200 DPI معمولاً برای پیش‌نمایش‌های وب کافی است.</li>
<li><strong>Batch Requests</strong> - هنگام تبدیل تعداد زیادی فایل، آن‌ها را در دسته‌های موازی ارسال کنید که توسط ظرفیت CPU و شبکه سرور شما محدود می‌شود.</li>
<li><strong>Reuse ApiClient</strong> - یک نمونهٔ <code>ConversionApi</code> ایجاد کنید و آن را در تبدیل‌های متعدد مجدداً استفاده کنید تا از هزینهٔ مکرر احراز هویت جلوگیری شود.</li>
</ol>
<p>اعمال این نکات می‌تواند زمان تبدیل را برای فایل‌های بزرگ اکسل تا ۴۰ % کاهش دهد.</p>
<h2 id="نتیجهگیری">نتیجه‌گیری</h2>
<p>تبدیل XLSX به JPG در جاوا به‌سادگی انجام می‌شود با <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> برای ارزیابی کتابخانه شروع کنید. این قابلیت را در برنامه‌های خود یکپارچه کنید تا پیش‌نمایش‌های بصری سریع از داده‌های اکسل بدون نیاز به نصب‌های Office در سمت کلاینت فراهم کنید.</p>
<h2 id="سوالات-متداول">سوالات متداول</h2>
<p><strong>چگونه می‌توانم تبدیل XLSX به JPG را در جاوا با استفاده از GroupDocs انجام دهم؟</strong><br>
از کلاس <code>ConversionApi</code> برای بارگذاری یک فایل XLSX استفاده کنید، <code>JpgConvertOptions</code> را تنظیم کنید (رزولوشن، کیفیت، async) و متد <code>convertDocument</code> را فراخوانی کنید. SDK یک شناسه کار (job ID) برمی‌گرداند که می‌توانید تا زمانی که فایل‌های 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/fa/conversion/step-by-step-tutorial-docx-to-pdf-conversion-in-java/">آموزش گام به گام - تبدیل DOCX به PDF در جاوا</a></li>
<li><a href="https://blog.groupdocs.cloud/fa/conversion/convert-mpp-to-excel-in-java/">تبدیل MPP به Excel با استفاده از Java REST API - تبدیل آسان MPP به XLSX</a></li>
<li><a href="https://blog.groupdocs.cloud/fa/conversion/convert-word-to-jpg-using-java/">تبدیل Word به JPG در جاوا - تبدیل DOCX به JPG با استفاده از Java REST API</a></li>
</ul>
]]></content:encoded>
    </item>
    
  </channel>
</rss>
