Migration manuelle vers le format de projet JET

Vous pouvez faire migrer manuellement la structure et les métadonnées d'un projet Design Pattern Toolkit (DPTK) vers le format JET.
Pour migrer manuellement vers le format JET :
  1. Faites migrer les informations du fichier .pattern de votre projet DPTK vers deux nouveaux fichiers : META-INF/MANIFEST.MF et plugin.xml.
  2. Créez un répertoire source Java (jet2java) et un fichier .classpath pour les besoins du générateur Java.
  3. Créez un fichier build.properties pour permettre l'exportation correcte des canevas JET vers des fichiers JAR (l'équivalent des fichiers .patzip de DPTK).
L'exemple suivant présente un fichier .pattern typique de DPTK et illustre comment faire migrer son contenu :
Remarque : Les lignes en gras doivent migrer vers des équivalents JET.

Les valeurs après le signe deux-points des lignes commençant par SetName, SetID et Version doivent être reportées dans le nouveau fichier META-INF/MANIFEST.MF :

SetName:bean generator
SetID:bean.generator
Controller:bean.generator/control.pat
Version:1.0
*Appdef: name="sample.appdef" description="bean generator"
Filter: type="appdef" resource="file" enablesFor="1" 
Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: valeur de SetName
Bundle-SymbolicName: valeur de SetID
Bundle-Version: valeur de Version
Bundle-Localization: plugin
Bundle-Vendor: 
Require-Bundle: org.eclipse.jet
Bundle-ClassPath: .,bin/

La valeur après le signe deux-points de la ligne Controller doit être reportée dans le nouveau fichier plugin.xml :

<?xml version="1.0" encoding="UTF-8"?>
<?eclipse version="3.0"?>
<plugin>
    <extension
          id=""
          name=""
          point="org.eclipse.jet.transform">
        <transform 
          startTemplate="valeur de Controller" 
          templateLoaderClass="org.eclipse.jet.compiled._jet_transformation">
            <description></description>
            <tagLibraries>
                <importLibrary 
                    id="com.ibm.xtools.jet.dptk.dptk"
                    usePrefix="" 
                    autoImport="true"/>
            </tagLibraries>
        </transform>
    </extension>
</plugin>

Un nouveau dossier, jet2java, doit être créé à la racine du projet. Un nouveau fichier .classpath doit aussi être ajouté à la racine du projet. Notez que le fichier .classpath contient une référence au nouveau dossier (en gras ci-après).

<?xml version="1.0" encoding="UTF-8"?>
<classpath>
    <classpathentry kind="src" path="jet2java/>
    <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
    <classpathentry kind="con" path="org.eclipse.pde.core.requiredPlugins"/>
    <classpathentry kind="output" path="bin"/>
</classpath>

Pour que les natures et les générateurs JET soient ajoutés au projet, vous devez modifier le fichier .project afin d'y inclure les lignes représentées en gras dans le code suivant :

<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
    <name>nom du projet existant</name>
    <comment></comment>
    <projects>
    </projects>
    <buildSpec>
        <buildCommand>
            <name>org.eclipse.jet.builder</name>
            <arguments>
            </arguments>
        </buildCommand>
        <buildCommand>
            <name>org.eclipse.jdt.core.javabuilder</name>
            <arguments>
            </arguments>
        </buildCommand>
        <buildCommand>
            <name>org.eclipse.pde.ManifestBuilder</name>
            <arguments>
            </arguments>
        </buildCommand>
        <buildCommand>
            <name>com.ibm.dptk.patternBuilder</name>
            <arguments>
            </arguments>
        </buildCommand>
    </buildSpec>
    <natures>
        <nature>org.eclipse.pde.PluginNature</nature> 
        <nature>org.eclipse.jdt.core.javanature</nature> 
        <nature>org.eclipse.jet.jet2Nature</nature>
        <nature>com.ibm.dptk.patternNature</nature>
    </natures>
</projectDescription>

Pour permettre au compilateur JET de reconnaître les fichiers PAT comme des canevas JET, le fichier .settings/org.eclipse.jet.prefs doit être créé avec le contenu suivant :

eclipse.preferences.version=1
org.eclipse.jet.projectPrefs=true
org.eclipse.jet.templateExt=pat,jet

Pour permettre l'exportation correcte du pattern vers un fichier JAR (l'équivalent fonctionnel d'un fichier .patzip de DPTK), créez le fichier build.properties à la racine du projet en y incorporant le contenu suivant :

source.. = jet2java/
output.. = bin/
bin.includes = .,\
    plugin.xml,\
    META-INF/,\
    **/*.pat,\
    **/*.jet
src.includes = .project,\
    build.properties,\
    .classpath
Remarque : Le pattern DPTK "Add JET Nature to Pattern" (ajouter la nature JET au pattern) effectue automatiquement tous les changements décrits plus haut. Il soumet également le pattern à une validation pour vérifier que toutes les balises DPTK peuvent migrer correctement.

Vos commentaires