struts2 pdfstream

Plugin Struts2 PDF Stream

Le plugin de flux PDF permet de transformer une vue en flux PDF et de le renvoyer en raison de l'action.

Vues prises en charge par défaut:

• Html
• Jsp
• Modèle Frearmarker
• Définition des carreaux Apache

Struts2 PDF Stream V2

Apache pdfbox 2

À partir de 2.0.0, HTML dans le rendu PDF est effectué par la bibliothèque OpenHTMLTOPDF qui utilise l'APACHE PDFBOX 2 pour créer des documents PDF. Apache PDFBox 2 est un outil Java open source pour travailler avec des documents PDF et il est publié sous la licence Apache v2.0.

Apache Struts 2.5

Amélioré pour être compatible avec Apache Struts 2.5

Java 7

Changé de Java 7

Présentation des fonctionnalités

• Transformation directe de la définition HTML, JSP, modèle Freemarker et Tiles Apache à PDF via Struts2 Résultat
• Style de contenu PDF à l'aide de CSS
• Prise en charge d'un large éventail de personnages dans PDF grâce aux polices Dejavu
• Manipulation du HTML malformé grâce au JSoup

Vitrine

L'application de vitrine peut être téléchargée à partir du référentiel Maven Central.

Télécharger Struts2-pdfstream-showcase

Contributif

Vous avez trouvé un bug ou avez une demande de fonctionnalité? Créez un nouveau problème ou soumettez une demande de traction.

Questions

Si vous avez des questions sur la façon d'utiliser struts2-pdfstream-plugin créez un nouveau problème ou posez une question sur le débordement de pile.

Installation

Copiez les pots suivants dans votre 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

Si vous utilisez Maven, ajoutez ceci à votre projet POM:

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

Si vous avez l'intention de transformer Apache Tiles Definition, un pot supplémentaire doit être inclus.

Pour la prise en charge des tuiles Apache, ajoutez les struts2-pdfstream-tiles .

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

Usage

1. Installez ce plugin en ajoutant une dépendance à votre POM ou en copiant des bocaux dans le répertoire / web-inf / lib.
2. Faites de votre package d'action étendre le package pdfstream-default ou ajoutez le type de résultat pdfstream .
3. Utilisez le type de résultat pdfstream .

Exemples

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

Définition des carreaux au flux 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>

Modèle Freemarker au flux 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>

Extension du plugin

Ajout de prise en charge des autres vues

Ce plugin peut être facilement étendu afin d'ajouter la prise en charge de la transformation d'autres vues (par exemple, la vitesse) en PDF.

1. Implémentez com.amashchenko.struts2.pdfstream.ViewRenderer .

2. Créer une définition de bean dans strut.xml ou dans struts-lugin.xml avec type="com.amashchenko.struts2.pdfstream.ViewRenderer" et nom personnalisé.

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

3. Utilisez le résultat pdfstream avec le paramètre renderer défini sur le nom du bean que vous avez défini.

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