Fran�ois DORIN

Bonjour,

Dans le billet du jour, nous allons avoir comment nous pouvons int�grer une classe, �crite initialement en Java, directement en C#, � travers un exemple concret : g�n�rer un PDF � partir de la biblioth�que Apache FOP.

Cela ne serait pas possible aussi facilement sans le projet IKVM.NET, qui est une impl�mentation de Java pour environnement .Net (Mono et le framework .NET de Microsoft).

Ce billet �tant ax� sur l'interop�rabilit� entre Java/.NET, je ne m'attarderai pas sur l'usage de Apache FOP.

Principe
Le principe retenu ici est assez simple.

Dans un premier temps, on va convertir le fichier .jar de la biblioth�que Apache FOP en un assembly .NET. Pour ce faire, on va utiliser l'utilitaire ikvmc qui permet de convertir le bytecode Java en assembly .NET.

Dans un second temps, on va utiliser cet assembly au sein d'un programme C#.

Pr�paration
Avant de proc�der � la g�n�ration de l'assembly,il nous faut r�cup�rer l'ensemble des outils n�cessaires via leur site respectif :

• IKVM : https://www.ikvm.net/
• Apache FOP : https://www.ikvm.net/

Une fois les outils t�l�charg�s, il faudra les extraire dans le dossier de votre choix.

Conversion .jar vers .dll
Ici, pas grand chose � faire. Si ce n'est ex�cuter le petit script suivant (avec quelques modifications en fonction de votre installation) :

Code :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
5
SET IKVM_BIN_PATH=C:\Users\fdori\Downloads\ikvmbin-7.2.4630.5\ikvm-7.2.4630.5\bin
set PATH=%PATH%;%IKVM_BIN_PATH%

ikvmc -target:library *.jar ../build/fop.jar -out:fop.dll

La premi�re partie du script permet d'indiquer o� se trouve le binaire de IKVM que vous avez t�l�charg� � l'�tape pr�c�dente. Au passage, on peut voir que pour ma part, j'utilise la version 7.2.4630.5.

La derni�re ligne du script est celle qui proc�de effectivement � la conversion .jar -> .dll. Elle doit �tre ex�cut� dans le sous-r�pertoire fop/lib de l'archive contenant Apache FOP.

Les param�tres pass�s sont les suivants (voir doc officielle pour plus d'informations) :

• -target: library : on indique ici que l'on souhaite g�n�r� un assembly .dll. Les autes cibles possibles sont "exe" pour une application console et "winexe" pour une application graphique ;
• *.jar : on indique ici les fichiers � inclure. Pour des raisons de simplicit�, et dans la mesure o� Apache FOP vient avec l'ensemble de ses d�pendances, on utilise le caract�re g�n�rique * ;
• out:fop.dll : nom du fichier de sortie, c'est-�-dire ici de l'assembly qui sera g�n�r�.

Mise en oeuvre
Maintenant que nous disposons de l'assembly fop.dll, nous pouvons l'utiliser dans un projet C# (ou VB.NET) classique. Il suffit d'ajouter � notre projet la r�f�rence de l'assembly que nous venons de g�n�rer.
Vous aurez aussi besoin de r�f�rencer des assemblys du projet IVMK. Pour Apache FOP, j'ai �u r�f�rencer les assemblys suivants :

• IKVM.OpenJDK.Core ;
• IKVM.OpenJDK.XML.API ;
• IKVM.OpenJDK.XML.Transporm.

Le premier sera n�cessaire dans tous les cas, car il contient les routines de bases de l'API Java.

Et maintenant le code :

Code C# :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
     public static void GenererPDF(System.Xml.XmlDocument source, string sourceToFOPXsltFileName, string ouputFileName)
        {
            // Récupération du fichier XSL
            System.Xml.Xsl.XslCompiledTransform xslt = new System.Xml.Xsl.XslCompiledTransform();
            xslt.Load(sourceToFOPXsltFileName);
 
            // Génération du fichier FOP
            string foFileName = System.IO.Path.GetTempFileName();
            using (System.Xml.XmlTextWriter writer = new System.Xml.XmlTextWriter(foFileName, System.Text.Encoding.UTF8))
            {
                xslt.Transform(source.CreateNavigator(), null, writer);
                writer.Close();
            }
 
            // Création du PDF par interop IKVM avec ApacheFOP
            java.io.File fo = new java.io.File(foFileName);
            java.io.File pdf = new java.io.File(ouputFileName);
            org.apache.fop.apps.FopFactory fopFactory = GetFactory();
            org.apache.fop.apps.FOUserAgent foUserAgent = fopFactory.newFOUserAgent();
            java.io.OutputStream sortie = new java.io.BufferedOutputStream(new java.io.FileOutputStream(pdf));
            org.apache.fop.apps.Fop fop = fopFactory.newFop("application/pdf", foUserAgent, sortie);
            javax.xml.transform.TransformerFactory factory = javax.xml.transform.TransformerFactory.newInstance();
            javax.xml.transform.Transformer transformer = factory.newTransformer();
            javax.xml.transform.Source src = new javax.xml.transform.stream.StreamSource(fo);
            javax.xml.transform.Result res = new javax.xml.transform.sax.SAXResult(fop.getDefaultHandler());
            transformer.transform(src, res);
            sortie.close();
        }      
 
        public static FopFactory GetFactory()
        {
            ResourceResolver myResolver = new MyResolver();
            File file = new File(fop_dir);
            FopFactoryBuilder builder = new FopFactoryBuilder(file.toURI(), myResolver);
            FontManager fontManager = builder.getFontManager();
 
            return builder.build();
        }

Code C# :

S�lectionner tout - Visualiser dans une fen�tre � part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
 
    public class MyResolver : ResourceResolver
    {
        public OutputStream getOutputStream(URI uri)
        {
            return null;
        }
 
        /// <summary>
        /// Méthode appelée pour récupérer des ressources externes, comme les images
        /// </summary>
        /// <param name="uri"></param>
        /// <returns></returns>
        public Resource getResource(URI uri)
        {
            return null;
        }
    }

La classe MyResolver est une impl�mentation tr�s basique et am�liorable que n�cessite Apache FOP pour r�cup�rer les ressources externes.

Conclusion
Comme on peut le constater, l'utilisation de IKVM est assez simple et permet d'utiliser une biblioth�que Java en C# avec un minimum d'effort. Cette approche n'est pas encore parfaite et peut parfois rencontrer quelques bugs, mais le fait qu'un projet de la taille d'Apache FOP soit support� est quand m�me tr�s encourageant.

Il peut tout � fait �tre utilis� pour g�rer une partie non critique d'une application (comme la g�n�ration de PDF, comme dans cet exemple).

Il existe �galement d'autres m�thodes pour interfacer du code Java et .NET. L'approche de IKVM est int�ressante dans la mesure o� elle se base sur une conversion du bytecode Java en assembly. Autrement dit, il n'est pas n�cessaire d'avoir une JVM d'installer pour pouvoir utiliser le code converti !