Mit der Refactoring-Funktion der Workbench können Sie Quellendateien umbenennen und Verweise auf diese Dateien korrigieren.
Mit dem Refactoring können Sie EGL-Quellendateien oder JSP-Dateien, die durch einen JSF-Handler gesteuert werden, umbenennen.
- Wählen Sie an einer der folgenden Stellen die Datei aus, den Sie umbenennen wollen:
- Klicken Sie in der Sicht 'Projektexplorer' mit der rechten Maustaste auf die Datei.
- Klicken Sie bei Dateien, die einen Hauptabschnitt enthalten, in der Sicht 'Gliederung', 'Abschnittsliste' oder 'EGL-Abschnittsverweis' mit der rechten Maustaste auf den Hauptabschnitt.
- Stellen Sie bei Dateien, die einen Hauptabschnitt enthalten, den Cursor im EGL-Editor auf den Abschnittsnamen und klicken Sie mit der rechten Maustaste.
- Klicken Sie im Popup-Menü auf . Das Fenster 'Abschnitt umbenennen' wird geöffnet.
- Geben Sie im Fenster 'Abschnitt umbenennen' einen neuen Namen für die Datei ein und beachten Sie hierbei die EGL-Namenskonventionen.
- Wenn Sie auf Vorschau klicken, wird eine Liste der Änderungen angezeigt, die EGL vornimmt, falls Sie den Vorgang fortsetzen.
- Wenn Sie das Kontrollkästchen Verweise aktualisieren abwählen, sucht EGL nicht in anderen Dateien nach Verweisen, die geändert werden müssen. In den meisten Fällen sollte dieses Kontrollkästchen jedoch ausgewählt werden.
- Klicken Sie auf OK.
Beim Umbenennen einer Datei finden die folgenden Änderungen statt:
- EGL ändert den Namen der Datei in den neuen Namen.
- Bei Dateien, die einen Hauptabschnitt enthalten, ändert EGL den Namen des Abschnitts in den neuen Dateinamen.
- Bei Dateien, die einen Hauptabschnitt enthalten, sucht EGL im Buildpfad nach Verweisen auf diesen Abschnitt und ändert die Verweise so, dass sie mit dem neuen Namen des Abschnitts übereinstimmen. Wenn Sie beispielsweise eine Datei umbenennen, die ein aufgerufenes Programm enthält, ändert EGL den Code, der das Programm aufruft, so, dass der neue Name verwendet wird.
- Bei Dateien, die einen JSF-Handler enthalten, verlinkt EGL die JSP-Datei mit der neuen Datei und ändert alle Verweise in der JSP-Datei auf den JSF-Handler so, dass der neue Name verwendet wird. Der Name der JSP-Datei hingegen wird nicht geändert.
- Bei Dateien, die einen JSF-Handler enthalten, aktualisiert EGL Verweise auf die Datei in der Faces-Konfigurationsdatei.
- Bei JSP-Dateien, die durch einen JSF-Handler gesteuert werden, aktualisiert EGL die Eigenschaft
view des JSF-Handlers, damit auf die neue JSP-Datei verwiesen wird.
- Bei Programmabschnitten innerhalb eines EGL-Plug-in-Projekts wird der Verweis auf das Programm in der Datei 'plugin.xml' korrigiert.
Möglicherweise müssen Sie dennoch überprüfen, ob vom Refactoring weitere Änderungen verursacht werden.
EGL ändert beispielsweise keine Bezeichnungen, die mit der Anweisung
forward verwendet werden.
Angenommen, eine Codezeile übergibt die Steuerung wie folgt an einen JSF-Handler:
forward to "myWebPage";
Wenn Sie
myWebPage umbenannt haben, ändert EGL in diesem Fall die Anweisung
forward nicht, um die neue Bezeichnung für die Seite wiederzugeben. Sie müssen nach den entsprechenden Änderungen suchen und die Dateien manuell aktualisieren.