struts2 pdfstream

Struts2 PDF -Stream -Plugin

Das PDF -Stream -Plugin ermöglicht es, eine Ansicht in einen PDF -Stream umzuwandeln und als Ergebnis aus der Aktion zurückzugeben.

Standard unterstützte Ansichten:

• Html
• JSP
• Freimaurer -Vorlage
• Apache -Fliesen -Definition

Struts2 PDF Stream V2

Apache PDFBox 2

Ab 2.0.0 wird HTML in das PDF -Rendering von der OpenHTMLTOPDF -Bibliothek durchgeführt, in der die Apache PDFBox 2 zum Erstellen von PDF -Dokumenten verwendet wird. Apache PDFBox 2 ist ein Open -Source -Java -Tool für die Arbeit mit PDF -Dokumenten und wird unter der Apache -Lizenz v2.0 veröffentlicht.

Apache Streben 2.5

Aktualisiert, um mit Apache Struts 2.5 kompatibel zu sein

Java 7

Wechselte auf Java 7

Funktionenübersicht

• Direkte Transformation von HTML-, JSP-, Freemarker -Vorlage und Apache -Tiles -Definition in PDF über Struts2 Ergebnis
• PDF -Inhaltsstyling mit CSS
• Unterstützung einer breiten Palette von Charakteren in PDF dank der Dejavu -Schriftarten
• Umgang mit dem fehlformierten HTML dank der JSOUP

Showcase

Die Showcase -Anwendung kann aus dem Maven Central Repository heruntergeladen werden.

Laden Sie Struts2-PDFStream-Showcase herunter

Beitragen

Einen Fehler gefunden oder eine Funktionsanforderung haben? Erstellen Sie eine neue Ausgabe oder senden Sie eine Pull -Anfrage.

Fragen

Wenn Sie Fragen zur Verwendung struts2-pdfstream-plugin verwenden, erstellen Sie ein neues Problem oder stellen Sie eine Frage zum Stapelüberlauf.

Installation

Kopieren Sie die folgenden Gläser in Ihren Klassenpfad (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

Wenn Sie Maven verwenden, fügen Sie dies zu Ihrem Projektpom hinzu:

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

Wenn Sie beabsichtigen, Apache -Fliesen -Definition zu transformieren, muss zusätzliches Glas enthalten sein.

Für die Apache-Kacheln Unterstützung Fügen Sie die struts2-pdfstream-tiles hinzu.

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

Verwendung

1. Installieren Sie dieses Plugin, indem Sie Ihrem POM eine Abhängigkeit hinzufügen oder Gläser in /web-inf /lib-Verzeichnis kopieren.
2. Lassen Sie Ihr Aktionspaket pdfstream-default -Paket erweitern oder pdfstream Ergebnistyp hinzufügen.
3. Verwenden Sie pdfstream -Ergebnistyp.

Beispiele

JSP zum PDF -Stream

 <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 zu PDF -Stream

 <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>

Kachelndefinition zum PDF -Stream

 <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>

Freimaurer -Vorlage zum PDF -Stream

 <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>

Das Plugin erweitern

Hinzufügen von Unterstützung für andere Ansichten

Dieses Plugin kann leicht erweitert werden, um Unterstützung für die Umwandlung anderer Ansichten (z. B. Geschwindigkeit) in PDF hinzuzufügen.

1. Implementieren Sie com.amashchenko.struts2.pdfstream.ViewRenderer interface.

2. Erstellen Sie die Bean-Definition in Struts.xml oder in Struts-plugin.xml mit type="com.amashchenko.struts2.pdfstream.ViewRenderer" und benutzerdefinierter Name.

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

3. Verwenden Sie pdfstream -Ergebnis mit dem renderer -Parameter, der auf den Namen der von Ihnen definierten Bean gesetzt ist.

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