struts2 pdfstream

PDF -плагин PDF -поток STRUTS2

Плагин PDF Stream позволяет преобразовать представление в PDF -поток и вернуть его в результате действия.

Поддерживаемые представления по умолчанию:

• HTML
• JSP
• Шаблон Freemarker
• Определение плитки Apache

Struts2 PDF -поток 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 в PDF через результат Struts2
• Стиль контента PDF с использованием CSS
• Поддержка широкого спектра персонажей в PDF благодаря шрифтам Dejavu
• Обработка необработанного HTML благодаря JSoup

Витрина

Приложение Showcase можно загрузить из центрального репозитория Maven.

Скачать Struts2-Pdfstream-Showcase

Внося

Нашел ошибку или есть запрос на функцию? Создайте новую проблему или отправьте запрос на привлечение.

Вопросы

Если у вас есть вопросы о том, как использовать struts2-pdfstream-plugin создайте новую проблему или задайте вопрос о переполнении стека.

Установка

Скопируйте следующие банки в вашем классе (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, должна быть включена дополнительная 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 Directory.
2. Сделайте свой пакет Action Extend pdfstream-default Package или добавьте тип результата 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 to 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>