iText サポートは jboss-seam-pdf.jar で提供されます。 この JAR には、 PDF にレンダリングが可能となるビューの作成に使用される iText JSF 制御、 およびレンダリングされたドキュメントをユーザーに提供する DocumentStore コンポーネントが含まれています。 PDF サポートをご使用のアプリケーションに含ませるには、 iText JAR ファイルと一緒に WEB-INF/lib ディレクトリに jboss-seam-pdf.jar を含ませます。 Seam の iText サポートを使用するのに必要な設定はこれだけで他にはありません。

Seam iText モジュールにはビューテクノロジーとして Facelets を使用する必要があります。 ライブラリの今後のバージョンは JSP の使用にも対応する可能性があります。 また、 seam-ui パッケージの使用も必要となります。

examples/itext プロジェクトには実行可能なデモ用 PDF サポートのサンプルが含まれています。 正確なパッケージ化の導入を行い、 現在サポートされている PDF 生成の主要な機能を実際に示すサンプルがいくつか含まれています。

ドキュメントは http://jboss.com/products/seam/pdf 名前空間にあるタグを使って facelets documents で生成されます。 ドキュメントには必ずドキュメントの root に document タグがなければなりません。 document タグは Seam がドキュメントを DocumentStore に生成し HTML リダイレクトをその格納コンテントにレンダリングする準備を行います。 次は 1 行のみのテキストから成る小規模の PDF ドキュメントです。

<p:document xmlns:p="http://jboss.com/products/seam/pdf">                                                      
   The document goes here.                                                                                             
</p:document>
        

役に立つドキュメントにはテキスト以外のものも含まれる必要があります。 ただし、 標準 UI コンポーネントは HTML 生成に対して適合されるので、 PDF コンテントの生成には役に立ちません。 Seam は特殊な UI コンポーネントを適切な PDF コンテントの生成に対して提供しています。 <p:image> や <p:paragraph> のようなタグはシンプルなドキュメントのベーシックな基盤となります。 <p:font> のようなタグはその回りのコンテントすべてに対してスタイル情報を提供します。

<p:document xmlns:p="http://jboss.com/products/seam/pdf"> 
    <p:image alignment="right" wrap="true" resource="/logo.jpg" />
    <p:font size="24">
        <p:paragraph spacingAfter="50">My First Document</p:paragraph>
    </p:font>

    <p:paragraph alignment="justify">
        This is a simple document.  It isn't very fancy.
    </p:paragraph>
</p:document>
        

<p:paragraph>
    The item costs <p:text value="#{product.price}">
        <f:convertNumber type="currency" currencySymbol="$"/>
    </p:text>
</p:paragraph>
            

<p:image resource="/jboss.jpg" />

<p:image imageData="#{images.chart}" />

生成されるドキュメントが本または論文の構造をとる場合、 p:chapter と p:section の各タグを使用して必要となる構造を構成することができます。 セクションは章の内側でのみ使用できますが、 適宜、 ネストさせることができます。 ほとんどの PDF ビューワはドキュメント内の章とセクション間を簡単に移動できる機能を提供しています。

<p:document xmlns:p="http://jboss.com/products/seam/pdf"
            title="Hello">

   <p:chapter number="1">
      <p:title><p:paragraph>Hello</p:paragraph></p:title>
      <p:paragraph>Hello #{user.name}!</p:paragraph>
   </p:chapter>

   <p:chapter number="2">
      <p:title><p:paragraph>Goodbye</p:paragraph></p:title>
      <p:paragraph>Goodbye #{user.name}.</p:paragraph>
   </p:chapter>

</p:document>    
        

一覧の構成は p:list と p:listItem のタグを使って表示させることができます。 一覧には適宜、 ネストされたサブリストを含ませることもできます。 一覧のアイテムは一覧の外側では使用できません。 次のドキュメントは ui:repeat タグを使って Seam コンポーネントから取得した値の一覧を表示しています。

<p:document xmlns:p="http://jboss.com/products/seam/pdf"
            xmlns:ui="http://java.sun.com/jsf/facelets"
            title="Hello">
   <p:list style="numbered">
      <ui:repeat value="#{documents}" var="doc">
         <p:listItem>#{doc.name}</p:listItem>
      </ui:repeat>
   </p:list>
</p:document>                
        

表の構成は p:table と p:cell のタグを使って作成することができます。 多くの表構成とは異なり明示的な列の宣言はありません。 表にコラムが 3 つある場合は、 3 セルすべてが自動的に列を形成します。 表の構成が複数ページに渡る場合、 ヘッダとフッタは繰り返されます。

<p:document xmlns:p="http://jboss.com/products/seam/pdf"   
            xmlns:ui="http://java.sun.com/jsf/facelets"
            title="Hello">   
   <p:table columns="3" headerRows="1">
      <p:cell>name</p:cell>
      <p:cell>owner</p:cell>
      <p:cell>size</p:cell>
      <ui:repeat value="#{documents}" var="doc">
         <p:cell>#{doc.name}</p:cell>
         <p:cell>#{doc.user.name}</p:cell>
         <p:cell>#{doc.size}</p:cell>
      </ui:repeat>
   </p:table>
</p:document>            
        

本セクションでは複数のタグで属性により共有される定数のいくつか説明します。

ドキュメントの生成は特に設定を必要とすることなく、 そのまま動作させることができます。 ただし、 本格的なアプリケーションには必要となる設定ポイントがいくつかあります。

デフォルトの実装は汎用 URL /seam-doc.seam から PDF ドキュメントを提供します。 多くのブラウザ (そしてユーザー) は、 /myDocument.pdf などのように実際の PDF 名を含む URL を好みます。 これにはいくつか設定が必要になってきます。 PDF ファイルを提供するには、 すべての *.pdf リソースが Seam Servlet Filter および DocumentStoreServlet にマッピングされなければなりません。

<filter>
    <filter-name>Seam Servlet Filter</filter-name>
    <filter-class>org.jboss.seam.servlet.SeamServletFilter</filter-class>
</filter>

<filter-mapping>
    <filter-name>Seam Servlet Filter</filter-name>
    <url-pattern>*.pdf</url-pattern>
</filter-mapping>

<servlet>
    <servlet-name>Document Store Servlet</servlet-name>
    <servlet-class>org.jboss.seam.pdf.DocumentStoreServlet</servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>Document Store Servlet</servlet-name>
    <url-pattern>*.pdf</url-pattern>
</servlet-mapping>

document store コンポーネントにある useExtensions オプションは、 document store に生成されているドキュメントタイプに対して正しいファイル名の拡張子を付けて URL を生成するよう指示することによりこの機能を補います。

        
<components xmlns="http://jboss.com/products/seam/components"
            xmlns:pdf="http://jboss.com/products/seam/pdf">
    <pdf:documentStore useExtensions="true" />
</components>

生成されるドキュメントは対話スコープに格納され、 対話が終了するときに期限が切れます。 この時点で、 ドキュメントへの参照は無効になります。 ドキュメントが存在しない場合、 documentStore の errorPage プロパティを使って表示されるデフォルトのビューを指定できます。

        
<pdf:documentStore useExtensions="true" errorPage="/pdfMissing.seam" />

iText に関する詳細は、 次を参照してください。