| <?xml version="1.0" encoding="UTF-8" ?> |
| <cheatsheet title="Faces Configuration Editor"> |
| |
| <intro |
| href="/org.eclipse.platform.doc.user/reference/ref-cheatsheets.htm"> |
| <description> |
| This cheat sheet will demonstrate how to edit a JSF |
| configuration file with Faces Config Editor. |
| <br /> |
| <br /> |
| To learn more about using cheat sheets, click the help |
| button in the top right corner (?). |
| </description> |
| </intro> |
| |
| <!-- Item --> |
| |
| <item title="Open the J2EE perspective" |
| href="/org.eclipse.jst.j2ee.doc.user/topics/cjpers.html" |
| dialog="false" skip="true"> |
| <description> |
| To open the J2EE perspective, select |
| <b>Window->Open Perspective->Other...</b> |
| and choose |
| <b>J2EE</b> |
| . |
| <br /> |
| <br /> |
| Alternatively, click the following button to perform the |
| task. |
| </description> |
| <command |
| serialization="org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.jst.j2ee.J2EEPerspective)" /> |
| </item> |
| |
| <!-- Item --> |
| |
| <item title="Create the JSF web project" |
| href="/org.eclipse.jst.jsf.doc.user/html/tasks/create_jsf_app.html" |
| dialog="true" skip="false"> |
| <description> |
| To create the JSF web application perform the following |
| steps |
| </description> |
| <subitem |
| label="Select "File->New->Project..." from the main menu and choose "Dynamic Web Project" from the resulting "New Project" dialog box" |
| skip="false"> |
| <command |
| serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.jst.servlet.ui.project.facet.WebProjectWizard)" /> |
| </subitem> |
| <subitem |
| label="Input "JSFApplication" into the "Project Name" text box" |
| skip="false" /> |
| <subitem |
| label="Select "JavaServer Faces v1.1 Project" in the "Configurations" dropdown box" |
| skip="false" /> |
| <subitem |
| label="Accept the rest of the default preloaded values on the "Dynamic Web Project" page and click "Next"" |
| skip="false" /> |
| <subitem |
| label="Accept the rest of the default preloaded values on the "Project Facets" page and click "Next"" |
| skip="false" /> |
| <subitem |
| label="Accept the rest of the default preloaded values on the "Web Module" page and click "Next"" |
| skip="false" /> |
| <subitem |
| label="Specify JSF Facet Settings on the "JSF Capabilities" page and click "Finish"" |
| skip="false" /> |
| </item> |
| |
| <item title="Open the JSF configuration file" |
| href="/org.eclipse.jst.jsf.doc.user/html/tasks/use_facesconfig_editor.html" |
| dialog="true" skip="false"> |
| <description> |
| To open the JSF configuration file, Expand the |
| WebContent/WEB-INF/ folder in the "Project |
| Explorer" view; Double click on the |
| "faces-config.xml" file to open it. Or right click |
| on it then select "Open With" -> "FacesConfig |
| Editor" |
| </description> |
| <subitem |
| label="Expand the /JSFApplication/WebContent/WEB-INF/ folder in the "Project Explorer" view; " |
| skip="true"> |
| </subitem> |
| <subitem |
| label="Double click on the "faces-config.xml" file to open it. |
| Or right click on it then select "Open With" -> "FacesConfig Editor"" |
| skip="false"> |
| <command |
| serialization="org.eclipse.ui.navigate.openResource(filePath=JSFApplication/WebContent/WEB-INF/faces-config.xml)" /> |
| </subitem> |
| </item> |
| |
| |
| <item href=" " title="Get an introduction on the FacesConfig Editor" |
| dialog="false" skip="true"> |
| <description> |
| On the "Introduction " page, there are some |
| introductions about the FacesConfig Editor, and some links |
| to start work with it, or show user the tutorial and help |
| documentation. |
| </description> |
| </item> |
| |
| |
| <item href=" " title="Get an overview of the content" dialog="false" |
| skip="true"> |
| <description> |
| On the "Overview " page, there are several tables |
| that list the main elements defined in the current faces |
| config file. By double-clicking on an element, user could be |
| guided to the corresponding page to edit it. |
| </description> |
| </item> |
| |
| <item |
| href="/org.eclipse.jst.jsf.doc.user/html/tasks/define_navigations.html" |
| title="Create a Navigation Rule"> |
| <description> |
| To create a navigation rule perform the following steps |
| </description> |
| <subitem |
| label="Use the JSP Page wizard to create a page called " login.jsp " in the Web Content folder of the new application. |
| In the Select Templates page of the wizard, select the "New JSP(html) " template. Click Finish." |
| skip="false"> |
| <command |
| serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.jst.jsp.ui.internal.wizard.NewJSPWizard)" /> |
| </subitem> |
| <subitem |
| label="In the same way, create a page called "welcome.jsp " ." |
| skip="false"> |
| <command |
| serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.jst.jsp.ui.internal.wizard.NewJSPWizard)" /> |
| </subitem> |
| <subitem |
| label="Select the "Page" control from the "Palette" and drop it on the "Navigation" tab. |
| Choose the page in the resulting "Select JSP File" dialog. " |
| skip="false" /> |
| <subitem |
| label="Connect the two pages. Click on the "Link" control in the "Palette", select the "login" page and draw a line to the "welcome" page. |
| Select the line in the "Navigation" tab and in the property view, set the value of the "from-outcome" to "login" . " |
| skip="false" /> |
| <subitem |
| label="Swith to the "Source" page, will find that there is a navigation-rule element created." |
| skip="false" /> |
| </item> |
| |
| <item |
| href="/org.eclipse.jst.jsf.doc.user/html/tasks/create_managedbean.html" |
| title="Create a Managed Bean"> |
| <description> |
| To create a managed bean perform the following steps |
| </description> |
| <subitem |
| label="Switch to the "ManagedBean" page; click the "New" button, the new managed bean wizard pops up." |
| skip="false" /> |
| <subitem |
| label="On the "Java Class Selection" page, choose "Create a new Java class", then click "Next"." |
| skip="false" /> |
| <subitem |
| label="On the "Java Class" page, input "com.tutorial" into the "Package" field and input "LoginBean" into the "Name" field, |
| then click "Next" to the next page." |
| skip="false" /> |
| <subitem |
| label="On the "Managed Bean Configuration" page, accept the default values and click "Finish" to finish this wizard." |
| skip="false" /> |
| <subitem |
| label="Swith to the "Source" page, will find that there is a managed-bean element created." |
| skip="true" /> |
| </item> |
| |
| <item |
| href="/org.eclipse.jst.jsf.doc.user/html/tasks/facesconfig_ui/add_component.html" |
| title="Create a Component"> |
| <description> |
| To create a component perform the following steps |
| </description> |
| <subitem |
| label="Switch to the "Component" page; expand the "Components" section; " |
| skip="false" /> |
| <subitem |
| label="Click the "New" button, a new empty component element is created." |
| skip="false" /> |
| <subitem |
| label="On the right part, fill in the essential fields for this component, for example "Component Type", "Component Class"." |
| skip="false" /> |
| <subitem |
| label="Swith to the "Source" page, will find that there is a component element created." |
| skip="false" /> |
| </item> |
| |
| |
| <item |
| href="/org.eclipse.jst.jsf.doc.user/html/tasks/facesconfig_ui/add_converter.html" |
| title="Create a Converter"> |
| <description> |
| To create a converter perform the following steps |
| </description> |
| <subitem |
| label="Switch to the "Component" page; expand the "Converters" section; " |
| skip="false" /> |
| <subitem |
| label="Click the "New" button, a new empty converter element is created." |
| skip="false" /> |
| <subitem |
| label="On the right part, fill in the essential fields for this converter, for example "Converter ID", "Converter Class"." |
| skip="false" /> |
| <subitem |
| label="Swith to the "Source" page, will find that there is a converter element created." |
| skip="false" /> |
| </item> |
| |
| <item |
| href="/org.eclipse.jst.jsf.doc.user/html/tasks/facesconfig_ui/add_renderkit.html" |
| title="Create a Render Kit"> |
| <description> |
| To create a render-kit perform the following steps |
| </description> |
| <subitem |
| label="Switch to the "Component" page; expand the "RenderKits" section; " |
| skip="false" /> |
| <subitem |
| label="Click the "New" button, a new empty render-kit element is created." |
| skip="false" /> |
| <subitem |
| label="On the right part, fill in the essential fields for this converter, for example "Renderkit ID", "Renderkit Class"." |
| skip="false" /> |
| <subitem |
| label="Swith to the "Source" page, will find that there is a render-kit element created." |
| skip="false" /> |
| </item> |
| |
| <item |
| href="/org.eclipse.jst.jsf.doc.user/html/tasks/facesconfig_ui/add_validator.html" |
| title="Create a Validator"> |
| <description> |
| To create a validator perform the following steps |
| </description> |
| <subitem |
| label="Switch to the "Component" page; expand the "Validators" section; " |
| skip="false" /> |
| <subitem |
| label="Click the "New" button, a new empty validator element is created." |
| skip="false" /> |
| <subitem |
| label="On the right part, fill in the essential fields for this converter, for example "Validator ID", "Validator Class"." |
| skip="false" /> |
| <subitem |
| label="Swith to the "Source" page, will find that there is a validator element created." |
| skip="false" /> |
| </item> |
| |
| <item |
| href="/org.eclipse.jst.jsf.doc.user/html/tasks/use_facesconfig_editor.html" |
| title="Editing other elements on the Others Page"> |
| <description> |
| On the "Others" page, there are several sections |
| for editing the elements such as |
| "action-listener", "locale-config", and |
| so on. |
| </description> |
| </item> |
| |
| <item title="Source Page"> |
| <description> |
| The "Source" page is a embeded XML editor, user can edit the xml source of faces config directly here. |
| </description> |
| </item> |
| |
| <item title="Completion"> |
| <description> |
| Congratulations, you should now be able to use this editor fluently. |
| </description> |
| </item> |
| </cheatsheet> |