<?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 word editing on Document Processing REST APIs | GroupDocs Cloud</title>
    <link>https://blog-qa.groupdocs.cloud/fa/tag/java-word-editing/</link>
    <description>Recent content in java word editing on Document Processing REST APIs | GroupDocs Cloud</description>
    <generator>Hugo -- gohugo.io</generator>
    <language>fa</language>
    <lastBuildDate>Mon, 28 Sep 2026 16:09:16 +0000</lastBuildDate><atom:link href="https://blog-qa.groupdocs.cloud/fa/tag/java-word-editing/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>ویرایش اسناد Word در Java</title>
      <link>https://blog-qa.groupdocs.cloud/fa/editor/edit-word-documents-in-java/</link>
      <pubDate>Mon, 28 Sep 2026 16:09:16 +0000</pubDate>
      
      <guid>https://blog-qa.groupdocs.cloud/fa/editor/edit-word-documents-in-java/</guid>
      <description>نحوه ویرایش اسناد Word در Java را با GroupDocs.Editor Cloud SDK بیاموزید. این راهنما یکپارچه‌سازی REST API، یک مثال کامل کد و نکات عملکردی را ارائه می‌دهد.</description>
      <content:encoded><![CDATA[<p>ویرایش فایل‌های Microsoft Word به‌صورت از راه دور یک چالش رایج هنگام ساخت برنامه‌های Java مشترک است. <a href="https://products.groupdocs.cloud/editor/java/">GroupDocs.Editor Cloud SDK for Java</a> کتابخانه‌ای قدرتمند مبتنی بر REST ارائه می‌دهد که به شما امکان می‌دهد اسناد Word را در Java و بدون نیاز به پردازش فایل به‌صورت دستی ویرایش کنید. در این راهنما خواهید آموخت که چگونه احراز هویت کنید، متن را جایگزین کنید، نقطه انتهایی ویرایش را فراخوانی کنید و نسخه به‌روز شدهٔ <a href="https://docs.fileformat.com/word-processing/docx/">DOCX</a> را دانلود کنید، همه اینها با مثال‌های کد واضح و نکات عملکردی.</p>
<h2 id="نحوه-ویرایش-اسناد-word-در-java---گام-به-گام">نحوه ویرایش اسناد Word در Java - گام به گام</h2>
<ol>
<li><strong>پیکربندی کلاینت API با اعتبارهای خود</strong>: یک شیء <code>Configuration</code> ایجاد کنید، <code>clientId</code>، <code>clientSecret</code> و URL پایه را تنظیم کنید، سپس <code>ApiClient</code> و APIهای مورد نیاز را نمونه‌سازی کنید.</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>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>config<span style="color:#f92672">.</span><span style="color:#a6e22e">setBaseUrl</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;https://api.groupdocs.cloud&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>ApiClient apiClient <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>EditorApi editorApi <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> EditorApi<span style="color:#f92672">(</span>apiClient<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>FilesApi filesApi <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> FilesApi<span style="color:#f92672">(</span>apiClient<span style="color:#f92672">);</span>
</span></span></code></pre></div><ol start="2">
<li><strong>آماده‌سازی FileInfo برای DOCX منبع</strong>: مسیر فایل ورودی ذخیره‌شده در GroupDocs Cloud storage را تعریف کنید.</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>FileInfo fileInfo <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> FileInfo<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>fileInfo<span style="color:#f92672">.</span><span style="color:#a6e22e">setFilePath</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;input.docx&#34;</span><span style="color:#f92672">);</span>
</span></span></code></pre></div><ol start="3">
<li><strong>تعریف عملیات ReplaceText</strong>: یک نمونه <code>ReplaceText</code> ایجاد کنید با متنی که می‌خواهید جایگزین کنید و آن را به یک لیست اضافه کنید.</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>ReplaceText replace <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> ReplaceText<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>replace<span style="color:#f92672">.</span><span style="color:#a6e22e">setOldValue</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;Hello&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>replace<span style="color:#f92672">.</span><span style="color:#a6e22e">setNewValue</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;Hi&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>List<span style="color:#f92672">&lt;</span>ReplaceText<span style="color:#f92672">&gt;</span> replaceList <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> ArrayList<span style="color:#f92672">&lt;&gt;();</span>
</span></span><span style="display:flex;"><span>replaceList<span style="color:#f92672">.</span><span style="color:#a6e22e">add</span><span style="color:#f92672">(</span>replace<span style="color:#f92672">);</span>
</span></span></code></pre></div><ol start="4">
<li><strong>ساخت EditDocumentOptions و فراخوانی editDocument</strong>: ترکیب اطلاعات فایل، گزینه‌های ویرایش و تنظیمات خروجی، سپس فراخوانی متد <code>editDocument</code>. این گام اصلی است که در آن واقعاً اسناد Word را در Java ویرایش می‌کنید.</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>EditOptions editOptions <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> EditOptions<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>editOptions<span style="color:#f92672">.</span><span style="color:#a6e22e">setReplaceText</span><span style="color:#f92672">(</span>replaceList<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>EditDocumentOptions options <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> EditDocumentOptions<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>options<span style="color:#f92672">.</span><span style="color:#a6e22e">setFileInfo</span><span style="color:#f92672">(</span>fileInfo<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>options<span style="color:#f92672">.</span><span style="color:#a6e22e">setOutputPath</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;output.docx&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>options<span style="color:#f92672">.</span><span style="color:#a6e22e">setFormat</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;docx&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>options<span style="color:#f92672">.</span><span style="color:#a6e22e">setEditOptions</span><span style="color:#f92672">(</span>editOptions<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>EditDocumentRequest editRequest <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> EditDocumentRequest<span style="color:#f92672">(</span>options<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>EditDocumentResult editResult <span style="color:#f92672">=</span> editorApi<span style="color:#f92672">.</span><span style="color:#a6e22e">editDocument</span><span style="color:#f92672">(</span>editRequest<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;Document edited. Document ID: &#34;</span> <span style="color:#f92672">+</span> editResult<span style="color:#f92672">.</span><span style="color:#a6e22e">getDocumentId</span><span style="color:#f92672">());</span>
</span></span></code></pre></div><ol start="5">
<li><strong>دانلود فایل DOCX ویرایش‌شده</strong>: برای بازیابی فایل ویرایش‌شده از ذخیره‌سازی ابری از <code>FilesApi</code> استفاده کنید.</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>DownloadFileRequest downloadRequest <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> DownloadFileRequest<span style="color:#f92672">(</span><span style="color:#e6db74">&#34;output.docx&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>InputStream inputStream <span style="color:#f92672">=</span> filesApi<span style="color:#f92672">.</span><span style="color:#a6e22e">downloadFile</span><span style="color:#f92672">(</span>downloadRequest<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">try</span> <span style="color:#f92672">(</span>FileOutputStream outputStream <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> FileOutputStream<span style="color:#f92672">(</span><span style="color:#e6db74">&#34;downloaded_output.docx&#34;</span><span style="color:#f92672">))</span> <span style="color:#f92672">{</span>
</span></span><span style="display:flex;"><span>    <span style="color:#66d9ef">byte</span><span style="color:#f92672">[]</span> buffer <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> <span style="color:#66d9ef">byte</span><span style="color:#f92672">[</span>8192<span style="color:#f92672">];</span>
</span></span><span style="display:flex;"><span>    <span style="color:#66d9ef">int</span> bytesRead<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span>    <span style="color:#66d9ef">while</span> <span style="color:#f92672">((</span>bytesRead <span style="color:#f92672">=</span> inputStream<span style="color:#f92672">.</span><span style="color:#a6e22e">read</span><span style="color:#f92672">(</span>buffer<span style="color:#f92672">))</span> <span style="color:#f92672">!=</span> <span style="color:#f92672">-</span>1<span style="color:#f92672">)</span> <span style="color:#f92672">{</span>
</span></span><span style="display:flex;"><span>        outputStream<span style="color:#f92672">.</span><span style="color:#a6e22e">write</span><span style="color:#f92672">(</span>buffer<span style="color:#f92672">,</span> 0<span style="color:#f92672">,</span> bytesRead<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><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;Edited document downloaded as downloaded_output.docx&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">}</span>
</span></span></code></pre></div><p>برای اطلاعات دقیق درباره کلاس‌ها، به صفحه مرجع <a href="https://reference.groupdocs.cloud/editor/">EditorApi</a> مراجعه کنید.</p>
<h2 id="مثال-کامل-عملی-برای-ویرایش-اسناد-word-در-java">مثال کامل عملی برای ویرایش اسناد Word در Java</h2>
<p>مثال زیر نشان می‌دهد که چگونه می‌توان یک فایل DOCX را با جایگزینی متن با استفاده از GroupDocs.Editor Cloud SDK for Java ویرایش کرد.</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">import</span> com.groupdocs.editor.cloud.api.EditorApi<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.editor.cloud.api.FilesApi<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.editor.cloud.client.ApiClient<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.editor.cloud.client.ApiException<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.editor.cloud.client.Configuration<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.editor.cloud.model.EditDocumentOptions<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.editor.cloud.model.EditDocumentResult<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.editor.cloud.model.EditOptions<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.editor.cloud.model.FileInfo<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.editor.cloud.model.ReplaceText<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.editor.cloud.model.requests.EditDocumentRequest<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> com.groupdocs.editor.cloud.model.requests.DownloadFileRequest<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.FileOutputStream<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> java.io.IOException<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> java.io.InputStream<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> java.util.ArrayList<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span><span style="color:#f92672">import</span> java.util.List<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">GroupDocsEditorExample</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:#f92672">{</span>
</span></span><span style="display:flex;"><span>        <span style="color:#75715e">// Configuration – replace with your actual credentials
</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>        config<span style="color:#f92672">.</span><span style="color:#a6e22e">setBaseUrl</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;https://api.groupdocs.cloud&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>ApiClient apiClient <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>        EditorApi editorApi <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> EditorApi<span style="color:#f92672">(</span>apiClient<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>        FilesApi filesApi <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> FilesApi<span style="color:#f92672">(</span>apiClient<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e">// Input and output file paths in the cloud storage
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>        String inputPath <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;input.docx&#34;</span><span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span>        String outputPath <span style="color:#f92672">=</span> <span style="color:#e6db74">&#34;output.docx&#34;</span><span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#66d9ef">try</span> <span style="color:#f92672">{</span>
</span></span><span style="display:flex;"><span>            <span style="color:#75715e">// Prepare file information
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>            FileInfo fileInfo <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> FileInfo<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>            fileInfo<span style="color:#f92672">.</span><span style="color:#a6e22e">setFilePath</span><span style="color:#f92672">(</span>inputPath<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e">// Define replace text operation
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>            ReplaceText replace <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> ReplaceText<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>            replace<span style="color:#f92672">.</span><span style="color:#a6e22e">setOldValue</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;Hello&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>            replace<span style="color:#f92672">.</span><span style="color:#a6e22e">setNewValue</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;Hi&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>            List<span style="color:#f92672">&lt;</span>ReplaceText<span style="color:#f92672">&gt;</span> replaceList <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> ArrayList<span style="color:#f92672">&lt;&gt;();</span>
</span></span><span style="display:flex;"><span>            replaceList<span style="color:#f92672">.</span><span style="color:#a6e22e">add</span><span style="color:#f92672">(</span>replace<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e">// Set edit options
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>            EditOptions editOptions <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> EditOptions<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>            editOptions<span style="color:#f92672">.</span><span style="color:#a6e22e">setReplaceText</span><span style="color:#f92672">(</span>replaceList<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e">// Build edit document options
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>            EditDocumentOptions options <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> EditDocumentOptions<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>            options<span style="color:#f92672">.</span><span style="color:#a6e22e">setFileInfo</span><span style="color:#f92672">(</span>fileInfo<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>            options<span style="color:#f92672">.</span><span style="color:#a6e22e">setOutputPath</span><span style="color:#f92672">(</span>outputPath<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>            options<span style="color:#f92672">.</span><span style="color:#a6e22e">setFormat</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;docx&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>            options<span style="color:#f92672">.</span><span style="color:#a6e22e">setEditOptions</span><span style="color:#f92672">(</span>editOptions<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e">// Execute edit operation
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>            EditDocumentRequest editRequest <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> EditDocumentRequest<span style="color:#f92672">(</span>options<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>            EditDocumentResult editResult <span style="color:#f92672">=</span> editorApi<span style="color:#f92672">.</span><span style="color:#a6e22e">editDocument</span><span style="color:#f92672">(</span>editRequest<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;Document edited. Document ID: &#34;</span> <span style="color:#f92672">+</span> editResult<span style="color:#f92672">.</span><span style="color:#a6e22e">getDocumentId</span><span style="color:#f92672">());</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#75715e">// Download the edited document
</span></span></span><span style="display:flex;"><span><span style="color:#75715e"></span>            DownloadFileRequest downloadRequest <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> DownloadFileRequest<span style="color:#f92672">(</span>outputPath<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>            InputStream inputStream <span style="color:#f92672">=</span> filesApi<span style="color:#f92672">.</span><span style="color:#a6e22e">downloadFile</span><span style="color:#f92672">(</span>downloadRequest<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>            <span style="color:#66d9ef">try</span> <span style="color:#f92672">(</span>FileOutputStream outputStream <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> FileOutputStream<span style="color:#f92672">(</span><span style="color:#e6db74">&#34;downloaded_output.docx&#34;</span><span style="color:#f92672">))</span> <span style="color:#f92672">{</span>
</span></span><span style="display:flex;"><span>                <span style="color:#66d9ef">byte</span><span style="color:#f92672">[]</span> buffer <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> <span style="color:#66d9ef">byte</span><span style="color:#f92672">[</span>8192<span style="color:#f92672">];</span>
</span></span><span style="display:flex;"><span>                <span style="color:#66d9ef">int</span> bytesRead<span style="color:#f92672">;</span>
</span></span><span style="display:flex;"><span>                <span style="color:#66d9ef">while</span> <span style="color:#f92672">((</span>bytesRead <span style="color:#f92672">=</span> inputStream<span style="color:#f92672">.</span><span style="color:#a6e22e">read</span><span style="color:#f92672">(</span>buffer<span style="color:#f92672">))</span> <span style="color:#f92672">!=</span> <span style="color:#f92672">-</span>1<span style="color:#f92672">)</span> <span style="color:#f92672">{</span>
</span></span><span style="display:flex;"><span>                    outputStream<span style="color:#f92672">.</span><span style="color:#a6e22e">write</span><span style="color:#f92672">(</span>buffer<span style="color:#f92672">,</span> 0<span style="color:#f92672">,</span> bytesRead<span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><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;Edited document downloaded as downloaded_output.docx&#34;</span><span style="color:#f92672">);</span>
</span></span><span style="display:flex;"><span>            <span style="color:#f92672">}</span> <span style="color:#66d9ef">finally</span> <span style="color:#f92672">{</span>
</span></span><span style="display:flex;"><span>                <span style="color:#66d9ef">if</span> <span style="color:#f92672">(</span>inputStream <span style="color:#f92672">!=</span> <span style="color:#66d9ef">null</span><span style="color:#f92672">)</span> <span style="color:#f92672">{</span>
</span></span><span style="display:flex;"><span>                    inputStream<span style="color:#f92672">.</span><span style="color:#a6e22e">close</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><span style="display:flex;"><span>        <span style="color:#f92672">}</span> <span style="color:#66d9ef">catch</span> <span style="color:#f92672">(</span>ApiException apiEx<span style="color:#f92672">)</span> <span style="color:#f92672">{</span>
</span></span><span style="display:flex;"><span>            System<span style="color:#f92672">.</span><span style="color:#a6e22e">err</span><span style="color:#f92672">.</span><span style="color:#a6e22e">println</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;API error: &#34;</span> <span style="color:#f92672">+</span> apiEx<span style="color:#f92672">.</span><span style="color:#a6e22e">getMessage</span><span style="color:#f92672">());</span>
</span></span><span style="display:flex;"><span>        <span style="color:#f92672">}</span> <span style="color:#66d9ef">catch</span> <span style="color:#f92672">(</span>IOException ioEx<span style="color:#f92672">)</span> <span style="color:#f92672">{</span>
</span></span><span style="display:flex;"><span>            System<span style="color:#f92672">.</span><span style="color:#a6e22e">err</span><span style="color:#f92672">.</span><span style="color:#a6e22e">println</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;IO error: &#34;</span> <span style="color:#f92672">+</span> ioEx<span style="color:#f92672">.</span><span style="color:#a6e22e">getMessage</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><span style="display:flex;"><span><span style="color:#f92672">}</span>
</span></span></code></pre></div><blockquote>
<p><strong>توجه:</strong> این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید که مسیرهای فایل و مقادیر پیکربندی را به‌گونه‌ای به‌روز کنید که با محیط واقعی شما مطابقت داشته باشد، اطمینان حاصل کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به <a href="https://docs.groupdocs.cloud/editor/">مستندات رسمی</a> مراجعه کنید یا برای دریافت کمک به <a href="https://forum.groupdocs.cloud/c/editor/20">تیم پشتیبانی</a> مراجعه کنید.</p>
</blockquote>
<h2 id="ویرایش-اسناد-word-از-طریق-rest-در-java-با-استفاده-از-curl">ویرایش اسناد Word از طریق REST در Java با استفاده از cURL</h2>
<p>در زیر یک جریان کاری cURL آورده شده است که همان عملیات جایگزینی متن را بدون نوشتن کد Java انجام می‌دهد. این برای تست سریع یا ادغام با سرویس‌های دیگر مفید است.</p>
<ol>
<li><strong>دریافت یک توکن دسترسی</strong> (مقادیر جایگزین را با اعتبارهای خود جایگزین کنید).</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/v2.0/oauth2/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/x-www-form-urlencoded&#34;</span> <span style="color:#ae81ff">\
</span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span>  -d <span style="color:#e6db74">&#34;grant_type=client_credentials&amp;client_id=YOUR_CLIENT_ID&amp;client_secret=YOUR_CLIENT_SECRET&#34;</span>
</span></span></code></pre></div><ol start="2">
<li><strong>بارگذاری DOCX منبع</strong> به ذخیره‌سازی ابری خود.</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 PUT <span style="color:#e6db74">&#34;https://api.groupdocs.cloud/v2.0/storage/file/input.docx&#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=@/path/to/local/input.docx&#34;</span>
</span></span></code></pre></div><ol start="3">
<li><strong>صدا زدن به نقطه انتهایی editDocument</strong> با یک بارگذاری <a href="https://docs.fileformat.com/web/json/">JSON</a> که عملیات جایگزینی را تعریف می‌کند.</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/v2.0/editor/edit/document&#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;fileInfo&#34;: { &#34;filePath&#34;: &#34;input.docx&#34; },
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">        &#34;outputPath&#34;: &#34;output.docx&#34;,
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">        &#34;format&#34;: &#34;docx&#34;,
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">        &#34;editOptions&#34;: {
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">            &#34;replaceText&#34;: [
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">                { &#34;oldValue&#34;: &#34;Hello&#34;, &#34;newValue&#34;: &#34;Hi&#34; }
</span></span></span><span style="display:flex;"><span><span style="color:#e6db74">            ]
</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><ol start="4">
<li><strong>فایل ویرایش‌شده را دانلود کنید</strong> پس از موفقیت عملیات.</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 GET <span style="color:#e6db74">&#34;https://api.groupdocs.cloud/v2.0/storage/file/output.docx&#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 downloaded_output.docx
</span></span></code></pre></div><p>برای مشاهدهٔ مشخصات کامل REST، به <a href="https://reference.groupdocs.cloud/editor/">مرجع API</a> مراجعه کنید.</p>
<h2 id="نصب-و-پیکربندی-groupdocseditor-cloud-sdk-for-java">نصب و پیکربندی GroupDocs.Editor 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-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-editor-cloud<span style="color:#f92672">&lt;/artifactId&gt;</span>
</span></span><span style="display:flex;"><span>    <span style="color:#f92672">&lt;version&gt;</span>25.7<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><p>آخرین JARها را از <a href="https://releases.groupdocs.cloud/editor/java/">صفحه دانلود</a> دریافت کنید.<br>
اطمینان حاصل کنید که زمان اجرا (runtime) جاوا شما نسخه 8 یا بالاتر است و یک حساب معتبر GroupDocs Cloud با شناسه مشتری (client ID) و رمز (secret) دارید.</p>
<h2 id="ویژگیهای-کلیدی-groupdocseditor-cloud-sdk-for-java">ویژگی‌های کلیدی GroupDocs.Editor Cloud SDK for Java</h2>
<ul>
<li><strong>ویرایش کامل Word</strong> - متن، تصویر و جدول‌ها را در فرمت‌های DOCX، <a href="https://docs.fileformat.com/word-processing/doc/">DOC</a>، و <a href="https://docs.fileformat.com/word-processing/odt/">ODT</a> جایگزین کنید.</li>
<li><strong>یکپارچه‌سازی ذخیره‌سازی ابری</strong> - به‌صورت مستقیم با ذخیره‌سازی GroupDocs Cloud کار می‌کند و نیاز به مدیریت فایل‌های محلی را از بین می‌برد.</li>
<li><strong>پشتیبانی شده توسط REST API</strong> - تمام عملیات از طریق تماس‌های امن HTTP انجام می‌شود و برای معماری‌های میکروسرویس ایده‌آل است.</li>
<li><strong>دانلود استریمینگ</strong> - سندهای بزرگ به‌صورت استریم شده منتقل می‌شوند تا مصرف حافظه بالا جلوگیری شود.</li>
<li><strong>گزینه‌های قابل گسترش</strong> - رفتار ویرایش را با استفاده از <code>EditOptions</code> به‌دقت تنظیم کنید (مثلاً جایگزینی متن، حذف نظرات).</li>
</ul>
<p>برای جزئیات بیشتر، به <a href="https://docs.groupdocs.cloud/editor/">مستندات رسمی</a> مراجعه کنید.</p>
<h2 id="پیکربندی-گزینههای-ویرایش-سند">پیکربندی گزینه‌های ویرایش سند</h2>
<p>شیء <code>EditOptions</code> به شما امکان می‌دهد مشخص کنید چه تغییراتی اعمال شود. در مثال ما از <code>replaceText</code> استفاده کردیم، اما می‌توانید اقدامات دیگری مانند حذف نظرات یا به‌روزرسانی فیلدها را نیز پیکربندی کنید.</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>EditOptions editOptions <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> EditOptions<span style="color:#f92672">();</span>
</span></span><span style="display:flex;"><span>editOptions<span style="color:#f92672">.</span><span style="color:#a6e22e">setReplaceText</span><span style="color:#f92672">(</span>replaceList<span style="color:#f92672">);</span> <span style="color:#75715e">// replaceList defined earlier
</span></span></span></code></pre></div><p>گزینه‌های اضافی مانند <code>removeComments</code> یا <code>updateFields</code> در <a href="https://reference.groupdocs.cloud/editor/">مرجع API</a> مستند شده‌اند.</p>
<h2 id="ملاحظات-عملکرد-برای-ویرایش-word-از-طریق-rest">ملاحظات عملکرد برای ویرایش Word از طریق REST</h2>
<ul>
<li><strong>استفاده از استریمینگ</strong>: SDK محتوا را به صورت استریم می‌کند که مصرف heap را برای فایل‌های بزرگ DOCX کاهش می‌دهد.</li>
<li><strong>جایگزینی‌های دسته‌ای</strong>: ترکیب چندین شیء <code>ReplaceText</code> در یک درخواست برای جلوگیری از تماس‌های مکرر شبکه.</li>
<li><strong>نگه‌داشتن فایل‌ها در ابر</strong>: انجام عملیات ویرایش به‌صورت مستقیم روی فایل‌های ذخیره‌شده در ابر، هزینه بارگذاری و دانلود چندباره باینری‌های بزرگ را کاهش می‌دهد.</li>
<li><strong>استفاده مجدد از ApiClient</strong>: یک بار <code>ApiClient</code> را ایجاد کنید و برای چندین عملیات ویرایش مجدداً استفاده کنید تا از مزایای استخر اتصال بهره‌مند شوید.</li>
</ul>
<h2 id="نتیجهگیری">نتیجه‌گیری</h2>
<p>ویرایش اسناد Word در Java به‌سادگی با <a href="https://products.groupdocs.cloud/editor/java/">GroupDocs.Editor Cloud SDK for Java</a> امکان‌پذیر می‌شود. با دنبال کردن مراحل، مثال کد و جریان کاری cURL ارائه‌شده در اینجا، می‌توانید قابلیت‌های قدرتمند ویرایش سند را در هر سرویس بک‌اند Java یکپارچه کنید. به‌خاطر داشته باشید که اعتبارنامه‌های مشتری خود را ایمن کنید، با یک لایسنس موقت از <a href="https://purchase.groupdocs.cloud/temporary-license/">صفحه لایسنس موقت</a> آزمایش کنید و هنگام انتقال به محیط‌های زنده، به لایسنس تولیدی ارتقا دهید. برنامه‌نویسی خوش!</p>
<h2 id="سوالات-متداول">سوالات متداول</h2>
<ul>
<li>
<p><strong>چگونه می‌توانم اسناد Word را در Java با استفاده از یک REST API ویرایش کنم؟</strong><br>
از نقطه انتهایی editDocument در <a href="https://products.groupdocs.cloud/editor/java/">GroupDocs.Editor Cloud SDK for Java</a> استفاده کنید. یک payload JSON که عملیات جایگزینی را تعریف می‌کند ارسال کنید، و سرویس DOCX ویرایش‌شده را برمی‌گرداند.</p>
</li>
<li>
<p><strong>بهترین روش برای احراز هویت تماس‌ها به API ویرایشگر چیست؟</strong><br>
یک شیء <code>Configuration</code> با شناسه مشتری و رمز مشتری خود ایجاد کنید، سپس اجازه دهید SDK به‌طور خودکار یک توکن OAuth دریافت کند. برای جزئیات بیشتر به <a href="https://docs.groupdocs.cloud/editor/">مستندات رسمی</a> مراجعه کنید.</p>
</li>
<li>
<p><strong>آیا می‌توانم چندین جای‌دار را در یک درخواست جایگزین کنم؟</strong><br>
بله. چندین ورودی <code>ReplaceText</code> را به فهرست <code>replaceText</code> داخل <code>EditOptions</code> اضافه کنید. SDK تمام جایگزینی‌ها را در یک فراخوانی ویرایشی واحد پردازش می‌کند.</p>
</li>
<li>
<p><strong>آیا محدودیتی برای اندازهٔ فایل Word که می‌توانم ویرایش کنم وجود دارد؟</strong><br>
سرویس ابری می‌تواند فایل‌ها را تا چند صد مگابایت مدیریت کند، اما برای عملکرد بهینه، فایل‌ها را زیر ۱۰۰ مگابایت نگه دارید و برای جلوگیری از افزایش ناگهانی حافظه، از دانلود استریمینگ استفاده کنید.</p>
</li>
</ul>
<h2 id="بیشتر-بخوانید">بیشتر بخوانید</h2>
<ul>
<li><a href="https://blog.groupdocs.cloud/fa/editor/edit-word-documents-using-rest-api-in-node.js/">ویرایش اسناد Word با استفاده از REST API در Node.js</a></li>
<li><a href="https://blog.groupdocs.cloud/fa/editor/edit-word-or-excel-documents-using-rest-api/">ویرایش اسناد Word یا Excel با استفاده از REST API</a></li>
<li><a href="https://blog.groupdocs.cloud/fa/editor/edit-powerpoint-files-using-java-library/">ویرایش فایل‌های PowerPoint با استفاده از کتابخانه Java</a></li>
</ul>
]]></content:encoded>
    </item>
    
  </channel>
</rss>
