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 شامل کلاس ها و روش های کار بر روی تمام اسناد ترکیبی 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 از فرمت های فایل باینری مانند 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 یا بالاتر سازگار است.

 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-قطعه کد زیر برای ایجاد سلول استفاده می شود.

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

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

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

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

بنابراین  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 را نصب کنیم؟

 همان طور که در بخش های فوق فهمیدیم که همه کتابخانه های 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 می‎‏توانید تمام فایل‏های مایکروسافت آفیس را در هر حجمی بخوانید و بنویسید و اصلاح کنید. قابلیت گسترده این ابزار آنقدر زیاد است که در بسیاری از سازمان‏ های بزرگ با حجم زیاد فایل‏های آفیس مورد استفاده قرار می‏گیرد. بنابراین با آشنایی از نحوه نصب، اجرا و کاربردهای مختلف این ابزار قدرتمند به زبان جاوا از قابلیت‏ها و کاربردهای متنوع آن بهره مند شوید.