1.关于硕正套件
 | 问1.为什么demo包采用静态页面?在 JSP 或 ASP.Net中能使用吗? |
答复: 因为是纯客户端产品的关系,和后端(服务器端)技术的关系不那么密切,所以我们选择最通用的静态页面作demo。不管是ASP还是JSP,HTML+CSS+JS是二者间最大的交集,换句话说,我们的产品在静态页面上都能跑,更何况是动态页面。
 | 问2.demo页和文档从未提到数据库,硕正套件支持什么样的数据库? |
答复: 硕正套件不直接连接数据库,所以也不关心数据库。我们认为,访问数据库应该是应用服务器的事,硕正套件只关心数据:基于Http request/response的数据。
 | 问3.demo中的数据基本上都是XML文件,实际开发时也必须是XML文件吗? |
答复: 不是的,应该是基于Http Response的数据包。实际开发中,应用服务器从数据库中获取数据并将其封装成XML(或JSON、TSV-TXT),然后将这个XML返回给客户端,这个过程有点类似于XML Web Service的对象封送,无论是JSP还是ASP.Net,都有简单的数据序列化的实现方法。
在Java EE开发中,通常采用Servlet作为顶层来处理Http Request / Response.
 | 问4.在IE下,硕正套件是一个ActiveX控件。我自己以前也开发过ActiveX控件,发现维护量很大,有些客户根本就安装不了,硕正套件也会有这个问题吗? |
答复: 你自己开发的ActiveX控件通常未经签名,微软操作系统对未经签名控件的限制越来越严厉。
硕正套件ActiveX是经过签名的,并且在运行过程中不写注册表、不读写其它目录的文件,所以在用户正常的IE安全等级下能够下载、运行,极少发现被操作系统拦截、无法安装的情况.
 | 问5.我的应用程序采用常规的服务器端Session来维护会话的安全性,Supcan套件的Http请求安全吗? |
答复: Supcan套件继承了页面的上下文环境,其Http请求自然也共享了页面已有的Cookie、和服务端的会话,所以是安全的.
 | 问6.Supcan套件能用在C/S产品中吗? |
答复: 不能,只能作为插件用在浏览器中。
硕正套件的C/S专版需要另外付费购买。
2.开发
 | 问1.如何学习用硕正套件开发? |
答复:
首先,您必须明白硕正套件相当于是客户端的中间件,它的容器是浏览器,要操控它,您必须具备页面开发的基本知识,比如html、javaScript、Ajax、CSS等。
由于是浏览器插件的关系,硕正套件与后端数据库是没有连接的,它只与应用服务器通讯:标准的 http 协议交互。为此,您必须精通一种后端开发的技能:JavaEE 或 ASP.Net.
单就硕正套件而言,如下是可参考的学习步骤:
1.学习左侧的《使用指南》,这是原理性的入门知识,对今后的开发和部署很有帮助;
2.从套件中选一种具体的组件入手,比如硕正树列表 或 硕正报表;
3.您可以结合这几种手段,逐步深入:
A.学习《开发者指南》中的具体组件的相关章节;
B.观看在线演示,按提示操作。请注意:我们绝大多数的演示页,在下方都有“技术分析区”,值得深入分析;
C.进一步解剖演示页的HTML源文件,源文件都在 demo 包中的根目录下,文件的命名是和演示顺序号严格对应的。文件名前缀规则是:
t*.htm - 树列表的演示页,如t1.htm、t2.thm...;
f*.htm - 自由表头的演示页,如f1.htm、f2.thm...;
report*.htm - 报表的演示页,如report1.htm、report2.thm...;
other*.htm - 小型页面控件的演示页.
D.如果是研究树列表,需要同时参考顶部Tab中的《Treelist XML 文档规范》;
E.逐步尝试开发,把html转变成您自己的jsp或aspx, html部分可以对照我们的demo页照猫画虎就行;
F.重视本《常见问题解答》,这是我们整理的最常见的咨询问题;
 | 问2.书写Treelist、Freeform的XML描述文件时,需要注意元素名、属性名的大小写吗? |
答复: 不需要,硕正套件内置的XML解析器对大小写是不敏感的.
 | 问3.我用asp.net开发了一个非常简单的页面,但是其中的硕正控件始终显示不出来,怎么回事? |
答复: 解决方法一:
把头上的这句没啥用的话去掉就行:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/ ... sitional.dtd">
解决方法二:用div包绕控件(需显式指定高宽):
<div style="width100%;height:400px">
<script type="text/javascript">insertReport('AF','')</script>
</div>
 | 问4.OnReady() 是在页面事件onLoad( )前还是后触发? |
答复: 不确定的。因为浏览器通常采用多线程渲染<div>、<td>中的内容,所以很难说哪个先完成。
如果你希望在OnReady( )和onLoad( )全部完成后做某项事情,最安全的做法是用一个计数变量。
 | 问5.为什么我的页面经常会发生Supcan控件OnReady( )事件未触发的现象? |
答复: 将该段 js 写到靠前一点(例如在Html的Head中),这样就保证能触发。
在IE浏览器中,OnReady( )的触发时机是:在硕正组件首次显示时。假如你的页面很长(指高度),需要用垂直滚动条往下拖时才显示硕正组件,那么在硕正组件初次浮现的一刹那,
OnReady( )事件才被触发的!
还有一种情形,页面中控件的Table、div容器的高度(height),如果你将其定义成百分比(例如 height="100%"),有可能也会导致该现象,因为我们发现,浏览器对百分比的高度的解析,在渲染过程中会有些不确定因素,建议您用js算出容器的高度,然后将高度修改成像素数.
 | 问6.我将硕正套件集成在ExtJS中,比如安置在TabPanel中,但是发现OnReady( )事件报错: "AF为空或不是对象",怎么解决? |
答复: 最终插件肯定是安置在某个<form name="?" ...>中,请参考“使用指南”中的“9.Firefox和IE的一些差别”,你需要取得这个form的name。或者也可以用 document.getElementsByTags('form') 返回form的数组,如果只有1个form元素,也可以用 document.getElementsByTags('form')[0] 代替。
此外,如果遵照ExtJS的建议,采用iframe作为容器的话,是不存在这个问题的。
 | 问7.InsertTreeList( )是在<div>中,再将其嵌到Table的<TD>中,为什么就看不见硕正组件了? |
答复: 把<div>这一层去掉应该就可以。
对硕正组件来说,<div>、<td>相当于都是“容器”,有一个容器就已经够了。
如果选用<td>容器,通常还须确定<tr>的高度的像素数,否则组件仍有可能未显示。在Chrome浏览器中,甚至<td>中也必须明确高度的像素。
 | 问8.我在页面中安置了多个控件,经常有些莫名其妙的问题,例如录入数据丢失、会自动刷新、甚至浏览器崩溃,但是单个控件的页面又是没问题的,什么原因? |
答复: 可能性一: 你的OnReady( id )书写有问题,例如如下脚本就有严重问题:
function OnReady( id )
{
AF1.func( ... );
AF2.func( ... );
}
从中可以看出页面中有2个控件实例,而2个实例各自会触发OnReady事件,也就是说这段js会执行2遍,在执行第一遍时,另外一个实例可能还没有被浏览器创建,这样就会发生难以预料的错误,这也是初学者容易忽视的地方。
正确的书写应该是:
function OnReady( id )
{
if(id == 'AF1')
AF1.func( ... );
else if(id == 'AF2')
AF2.func( ... );
}
可能性二:假设你的页面一打开,控件之间就需要交互,如果你写成如下这样,也有大问题:
function OnReady( id )
{
if(id == 'AF1') {
AF1.func( ... );
}
else if(id == 'AF2') {
var s = AF1.func( ... ); //在 OnReady('AF2')中访问其它对象:大忌
AF2.func( ... );
}
}
问题出在第7行,因为这个时候AF1可能尚未创建,浏览器未必是按页面脚本的前后次序创建控件实例的。正确的写法可以参考如下的例子:
var count = 0; //计数器
function OnReady( id )
{
count++;
if(count==2) { //OnReady( )2遍了,此时2个对象均已创建,下面的代码就很安全了
AF1.func( ... );
var s = AF1.func( ... );
AF2.func( ... );
}
}
如下是一个更复杂的例子,请您分析一下问题的所在:
var bReadyAF1 = false;
var bReadyAF2 = false;
var bReadyAF3 = false;
function OnReady(id) {
if (id == 'AFList') {
AFList.func("Build", "build/base/OrgsList.xml");
bReadyAF1 = true;
}
else if (id == 'AFPager') {
AFPager.func("Build", "build/comm/Pager.xml");
bReadyAF2 = true;
}
else if (id == 'AFEditForm') {
AFEditForm.func("Build", "build/base/OrgsEdit.xml");
bReadyAF3 = true;
}
if (bReadyAF1 && bReadyAF2) {
var h = AFList.func("GetHandle", "");
AFPager.func("BindPager", h + "\r\n pageID"); //绑定
var url = "build/base/Org.ashx?Method=Orgs&StartRow=@startRow&Rows=@rows";
AFPager.func("SetObjProp", "PageID \r\n dataUrl \r\n" + url + "\r\n mode=asynch ");
}
if (bReadyAF3) {
WinEdit.hide();
}
}
可能性三:如果你的页面很长(指高度),比如需要垂直滚动条, 如果插件一开始是隐藏在底部的,需要拖动滚动条才能显现,那么在IE中,插件是在初次显现时才会触发OnReady( )事件的!
 | 问9.我在<script>insertFreeForm('AF', '')</script>下加了一句 <asp:Button ID="Button2" runat="server" Text="提交"/>后, 发现回车键不起作用了,怎么办? |
答复: <asp:Button >对应到Html是<input type="submit" >,浏览器将拦截submit的回车事件。
解决方法也很简单:将<script>insertFreeForm('AF', '')</script>安置在<Form>中、或将<asp:Button >安置在<Form>中就行。
如果这二者都在<Form>中,只要将其中一个移出<Form>就行。
 | 问10.我的页面提交后,怎么组件中的数据全部丢失了? |
答复: 原因就是:你的页面刷新了。 对于硕正套件而言,刷新相当于就是重新创建一遍控件实例、重新触发OnReady( )。所以为了保持状态,建议不要轻易使用刷新, 一般象<input type="submit" ...>、页面上传文件均会导致刷新, 原生的ASP.Net页面开发也经常会导致刷新。
页面和后端的交互应尽可能使用AJAX, 而不是提交页面。
 | 问11.硕正演示页中有多种模式对话框方案,我该如何选择使用? |
答复: 有3种方案,以下是方案的分析:
方案1:直接使用html的window.showModalDialog( )。这是浏览器本身就支持的对话框,对话框中是一个独立页面,易于开发,但很多程序员不喜欢它的界面风格;
方案2:使用能遮罩页面内容的js对话框。界面比较美观,并且对话框中也是一个独立页面,目前有很多开源项目,但并不是所有项目都能和硕正套件相配,在Treelist演示页中有一个改进后的lhgdialog的实例可参考;
方案3:使用硕正套件内置的自定义对话框,对话框中是一个Freeform,并且该Freeform可以是URL,也可以是XML大串,比较适合于服务器端的动态生成,常用于诸如查询条件、单据查询等简单场合。自定义对话框分模式、非模式对话框二种,二者的差别在于:
A.非模式对话框, 是线程不阻塞的对话框,所以支持js的OnEvent事件交互,但开发稍复杂,并且其窗口被包容在组件内部;
B.模式对话框, 是Windows标准对话框,主线程是阻塞的,所以开发稍简单,但不支持js的事件交互、对话框打开期间不能切换浏览器的选项卡(Tab)、并且对Firefox浏览器支持不好(易僵死);
 | 问12.FireFox访问页面元素都需要采用 getElementById() 或 getElementByName() 函数,访问插件也需要这样写吗? |
答复: 不需要,因为插件是一种特殊的页面元素,可以直接访问,本demo页中均是这样写的。在这一点上,FireFox和IE是没区别的.
 | 问13.在Firefox浏览器下,我修改了XML模板文件,但Treelist或Report经常无法刷新,加载的仍然是老文件,清理了浏览器的缓存也不顶用,这是怎么回事? |
答复: 硕正套件的底层Http通讯直接使用了 Windows 的 WinInet 基础组件,所以它实际上是共享了 IE 的 Cache,你应该清理 IE 的 Cache.
 | 问14.在Firefox 4.0下,发现在OnEvent( )事件中调用js函数 alert( ) 后浏览器有时会死机,如何解决? |
答复: 请用全局函数MessageBoxFloat代替alert( )吧.
 | 问15.我的网站在IE下完全正常,但在FireFox、Chrome下有很多问题,怎么办? |
答复: HTML、CSS、JavaScript、正则表达式本身在IE和FireFox、Chrome下就有不少的差别,你需要先搞定和硕正套件无关的那些内容.
 | 问16.我的网站在IE下完全正常,但为什么在FireFox下却发现同一个插件会多次触发OnReady( )事件? |
答复: 可以肯定地说,一个插件只会触发一次OnReady( )。但是页面中样式发生变化时,FireFox可能会重新渲染一次的,导致插件被多次销毁、创建,每次创建肯定都会触发OnReady( )事件.
 | 问17.当Session过期时,执行Load加载不到数据,能否让客户端有个提示? |
答复: 请参考开发者指南的《公共内容》下的“4.XML/JSON异常包”,相信您会满意!
 | 问18.可以结合Ext-JS开发吗? |
答复: 可以。事实上,我们很多成熟的用户都是以Ext-JS作为框架,包容了Supcan插件的。
 | 问19.从安全考虑,我后端的程序需要甄别哪些请求来自页面、哪些来自硕正套件。怎么才能知道 request 请求是来自硕正套件的? |
答复: 从硕正插件发起的http请求,它的http头大多是这样的格式:
GET /supcan/treelistdata/data.txt HTTP/1.1
Accept-Encoding: gzip, deflate
Content-Type: text/html; charset=UTF-8
User-Agent: BC
Host: localhost:8081
Cache-Control: no-cache
里面的 "User-Agent" 固定是 "BC",你只要判断这个属性就行。
 | 问20.我看到几乎所有demo页源码的底部都执行了 nstd.js,我们自己的页面有必要使用这个js吗? |
答复: 没有必要,执行该js反而会影响性能。该js是硕正demo页格式化示例源码显示用的。
 | 问21.有时候敲“BackSpace”键会导致页面回退,即回到上一个页面,如何避免这种现象? |
答复: 如果当前焦点是硕正控件,应该是不会发生这种情况的,否则是有可能的,因为这个时候键盘的控制权不在控件。但是我们可以给您一个建议:请在页面按钮的js脚本的末尾处添加一句诸如:focusIE(AF),该语句的作用是把焦点切换给控件 (此函数在 dynaload.js 中)。
 | 问22.发现某些页面的 Treelist 或 Report的回车键都不起作用,怎么回事呢? |
答复: 请检查一下您的页面源码,是否包含了这种页面元素: <button type="submit" ... >,因为 submit 将独占回车事件,硕正控件无法获得。
此外,submit是提交整个页面,将导致页面的刷新,过多的刷新不符合用户的习惯,建议将 type="submit" 换成 type="button"。
 | 问23.我隐藏了含硕正控件的Div图层, jquery是这样写的: $("#divMain").hide(); ,再显示图层时,发现里面数据清空了,似乎控件被销毁后又重建了。在Chrome、Firefox下有这个问题,IE下没问题,这是怎么回事啊? |
答复: hide 是设置图层的 display 为 none,这样会导致里面的控件被自动销毁。请您重新写个隐藏的方法:设置 visibility 为 hidden 就可以了。
 | 问24.我后端一进入调试(Debug),发现浏览器就僵死,这正常吗? |
答复: 正常,因为控件一直等着服务器返回 response 呢!