struts2 pdfstream

Struts2 PDF Stream Plugin

El complemento de transmisión PDF permite transformar una vista en una transmisión PDF y devolverla como resultado de la acción.

Vistas compatibles predeterminadas:

• Html
• JSP
• Plantilla de marca libre
• Definición de mosaicos Apache

Struts2 PDF Stream V2

Apache PDFBox 2

A partir de 2.0.0, HTML en la representación PDF es realizada por la biblioteca OpenHTMLTOPDF que utiliza el Apache PDFBox 2 para crear documentos PDF. Apache PDFBox 2 es una herramienta Java de código abierto para trabajar con documentos PDF y se publica bajo la licencia de Apache v2.0.

Apache Struts 2.5

Actualizado para ser compatible con Apache Struts 2.5

Java 7

Cambiado a Java 7

Descripción general de las características

• Transformación directa de HTML, JSP, Freemarker Template y Apache Tiles Definición a PDF a través de Struts2 Resultado
• Estilización de contenido PDF con CSS
• Soporte de una amplia gama de personajes en PDF gracias a las fuentes DeJavu
• Manejo del HTML malformado gracias al JSOUP

Escaparate

La aplicación Showcase se puede descargar desde el repositorio central de Maven.

Descargar struts2-pdfstream-showcase

Que contribuye

¿Encontró un error o tiene una solicitud de función? Cree un nuevo problema o envíe una solicitud de extracción.

Preguntas

Si tiene preguntas sobre cómo usar struts2-pdfstream-plugin cree un nuevo problema o haga una pregunta en Stack Overflow.

Instalación

Copie los siguientes frascos en su 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 está utilizando Maven, agregue esto a su proyecto POM:

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

Si tiene la intención de transformar la definición de los mosaicos Apache, se debe incluir el frasco adicional.

Para el soporte de mosaicos Apache, agregue el struts2-pdfstream-tiles .

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

Uso

1. Instale este complemento agregando dependencia a su POM o copiando frascos en el directorio /web-inf /lib.
2. Haga que su paquete de acción extienda el paquete pdfstream-default o agregue el tipo de resultado pdfstream .
3. Use el tipo de resultado pdfstream .

Ejemplos

JSP a la transmisión 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 a la transmisión 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>

Definición de mosaicos a la transmisión 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>

Plantilla de marca libre para la transmisión 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>

Extendiendo el complemento

Agregar soporte para otras vistas

Este complemento se puede extender fácilmente para agregar soporte para transformar otras vistas (por ejemplo, velocidad) en PDF.

1. Implementar com.amashchenko.struts2.pdfstream.ViewRenderer interfaz.

2. Cree definición de frijoles en Struts.xml o en Struts-Plugin.xml con type="com.amashchenko.struts2.pdfstream.ViewRenderer" y nombre personalizado.

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

3. Use el resultado pdfstream con el parámetro renderer establecido al nombre del frijol que ha definido.

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