Migrating a JSF .view File Project to JSF Facelets Format

You can migrate a JSF .view file project to JSF Facelets format. Migrating the project updates the project facets to ensure they are using the latest versions and converts all .view files in the project to .xhtml files.

Note: After you migrate a project, any new views you add to the project are added subject to the setting for the UI Development preference Prefer JSF 2.x xhtml Facelet Templates for New Pages. For more information, see Enabling the JSF Facelets Functionality for New Projects and Views. While it is permissible to mix both .view files and .xhtml files in a JSF Facelets application, you are advised to migrate any .view files to .xhtml format.

1. Select the project or projects you want to migrate in the Project Explorer view or Navigator view.

2. Right-click the project and click CAF Tools > Migrate to JSF 2.x. In the migration wizard, do the following:

a. If one or more of the selected projects is not using the latest supported version of the project facet, the Migrate projects panel appears. All projects requiring a facet update are selected by default. Accept the default selections, or clear a check box to omit a project from being migrated. Click Finish to migrate the selected projects, all .view files, and any managed bean declarations, or click Next to refine your migration selections.

b. In the Migrate .view files panel, all .view files are displayed and selected by default. This panel appears first if all projects have up-to-date facets. Accept the default selections, or clear the check box for any .view file you do not want to migrate. Click Finish to migrate the .view files and any managed bean declarations, or click Next to refine your migration selections.

Note: If any of the .view files that are to be migrated have unsaved changes in an active editor, the wizard prompts you to select those files for saving before converting them. If you do not select the files for saving before conversion, the unsaved changes will not be included in the conversion.

c. If one or more of the projects contain bean declarations in the WEB-INF/faces-config.xml file, the declarations available for migration to Java annotations are displayed and selected. For more information about bean annotations, see About Migrating Managed Bean Declarations. Clear the check box for any declaration you do not want to migrate, then click Finish to complete the migration.