使用Sun Java System Portal Server(以后称为Portal Server),您可以把你的portal创建为一个含HTML标签<iframe>的一个frame。不要通过常规的frame创建一个portal channel,相反采用内嵌frame创建它会带给你许多显著的有点。
首先,一个内嵌frame支持channel中frame的所有特性,而一个常规的frame却不能。于是,您可以在这个portal使用其他HTML特性,而不仅仅限于frameset标签。
其次,如果一个表单是内嵌frame的channel的部分内容,用户输入和后继处理仅在该channel中进行,这就保全了这个portal的完整性。Portal Server的URLScraper不能处理用户输入行为,所以如果您在一个URLScraper channel中的表单域中输入信息,并且点击提交,URLScraper把您的整个portal脱离上下文(context)。而一个内嵌frame的channel却没有这个问题;该channel中对响应的处理仅仅在该channel中进行,portal的其他部分仍然是不受影响的。
当今大多数浏览器,例如Netscape Communicator 6.x, Internet Explorer 5.x,和Mozilla 1.2.x都支持内嵌标签(<iframe>),该标签是HTML 4.0的一部分。内嵌frame在一个HTML页面中的显示方式就像图片或者tables,而且采用的参数也是相似的。下面是一个HTML代码示例:
<iframe src="http://www.sun.com" width="80%" height="100"></iframe>
这篇文章将带你进行把一个portal channel创建为一个内嵌frame的过程。各个步骤在如下章节中详述。
n 定义Provider显示配置文件
n 定义Channel显示配置文件
n 为Provider创建一个JSP页面
n 在TabContainer中把内嵌frame的Channel添加到MyFrontPage中
(注意:这篇文章假设你已经安装了伴随Portal Server发布的示例portal)
定义Provider显示配置文件
首先,用xml为内嵌frame的channel创建一个显示配置文件:
1. 在您的安装目录下面创建一个dp-IFrameProvider.xml文件,内容如下
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE DisplayProfile SYSTEM "jar://resources/psdp.dtd">
<Provider
name="IFrameProvider"
class="com.sun.portal.providers.jsp.JSPProvider" version="2">
<Properties>
<ConditionalProperties condition="locale" value="en" >
<ConditionalProperties condition="locale" value="US" >
<String name="title" value="IFrameProvider"/>
<String name="description" value="This provider uses inline frames."/>
</ConditionalProperties>
</ConditionalProperties>
<String name="title" value="IFrameProvider"/>
<String
name="description"
value="This Provider uses IFrames"
/>
<String name="contentPage" value="iframe.jsp"/>
<String name="refreshTime" value="0" advanced="true"/>
<String name="srcURL" value="URL" />
<String name="width" value="thick" />
<String name="fontFace1" value="Sans-serif"/>
<String name="productName" value="Sun Java System Portal Server"/>
<String name="fWidth" value="100"/>
<String name="fHeight" value ="300"/>
<String name="scrolling" value="no"/>
<Boolean name="showExceptions" value="false"/>
<String name="fBorder" value="0"/>
<Boolean name="isEditable" value="false" advanced="true"/>
<String name="editType" value="edit_complete" advanced="true"/>
</Properties>
</Provider>
srcURL字符串的值可以是你要布置的网站内容的地址(例如,http://www.sun.com)或者一个您的服务器上的一个HTML文件的文件名(例如,example.html)。您可以任意改变这些参数,诸如width,fontFacel等等。
2. 以root身份,运行下面的命令把显示配置文件上传到Portal Server(命令都在一行写完)
#dpadmin add –u dn-admin –w password –d distinguished_name dp-IFrameProvider.xml
要查看dpadmin命令的详情,请查阅its section in the Portal Server 6.2 Administrator's Guide。
定义Channel的显示配置文件
接下来,为内嵌frame的channel创建一个显示配置文件,请按下列步骤:
1. 创建一个名为dp-IFrameChannel.xml的文件,内容如下
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE DisplayProfile SYSTEM "jar://resources/psdp.dtd">
<Channel
name="IFrameChannel"
provider="IFrameProvider">
<Properties>
<ConditionalProperties condition="locale" value="en" >
<ConditionalProperties condition="locale" value="US" >
<String name="title" value="IFrame Channel"/>
<String name="description" value="This is an example of an inline-frame provider."/>
</ConditionalProperties>
</ConditionalProperties>
<String name="title" value="IFrame Channel"/>
<String
name="description"
value="This is an example of an inline-frame provider."
/>
<String name="srcURL" value="URL" />
<String name="width" value="thick" />
<String name="fWidth" value="100"/>
<String name="fHeight" value ="300"/>
<String name="scrolling" value="no"/>
<String name="fBorder" value="0"/>
</Properties>
</Channel>
和“定义Provider的显示配置文件”中步骤1一样,srcURL的值可以是你要布置的网站内容的地址,也可以是您的服务器上的一个HTML文件的文件名。您可以按照您的医院调整这些参数。
2. 以root身份运行下列命令,把显示配置文件上传到Portal Server(命令都在一行写完)
# dpadmin add -u dn-admin -w password -d distinguished_name dp-IFrameProvider.xml
为这个Provider创建一个JSP页面
为这个内嵌frame的provider创建一个JSP页面,步骤如下:
1. 以provider的名称在/etc/opt/SUNWps/desktop/sampleportal下创建一个新目录。输入
% cd /etc/opt/SUNWps/sampleportal
% mkdir IFrameProvider
2. 转到provider的目录下
% cd IFrameProvider
3. 创建一个名为iframe.jsp的JSP页面,内容如下:
<%--
Copyright 2003 Sun Microsystems, Inc. All rights reserved
Use is subject to license terms.
--%>
<%@ taglib uri="/tld/jx.tld" prefix="jx" %>
<%@ taglib uri="/tld/desktop.tld" prefix="dt" %>
<%@ taglib uri="/tld/desktopProviderContext.tld" prefix="dtpc" %>
<dt:obtainChannel channel="$JSPProvider">
<iframe src='<dtpc:getStringProperty key="srcURL"/>'
frameborder='<dtpc:getStringProperty key="fBorder"/>'
scrolling='<dtpc:getStringProperty key="scrolling"/>'
width='<dtpc:getStringProperty key="fWidth"/>'
height='<dtpc:getStringProperty key="fHeight"/>'></iframe>
</dt:obtainChannel>
在TabContainer中把内嵌Frame的Channel添加到MyFrontPage分页中。
最后,把这个内嵌frame的channel添加到你的portal的用户界面中。
1. 以管理员身份登陆Identity Server Administration Console。
2. 点击顶端的Identity Management tab,浏览到合适的组织或者子组织(suborganization)。然后,在左边的面板,从View菜单中选择Services。
3. 点击Portal Server Configuration下Portal Desktop边上Properties箭头。
桌面属性在数据面板显示。
4. 点击Channel and Container Management链接。
在Container Channels下面将显示一个channel的列表。
5. 确定IFrame Channel在Existing Channel列表上,点击MyFrontPageTabPanelContainer。
6. 在Existing Channel上点击IFrame Channel,然后点击Add把它添加到Available and Visible列表。点击Save。
要知道如何添加channels详情,查看Portal Server 6.2 Administrator's Guide中的To Modify a Channel or Container Channel Property章节。
测试内嵌frame的channel
确定内嵌frame的channel是可访问的,步骤如下:
1. 浏览http://hostname:portnumber/portal/dt?provider=JSPTabContainer
2. 点击MyFrontPage分页。
内嵌frame的channel将被显示出来
关于作者
Rama Talasila在1999年加入Sun公司,成为其中的一名技术人员。已经花了3年时间开发Sun Java System Portal Server。
Marina Sum是一名Sun Developer Network(http://developers.sun.com/)上的作家。她已经为Sun写作15年了,大多数都在技术领域。
-------------------------------------
注:这是本人在CSDN上翻译的第一篇文章,请多多指教,不胜感激。同时欢迎任何批评和技术交流,谢绝人身攻击。