DOCX4J - Java SDK منبع باز برای کار با فایل های DOC و DOCX
Java API منبع باز رایگان و قدرتمند برای ایجاد، ویرایش و تبدیل اسناد DOC و DOCX.
Docx4J API برای جاوا چیست؟
Docx4J یک API جاوا منبع باز است که برای دستکاری اسناد Microsoft Word در قالب DOCX طراحی شده است. Docx4J که بر روی استاندارد Open XML ساخته شده است، به توسعه دهندگان جاوا اجازه می دهد بدون اتکا به مایکروسافت آفیس اسناد Word را به صورت برنامه ریزی شده ایجاد، اصلاح و تولید کنند. با پشتیبانی از مدیریت عناصر پیچیده مانند جداول، تصاویر، سرصفحه ها، پاورقی ها و موارد دیگر، پردازش یکپارچه سند را در موارد مختلف، از جمله تولید گزارش خودکار، تبدیل سند، و ایجاد سند مبتنی بر الگو، امکان پذیر می کند. API به خوبی با JAXB ادغام می شود و یک رویکرد کارآمد برای کار با ساختارهای اسناد مبتنی بر XML ارائه می دهد.
DOCX4J برای Java API - ویژگی های کلیدی
برخی از ویژگی های اصلی Docx4J API در زیر آمده است:
- ایجاد و اصلاح سند: Docx4J به توسعهدهندگان اجازه میدهد تا فایلهای DOCX جدید را از ابتدا ایجاد کنند و همچنین فایلهای موجود را با افزودن یا تغییر متن، تصاویر، جداول و عناصر دیگر اصلاح کنند.
- پشتیبانی از فرمت XML باز: از آنجایی که DOCX مبتنی بر استاندارد Open XML است، Docx4J راهی برای کار مستقیم با XML زیرین اسناد Word ارائه میکند و کنترل دقیقی بر محتوای سند ارائه میدهد.
- بررسی عناصر پیچیده سند: API از عناصر مختلف سند مانند سرصفحه ها و پاورقی ها، پاراگراف ها، بخش ها، فهرست ها، جداول، تصاویر، لینک ها و پاورقی ها پشتیبانی می کند.
- سبکها و قالببندی: Docx4J به توسعهدهندگان امکان میدهد تا سبکها و قالببندیهای سفارشی را در متن، پاراگرافها و سایر عناصر داخل سند، از جمله فونتها، رنگها و تراز، اعمال کنند.
- تولید سند مبتنی بر الگو: از استفاده از الگوهای DOCX پشتیبانی میکند و به توسعهدهندگان اجازه میدهد محتوای پویا را با پر کردن مکانها در قالبهای از قبل موجود ایجاد کنند.
- تبدیل سند: API قابلیتهایی را برای تبدیل اسناد DOCX به فرمتهای دیگر، مانند PDF، HTML، و تصاویر (مانند PNG)، با استفاده از کتابخانهها یا قالبهای دیگر ارائه میدهد.
- پشتیبانی از امضاهای دیجیتال: Docx4J امکان جاسازی و اعتبارسنجی امضاهای دیجیتال را در اسناد DOCX میدهد و یک لایه امنیتی و احراز هویت اضافه میکند.
- ادغام JAXB: از آنجایی که Docx4J حول JAXB (معماری جاوا برای صحافی XML) ساخته شده است، روشی یکپارچه برای مارشال و حذف محتوای XML ارائه میکند و دستکاری بخشهای سند را به صورت برنامهریزی آسانتر میکند.
- دستکاری فراداده: API کار با ابردادههای سند، مانند اطلاعات نویسنده، ویژگیهای سند، و سابقه بازبینی را امکانپذیر میکند.
- ادغام و تقسیم اسناد: Docx4J شامل ویژگیهایی برای ادغام چندین سند Word در یک سند یا تقسیم یک سند به بخشهای جداگانه بر اساس بخشها یا صفحات است.
- ردیابی تغییرات: از مدیریت اسناد با فعال بودن «تغییرات ردیابی» پشتیبانی میکند و به شما امکان بازرسی یا مدیریت بازبینیها را میدهد.
شروع به کار با DocX4J برای Java API
برای شروع کار با Docx4J API، ابتدا باید API را در پروژه جاوا خود نصب کنید.
نصب و راه اندازی
برای نصب Docx4J، باید وابستگی آن را با استفاده از Maven به پروژه خود اضافه کنید:
<groupId>org.docx4j</groupId> <artifactId>docx4j-JAXB-Internal</artifactId> <version>8.0.0</version> </dependency> <dependency> <groupId>org.docx4j</groupId> <artifactId>docx4j-JAXB-ReferenceImpl</artifactId> <version>8.0.0</version> </dependency> <dependency> <groupId>org.docx4j</groupId> <artifactId>docx4j-JAXB-MOXy</artifactId> <version>8.0.0</version> </dependency>نمونه کد برای Docx4J API برای جاوا
DocX یک API قدرتمند است که ویژگی های غنی را برای کار با ویژگی های Document فراهم می کند. در این بخش میتوانید نمونههای C# برای ایجاد سند Word، بهروزرسانی فایل DOCX موجود، درج سربرگ و پاورقی در سند و کار با تصاویر را بیابید.
چگونه یک فایل DOCX خالی با استفاده از DocX4J API برای جاوا ایجاد کنیم؟
می توانید با استفاده از DocX4J API یک سند DOCX خالی ایجاد کنید. سپس می توان آن را به عنوان فایل DOCX در قالب Microsoft Word 2007+ در دیسک ذخیره کرد، همانطور که در نمونه کد زیر نشان داده شده است:
چگونه یک فایل DOCX موجود را در جاوا باز کنیم و آن را در جاوا تغییر دهیم؟
می توانید یک فایل DOCX موجود را با استفاده از DocX4J API بخوانید و محتویات آن را به روز کنید. هنگامی که تغییرات خود را انجام دادید، می توانید سند را در دیسکی مشابه گزینه "ذخیره به عنوان" موجود در Microsoft Word ذخیره کنید.
چگونه هدر و پاورقی را به سند Word در جاوا اضافه کنیم؟
DocX4J API به شما امکان می دهد سرصفحه و پاورقی را از داخل برنامه جاوا به سند Word اضافه کنید. همانطور که در نمونه کد زیر نشان داده شده است می توانید هدر را به فایل Word اضافه کنید، محتویات آن را تغییر دهید، فوتر اضافه کنید و محتوای آن را به روز کنید.
چگونه تصویر را در یک فایل Word DOCX در جاوا وارد کنیم؟
اگر میخواهید با استفاده از جاوا تصویری را در فایل Word DOCX وارد کنید، DocX4J API به توسعهدهندگان جاوا اجازه میدهد تا تصاویر جاسازیشده در اسناد Word DOCX را به صورت برنامهنویسی دستکاری کنند. نمونه کد زیر نحوه درج یک تصویر در فایل DOCX در جاوا را نشان می دهد.
نتیجه گیری
Docx4J یک API جاوا قدرتمند و همه کاره است که به توسعه دهندگان اجازه می دهد اسناد DOCX را به صورت برنامه نویسی ایجاد، دستکاری و مدیریت کنند. ادغام عمیق آن با فرمت Open XML کنترل دقیقی بر عناصر سند مانند متن، جداول، تصاویر، سرصفحه ها، پاورقی ها و ابرداده ها را امکان پذیر می کند. Docx4J با پشتیبانی داخلی برای تبدیل سند، سبکسازی، امضای دیجیتال و مدیریت عناصر پیچیده، راهحلی جامع برای طیف وسیعی از وظایف مرتبط با سند ارائه میکند. چه در حال تولید گزارشهای پویا، تغییر اسناد Word موجود یا تبدیل فرمتها باشید، Docx4J انعطافپذیری و عملکرد مورد نیاز برای کار مؤثر با اسناد Word در برنامههای جاوا را ارائه میدهد.