Depuis Programmez! 97 nous savons générer des documents PDF en Java à l'aide de la librairie iText. Nous voyons aujourd'hui comment incorporer des composants Swing ou des graphiques JFreeChart dans les documents.

Supposons que nous ayons écrit une grosse application en Java. Nous voulons que notre application soit accompagnée, outre la Javadoc, d'un manuel de qualité. Un document PDF est un excellent choix. Naturellement notre manuel devra comporter des illustrations. Par exemple des boîtes de dialogue de l'application que nous voulons documenter. Ou encore des graphiques que celle-ci est susceptible de produire. Supposons pour l'exemple qu’il s’agisse de graphiques obtenus à partir de la librairie JFreeChart. Comment générer notre document PDF? Nous pouvons tout simplement l'écrire avec un outil tel qu'Open Office, qui générera le PDF une fois le document écrit. Dans ce cas, nous devons faire des captures d'écrans de notre application et nous devons les incorporer manuellement dans le document. Avec tous les risques d'oublis et d'erreurs que cela entraîne si le document doit être repris et modifié. Une autre solution, que je préfère, est d'écrire le document sous la forme d'un texte brut, avec des balises pour les illustrations à insérer. On écrira alors une petite application Java qui, à partir du document brut et de la librairie iText, générera notre PDF. Ceci posé, reste le problème des illustrations. Si nous devons continuer à faire les captures et les manipulations qui s'ensuivent à la main, nous ne gagnons pas grand-chose avec notre procédé. En revanche, s'il était possible que l'application à documenter génère elle-même ses illustrations nous pourrions plus facilement automatiser la génération de notre documentation. Ceci est il possible ? Oui. Java, iText et JFreechart offrent tout ce qu'il nous faut. Tout ce que nous avons à faire est d'assembler les pièces du puzzle, ce que nous faisons dans cet article.