NetAdvantage for JSF 2007指南（1）

NetAdvantage for JSF 2007指南（1）
1、安装和部署Infragistics NetAdvantage for JSF 2007 vol.1
需要JavaServer Faces v1.1支持，下载jsf-api.jar和jsf-impl.jar到你的web应用程序的WEB-INF/lib目录下。
验证你的web应用程序的目录结构的正确性，如下：
－－－－－－－－－－－－－－－－－
- recources
  - infragistics
    + scripts
    + themes
  - WEB-INF
    + lib
－－－－－－－－－－－－－－－－－
注意：如你要指定一个不同的resources文件夹的位置，可以修改WEB-APP/conf/web.xml，如下：
－－－－－－－－－－－－－－－－－
<context-param>
    <param-name>com.infragistics.faces.RESOURCES_FOLDER</param-name>
    <param-value>/put the location of the resources folder here</param-value>
</context-param>
－－－－－－－－－－－－－－－－－
在部署时需要的文件和文件夹：
（1）JavaScript文件。/resources/infragistics/scripts文件夹下面必须包含NetAdvantage for JSF组件需要的JavaScript支持文件，这些文件必须放进install_dir/lib/runtime/resources/infragistics/scripts目录下；
（2）theme文件。这些文件是CSS和image文件，支持NetAdvantage for JSF组件的各种主题，这些文件必须部署到resources/infragistics/theme/theme_name目录下；
（3）JAR文件。这些文件是NetAdvantage for JSF组件所依赖的类包，必须放到WEB-INF/lib目录下。
NetAdvantage for JSF组件包有一定的针对性。尽管推荐所有的组件都部署到应用中，实际上可部署其子集。如：infragistics-webgrid.jar只用于WebGrid组件。
下表列出了每一个组件group需要的东东：
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
Component     |  Script Folder    |  Themes Folder               |  Lib Folder
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
*Shared           |  igf_core.js        | igf_shared.CSS/              |  infragistics-shared.jar
                          |  igf_ui.js            |                                              |
                          |  igf_effect.js      |                                             |
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
WebBar            |  igf_bar.js       | igf_bar.CSS/webbar/        |  infragistics-webbar.jar
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
WebGrid          |  igf_grid.js      |igf_grid.CSS/webgrid/       |  infragistics-webgrid.jar
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
WebInput        |  igf_input.js     |igf_input.CSS/webinput/   |  infragistics-webinput.jar
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
WebMenu       |  igf_menu.js   | igf_menu.CSS/webmenu/  |  infragistics-webmenu.jar
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
WebTab          |  igf_tab.js       | igf_tag.CSS/webtab/         |  infragistics-webtab.jar
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
WebTree        |  igf_tree.js      | igf_tree.CSS/webtree/       |  infragistics-webtree.jar
－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
*在部署时，Shared组件需要的文件和文件夹必须包含进部署目录。
2、看NetAdvantage for JSF的样例
如果你不想看到讨厌的提示窗口，你需要把infragistics-netadvantage.lic放入部署后的WEB-INF目录下。
3、Facelets支持
NetAdvantage for JSF组件应该工作在Facelet下。
4、Portlet支持
NetAdvantage for JSF组件可以运行在portlet服务器下面：
（1）JBoss
（2）Liferay
（3）IBM WebSphere
以JBoss为例，要安装和部署样例程序到JBoss2.4或更高版本：
（1）以run.bat开始启动JBoss；
（2）复制infragistics-netadvantage.war到JBoss的deploy下，其war文件中包含了jsf-impl.jar和jsf-api.jar，为避免与JBoss的JAR相冲突，可移走war中的这两个jar文件；
（3）在web.xml文件，定位下列行：
<listener-class>com.sun.faces.config.ConfigureListener</listener-class>
改为：
<listener-class>org.apache.myfaces.webapp.StartupServletContextListener</listener-class>
（4）去http://myfaces.apache.org下载Apache MyFaces 1.1.5，拷贝其JAR到WEB-INF/lib目录下。
（5）在Portlet.xml页中，定位下面行：
<portlet-class>com.sun.faces.portlet.FacesPortlet</portlet-class>
改为：
<portlet-class>org.apache.myfaces.portlet.MyFacesGenericPortlet</portlet-class>
（6）导航到JBoss Portal的Admin页面，点击Portlets链接，将出现一个有效的portlet列表。
（7）点击infragistics-netadvantage链接，出现一个对话框，允许你创建portlet实例。
（8）键入名字“Infragistics JSF Samples”，点击创建实例。这在JBoss中创建了一个portlet，你可以增加Starter portal页面。
（9）在Admin tab中，点击Portal链接，将展开Starter portal页面树，选择Infragistics JSF Samples，增加一个名为“samples”的Starter portal页面。
（10）点击Starter tab，将显示NetAdvantage for JSF samples。