There are currently two wizards available in JBOSS Developer Studio JSF Tools. They include:
New JSF Project and;
New Faces Config.
The New JSF project wizard is detailed in JSF Tools Project Creation.
Section Feedback
The user has the option to define a new faces-config.xml file and to register that file in the web.xml file. The use of this wizard is discussed in the following procedures:
Procedure 6.1. JBoss Developer Studio New - Other (Wizard Selection)
Access the New - Select a wizard dialog
Select
→ →The New - Select a wizard screen displays.
The General folder in the above image can be expanded by clicking on the arrow highlighted in the image. This same technique can be applied to expanding folders in the Package Explorer view and is the technique used throughout this document.
Procedure 6.2. New Faces Config
Access the New - Select a wizard dialog
Click on the Faces Config label by expanding the → folders.
Click the
button to proceed.The New Faces Config - Faces Config screen displays.
Define the Project Attributes
Define the JSF Project Attributes according to the options displayed in Table 6.1, “New Faces Config”
Table 6.1. New Faces Config
Field | Mandatory | Instruction | Description |
---|---|---|---|
Folder | yes | Enter the folder to host the config file. | The folder is usually the WEB-INF/lib folder. |
Name | yes | Enter the name of the config file. | Remember to name the file differently to any existing config files. The .xml extension is not required |
Version | yes | Specify the config file version number. | The user has the option to select from multiple option as listed in Table 6.2, “New Config File - Version”. |
Register in web.xml | no | Select this option to register the file in the web.xml deployment descriptor. | Registering the file in the deployment descriptor will result in the file being read and available once the application is deployed. |
Table 6.2. New Config File - Version
Label | Description |
---|---|
1.0 | This option specifies the faces-config version 1.0 implementation. |
1.1 | This option specifies the faces-config version 1.1 implementation. |
1.2 | This option specifies the faces-config version 1.0 implementation. |
Access the config file editor.
Click the
button to complete the New Faces Config wizard.The new file is opened in the Diagram view of the faces-config-*.xml editor.
Futher details regarding the faces-config-*.xml
editor are available in the following procedures:
Section Feedback
The user has the option to define/create a .....project/file. The use of this wizard is discussed in the following procedure(s):
The relevant procedures are imported/included here.
The relevant procedures are imported/included here.
The relevant procedures are imported/included here.
The relevant procedures are imported/included here.
Section Feedback
Section Feedback
The relevant perspective for JBoss Developer Studio JSF Tools is the Web Development perspective. This perspective can be chosen according to the following procedure.
Procedure 6.3. Open Perspective
Access the Open Perspective dialog
Select
→ →The Open perspective dialog is displayed.
Select the perspective
Highlight the required perspective.
Click the
button to proceed.The user is returned to the main display with the development perspective changed to the selected type.
The following sections describe the views associated with the Web Development perspective.
The Web Projects view presents each web project in a format suitable for navigating through the various attributes of a typical web project such as Tag Libraries and web.xml properties. The Web Projects view is displayed in Figure 6.5, “Web Development Perspective - Web Projects View”
The components of that make up this view are described in the following list:
Web Development View - Web Projects Navigation
This option lists the content deployed to the server. The available navigation options include:
OMIT THE SUB-ITEMS HERE AND JUST LINK TO ANOTHER DESCRIPTION AS THERE ARE MANY SUB-ITEMS FOR SOME NAVIGATION OPTIONS?
META-INF: This folder includes the MANIFEST.MF
file ......
pages: This folder lists the jsp pages which will be deployed to the server. Clicking on a jsp page renders the page in the jsp files editor Section 9.2.1, “Placeholder for a link”.
WEB-INF: This folder lists the classes for the project.
This option lists the tag libraries associated with the project. Clicking on a library file renders the file in the JBoss Tools Tag Library Editor Section 9.2.1, “Placeholder for a link”.
This option lists the resources associated with the project. Details are available in Section 9.2.1, “Placeholder for a link”
This option lists the configuration settings (faces-config.xml
) for the project. Clicking on a config file renders the file in the Faces Config Editor Section 9.2.1, “Placeholder for a link”.
This option lists the Beans defined within the project. Clicking on a Bean file renders the file in a standard Java file editor.
This option lists the tiles associated with the project. Details are available in Section 9.2.1, “Placeholder for a link”
This option lists the web.xml settings and parameters. Clicking on the web.xml label or any sub item, renders the file in the Web XML Editor Accessing the JSF configuration file editor.
The icons associated with the Web Projects view are listed in Table 6.3, “Web Development Perspective - Web Projects View”
Table 6.3. Web Development Perspective - Web Projects View
Icon | Mouse-Over Description | Result |
---|---|---|
![]() [D] | Create New JSF Project | JSF Tools Project Creation |
![]() [D] | Import JSF Project | Section 9.2.1, “Placeholder for a link” |
![]() [D] | Create New Struts Project | Section 9.2.1, “Placeholder for a link” |
![]() [D] | Import Struts Project | Section 9.2.1, “Placeholder for a link” |
Section Feedback
The Palette view is activated when a Java Server Page (.jsp) file is selected. The Web Projects view is displayed in Figure 6.5, “Web Development Perspective - Web Projects View”.
This view, by default, is comprised of the following tabs:
JBoss Ajax4jsf
JBoss RichFaces
JBoss Seam
JBoss Facelets
JBoss HTML
IT WILL BE OVERKILL TO LIST ALL OF THE TAGS WITH A DESCRIPTION FOR EACH (THERE ARE MANY). IT IS PREFERABLE TO PROVIDE A SAMPLE PROCEDURE ON HOW TO INSERT A TAG INTO A JSP PAGE.
These tabs refer to the tag set available for insertion into the jsp page. Once the tab is selected, the list will be expanded and a tag may be inserted as descibed in Section 9.2.1, “Placeholder for a link”
Further palettes may be selected by clicking on the Palette Editor icon listed in Table 6.4, “Web Development Perspective - Web Projects View”
The icons associated with the Web Projects view are listed in Table 6.4, “Web Development Perspective - Web Projects View”
Table 6.4. Web Development Perspective - Web Projects View
Icon | Mouse-Over Description | Result |
---|---|---|
![]() [D] | Palette Editor | Section 9.2.1, “Placeholder for a link” |
![]() [D] | Show/Hide | Section 9.2.1, “Placeholder for a link” |
![]() [D] | Import | Section 9.2.1, “Placeholder for a link” |
Section Feedback
Section Feedback
NOT IMPLEMENTING THIS SECTION UNLESS WE DISCOVER A NEED FOR IT.
Section Feedback
NOT IMPLEMENTING THIS SECTION AS THIS IS COVERED IN PROCEDURES (MAY DISCOVER SOME NEED LATER PERHAPS).
Section Feedback
NOT IMPLEMENTING THIS SECTION AS ICONS COVERED IN THE VIEWS SECTION (BUTTONS ARE THE SAME AS ICONS? AGAIN PERHAPS IMPLEMENT BUTTONS LATER).
Section Feedback