struts2 pdfstream

STRUTS2 PDF Stream Plugin

يسمح البرنامج المساعد PDF Dream بتحويل طريقة عرض إلى دفق PDF وإعادته كنتيجة لذلك من الإجراء.

طرق العرض المدعومة الافتراضية:

• HTML
• JSP
• قالب الجاذبية
• تعريف البلاط Apache

Struts2 PDF Tream V2

Apache PDFBOX 2

بدءًا من 2.0.0 ، يتم إجراء HTML إلى عرض PDF بواسطة مكتبة OpenHTMLTOPDF التي تستخدم Apache PDFBOX 2 لإنشاء مستندات PDF. Apache PDFBox 2 هي أداة Java مفتوحة المصدر للعمل مع مستندات PDF ويتم نشرها ضمن ترخيص Apache v2.0.

أباتشي دعامات 2.5

تمت ترقيتها لتكون متوافقة مع Apache Struts 2.5

جافا 7

تحول إلى Java 7

ميزات نظرة عامة

• التحول المباشر لـ HTML و JSP و Template Template و Apache Tiles تعريف PDF عبر STRUTS2 نتيجة
• تصميم محتوى PDF باستخدام CSS
• دعم مجموعة واسعة من الشخصيات في PDF بفضل خطوط Dejavu
• التعامل مع HTML المشوه بفضل JSUP

عرض

يمكن تنزيل تطبيق العرض من مستودع Maven Central.

قم بتنزيل Struts2-PDFStream Showcase

المساهمة

وجدت خطأ أو لديك طلب ميزة؟ إنشاء مشكلة جديدة أو إرسال طلب سحب.

أسئلة

إذا كانت لديك أسئلة حول كيفية استخدام struts2-pdfstream-plugin ، قم بإنشاء مشكلة جديدة أو طرح سؤال على فائض Stack.

تثبيت

انسخ الجرار التالية في classpath الخاص بك (web-inf/lib):

• Struts2-Pdfstream-Plugin-2.0.0.jar
• Jsoup-1.9.2.jar
• OpenHTMLTOPDF-CORE-0.0.1-RC4.JAR
• OpenHTMLTOPDF-PDFBOX-0.0.1-RC4.JAR
• pdfbox-2.0.0.jar
• fontbox-2.0.0.jar

إذا كنت تستخدم Maven ، فأضف هذا إلى Project POM:

 <dependencies>
    ...
    <dependency>
        <groupId>com.amashchenko.struts2.pdfstream</groupId>
        <artifactId>struts2-pdfstream-plugin</artifactId>
        <version>2.0.0</version>
    </dependency>
    ...
</dependencies>

إذا كنت تنوي تحويل تعريف البلاط Apache ، فيجب تضمين جرة إضافية.

لدعم البلاط Apache ، أضف struts2-pdfstream-tiles .

 <dependency>
    <groupId>com.amashchenko.struts2.pdfstream</groupId>
    <artifactId>struts2-pdfstream-tiles</artifactId>
    <version>2.0.0</version>
</dependency>

الاستخدام

1. قم بتثبيت هذا المكون الإضافي عن طريق إضافة التبعية إلى POM أو عن طريق نسخ الجرار إلى دليل /Web-INF /LIB.
2. اجعل حزمة الإجراء الخاصة بك تمديد حزمة pdfstream-default أو إضافة نوع نتيجة pdfstream .
3. استخدام نوع نتيجة pdfstream .

أمثلة

JSP إلى دفق PDF

 <action name="jspToPdf">
    <result type="pdfstream">
        <param name="location">/WEB-INF/pages/example.jsp</param>
        <param name="cssPaths">css/bootstrap.min.css, css/style.css</param>
        <param name="contentDisposition">attachment;filename=jsppdf.pdf</param>
    </result>
</action>

HTML إلى تدفق PDF

 <action name="htmlToPdf">
    <result type="pdfstream">
        <param name="location">/WEB-INF/pages/example.html</param>
        <param name="cssPaths">css/bootstrap.min.css, css/style.css</param>
        <param name="contentDisposition">attachment;filename=htmlpdf.pdf</param>
    </result>
</action>

تعريف البلاط لتيار PDF

 <action name="tilesToPdf">
    <result type="pdfstream">
        <param name="location">example</param>
        <param name="renderer">tiles</param>
        <param name="contentDisposition">attachment;filename=tilespdf.pdf</param>
    </result>
</action>

قالب علامة freemarker إلى تيار PDF

 <action name="freemarkerToPdf">
    <result type="pdfstream">
        <param name="location">/WEB-INF/ftl/example.ftl</param>
        <param name="renderer">freemarker</param>
        <param name="cssPaths">css/bootstrap.min.css, css/style.css</param>
        <param name="contentDisposition">attachment;filename=ftlpdf.pdf</param>
    </result>
</action>

تمديد البرنامج المساعد

إضافة دعم للآراء الأخرى

يمكن تمديد هذا البرنامج المساعد بسهولة من أجل إضافة دعم لتحويل طرق العرض الأخرى (مثل السرعة) إلى PDF.

1. تنفيذ com.amashchenko.struts2.pdfstream.ViewRenderer واجهة.

2. قم بإنشاء تعريف فول في struts.xml أو في struts-plugin.xml مع type="com.amashchenko.struts2.pdfstream.ViewRenderer" والاسم المخصص.

    <bean type="com.amashchenko.struts2.pdfstream.ViewRenderer" 
          class="some.package.CustomRenderer" name="customrenderer" />
   

3. استخدم نتيجة pdfstream مع تعيين معلمة renderer إلى اسم الفول الذي حددته.

    <action name="customToPdf">
        <result type="pdfstream">
            <param name="location">example</param>
            <param name="renderer">customrenderer</param>
        </result>
    </action>