struts2 pdfstream

ปลั๊กอิน Struts2 PDF Stream

ปลั๊กอินสตรีม PDF อนุญาตให้แปลงมุมมองเป็นสตรีม PDF และส่งคืนเป็นผลมาจากการกระทำ

มุมมองที่รองรับเริ่มต้น:

• HTML
• JSP
• เทมเพลต FreeMarker
• คำจำกัดความของกระเบื้อง Apache

struts2 pdf stream v2

Apache pdfbox 2

เริ่มต้นจาก 2.0.0, HTML ในการแสดงผล PDF ทำได้โดยไลบรารี OpenHTMLTopDF ซึ่งใช้ Apache PDFBox 2 เพื่อสร้างเอกสาร PDF Apache PDFBox 2 เป็นเครื่องมือโอเพ่นซอร์ส Java สำหรับการทำงานกับเอกสาร PDF และเผยแพร่ภายใต้ใบอนุญาต Apache v2.0

Apache Struts 2.5

อัพเกรดให้เข้ากันได้กับ apache struts 2.5

Java 7

เปลี่ยนเป็น Java 7

ภาพรวมคุณสมบัติ

• การแปลงโดยตรงของ HTML, JSP, เทมเพลต Freemarker และ Apache Tiles นิยามเป็น PDF ผ่านผลลัพธ์ struts2
• การออกแบบเนื้อหา PDF โดยใช้ CSS
• การสนับสนุนอักขระที่หลากหลายใน PDF ด้วยฟอนต์ Dejavu
• การจัดการ HTML ที่ไม่ถูกต้องขอบคุณ JSOUP

การแสดง

แอปพลิเคชัน Showcase สามารถดาวน์โหลดได้จากที่เก็บ Maven Central

ดาวน์โหลด struts2-pdfstream-showcase

การบริจาค

พบข้อผิดพลาดหรือมีคำขอคุณสมบัติ? สร้างปัญหาใหม่หรือส่งคำขอดึง

คำถาม

หากคุณมีคำถามเกี่ยวกับวิธีการใช้ struts2-pdfstream-plugin สร้างปัญหาใหม่หรือถามคำถามเกี่ยวกับสแต็กล้น

การติดตั้ง

คัดลอกขวดต่อไปนี้ลงใน 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 ให้เพิ่มสิ่งนี้ลงในโครงการ POM ของคุณ:

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

หากคุณตั้งใจจะแปลงคำจำกัดความของ Apache Tiles Jar เพิ่มเติม

สำหรับรองรับ Apache Tiles เพิ่ม 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>