Restarting the server for a Faces JSP file

Each time you make certain changes in a Web application that is created with Faces components and running in a test environment, the server or Enterprise Application restarts. The changes that the server wants to pick up are ones that affect the configuration file for the Web application.

Each Web application created with Faces components contains a configuration file named faces-config.xml. This configuration file stores the following kinds of information for the Web project:

• Reusable Java classes added by the user

• Reusable Java classes that are added automatically, such as the page code class associated with each Faces JSP page

• Navigation rules that you set in the Properties views for the Command - Link and the Command - Button components

If the settings in faces-config.xml are changed, the application of the server is automatically restarted so that the application can pick up the changes. This restart may occur frequently if many new pages, data sources, or navigation rules are being added. If the server is restarting too frequently, you may find it interferes with development tasks. To work around this, choose one of the following options:

• To turn off the automatic restart feature, choose Window > Preferences > Web Tools > Faces > Server Behavior. Note that manually restart the application after you finish your configuration changes.

• Shut down the server until you are finished the changes that are affecting faces-config.xml.

After Faces JSP pages are built and after the navigation rules between them are defined, you can add Faces components and make layout changes without triggering a restart.

 

Related concepts

Faces components

 

Related tasks

Creating Faces applications - overview
Viewing page code for a Faces JSP file

Related reference
Faces components reference
Faces attributes reference