Rational Developer for System z


Leçon 2 : écriture du code Java pour gérer la classe CARMADeveloperView

Vous allez devoir implémenter deux méthodes pour contrôler la vue CARMA : createFramelist et createViewer.
Pour implémenter ce code, vous allez utiliser FrameList et la classe Viewer. FrameList est une liste de cadres qui permettent de naviguer dans la vue. Viewer contient la structure qui s'affiche dans la vue. Pour la liste de cadres, vous allez créer une liste de cadres pour un afficheur d'arborescence similaire à la vue par défaut Référentiels CARMA. Pour l'afficheur, vous allez définir le fournisseur de contenu sur le fournisseur de contenu CARMA par défaut.

Pour implémenter les méthodes Java :

  1. Ouvrez la classe CARMADeveloperView en développant, dans la vue Explorateur de package, com.ibm.carma.plugin.view > view, et en cliquant deux fois sur CARMADeveloperView.
  2. Dans l'éditeur, vous devez ajouter la méthode createFrameList. Cette méthode crée d'abord TreeViewerFrameSource, puis une autre FrameList, et enfin définit la source sur TreeViewerFrameSource. Utilisez l'exemple de code suivant pour implémenter cette fonctionnalité :
    protected FrameList createFrameList()
    {
       /*
        * Ce code gère les boutons avant-arrière dans la vue. 
        * Obtiendra l'écouteur de cadre d'arborescence d'Eclipse.
        */
       TreeViewerFrameSource source = new TreeViewerFrameSource((TreeViewer)getViewer());
    	
       /* Ceci est un TreeViewer.
        * Créer une liste de cadres.
        */
       FrameList frameList = new FrameList(source);
       source.connectTo(frameList);
    
       return frameList;
    }
  3. Ensuite, vous devez écraser le createViewer afin de créer le CARMATreeViewer avec le CARMAContentProvider par défaut. Utilisez l'exemple de code suivant pour implémenter cette fonctionnalité :
    protected StructuredViewer createViewer(Composite parent)
    {
       /*
        * Créer la structure que vous voulez voir présente dans la vue ici. 
        * L'exemple utilise le modèle d'arborescence CARMA comme la vue Référentiels CARMA.
        */
       CARMATreeViewer viewer = new CARMATreeViewer(parent);
       return viewer;
    }
  4. Assurez-vous que toutes les classes et tous les packages mentionnés dans la source sont inclus dans les commandes d'importation au début de la classe. Pour ce faire, le plus facile est de cliquer avec le bouton droit de la souris dans l'éditeur et sélectionner Source > Organiser les importations. Vérifiez que les classes suivantes sont toutes importées :
    import org.eclipse.jface.viewers.StructuredViewer;
    import org.eclipse.jface.viewers.TreeViewer;
    
    import org.eclipse.swt.widgets.Composite;
    
    import org.eclipse.ui.views.framelist.FrameList;
    import org.eclipse.ui.views.framelist.TreeViewerFrameSource;
    
    import com.ibm.carma.ui.view.BaseCarmaBrowser;
    import com.ibm.carma.ui.widget.CARMATreeViewer;
  5. Enregistrez les modifications et déboguez les éventuelles erreurs.
  6. Enfin, vous devez ajouter l'extension appropriée et la configurer. Dans l'éditeur de plug-in, sélectionnez l'onglet Extensions dans la partie inférieure de l'éditeur. Cliquez sur Ajouter. Filtrez sur l'extension org.eclipse.ui.views. Quand elle s'affiche, sélectionnez-la et cliquez sur OK. Vous devriez voir l'extension affichée dans le panneau gauche.
  7. Ouvrez l'onglet plugin.xml dans le menu inférieur des onglets. Configurez le fichier plugin.xml comme suit :
    <plugin>
    	<extension
    		point="org.eclipse.ui.views">
    			<category
    				name="BootCamp"
    				id="carma.bootcamp.ui">
    			</category>
    			<view
    				name="CARMA Developer View"
    				icon="icons/sample.gif"
    				category="carma.bootcamp.ui"
    				class="view.CARMADeveloperView"
    				id="view.CARMADeveloperView">
    			</view>
    	</extension>
    </plugin>
    Remarque : Les attributs utilisés dans le plugin.xml sont décrits plus en détail ci-dessous :
    • Catégorie : les attributs utilisés avec ce balisage correspondent à l'étiquetage et à la vue de la boîte de dialogue Afficher la vue.
      • Nom : le nom qui s'affiche comme catégorie globale dans la boîte de dialogue Afficher la vue.
      • Id : ID de la catégorie que la vue doit afficher quand elle est recherchée dans la boîte de dialogue Afficher la vue.
    • Vue : les attributs utilisés avec ce balisage correspondent à l'étiquetage, l'apparence et l'emplacement de la source pour la vue réelle que vous avez créée.
      • Nom : le libellé donné à la vue, ce nom s'affiche dans l'onglet associé à la vue, ainsi que dans la boîte de dialogue Afficher la vue.
      • Icône : l'image à associer à cette vue, s'affiche dans l'onglet associé à cette vue, ainsi qu'en regard de son libellé dans la boîte de dialogue Afficher la vue.
      • Catégorie : ID de la catégorie que la vue doit afficher quand elle est recherchée dans la boîte de dialogue Afficher la vue.
      • Classe : la classe Java que vous avez écrite qui contrôle la vue. Vous devez également fournir le package global.
      • Id : l'identifiant unique de la vue.

Conditions d'utilisation | Commentaires en retour



Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)