POI چیست و چه کاربردی در جاوا دارد؟

شنبه ۸ مهر ۱۴۰۲ | ۱۶:۴۴:۵۴

وبلاگ » مقالات جاوا »

۱۳۹۹/۱۰/۳۰ سه شنبه

(2)

(0)

POI چیست و چه کاربردی در جاوا دارد؟

چگونه فایل های آفیس را در جاوا دستکاری کنیم؟

POI یک API محبوب است که به برنامه نویسان اجازه می‌دهد تا با استفاده از برنامه هایی با زبان جاوا ، پرونده های MS Office را ایجاد، اصلاح و نمایش دهند. این ابزار یک کتابخانه منبع باز است که توسط بنیاد نرم افزار Apache برای طراحی یا اصلاح فایلهای Microsoft Office با استفاده از برنامه جاوا تهیه و توزیع شده است.

POI چیست و چه کاربردی دارد؟

بارها و بارها برای تولید گزارش در قالب فایل Microsoft Excel به یک برنامه نرم افزاری نیاز دارید. حتی گاهی اوقات انتظار می‌رود که یک برنامه، پرونده های اکسل را به عنوان داده ورودی دریافت کند. به عنوان مثال، یک برنامه کاربردی برای بخش مالی یک شرکت ایجاد شده است که باید تمام خروجی های‌ آنها را در Excel تولید کند. هر برنامه نویس جاوا که می‌خواهد پرونده های MS Office را به عنوان خروجی تولید کند، برای این کار باید از یک API از پیش تعریف شده و فقط خواندنی استفاده کند.

POI یک API محبوب است که به برنامه نویسان اجازه می‌دهد تا با استفاده از برنامه هایی با زبان جاوا، پرونده های MS Office را ایجاد، اصلاح و نمایش دهند. این ابزار یک کتابخانه منبع باز است که توسط بنیاد نرم افزار Apache برای طراحی یا اصلاح فایلهای Microsoft Office با استفاده از برنامه جاوا تهیه و توزیع شده است. این ابزار شامل کلاس ها و روش های رمزگشایی داده های ورودی کاربر یا یک پرونده برای اسناد MS Office است.

کاربرد POI در جاوا چیست؟

اجزای POI چیست؟

POI شامل کلاس ها و روش های کار بر روی تمام اسناد ترکیبی OLE2 MS Office است. لیست اجزای این API در زیر آورده شده است:

• POIFS (سیستم اجرای فایل نامشخص و نامفهوم ضعیف) - این مؤلفه، عامل اصلی سایر عناصر POI است. برای خواندن پرونده های مختلف استفاده می‌شود.
• HSSF (فرمت گسترده صفحه گسترده) - برای خواندن و نوشتن فرمت xls و پرونده های MS-Excel استفاده می‌شود.
• XSSF (فرمت صفحه گسترده XML) – این فرمت برای قالب فایل xlsx از MS-Excel استفاده می‌شود.
• HPSF (فرمت تنظیمات ویژگی نامطلوب) - برای استخراج مجموعه‏ ویژگی‏های پرونده های MS-Office استفاده می‌شود.
• HWPF (قالب پردازنده کلمات نامناسب) - برای خواندن و نوشتن پرونده های پسوند doc MS-Word استفاده می‌شود.
• XWPF (فرمت پردازشگر کلمه XML) - برای خواندن و نوشتن پرونده های پسوند docx از MS-Word استفاده می‌شود.
• HSLF (قالب چیدمان اسلاید نامناسب) - برای خواندن، ایجاد و ویرایش پاورپوینت استفاده می‌شود.
• HDGF (قالب نامناسب دیاگرام) - شامل کلاس ها و روش ها برای پرونده های باینری MS-Visio است.
• HPBF (قالب نامناسب PuBlisher) - برای خواندن و نوشتن پرونده های MS-Publisher استفاده می‌شود.

آموزش POI در جاوا

توجه: نسخه های قدیمی POI از فرمت های فایل باینری مانند doc، xls، ppt و ... پشتیبانی می‌کنند. نسخه 3.5 به بعد، POI از فرمت های فایل OOXML MS-Office مانند docx، xlsx، pptx و ... پشتیبانی می‌کند.
مانند Apache POI، کتابخانه های دیگری نیز وجود دارد که توسط فروشندگان مختلف برای تولید فایل اکسل ارائه می‌شود.‌ آنها شامل سلول های Aspose برای جاوا توسط Aspose، JXL توسط Commons Libraries و JExcel توسط Team Dev است.

Aspose Cells برای جاوا یک Java Excel API کاملاً مجاز است که توسط فروشنده Aspose تهیه و توزیع شده است. آخرین نسخه این API 8.1.2 است که در جولای 2014 منتشر شد. این یک API غنی است و ترکیبی از کلاس های جاوا ساده و کلاس های AWT برای طراحی فایل اکسل است که می‌تواند صفحات گسترده را بخواند، بنویسد و ویرایش کند.
POI یک کتابخانه 100٪ منبع باز است که توسط بنیاد نرم افزار Apache ارائه شده است. بیشتر توسعه دهندگان برنامه های کوچک و متوسط به شدت به Apache POI (HSSF + XSSF) وابسته هستند. این ابزار از تمام ویژگی های اساسی کتابخانه های اکسل پشتیبانی می‌کند. با این حال، رندر و استخراج متن از ویژگی های اصلی آن است.

POI و کاربرد آن برای فایل‏های اکسل
این رابط کاربری فوق العاده دارای همه کلاس هایی است که فایل‏های کاربری اکسل را ایجاد یا نگهداری می‌کنند. دو کلاس که این رابط را اجرا می‌کنند به شرح زیر است:

HSSFWorkbook - این کلاس روش هایی برای خواندن و نوشتن فایلهای Microsoft Excel در قالب.xls دارد. با نسخه های MS-Office 97–2003 سازگار است.

XSSFWorkbook - این کلاس روش هایی برای خواندن و نوشتن فایلهای xml مایکروسافت اکسل و OpenOffice در قالب.xls یا.xlsx دارد. با نسخه های MS-Office 2007 یا بالاتر سازگار است.

POI در زبان برنامه نویسی جاوا چه کاربردی دارد؟

HSSF work book را پیاده سازی می‌کند و برای پرونده های اکسل در قالب.xls استفاده می‌شود. در زیر برخی از روش ها و سازنده های این کلاس ذکر شده است. این کلاس می‌تواند صفحات گسترده اکسل را ایجاد کند و به شما امکان می‌دهد سبک ورق و داده های قالب را قالب بندی کنید.

XSSFCell رابط کاربری Cell را پیاده سازی می‌کند. این نمایش سطح بالایی از سلول ها در ردیف های صفحه گسترده است.
در زیر برخی از قسمت های کلاس XSSFCell به همراه توضیحات‌ آنها ذکر شده است.

• CELL_TYPE_BLANK:
سلول خالی را نشان می‌دهد
• CELL_TYPE_BOOLEAN:
سلول درست یا غلط را نشان می‌دهد
• CELL_TYPE_ERROR:
مقدار خطای سلول را نشان می‌دهد
• CELL_TYPE_FORMULA:
نتیجه فرمول را در سلول نشان می‌دهد

• CELL_TYPE_NUMERIC:
داده های عددی سلول را نشان می‌دهد
• CELL_TYPE_STRING:
رشته (متن) سلول را نشان می‌دهد

روش های کلاس XSSFCell عبارتند از:

• setCellStyle:
سبک را برای سلول تنظیم می‌کند.
• setCellType:
نوع سلول ها (عددی، فرمول یا رشته) را تنظیم می‌کند.

هر داده ای که به صفحه گسترده وارد کنید همیشه در سلول ذخیره می‌شود. ما برای شناسایی سلول از برچسب ردیف ها و ستون ها استفاده می‌کنیم. در این بخش نحوه دست کاری داده ها در سلول ها در صفحه گسترده با استفاده از برنامه نویسی جاوا توضیح داده شده است.

1-یک سلول ایجاد کنید:

2-قبل از ایجاد سلول باید یک سطر ایجاد کنید. ردیف چیزی نیست جز مجموعه ای از سلول ها.

3-قطعه کد زیر برای ایجاد سلول استفاده می‌شود.

XSSFWorkbook workbook = new XSSFWorkbook();

// ایجاد کتاب کار جدید

XSSFSheet spreadsheet = workbook.createSheet ("new sheet")؛

// ایجاد صفحه گسترده با نام

XSSFRow row = spreadsheet.createRow (0);

// ایجاد اولین ردیف در صفحه گسترده ایجاد شده

XSSFCell cell = row.createCell (0);

// ایجاد اولین سلول در ردیف ایجاد شده

استفاده از فایل های آفیس در جاوا

بنابراین setCellType مشخص می‌کند که آیا یک سلول می‌تواند شامل رشته ها، مقدار عددی یا فرمول باشد. یک سلول رشته ای نمی‌تواند مقادیر عددی را نگه دارد و یک سلول عددی نمی‌تواند رشته ها را نگه دارد. در زیر انواع سلول ها، مقادیر‌ آنها و نوع نحو آورده شده است.

اگر سیستم شما با کتابخانه POI پیکربندی شده باشد، برای تولید یک فایل اکسل به نام typesofcells.xlsx در فهرست فعلی شما اجرا می‌شود و خروجی زیر را نمایش می‌دهد.

مراحل نصب Apache POI در کتابخانه پروژه

مرحله 1. برای بارگیری Apache POI Libraries، به لینک زیر مراجعه کنید:

https://poi.apache.org/download.html، روی فایل zip کلیک کنید.

مرحله 2. در صفحه دوم، روی اولین لینک کلیک کنید و پرونده را ذخیره کنید.

مرحله 3. فایل بارگیری شده را استخراج کنید، یعنی poi-4.1.1 (آخرین نسخه موجود) و فایلهای jar را که برای پروژه شما استفاده می‌شوند، بررسی کنید.

مرحله 4. به پروژه در Eclipse بروید، روی آن کلیک راست کنید. به مسیر زیر بروید.

build path> configure build path.

مرحله 5. سپس بر روی "add external jars" کلیک کنید و تمام پرونده های موجود در مرحله 3 را انتخاب کنید و بر روی دکمه " apply and close" کلیک کنید.

توجه: نیازی به انتخاب پرونده های junit & log4j jar موجود در پوشه lib نیست.

مرحله 6. پرونده های jar اضافه شده را می‌توانید در پروژه در زیر پوشه "references references" پیدا کنید.
همچنین می‌توانید با ساختن نام پوشه jarfiles در پروژه، مسیر ساخت را پیکربندی کنید و همه jar ها را در این پوشه کپی-پیست کنید. سپس، روی پوشه کلیک راست کنید و مسیر build path> configure build path > را طی کنید و همه پرونده های jar را انتخاب کنید و روی دکمه " apply and close" کلیک کنید. به این ترتیب، تمام پرونده های jar در پوشه Referenced Libraries پیکربندی می‌شوند.

نصب کتابخانه های POI در زبان برنامه نویسی جاوا

چگونه کتابخانه های POI را نصب کنیم؟

همان طور که در بخش های فوق فهمیدیم که همه کتابخانه های Apache POI به عنوان JAR در دسترس هستند. اکنون برای دسترسی به قابلیت های POI، این JAR ها باید در مسیر ساخت برنامه / چارچوب شما موجود باشند. در ادامه می‏توانید یاد بگیرید چگونه می‌توان POI JAR ها را در مسیر ساخت یک پروژه در Eclipse نصب کرد:

برای افزودن POI JAR ها در یک پروژه Eclipse، مراحل زیر را انجام دهید:

1. ابتدا فرض کنید که یک یک پروژه جاوا را در Eclipse ایجاد کرده اید.

2. پس از آن، روی پروژه در Eclipse راست کلیک کنید. بعداً، ساخت مسیر را انتخاب کنید.

3. سپس، "properties" پروژه را باز کنید. پس از آن، برگه libraries را انتخاب کنید. در آخر، بر روی Add External JARs کلیک کنید.

توجه: هنگام افزودن JAR های خارجی باید Classpath انتخاب شود.

4. چهارم، JARs موجود در پوشه اصلی پرونده های POI باز نشده را انتخاب کنید. پس از آن، روی دکمه Open کلیک کنید تا‌ آنها در پروژه Eclipse قرار گیرند

5- بعد JARs را در زیر پوشه ooxml-lib در پوشه POI باز نشده انتخاب کنید.

6. ششم، JAR ها را در زیر پوشه lib در پوشه POI باز نشده انتخاب کنید.

7. پس از آن، هنگامی که تمام POI JAR ها اضافه شد، بر روی دکمه apply و close کلیک کنید.

8- هنگامی که همه کتابخانه های POI با موفقیت در پروژه Eclipse نصب شدند، کتابخانه ها در پوشه Referenced Libraries در سمت چپ ساختار پروژه Eclipse مشخص هستند.

بنابراین، این کار نصب POI را در یک پروژه Eclipse کامل می‌کند. بنابراین، اکنون می‌توانیم از توانایی این کتابخانه ها در پروژه JAVA خود استفاده کنیم.

در پایان لازم است که یادآوری شود با استفاده از POI می‎‏توانید تمام فایل‏های مایکروسافت آفیس را در هر حجمی بخوانید و بنویسید و اصلاح کنید. قابلیت گسترده این ابزار آنقدر زیاد است که در بسیاری از سازمان‏ های بزرگ با حجم زیاد فایل‏های آفیس مورد استفاده قرار می‏گیرد. بنابراین با آشنایی از نحوه نصب، اجرا و کاربردهای مختلف این ابزار قدرتمند به زبان جاوا از قابلیت‏ها و کاربردهای متنوع آن بهره مند شوید.

نام گالری فیلم و نام ویدیو