在内嵌frame中创建一个Portal Channel

 

使用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上翻译的第一篇文章，请多多指教，不胜感激。同时欢迎任何批评和技术交流，谢绝人身攻击。