2013-04-24

Interfaces graphiques

Corrigé de l'exercice sur les requêtes

Extrait de la méthode main de la classe ChapitrePlusTeiLuceneSearcher :

// Recherche n°1 : "mort" dans les balises <p>
// 86 résultats
BooleanQuery query1 = new BooleanQuery();
query1.add(new TermQuery(new Term("contenu", "mort")), Occur.MUST);
query1.add(new TermQuery(new Term("balise", "p")), Occur.MUST);
runQuery("Mort dans les balises <p>", query1);

// Recherche n°2 : "mort" dans les balises <said>
// 8 résultats
BooleanQuery query2 = new BooleanQuery();
query2.add(new TermQuery(new Term("contenu", "mort")), Occur.MUST);
query2.add(new TermQuery(new Term("balise", "said")), Occur.MUST);
runQuery("Mort dans les balises <said>", query2);

// Recherche n°3 : copain ou mère dans les balises <said>
// 36 résultats
BooleanQuery query3 = new BooleanQuery();
BooleanQuery query3bis = new BooleanQuery();
query3bis.add(new TermQuery(new Term("contenu", "copain")), Occur.SHOULD);
query3bis.add(new TermQuery(new Term("contenu", "mère")), Occur.SHOULD);
query3.add(query3bis, Occur.MUST);
query3.add(new TermQuery(new Term("balise", "said")), Occur.MUST);
runQuery("copain ou mère dans les balises <said>", query3);

// Recherche n°4 : copain et mère dans les balises <said>
// 1 résultat
BooleanQuery query4 = new BooleanQuery();
query4.add(new TermQuery(new Term("balise", "copain")), Occur.MUST);
query4.add(new TermQuery(new Term("balise", "mère")), Occur.MUST);
query4.add(new TermQuery(new Term("balise", "said")), Occur.MUST);
runQuery("Copain et mère dans les balises <said>", query4);

// Recherche n°5 : voyage dans les chapitres 10 à 23
// 9 résultats
BooleanQuery query5 = new BooleanQuery();
query5.add(new TermQuery(new Term("contenu","voyage")), Occur.MUST);
query5.add(NumericRangeQuery.newIntRange("numero", 10, 23, true, true), Occur.MUST);
runQuery("voyage dans les chapitre 10 à 23", query5);

// Recherche n°6 : voyage dans les chapitres 12, 15 et 20
// 6 résultats
BooleanQuery query6 = new BooleanQuery();
query6.add(new TermQuery(new Term("contenu", "voyage")), Occur.MUST);
BooleanQuery subQuery6 = new BooleanQuery();
subQuery6.add(NumericRangeQuery.newIntRange("numero", 11, 13, false, false), Occur.SHOULD);
subQuery6.add(NumericRangeQuery.newIntRange("numero", 14, 15, false, true), Occur.SHOULD);
subQuery6.add(NumericRangeQuery.newIntRange("numero", 20, 20, true, true), Occur.SHOULD);
query6.add(subQuery6, Occur.MUST);
runQuery("voyage dans les chapitres 12, 15 et 20", query6);

// Recherche n°7 : vie dans les balises <p> des chapitres pairs
// 83 résultats
BooleanQuery query7 = new BooleanQuery();
query7.add(new TermQuery(new Term("contenu", "vie")), Occur.MUST);
query7.add(new TermQuery(new Term("pair", "1")), Occur.MUST);
query7.add(new TermQuery(new Term("balise", "p")), Occur.MUST);
runQuery("vie dans les chapitres pairs", query7);

Le champ "pair" est créé comme suit dans ChapitrePlusTeiLuceneIndexer :

if (numero % 2 == 0) {
    doc.add(new StringField("pair", "1", Store.NO));
}

Swing, interfaces graphiques en Java

• Package javax.swing.*
• Tous les éléments graphiques sont des objets
• Toutes les classes graphiques dérivent de java.awt.Component
• Tous les éléments qui peuvent en contenir d'autres dérivent de java.awt.Container

Quelques composants courants

• Fenêtre principale JFrame
• Menus
  • JMenuBar
  • JMenu
  • JMenuItem
• Bouton JButton
• Texte
  • JLabel
  • JTextField
  • JTextArea
  • JTextPane
• Sélecteur de fichier JFileChooser
• Conteneur de composants JPanel

Mise en page

• Dans un Container, on peut placer plusieurs composants graphiques, leur disposition et le comportement au redimensionnement va dépendre du gestionnaire de Layout choisi. Parmi les plus utilisés :
  • BorderLayout
  • FlowLayout
  • GridLayout
  • GridBagLayout
• Pour composer son interface, on peut utiliser un layout pour le conteneur principal puis ajouter un sous-conteneur qui dispose d'un autre layout

Personnalisation

• Pour personnaliser un élément graphique, on peut le faire de l'extérieur :

  ~~~~
  :::java
  import javax.swing.JFrame;
  ...
  JFrame frame = new JFrame();
  frame.setTitle("Mon application");
  frame.setSize(300,400);
  frame.setLocation(20, 400);
  ...
  frame.setVisible(true);
  ~~~~

Ou dériver la classe graphique :

import javax.swing.JFrame;
...
public class MaFenetre extends JFrame {
    /**
     * Constructeur
     */
    public MaFenetre() {
        setTitle("Mon application");
        setSize(300,400);
        setLocation(20, 400);
        ....
        setVisible(true);
    }
    ...
}

TP

Objectif : réutiliser le code de la classe ChapitreTeiLuceneSearcher dont le code source est disponible sur la page de la séance du [2013-04-10] pour développer une interface graphique permettant de rechercher dans l'index.

Étape 1

• Créer une classe ChapitreTeiLuceneGui qui hérite de javax.swing.JFrame.
• Dans le constructeur, initialiser son titre, sa taille, sa position à l'écran et sa visibilité
• Dans la méthode main(), créer une nouvelle instance de cette classe
• La fenêtre devrait s'afficher

On peut récupérer les dimensions de l'écran en utilisant la classe java.awt.Toolkit :

// Taille de l'écran
Dimension d = Toolkit.getDefaultToolkit().getScreenSize();

Pour adapter l'aspect de l'interface graphique à votre système d'exploitation, on pourra utiliser la classe javax.swing.UIManager :

// Look natif
try {
    UIManager.setLookAndFeel(
    UIManager.getSystemLookAndFeelClassName());
} catch (Exception e) {
    e.printStackTrace();
}

Étape 2

• Ajouter les menus :
  • Fichier
    • Ouvrir un dossier d'index... (CTRL-O)
    • Rechercher... (CTRL-F)
    • Quitter (CTRL-Q)
  • Aide
    • À propos (CTRL-F1)
• Désactiver le menu Rechercher...

Pour positionner un raccourci clavier sur un JMenuItem (CTRL-O ici) :

menuItem.setAccelerator(
    KeyStroke.getKeyStroke(KeyEvent.VK_O, ActionEvent.CTRL_MASK));

Pour désactiver un menu :

menu.setEnabled(false);

Étape 3

• Activer le menu "À Propos" pour qu'il affiche une information sommaire dans une boite de dialogue (JOptionPane)
• Activer le menu Quitter pour qu'il demande confirmation avant de quitter l'application
• Faire en sorte qu'un clic sur l'icône de fermeture de la fenêtre ait le même effet que de passer par le menu "Quitter"

Activer un menu :

JMenuItem menuItem = new JMenuItem("item");
....
menuItem.addActionListener(new ActionListener() {
    @Override
    public void actionPerformed(ActionEvent evt) {
        System.out.println("Coucou");   
    }
});

Changer le comportement lors de la fermeture de la fenêtre :

// Fermeture de la fenêtre
setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE);
this.addWindowListener(new WindowAdapter() {
    @Override
    public void windowClosing(WindowEvent evt) {
        // Instructions executées à la fermeture de la fenêtre
        ...
    }
});

Étape 4

• Ajouter un composant JTextArea au centre de votre fenêtre pour y afficher du contenu texte
• Ajouter une barre d'état (JLabel) en bas de votre fenêtre
• Activer le menu "Ouvrir un dossier d'index..." pour présenter une boite de dialogue de sélection de fichiers (JFileChooser) permettant de choisir un dossier. Afficher le chemin du dossier choisi dans la zone texte.
• Ajouter le code nécessaire pour ouvrir l'index Lucene sur le dossier choisi.
• Si l'ouverture se passe bien, dégriser le menu "Rechercher..."
• Sinon afficher un message d'erreur

Ouvrir un sélecteur de dossiers :

JFileChoose directoryBrowser = new JFileChooser();
directoryBrowser.setFileSelectionMode(JFileChooser.DIRECTORIES_ONLY);
if (directoryBrowser.showOpenDialog(this) != JFileChooser.APPROVE_OPTION) {
    // L'utilisateur a annulé
} else {
    // Affichage du dossier sélectionné
    System.out.println("Dossier = " + directoryBrowser.getSelectedFile());
}

Étape 5

• Activer le menu "Rechercher..." pour afficher une boite de dialogue permettant la saisie d'une expression à rechercher
• Brancher le code de la recherche et afficher les résultats dans la zone texte

Étape 6

• Utiliser un JTextPane plutôt qu'un JTextArea pour permettre le texte riche et le surlignement des résultats

[crim.fr, prof java]

Pour lancer l'application exemple :

java -jar teigui.jar