blob: 738ae8b8c53e7e3d6ee5cdac9349ad29211f8147 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC"-//W3C//DTD HTML 4.01 Transitional//EN">
<html lang='zh'>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="Content-Language" content="zh-cn">
<title>NetBeans Visual Web Pack 5.5 发行说明</title>
<link rel="stylesheet" type="text/css" href="../../../netbeans.css">
<meta name="description" content="本指南提供了 NetBeans Visual Web Pack 不同发行版本之间的更改、有关配置和已知问题的说明以及指向其他 Visual Web Pack 文档的链接信息。">
<meta name="keywords" content="常见问题解答, 配置, FAQ">
</head>
<body>
<a name=top></a>
<h1>NetBeans Visual Web Pack 5.5 发行说明 </h1>
<!-- <p>Last Updated: October 2006</p> -->
<p>NetBeans Visual Web Pack 5.5 为快速构建 Web 应用程序(具有 AJAX 的 JavaServer Faces 组件以及拖放式数据源绑定支持等)提供了一个环境平台。 </p>
<p><b>目录</b></p>
<ul>
<li> <a href="#sysreq" title="先决条件">系统要求</a> </li>
<li> <a href="#configinfo" title="配置信息">配置信息</a> </li>
<li><a href="#sampleapp">样例应用程序 </a></li>
<li><a href="#changenotes">更改说明 </a></li>
<li><a href="#knownissues">已知问题</a></li>
<li><a href="#documentation">文档</a></li>
<li> <a href="#more_information">更多信息</a></li>
</ul>
<br> <!-- FOR REVIEW -->
<p><b>注意:</b>NetBeans Visual Web Pack 5.5 包含的 AJAX 组件仅作为样例使用,并不适用于产品应用程序。 </p>
<!-- PREREQUISITES -->
<h2><a name=sysreq></a>系统要求</h2>
<p>本主题列出了在开始安装 NetBeans Visual Web Pack 5.5 之前必须具备的先决条件。</p>
<blockquote>
<h3>系统设置</h3>
<p>下表列出了运行 NetBeans Visual Web Pack 5.5 所需的硬件和操作系统的最低配置要求:</p>
<table BORDER=1 CELLPADDING=4 CELLSPACING=3 summary="minimum h/w and OS specs">
<col width=36*>
<col width=36*>
<col width=36*>
<col width=36*>
<col width=36*>
<col width=77*>
<tr valign=top>
<th width=14%> <p>
平台</p></th>
<th width=14%> <p>CPU</p></th>
<th width=8%> <p align="center">RAM</p></th>
<th width=8%> <p>硬盘空间</p></th>
<th width=20%> <p>操作系统</p></th>
<th width=24%> <p>支持的浏览器</p></th>
</tr>
<tr valign=top>
<td width=14%> <p>Solaris SPARC</p></td>
<td width=14%> <p>处理速度为 750 MHz 的 UltraSPARC III</p></td>
<td width=8%> <p align="center">1 GB </p></td>
<td width=8%> <p align="center">130 MB </p></td>
<td width=20%> <p>Solaris 10 OS</p></td>
<td width=24%> <p> Sun 支持的 Mozilla 1.7 </p></td>
</tr>
<tr valign=top>
<td width=14%> <p>Solaris (x86 Platform Edition)</p></td>
<td width=14%> <p>处理速度为 1 GHz 的 Intel Pentium 4(或与之等效的 CPU)</p></td>
<td width=8%> <p align="center">1 GB</p></td>
<td width=8%> <p align="center">130 MB</p></td>
<td width=20%> <p> Solaris 10 OS</p></td>
<td width=24%> <p> Sun 支持的 Mozilla 1.7 </p></td>
</tr>
<tr valign=top>
<td width=14%> <p>Microsoft Windows</p></td>
<td width=14%> <p>处理速度为 1 GHz 的 Intel Pentium 4(或与之等效的 CPU)</p></td>
<td width=8%> <p align="center">1 GB</p></td>
<td width=8%> <p align="center">130 MB</p></td>
<td width=20%> <p>Windows 2000 Professional Edition (Service Pack 4)、<br> Windows XP Professional Edition (Service Pack 2)<br>
</p></td>
<td width=24%> <p>Internet Explorer 5.5 Service Pack 2 (Windows 2000)<br> Internet Explorer 6 Service Pack 2 (Windows XP)
</p></td>
</tr>
<tr valign=top>
<td width=14%> <p>Linux </p></td>
<td width=14%> <p>处理速度为 1 GHz 的 Intel Pentium 4(或与之等效的 CPU)</p></td>
<td width=8%> <p align="center">1 GB</p></td>
<td width=8%> <p align="center">130 MB</p></td>
<td width=20%> <p>Red Hat Fedora Core 3(在 zh_CN 语言环境中运行时会出现问题,并且在其他亚洲语言环境中也有可能出现此类问题);请参见下面“已知问题”中的<a href="#render">呈现问题</a>)。
</p></td>
<td width=24%> <p>Firefox 1.0.4(最低配置) </p></td>
</tr>
<tr valign=top>
<td width=14%> <p>Mac OS</p></td>
<td width=14%> <p>1 GHz PowerPC G4<br> 1.83 GHz Intel Dual Core </p></td>
<td width=8%> <p align="center">1 GB</p></td>
<td width=8%> <p align="center">130 MB</p></td>
<td width=20%> <p>Macintosh OS 10.4、10.4.5 </p></td>
<td width=24%> <p>最低配置为 Safari 1.2.1(对于 OS 10.4.5,最低配置为 Safari 2)、Mozilla 1.6</p></td>
</tr>
</table><br><br>
<h3>所需的软件</h3>
<p>在安装 NetBeans Visual Web Pack 5.5 之前,必须先安装以下软件:</p>
<ul>
<li><a href="http://services.netbeans.org/downloads/" target="_blank">NetBeans IDE 5.5</a></li>
<li><a href="http://java.sun.com/javase/downloads/index.jsp" target="_blank">Java SE Development Kit (JDK) 5.0 Update 6(版本 1.5.0_06)</a>或更高版本。<br><br>如果未安装 JDK 5.0 Update 6 或更高版本,则无法执行此安装。您可以从 <a href="http://java.sun.com/javase/downloads/index.jsp" target="_blank">Java SE 下载</a>页中下载此 JDK。<br> <br>请注意,Mac OS X 安装需要 Java 2 Standard Edition (J2SE) 5.0 Release 4。您可以从 <a href="http://www.apple.com/support/downloads/" target="_blank">Apple 下载页</a>中下载此 JDK。请搜索 &quot;J2SE&quot; 以查找此发行版本。 </li>
<li> 应用服务器<br> <br>要利用 Visual Web Pack 的样例应用程序和数据库并通过 Java EE 5 开发 Visual Web 应用程序,请使用 Sun Java System Application Server 9 Platform Edition(开放源代码 Java EE 5 应用服务器)。有关详细信息,请参见 <a href="http://www.sun.com/software/products/appsrvr/index.xml" target="_blank">Java EE 下载</a></li>
</ul>
<br>
<h3>支持的技术</h3>
<p><b>NetBeans Visual Web Pack 5.5 支持以下技术:</b></p>
<ul>
<li>Enterprise JavaBeans (EJB) 3.0</li>
<li>JAX-WS 2.0</li>
<li>Java Persistence (JSR-220)</li>
<li>JavaServer Faces 1.2 (JSR-127)</li>
<li>Java Servlet 2.5</li>
<li>JavaServer Pages (JSP) 2.1</li>
<li>Struts 1.2.9</li>
<li>Java API for XML-based Remote Procedure Calls (JAX-RPC) 1.6</li>
<li>Java APIs for XML Registries (JAXR) 1.0</li>
<li>Java API for XML Processing (JAXP) 1.2</li>
<li>JavaServer Pages Standard Tag Library 1.1</li>
</ul>
<div class="greybox" style="">
<p><b>注意:</b>如果使用的 JBoss、WebLogic 或 Struts 版本不是明确列出的版本,则可能会导致 IDE 出现不可预料的行为,这是因为它们是外部接口,不能被项目组所控制。 </p>
</div>
<p><b>在 NetBeans IDE 5.5 中测试通过了以下应用服务器:</b></p>
<ul>
<li>Sun Java System Application Server PE 9.0 Update Release 1</li>
<!--<li>Sun Java System Application Server PE 8.1 update 2</li>-->
<li>Sun Java System Application Server PE 8.2</li>
<li>Tomcat 5.5.17</li>
<li>JBoss 4.0.4</li>
<li>WebLogic 9.1</li>
</ul>
<div class="greybox">
<p>如果使用的是 GlassFish 应用服务器,则建议您将 GlassFish V1 UR1 最终版本与 NetBeans IDE 5.5 一起使用。</p>
</div>
<h3>防火墙应用程序</h3>
<p>启用防火墙应用程序可能无法在安装过程中正确配置某些组件。请参阅防火墙文档以确定在安装之前是否应禁用防火墙。</p>
</blockquote> <p align=center><a href="#top">返回页首</a></p>
<!-- CONFIG INFO -->
<h2><a name=configinfo></a>配置信息</h2>
<p>有关为 NetBeans Visual Web Pack 5.5 配置数据库和应用服务器的信息,请参见<a href="vwp-install_zh_CN.html#configinfo">安装指南</a></p>
<p>如果为 Visual Web Pack 配置使用 Sun Java System Application Server 9 Platform Edition,则会包括一个捆绑的数据库服务器 (Java DB)。有关 Java DB 的详细信息,请参见 <a href="http://developers.sun.com/prodtech/javadb/" title="Java DB 概览" target="_blank">Java DB 概览</a>。一旦配置了 Sun Java System Application Server,则在重新启动 IDE 后,将会配置名为 <b>Travel</b> 的样例数据库以及 <b>Travel</b> 的数据库连接。如果删除位于 <tt>&lt;HOME&gt;/.netbeans/5.5</tt> 下面的 home 目录,则在下次重新配置 Sun Java System Application Server 之前数据库将保持原样。样例数据库目录位于 home 目录 <tt>.netbeans-derby</tt> 中。 </p>
<p><span class="bold"><b>注意:</b></span>在解析 Travel 数据库的数据库连接之前,您必须启动 Java DB。 </p>
<blockquote>
<h3><a name="bundledDB"></a>捆绑的数据库</h3>
<p>如果安装了 Sun Java System Application Server,您还可以将捆绑的 Java DB 数据库设置为与 NetBeans Visual Web Pack 5.5 一起使用。 </p>
<p>为单独的 NetBeans IDE 5.5 安装设置 Java DB 服务器:
<ol>
<li>启动 IDE。</li>
<li>按照<a href="vwp-install_zh_CN.html#config_sjas">安装指南</a>中所述,在 NetBeans IDE 的“运行环境”窗口中注册 Sun Java System Application Server。
<li>选择“工具”&gt;“选项”,然后在“选项”对话框中单击“高级选项”。</li>
<li>展开“IDE 配置”&gt;“服务器和外部工具设置”,然后选择“Java DB 数据库”以验证数据库设置。</li>
</ol>
<h3>恢复数据库连接<a name="restdbcon"></a></h3>
<p>在 Visual Web Pack 中打开组件与行集绑定的 Java Studio Creator 项目时,IDE 找不到该数据源。将 Java Studio Creator 项目导入到 Visual Web Pack 时,IDE 会建议您备份该项目,因为您将无法在 Java Studio Creator 中重新打开它。要解决缺少数据连接的问题,请先添加数据库驱动程序,然后将项目重新连接到数据库。如果项目使用 Java DB,并且按照<a href="#bundledDB">捆绑的数据库</a>中所述安装了 Sun Java System Application Server,则不需要添加数据库驱动程序。 </p>
<div>添加数据库驱动程序: </div>
<ol>
<li>打开“运行环境”窗口。 </li>
<li>展开“数据库”节点。右键单击“驱动程序”,然后选择“新建驱动程序”。 </li>
<li>在“新建 JDBC 驱动程序”窗口中,单击“添加”。导航至数据库的 <tt>.jar</tt> 文件,然后单击“打开”。</li>
<li>选择“驱动程序类”,键入数据库的名称(或保留缺省名称),然后单击“确定”。 </li>
<li>右键单击“数据库”节点,然后选择“新建连接”。</li>
<li>
<p>在“新建数据库连接”对话框中: </p>
<ol type="a">
<li>从“名称”下拉列表中选择该数据库。</li>
<li>键入数据库 URL。</li>
<li>键入用户名和口令。 </li>
<li>单击“确定”。 </li>
</ol>
</li>
<li>在“数据库”节点下面,右键单击与该数据库关联的数据库 URL,然后选择“连接”。系统会提示您输入口令。</li>
</ol>
<p>有关驱动程序和数据库 URL 的详细信息,请参见<a href="#sup_dat">支持的数据库、JDBC 驱动程序和部署容器</a></p>
<div>解决数据库连接问题:</div>
<ol><li>
<p>打开“项目”窗口。IDE 将搜索是否缺少数据连接。请注意,项目越大,搜索过程越长。</p>
当 IDE 确定了缺少的数据连接时,它将标记项目节点图标并以红色显示项目名称。</li>
<li>右键单击缺少数据连接的项目,然后从弹出式菜单中选择“解决数据库问题”。</li>
<li>在“解决数据源”对话框中,选择数据库名称,然后单击“添加数据连接”。</li>
<li>
<p>在“添加数据库连接”对话框中,从“服务器类型”下拉列表中选择您的数据库,提供要求的信息,然后单击“确定”。</p>
对于使用 Java DB 的 Java Studio Creator 应用程序,请键入与该应用程序关联的用户 ID 和口令。例如,CorporateTravelCenter 项目的用户 ID 和口令均为 <tt>travel</tt>。数据库 URL 为:<tt>jdbc:derby://<em>host_name</em>:<em>port_number</em>/<em>database_name</em></tt>。例如,与 Java DB 捆绑在一起的 Travel 数据库的数据库 URL 在缺省端口上为 <tt>jdbc:derby://localhost:1527/travel</tt></li>
</ol>
<h3><a name="sup_dat"></a>支持的数据库、JDBC 驱动程序和部署容器</h3>
<p>经测试,NetBeans Visual Web Pack 5.5 可以与下列数据库和驱动程序配合使用:
<ul><li><a href="#oracleoracle">Oracle 驱动程序/Oracle 数据库</a></li>
<li><a href="#mssql">Microsoft 驱动程序/SQL Server 数据库</a></li>
<li><a href="#ibmdb2">IBM 驱动程序/DB2 数据库</a></li>
<li><a href="#dd">DataDirect/Oracle/SQLServer/DB2/Sybase </a></li>
</ul>
<p class="titlectable"><a name="oracleoracle"></a>运行于 Oracle 数据库之上的 Oracle 驱动程序:
<table BORDER=1 CELLPADDING=4 CELLSPACING=3 summary="oracle driver info" width="60%">
<col width="1*"><col width="3*"><tr><td width="14%">驱动程序位置</td><td><a href="http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/htdocs/jdbc_10201.html" target="_blank">Oracle Database 10g Release 2 JDBC 驱动程序</a></td>
</tr>
<tr>
<td>驱动程序版本</td>
<td>Oracle Database 10g Release 2 (10.2.0.2)
</td></tr>
<tr>
<td>驱动程序 JAR 文件</td>
<td><tt> ojdbc14.jar </tt></td>
</tr>
<tr>
<td>驱动程序类名</td>
<td> oracle.jdbc.driver.OracleDriver </td>
</tr>
<tr>
<td>URL 格式</td>
<td> jdbc:oracle:thin:@//<em>hostname</em>:<em>port</em>/<em>database</em></td>
</tr>
<tr>
<td>示例 URL</td>
<td> jdbc:oracle:thin:@//localhost:1521/ora9i </td>
</tr></table>
</p>
<p><a name="mssql"></a><span class="titlectable">运行于 SQL Server 数据库之上的 Microsoft 驱动程序:</span>
<table BORDER=1 CELLPADDING=4 CELLSPACING=3 summary="ms sql driver info" width="60%">
<col width="1*"><col width="3*"><tr><td width="14%">驱动程序位置</td>
<td><a href="http://www.microsoft.com/downloads/details.aspx?FamilyId=6D483869-816A-44CB-9787-A866235EFC7C&displaylang=en" target="_blank">Microsoft SQL Server 2005 JDBC Driver 1.1</a></td>
</tr>
<tr><td>驱动程序版本</td>
<td>Microsoft SQL Server 2005 JDBC Driver 1.1<br> <tt>sqljdbc_1.1.1501.101_enu.tar.gz</tt></td>
</tr>
<tr>
<td>驱动程序 JAR 文件</td>
<td><tt>sqljdbc.jar</tt></td>
</tr>
<tr><td>驱动程序类名</td><td> com.microsoft.sqlserver.jdbc.SQLServerDriver </td>
</tr>
<tr><td>URL 格式</td>
<td> jdbc:sqlserver://<em>hostname</em>:1433;databaseName=<em>database</em>;selectMethod=cursor </td>
</tr>
<tr><td >示例 URL</td><td> jdbc:sqlserver://localhost:1433;databaseName=travel;selectMethod=cursor </td>
</tr></table></p>
<p class="titlectable"><a name="ibmdb2"></a>运行于 DB2 数据库之上的 IBM 驱动程序:
<table BORDER=1 CELLPADDING=4 CELLSPACING=3 summary="ibm driver info" width="62%"><col width="1*"><col width="3*"><tr><td width="14%">驱动程序位置</td><td><a href="https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?pkgid=&S_SRCID=rjd&source=rjd&S_TACT=104AH+W42&S_CMP=&S_PKG=dl_82&s=z&ltype=input&l=All+Lang+per+ESD%2FPA+Media&mtype=input&m=download&id=2004-09-20+10%3A09%3A21.003415R&fam=&cat=" target="_blank">DB2 Personal Developer's Edition:Redistributable DB2 JDBC Type 4 Driver</a>(需要注册)</td>
</tr>
<tr><td>驱动程序版本</td><td>Redistributable DB2 JDBC Type 4 driver v8 fixpack 11 <br> <tt>db2_jdbc_t4_fp11.zip</tt></td>
</tr>
<tr><td>驱动程序 JAR 文件</td>
<td>Type 4<ul>
<li><tt>db2jcc.jar</tt></li>
<li><tt>2jcc_license_cu.jar</tt></li>
</ul></td>
</tr>
<tr><td>驱动程序类名</td><td> com.ibm.db2.jcc.DB2Driver </td>
</tr>
<tr>
<td>URL 格式 (Type 4) </td>
<td> jdbc:db2://<em>hostname</em>:<em>port</em>/<em>database</em> </td>
</tr>
<tr><td>示例 URL</td>
<td>jdbc:db2://localhost:50002/sample</td>
</tr></table> </p>
<p><b>注意:</b>IBM 驱动程序支持 Type 2(本机)和 Type 4(纯 Java)。要使驱动程序以 Type 4 方式运行,请在连接数据库时添加属性 driverType = 4。</p>
<p class="titlectable"><a name="dd"></a>运行于 Oracle、SQL Server、DB2 和 Sybase 数据库之上的 DataDirect 驱动程序:</p>
<table BORDER=1 CELLPADDING=4 CELLSPACING=3 summary="datadirect driver info" width="68%"><col width="1*"><col width="3*"><tr><td width="14%">驱动程序位置</td><td><a href="http://www.datadirect.com/downloads/registration/connect_jdbc/index.ssp" target="_blank">DataDirect Connect for JDBC, Release 3.6 Service Pack 1</a></td>
</tr>
<tr>
<td>驱动程序版本</td>
<td>DataDirect Connect for JDBC - 3.6<br> DataDirect Connect for JDBC - 3.6.07
</td></tr>
<tr>
<td>驱动程序 <tt>.jar</tt> 文件</td><td>DataDirect 驱动程序 <tt>.jar</tt> 文件
<ul>
<li><tt>base.jar</tt></li>
<li><tt>util.jar</tt></li>
<li><tt>spy.jar</tt></li>
<li><tt>resource.jar</tt></li>
<li><tt>oracle.jar</tt></li>
<li><tt>sybase.jar</tt></li>
<li><tt>sqlserver.jar</tt></li>
<li><tt>db2.jar</tt></li>
<li><tt>informix.jar</tt></li>
</ul></td>
</tr>
<tr>
<td>驱动程序类名</td>
<td>DataDirect 驱动程序类
<ul>
<li>com.ddtek.jdbc.oracle.OracleDriver</li>
<li>com.ddtek.jdbc.sqlserver.SQLServerDriver</li>
<li>com.ddtek.jdbc.db2.DB2Driver</li>
<li>com.ddtek.jdbc.sybase.SybaseDriver</li>
</ul></td></tr>
<tr>
<td>URL 格式</td>
<td></li>
</ul>
DataDirect URL 格式
<ul>
<li>jdbc:datadirect:oracle://<em>server_name</em>[:<em>portNumber</em>];SID=<em>database</em></li>
<li>jdbc:datadirect:sqlserver://<em>server_name</em>[:<em>portNumber</em>];databaseName=<em>database</em></li>
<li>jdbc:datadirect:db2://<em>server_name</em>[:<em>portNumber</em>]databaseName=<em>database</em></li>
<li>jdbc:datadirect:sybase://<em>server_name</em>[:<em>portNumber</em></li>
</ul></td></tr>
<tr>
<td>示例 URL</td>
<td><tt>jdbc:datadirect:oracle://localhost;SID=ora9i</tt><br> <tt>jdbc:datadirect:sqlserver://localhost:1433;DatabaseName=travel;SelectMethod=cursor</tt><br> <tt>jdbc:datadirect:db2://localhost:50002;databaseName=sample</tt></td>
</tr></table>
</blockquote>
<p align=center><a href="#top">返回页首</a></p>
<!-- SAMPLE APPLICATIONS --> <a name="sampleapp"></a><h2>样例应用程序</h2>
<p>要使用任何 Visual Web Pack 样例应用程序,您必须新建一个使用该应用程序的 Visual Web 项目,然后将该项目连接到样例数据库(如果已提供)。</p>
<p>
Visual Web Pack 更新可能包含新的样例数据库和样例应用程序。更新后,要查看是否有新的样例应用程序,请选择“文件”&gt;“新建项目”以打开“新建项目”向导,然后选择“样例”&gt; &quot;Visual Web&quot; 以查看右窗格中的样例应用程序列表。创建样例应用程序:
<ol>
<li>
<p>选择“文件”&gt;“新建项目”。</p>将打开“新建项目”向导。
</li>
<li>在“新建项目”向导的“类别”窗格中,展开“样例”节点,然后选择 &quot;Visual Web&quot;。 </li>
<li>从“项目”窗格中选择样例项目,然后单击“下一步”继续。</li>
<li>
<p>在“项目名称”字段中键入项目的名称。</p>
IDE 将提供建议的名称(您可以对其进行编辑)。</li>
<li>
<p>基于以上项目名称提供建议的项目位置和项目文件夹。您可以更改项目位置。</p>
IDE 将基于您输入的信息来创建文件夹名称。IDE 将为项目提供建议的缺省 Java 包。您可以键入新名称来更改 Java 包名称。
<li>请确保在“源结构”下拉列表中选定了 &quot;Java Blueprints&quot;。</li>
<li>
<p>请确保在“服务器”下拉列表中选定了 &quot;Sun Java System Application Server&quot;。
</p>
如果在列表中找不到 Sun Java System Application Server,则必须按照帮助主题“注册 Sun Java System Application Server 实例”中所述在 NetBeans 中注册该服务器。</li>
<li>从“Java EE 版本”下拉列表中选择 &quot;Java EE 5&quot;,然后单击“完成”以创建项目。
</li>
</li>
</ol>
</p>
<p align=center><a href="#top">返回页首</a></p>
<!-- KNOWN ISSUES -->
<h2><a name="changenotes"></a>更改说明</h2>
本部分介绍了 NetBeans Visual Web Pack 不同发行版本之间的更改。
<h3>NetBeans Visual Web Pack 5.5 FCS </h3>
<br><b><span style="color: rgb(4, 84, 145);">升级到产品发行版本</span></b>
<blockquote><p>有关从 NetBeans Visual Web Pack 5.5 技术预览版本升级到产品发行版本的说明,请参见<a href="vwp-install_zh_CN.html#upgrade">安装指南</a></p></blockquote>
<b><span style="color: rgb(4, 84, 145);">组件面板中将不再自动显示下载的组件库。</span></b>
<blockquote>
<p><strong>描述:</strong>NetBeans Visual Web Pack 5.5 UI 已发生更改。要在组件面板中显示组件库,只需先将其组件库文件导入到 IDE 中,然后将其添加到项目中即可。导入的组件库并非显示在所有项目中,而只显示在添加了这些组件库的项目中。
<p>有关详细信息,请参见<a href="../../../kb/55/vwp-ajaximportcomponents_zh_CN.html">下载并导入 AJAX 和其他组件</a>教程和帮助主题“关于组件库”。</p>
</blockquote>
<p align=center><a href="#top">返回页首</a></p>
<!-- KNOWN ISSUES -->
<h2><a name=knownissues></a>已知问题</h2>
<p> 本部分介绍了此发行版本中未解决的问题。有关详细信息,请参见 <a href="http://wiki.netbeans.org/wiki/view/NetBeansVWPUserFAQ">NetBeans Visual Web Pack 常见问题解答</a></p>
<blockquote>
<h3>样例数据库</h3>
<!-- Bug ID: 6472618 http://bt2ws.central.sun.com/CrPrint?id=6472618 --> <br> <b><span style="color: rgb(4, 84, 145);">Sun Application Server 9 Platform Edition 要求重新启动 IDE。</span></b>
<blockquote>
<p><strong>描述:</strong>要将 Travel 数据库与 Sun Application Server 9 PE 一起使用,则在“服务器”窗口中选择了应用服务器后必须重新启动 IDE。</p>
</blockquote>
<h3>清理并生成</h3><br> <!-- Bug ID: 6467949 http://bt2ws.central.sun.com/CrPrint?id=6473912 --> <b><span style="color: rgb(4, 84, 145);">在部署应用程序后,执行清理并生成操作时失败。</span></b>
<blockquote>
<p><strong>描述:</strong>在部署应用程序时返回“无法删除文件 <tt>...\build\web\WEB-INF\lib\appbase.jar</tt>”错误。</p>
<p><strong>解决方法:</strong>停止并重新启动应用服务器,然后重新部署应用程序。 </p>
</blockquote>
<h3>按钮外观</h3><br> <!-- Bug ID: 6470992 http://bt2ws.central.sun.com/CrPrint?id=6470992 --> <b><span style="color: rgb(4, 84, 145);">编辑工具栏中的按钮文本丢失或被截断。</span></b>
<blockquote>
<p><strong>描述:</strong>在 Microsoft Windows XP 上使用 Windows XP 显示样式时,按钮文本使用省略号来代替。此问题与 JDK 5.0 Update 8(版本 1.5.0_08)有关。</p>
<p><strong>解决方法:</strong>将显示样式更改为“Windows 经典样式”,方法如下:
<ol>
<li>选择“开始”&gt;“设置”&gt;“控制面板”。</li>
<li>在控制面板上,双击“显示”。</li>
<li>在“外观”标签中,选择“窗口和按钮”下面的“Windows 经典样式”。</li></ol>
</blockquote>
<h3>组件库和 JBoss</h3><br> <b><span style="color: rgb(4, 84, 145);">与 NetBeans Visual Web Pack 5.5 捆绑在一起的 webui 组件库中的组件(基于 JSF 1.1/J2EE 1.4)无法正常工作。 </span></b>
<blockquote>
<p><strong>描述:</strong>在创建项目时,将检查容器中的类路径。如果找到 MyFaces 实现,则优先使用该实现。如果删除 MyFaces 实现,则会使应用程序捆绑 JSF-RI 库。</p>
<p><strong>解决方法:</strong>为该容器创建 Visual Web Pack 项目之前,将以下文件移到缺省目录外部: </p>
<tt>JBOSS_HOME/server/default/deploy/jbossweb-tomcat55.sar/jsf-lib</tt></blockquote>
<h3>Java EE 5 部署</h3>
<!-- http://bt2ws.central.sun.com/CrPrint?id=6479877
https://netbeans.org/bugzilla/show_bug.cgi?id=77122
http://glassfish.dev.java.net/issues/show_bug.cgi?id=1197--><br> <b><span style="color: rgb(4, 84, 145);">部署应用程序时出现挂起。</span></b>
<blockquote>
<p><strong>描述:</strong>将 Java EE 5 应用程序部署到 Sun Java System Application Server 时出现挂起,原因是服务器的部署管理器依赖于线程不安全的代码。 </p>
<p>此问题似乎仅在运行 Windows XP 的多处理器或多核计算机的情况下出现。 </p>
<p><strong>解决方法:</strong>重新启动 IDE,然后使用服务器管理器:<ol><li>重新启动应用服务器(如有必要)。</li><li>取消部署所有应用程序。</li>
<li>重新部署这些应用程序。</li></ol>
如果无法启动或停止应用服务器,请在重新启动 IDE 之前通过任务管理器停止所有 Java 进程。 </p>
</blockquote>
<h3>重命名项目文件夹</h3>
<!-- http://bt2ws.central.sun.com/CrPrint?id=6481988--> <br> <b><span style="color: rgb(4, 84, 145);">重命名项目文件夹后抛出 IllegalStateException。</span></b>
<blockquote>
<p><strong>描述:</strong>重新打开包含重命名文件夹的项目或包含重命名页面的文件夹时,IDE 抛出了 <tt>IllegalStateException</tt></p>
<p><strong>解决方法:</strong>仅重命名“源包”节点中的文件夹。右键单击此节点下面的文件夹,然后从弹出式菜单中选择“重构”&gt;“重命名”。请注意,IDE 当前不支持重命名缺省的 Bean 包。</p>
</blockquote>
<h3>绑定到数据</h3>
<!-- http://bt2ws.central.sun.com/CrPrint?id=6481512 --><br> <b><span style="color: rgb(4, 84, 145);">将“下拉列表”组件绑定到表数据时返回异常。</span></b>
<blockquote>
<p><strong>描述:</strong>使用 MySQL 时尝试将“下拉列表”组件绑定到表数据,则返回 IllegalArgumentException。</p>
<p><strong>解决方法:</strong>出现这种问题时,请关闭“绑定到数据”对话框,然后将其重新打开。如果执行失败,请关闭并重新打开项目。</p>
</blockquote>
<h3>查看数据 SQL 命令 </h3>
<!-- https://netbeans.org/bugzilla/show_bug.cgi?id=86276
http://bt2ws.central.sun.com/CrPrint?id=6466706--><br> <b><span style="color: rgb(4, 84, 145);">插入新行或空格后返回的结果为空。</span></b>
<blockquote>
<p><strong>描述:</strong>在“查看数据”窗口中执行查询时,如果查询是以空格或回车结尾,则不执行该查询。</p>
<!-- <p><strong>Workaround: </strong>Make sure commands end with a character rather than space or a carriage returns.</p>-->
</blockquote>
<h3> Web 服务</h3>
<!-- http://bt2ws.central.sun.com/CrPrint?id=6484142 --><br> <b><span style="color: rgb(4, 84, 145);">对于使用 J2EE 1.4 的项目,在 JDK 1.5_06 下面看不见 Web 服务包。</span></b>
<blockquote>
<p><strong>描述:</strong>在添加了 Web 服务的项目中,import 语句会在 &quot;Java&quot; 视图中自动完成(也就是说,对于该应用程序,Web 服务应该是可见的),但 IDE 却没有返回任何内容。 </p>
<p><strong>解决方法:</strong>先生成项目,然后 Java 源代码编辑器会提供建议。 </p>
</blockquote>
<a name="kidistim"></a><h3>图像失真</h3>
<!-- http://bt2ws.central.sun.com/CrPrint?id=6479271 --><br> <b><span style="color: rgb(4, 84, 145);">在执行传回操作时浏览器中的背景图像失真或丢失。</span></b>
<blockquote>
<p><strong>描述:</strong>在执行传回操作时,通过使用具有相对 URL 的 background-image 样式设置的背景图像(如 <tt>background-image: url(./resources/flower.gif)</tt>)在浏览器中失真或丢失。</p>
<p><strong>解决方法:</strong>以下修补程序可以为 Java EE 4 和 EE 5 项目提供修复。请使用如下所示的代码手动设置背景图像:
<pre class="examplecode">&lt;h:panelGrid binding=&quot;#{Page1.gridPanel1}&quot; id=&quot;gridPanel1&quot;
style=&quot;background-image: url(/WebApplication1/resources/flower.gif);
height: 200px; left: 312px; top: 240px; position: absolute&quot; width=&quot;312&quot;/&gt;</pre>
在某些浏览器中为了显示背景图像,至少需要为上面节选代码中的网格面板提供一个子项。例如,子项可以是“静态文本”组件,其 <tt>escape</tt> 属性设置为 <tt>False</tt><tt>text</tt> 属性设置为不间断空格 (<tt>&amp;nbsp;</tt>):<pre class="examplecode">&lt;h:panelGrid binding=&quot;#{Page1.gridPanel1}&quot; id=&quot;gridPanel1&quot;<br> style=&quot;background-image: url(/WebApplication1/resources/flower.gif);
height: 200px; left: 312px; top: 240px; position: absolute&quot; width=&quot;312&quot;&gt;<br>&lt;webuijsf:staticText binding=&quot;#{Page1.staticText1}&quot; escape=&quot;false&quot; id=&quot;staticText1&quot; text=&quot;&amp;amp;nbsp;&quot;/&gt;
&lt;/h:panelGrid&gt;</pre>
<p>请注意,尽管这种解决方法在运行时非常有效,但它在设计时会丢失该图像。</p>
</blockquote>
<h3>复选框组件</h3>
<!-- http://bt2ws.central.sun.com/CrPrint?id=6455276 --><br> <b><span style="color: rgb(4, 84, 145);">“复选框”和“复选框组”组件的 readOnly 属性无效。</span></b>
<blockquote>
<p><strong>描述:</strong>即使将这些组件的属性设置为 readOnly,仍可以单击这些组件。</p>
<p><strong>解决方法:</strong>请使用 <tt>disabled</tt> 属性在应用该组件时呈现它,但不能对其进行更改。 </p>
<p>此外还可以使用脚本来禁止对只读元素进行更改。此处的 <tt>button1_action</tt> 用于切换 <tt>checkbox1</tt><tt>readOnly</tt> 属性:
<pre class="examplecode">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;<br>&lt;jsp:root version=&quot;1.2&quot; xmlns:f=&quot;http://java.sun.com/jsf/core&quot; xmlns:h=&quot;http://java.sun.com/jsf/html&quot;
xmlns:jsp=&quot;http://java.sun.com/JSP/Page&quot; xmlns:webuijsf=&quot;http://www.sun.com/webui/webuijsf&quot;&gt;<br> &lt;jsp:directive.page contentType=&quot;text/html;charset=UTF-8&quot; pageEncoding=&quot;UTF-8&quot;/&gt;<br> &lt;f:view&gt;<br> &lt;webuijsf:page binding=&quot;#{Page1.page1}&quot; id=&quot;page1&quot;&gt;<br> &lt;webuijsf:html binding=&quot;#{Page1.html1}&quot; id=&quot;html1&quot;&gt;<br> &lt;webuijsf:head binding=&quot;#{Page1.head1}&quot; id=&quot;head1&quot;&gt;<br> &lt;webuijsf:link binding=&quot;#{Page1.link1}&quot; id=&quot;link1&quot; url=&quot;/resources/stylesheet.css&quot;/&gt;<br> &lt;webuijsf:script binding=&quot;#{Page1.script1}&quot; id=&quot;script1&quot;&gt;&lt;![CDATA[<br> function preventIfReadOnly(element) {<br> if (element.readOnly != false) {<br> //element is readOnly, so prevent change by returning false<br> return false;<br> }<br> //allow change by returning true<br> return true;<br> }<br> ]]&gt;&lt;/webuijsf:script&gt;<br> &lt;/webuijsf:head&gt;<br> &lt;webuijsf:body binding=&quot;#{Page1.body1}&quot; id=&quot;body1&quot; style=&quot;-rave-layout: grid&quot;&gt;<br> &lt;webuijsf:form binding=&quot;#{Page1.form1}&quot; id=&quot;form1&quot;&gt;<br> &lt;webuijsf:checkbox binding=&quot;#{Page1.checkbox1}&quot; id=&quot;checkbox1&quot; label=&quot;Checkbox&quot; onClick=&quot;return preventIfReadOnly(this);&quot; style=&quot;position: absolute; left: 192px; top: 192px&quot;/&gt;<br> &lt;webuijsf:button actionExpression=&quot;#{Page1.button1_action}&quot; binding=&quot;#{Page1.button1}&quot; id=&quot;button1&quot;<br> style=&quot;position: absolute; left: 216px; top: 288px&quot; text=&quot;Toggle checkbox readOnly property&quot;/&gt;<br> &lt;webuijsf:messageGroup binding=&quot;#{Page1.messageGroup1}&quot; id=&quot;messageGroup1&quot; style=&quot;position: absolute; left: 432px; top: 120px&quot;/&gt;<br> &lt;/webuijsf:form&gt;<br> &lt;/webuijsf:body&gt;<br> &lt;/webuijsf:html&gt;<br> &lt;/webuijsf:page&gt;<br> &lt;/f:view&gt;<br>&lt;/jsp:root&gt;</pre></blockquote>
<a name="i18n"></a> <h3>国际化</h3>
<!-- http://bt2ws.central.sun.com/CrPrint?id=6498866 --><br> <b><span style="color: rgb(4, 84, 145);">将 URL 属性限制为 ISO-8859-1 字符。</span></b>
<blockquote>
<p><strong>描述:</strong>在 jp 语言环境下,不显示上载的文件组件。当文件名采用多字节字符集时,可以在浏览器和日志文件中正确显示文件名,但不显示图像。如果上载文件的原始文件名包含 UCS 字符,则无法正确呈现 <tt>img</tt> 标记的 <tt>src</tt> 属性。因此,当浏览器获取图像时,将出现“找不到文件”错误,并且在浏览器窗口中不显示任何内容。 </p>
<p><strong>解决方法:</strong>将该应用程序的 <tt>URL</tt> 属性限制为 ISO-8859-1 字符。例如,提供一个从 ISO 10646 UCS 字符集到 ISO-8859-1 的单独转换步骤。最好完全避免使用 UCS 字符。 </p>
</blockquote>
<h3> 捆绑的数据库 </h3>
<!-- http://bt2ws.central.sun.com/CrPrint?id=6483217 --><br> <b><span style="color: rgb(4, 84, 145);">在删除用户目录并重新安装 IDE 之前创建的项目中,无法连接到数据库。</span></b>
<blockquote>
<p><strong>描述:</strong>当删除用户目录时,JDBC 驱动程序将会丢失,因此用户无法解决缺少数据连接的问题。 </p>
<p><strong>解决方法:</strong>在删除用户目录之前,请将 <tt>jdbc-drivers</tt> 文件夹复制到外部目录,重新安装 IDE 后再将其复制回用户目录中。 </p>
</blockquote>
<h3>重命名变量</h3>
<!-- http://bt2ws.central.sun.com/CrPrint?id=5097400 --><br> <b><span style="color: rgb(4, 84, 145);">当用户选择“Bean 模式”&gt;“属性”&gt;“重命名”以重命名属性时,NetBeans IDE 不会将重命名视为完全重构。按此方式重命名的变量的新名称不会应用到整个项目中。</span></b>
<blockquote>
<p><strong>描述:</strong>如果用户在包含 getter 和 setter 方法的弹出式对话框中单击“是”,IDE 将重命名这些方法,但不会对这些方法的其他引用进行更新。在部署应用程序时,如果只更改了该应用程序的变量名称(例如,Bean 属性的名称),IDE 将抛出编译器错误。</p>
</blockquote>
<h3>JDBC 驱动程序</h3>
<!-- http://bt2ws.central.sun.com/CrPrint?id=6476830 (replaces 6476831, 6476832, 6476855)
https://netbeans.org/bugzilla/show_bug.cgi?id=86213 --> <br> <b><span style="color: rgb(4, 84, 145);">如果未将 JDBC 驱动程序复制到服务器中,使用数据源的应用程序将运行失败。</span></b>
<blockquote>
<p><strong>描述:</strong>NetBeans 未将 JDBC 驱动程序 JAR 文件复制到部署容器中。 </p>
<p><strong>解决方法:</strong>手动将 JAR 文件复制到容器的类路径中。 </p>
</blockquote>
<h3>Woodstock 组件</h3>
<!-- http://bt2ws.central.sun.com/CrPrint?id=6490614 --><br> <b><span style="color: rgb(4, 84, 145);">在 Visual Web Pack 技术预览版本中创建的项目无法在产品发行版本中进行生成。</span></b>
<blockquote>
<p><strong>描述:</strong>IDE 未能在生成时复制 WebUI 组件库中的所有内容,从而导致生成失败。 </p>
<p><strong>解决方法:</strong>按如下方式删除旧的 WebUI 组件库,然后添加新的 WebUI 组件库:
<ol><li>在“项目”窗口中,右键单击该项目,然后选择“属性”。</li>
<li>选择“库”,选择“Web UI 组件”库包,然后单击“删除”。单击“确定”关闭该对话框。</li>
<li>再次右键单击该项目,然后选择“属性”。</li>
<li>选择“库”,然后单击“添加库”。在“添加库”对话框中,选择“Web UI 组件”,然后单击“添加库”。在“项目属性”窗口中,单击“确定”。</li>
<li>右键单击该项目,然后选择“清理并生成项目”。</li>
</ol>
</p>
</blockquote>
<!--
<h3>Subject</h3>
http://bt2ws.central.sun.com/CrPrint?id=___ <br>
<b><span style="color: rgb(4, 84, 145);">summary.</span></b>
<blockquote>
<p><strong>Description: </strong>xyz </p>
<p><strong>Workaround: </strong>BCD. </p>
</blockquote>
--> <a name="buttonwidth"></a> <h3>Internet Explorer 中的按钮宽度</h3>
<!--http://bt2ws.central.sun.com/CrPrint?id=6498140--> <br> <b><span style="color: rgb(4, 84, 145);">仅限 IE 7:不支持缺省按钮宽度。</span></b>
<blockquote>
<p><strong>描述:</strong>如果未显式设置按钮宽度,IE 7 会将按钮大小调整为容器宽度。 </p>
<p><strong>解决方法:</strong>在可视设计器中显式设置按钮宽度。 </p>
</blockquote>
<h3><a name="kisession"></a>Internet Explorer 中的会话数据丢失</h3>
<!-- http://bt2ws.central.sun.com/CrPrint?id=6482174 --><br> <b><span style="color: rgb(4, 84, 145);">仅限 IE 6 和 IE 7:在导航 20 页后会话将丢失。</span></b>
<blockquote>
<p><strong>描述:</strong>在包含 20 多个页面的项目中,当用户导航的页面超过 20 个后会话数据将丢失,并且保存在会话 Bean 属性中的信息被重置为 Null。但 Firefox 或其他浏览器不会出现此问题。 </p>
<p>如果将浏览器的安全性设置为“中”,则在到达第 22 个页面时更新会话;如果设置为“高”,则在到达第 30 个页面时更新会话。当禁用 Cookie 时,将保留该会话。</p>
<p><strong>解决方法:</strong>在 Internet Explorer 中: </p>
<ol>
<li>选择“工具”&gt;“Internet 选项”。</li>
<li>选择“隐私”标签。</li>
<li>将设置由“中”(缺省)更改为“高”或“阻止所有 Cookie”。</li>
<li>按“确定”。</li>
<li>重新启动 Internet Explorer 的所有实例。</li>
</ol>
</blockquote>
<!--
<h3>Subject</h3>
http://bt2ws.central.sun.com/CrPrint?id=___ <br>
<b><span style="color: rgb(4, 84, 145);">summary.</span></b>
<blockquote>
<p><strong>Description: </strong>xyz </p>
<p><strong>Workaround: </strong>BCD. </p>
</blockquote>
--><a name="render"></a>
<h3>呈现问题</h3>
<br> <b><span style="color: rgb(4, 84, 145);">在使用 zh_CN 语言环境的 Red Hat Fedora Core 3 上,无法读取 IDE 文本。</span></b>
<blockquote>
<p><strong>描述:</strong>在使用 zh_CN 语言环境(也可能还有某些其他亚洲语言环境)的 Red Hat Fedora Core 3 上运行 IDE 时,文本会由于呈现问题而不可读。这是由于 Fedora Core 版本上的 JDK 存在字体支持问题,因此,此问题可能也存在于 Fedora Core 上运行的其他 Java 应用程序。 </p>
<p><strong>解决方法:</strong>目前没有有效的办法来解决 Red Hat Fedora Core 3 上存在的呈现问题,因此,最好在这些语言环境中使用不同的 Linux 版本或操作系统。我们已验证了在 Red Hat Enterprise Linux 3 上不会出现这种问题。</p>
</blockquote>
</blockquote>
<blockquote>
<h3>Java Server Pages</h3>
<!-- https://netbeans.org/bugzilla/show_bug.cgi?id=88510 --><br> <b><span style="color: rgb(4, 84, 145);">启用 Visual Web 模块时将在自由格式的项目中隐藏 Java Server Pages。</span></b>
<blockquote>
<p><strong>描述:</strong>如果是在 2006 年 10 月 29 日至 2006 年 11 月 3 日之间下载并安装了 NetBeans Visual Web Pack 5.5 技术预览版本,您可能会发现启用 Visual Web 模块时将在自由格式的项目中隐藏 Java Server Pages。此问题已在 <a href="https://netbeans.org/bugzilla/show_bug.cgi?id=88510" target=_blank>NetBeans 问题 88510</a> 中进行了描述。2006 年 11 月 4 日以后提供的下载中已解决了这一问题。
<p><strong>解决方法 1:</strong>按如下方式从 Visual Web Pack 更新中心下载修补程序: </p>
<ol><li>
<p>从 IDE 的主菜单中,选择“工具”&gt;“更新中心”。</p>
将打开“更新中心向导”。如果您处于防火墙的保护下,则必须配置代理服务器。请单击“代理配置”,然后在对话框中输入代理信息。</li>
<li>请确保选中了“NetBeans Visual Web Pack 更新中心”。</li>
<li>在“更新中心向导”中单击“下一步”。该向导会检查是否存在可用的更新和新模块,如果存在可用的更新或新模块,则会打开“选择要安装的模块”窗格。</li>
<li>在左面板中,选择“组件库(版本 1.1)”和“JSF 项目核心(版本 1.2.0.2)”,然后单击“添加”按钮以将其移到“包含在安装中”面板。</li>
<li> <p>单击“下一步”,然后阅读并接受许可证协议。</p>
“更新中心向导”将下载修补程序。</li>
<li>单击“下一步”将模块安装到 IDE 中,单击“完成”,然后单击“确定”以重新启动 IDE。</li>
</ol>
<p><b>解决方法 2:</b>按如下方式禁用 NetBeans Visual Web Pack 5.5 模块:</p>
<ol><li>从 IDE 主菜单中选择“工具”&gt;“模块管理器”。</li>
<li>在模块管理器中,取消选中“活动”列中与 <tt>Visual Web</tt> 关联的复选框。</li>
<li>当 IDE 更新模块后,请单击“关闭”。 </li>
</ol><p>您可以随时使用相同的步骤重新启用这些模块。</p>
</blockquote>
</blockquote>
</blockquote>
</blockquote>
<p align=center><a href="#top">返回页首</a></p>
<!-- DOCUMENTATION --> <a name="documentation"></a>
<h2>文档</h2>
<blockquote>
<p>以基于 Web 的指南和 IDE 的帮助系统的形式,提供了有关 NetBeans Visual Web Pack 5.5 文档。您可以阅读以下文档,快速了解相关的入门知识:</p>
<ul>
<li><a href="vwp-install_zh_CN.html">NetBeans Visual Web Pack 5.5 安装说明</a></li>
<li><a href="https://netbeans.org/kb/55/index_zh_CN.html">NetBeans IDE 5.5 文档</a></li>
</ul>
</blockquote>
<p align="center"><a href="#top">返回页首</a></p>
<a name="more_information"></a><h2>更多信息</h2>
<blockquote>
<p>您可以在 <a href="https://netbeans.org/" target="_blank">NetBeans 项目</a>的 Web 站点上获取有价值的信息。由于 NetBeans IDE 是一个开放源代码项目,因此您还可以通过该 Web 站点访问源代码、问题数据库,并获取有关创建您自己的 NetBeans 模块等信息。 </p>
<p>更多信息,请访问 <a href="https://netbeans.org/" target="_blank">https://netbeans.org/</a></p>
<p>NetBeans Visual Web Pack 常见问题解答位于 <a href="http://wiki.netbeans.org/wiki/view/NetBeansVWPUserFAQ">http://wiki.netbeans.org</a></p>
</blockquote>
<p align=center><a href="#top">返回页首</a></p>
<hr class="light">
<br>
<div class="feedback-box">
<a href="/about/contact_form.html?to=4&subject=Feedback: NetBeans Visual Web Pack 5.5 Release Notes">请将您的意见和建议发送给我们</a></div>
<br style="clear:both;" />
</body>
</html>