---
title: "IBM WebShere Portal主题与皮肤开发"
author: "java_frog"
date: "2009-07-06T15:50:58Z"
tags: []
slug: "ibm-webshere-portal"
draft: false
lastmod: "2009-07-06T15:50:58Z"
id: 420855
url: "https://java-frog.iteye.com/blog/420855"
---

所谓主题与皮肤，主要指门户系统的界面风格与显示方式。在企业门户项目的实施中，主题与皮肤的开发是重中之重。因为作为所有企业内外信息、应用的统一入口，可谓是一个企业的脸面。另一方面讲，在一个企业内，没有任何系统比他们的门户系统有更多的员工使用，在项目实践经验中我也发现，花在主题与皮肤开发上面的时间往往占很大的比重，对美工的要求也比较严格。所以本书把这一部分内容作为第一章讨论。
8{V4_v@Y
M!i        l-NPortal 的主题与皮肤开发，说穿了还是普通jsp的开发，只不过大量使用了ibm自带的标签库，而且页面之间的调用非常复杂，初级开发者甚至找不到页面元素所在的文件，所以开发起来显得比较麻烦。另外，IBM WebSphere Portal6.0较之以前的版本又做了较大的改动，或者说随着新版本的推出，我们将面对不断地技术更新与挑战。但是，如果您深刻洞悉了与主题、皮肤相关的这几个文件之间的调用关系，使用起来就能运用自如了。)^uE;z6Y{$Z
本章主要是对5.1的介绍，附加了对6.0的延伸，尤其是变化比较大的地方。我们将从一下部分来讨论：+f?;}3H#z

2FB
4、高级探索：开发自适应分辨率的主题与皮肤；
$M|0_z7H*t^r4B5、高手过招：更改Portal系统的登录方式；FJ2x9Z$pG x|*g1On
6、Portal的皮肤开发简介。
g9^%?`&Zg
注意：这部分内容属于最初级的开发，您要弄懂这些介绍，必须具备一定的jsp、jspf基础、css基础和标签库的基础，最好做过相应的开发。-e        pZJ`5z

d        n s Qof4A5.1.1         Default.jsp：
@a_o#Z
iQP\W*b所有屏幕聚集都从 Default.jsp 开始。用于缺省主题的 Default.jsp 位于wp_root\app\wps.ear\wps.war\themes\html。这个 JSP 包含其它用于显示标题、公司徽标、工具栏的 JSP 以及用于往可用位置及页面植入内容的 JSP。在 Default.jsp 的末尾处，screenRender JSP 标记选择被请求的屏幕（例如 login 或 forgotpassword）。Default.jsp初始化一张表格，表格内部划分为任意的单元格，每个单元格几可以直接显示内容，也可以调用别的 jsp页面。我们以从上到下、从做到有的顺序，来分别介绍开发主题所用到的页面。以下介绍的jsp就是以这样的顺序先后调用的。
        m"ag*C9I4\        \:E5.1.2         Head.jsp]yR用来显示二级菜单，当您点击一级菜单中的任一标签时，系统会调用该文件，并检索出该菜单的所有子菜单，默认显示在PlaceBar的下面。该文件在Default.jsp初始化表格的第三行被调用，如果我们不调用该文件，那么，包含子菜单的一级菜单被调用时，其子菜单将在屏幕的左侧显示，该文件位于皮肤文件夹下，具体的文件操作我们将在接下来的皮肤开发中介绍。
v`{C,Gn
Q{5.1.7        Portal6.0中的调用关系www.portalfan.com|2c1_y;]
V3q
现在我们拿出一节的篇幅来简要介绍Portal6.0中的文件调用关系以其职责。如图：&o#UqCMvB4HM
YE7Z]d5tp:O
                 图：Portal6.0开发一套主题需要调用的页面清单.E%Jm5]FZ_,No
我们通常使用的是这几个：;d)dA5C3?8{4h)Oiz

CIVs-]5P
w\;Gq&W8a�T我们看这个例子，Default.jsp大致上将Portal系统的默认页面划分为这样一个表格：
:Fc;O!U)`7l.e
i6z+HgN+V1nwww.portalfan.com表-1： Default.jsp总体调用效果
au/IlnF
v
kwww.portalfan.comPageBegin: /O@?Yk'jK!^
用来显示页面生成以前的提示文字，例如：Portal系统正在加载，请稍候……d2IN
u:t1gTt6~
PageContent：\~2d&]Lg-C,`\
Portal系统主体部分：用来显示详细的Portal页面；portal爱好者sFFNo
c!U6Q!O/A#np
PageEnd.jsp用来显示页面生成以后的东西。例如公司版权信息等。9?z,COWB@.A        p

G1UW\q5Pg
  打开Default.jsp，您会开到一个表格，在表格的左上角，有这样一段语句，用来显示默认主题的Logo徽标：
F�h+oQ#Y%R*F
?V3O
/Tbg|]t9^
?S'W-}portal爱好者
(deC6x0}XP/siportal爱好者上面已经介绍过，整个Portal系统的页面由Default.jsp分割成一个大的表格，用来显示或者调用不同的jsp。我们在这个大表格的最左上角化出一个<td>,用来显示公司的徽标。这段语句就是在这个单元格内插入一个图片，叫做Logo.gif。aELw
V1XW
明白了吗？您可以将这个文件名改称您想插入的任意一张图片的名字，只要将这张图片放到.war/images/目录下就可以了。这里支持几乎所有的图片格式，您可以任意摆放，大小、位置等都有您说了算。到这里，您可能已经想到了：那么，我养插入一个Flash呢？别着急，下面将会提到这点。
7i'KxS-EX5.2.3         用flash作logo：
r        n3D9` Ywww.portalfan.com用Flash作徽标是个不错的注意，它可以使您的门户网站看起来更丰富、生动一些。但是，Flash，也就是.swf格式的文件，是不能直接通过这种方式来插入的，因为我们的浏览器并不能识别它。要插入一个动画，必须位置制定相应的驱动。您可以用以下这段代码，为之生成：&W F7`)Y5w�_x(z0i

G3`y.m.B5re&g        txC+Q
portal爱好者*PX;wB6W(O-}
然后打开文件flyout.js文件，加入如下函数：www.portalfan.comW)t2li/y6V
/*≡≡≡═══─────────t5s+2d1b`d%Spluginspage="http://www.macromedia.com/go/getflashplayer"  type="application/x-shockwave-flash" height="'+h+'"></embed>');Zvjpd%K�qbI
    document.write('</object>');www.portalfan.com1a2c,xkTd]9C9zw
}
:Ud&rJEWB)R kportal爱好者
9I$\uU qqwww.portalfan.com然后在需要插入Flash的地方插入以下代码：@e
^Ic
<tr>0CD        {"tkL9P.|9q^
    <td align="center" valign="middle">
~`8NHSwww.portalfan.com           <script language="javascript" type="text/javascript">_.T(oOYB
H9\]"1\Si8D
        </td>
'vL5^)@B  </tr>d'S(p!g"H6^a
重起服务器，再检查一下，是不是虚框已经没有了？
U
i(x$a*UO5.3         中级进阶：开发个性化的Portal主题t,o]mfc
5.3.1         理解各级菜单；
BSuKz,J&ao;B;o
NDefault.jsp 调用PlaceBarInclude.jsp文件来显示一级菜单，如果一级菜单下面还有二级菜单，那么当您点击该一级菜单时，Default将调用 PageBarInclude.jsp来显示二级菜单。当然，您也可以不调用该文件，那么系统将缺省调用Portlet的皮肤里面的 LayerContainer.jsp文件，用来以三级菜单代替二级菜单，这就是个性化的左侧管理菜单。"uo9i        rG }x/M;ZU
打开这两个文件，您会发现里面的内容非常简单。请看下面的清单：H5pb�P;~
首先由这样一个标签：/f/uI^�S?P
:rVP&utn6|?#~
意思是如果菜单是可用的，那么当您登录进去以后将执行如下操作。使用这句代码，必须引入Portal的标签库，具体的过程这里不再赘述。接下来绘制了一个表格，用来显示里面的操作。表格内的内容，下面将作介绍。/S(ZX,r4]
菜单的左右协调：如果您一共定义了十几个一级菜单，而一栏只能显示8个，剩下的菜单怎么办？我们在这里放置了两个三角形的小图标，如果右边还有更多的菜单，小图标会自动出现，当您点击时，就会显示出剩余的菜单。  具体的代码是通用的，这里不再赘述。我们需要强调的是：菜单条在这里支划分为两种情况：一是选中的情况下，一是为选中的情况下，即：sQ:D NM!IO$Q
      
'F1C(h4j$osI@y8J例如：portal爱好者x"n*^&I;t$QG*d$K

1K-x^m}n
"dV`!])]C
Q;z我们首选添加一张背景图片，然后左侧放一张前缀，中间打印该菜单条的名字，后面又放一张图片做后缀，这样整个菜单条看起来就非常漂亮了。
8M4f,KUbc
J:Zig{t接下来是显示工具栏的情况下：        J\8Q?/?)E

wx6Z+YSFN7g%f
z这里的操作将使具有权限的用户通过点击这张图片，直接编辑相应的portal页面。不过据笔者的开发经验，大部分的用户会隐藏掉这个入口，以免引起管理上的混乱，具体的开发内容将在以后的文章中提及，这里将不再详细介绍。
FJ
W7EB8z最后的代码用来显示系统收藏夹：
)igi-kJ+P&n当您登录后，会发现在一级菜单的最右边多出一个“我的最爱”的东西，这是portal系统自带的收藏夹，您可以通过这个入口将自己喜欢的页面添加到您的收藏夹，然后您就可以通过点击这里直接进入到你收藏的页面了。9B,e�d9C7te7a `
#rX%G$F
在这里你可以编辑自己的“概要文件”，就个人的用户信息，修改自己的姓名、密码等。更深一层的话，您可以在这里显示欢迎信息，例如张三同志登录后，会打印出：“欢迎您，张三同志！”的语句。要实现这个功能实际上非常简单，请看：T        i\_
OJ3xpW$];H
         Zp}(y�H
iV8j        P
当然，您需要引入相应的标签库，具体的应用属于普通的jsp开发，您可以参照平常的开发经验去实现。portal爱好者Tl8?'Z
e%xZ^k
5.3.3         个性化的管理标签
}Rw9?W0?0a/s!wyC,}www.portalfan.com所谓的个性化指的是，您可以删掉管理标签的一个或者多个，也可以根据喜好添加自己需要的标签。这需要您来修改AdminLinkBarInclude.jsp文件。例如：+q1GMv2MQ^E
  
u\7u#H
~(ywww.portalfan.com这段代码用来显示“新建页面”的管理标签，通过电机这个标签，您可以为当前页面创建一个子页面。同理，您可以个性化“编辑页面”和“分配页面权限”，当然，您也可以之间隐藏掉这个入口。^1yq'erQf3s

m#X%rBn
yYP5.4         高级探索：开发自适应分辨率的主题与皮肤www.portalfan.comulxk+_}5n刚安装完Portal系统后，刚才介绍的几个jsp 会在默认的.war/theme目录下，您可以新建一个文件夹，将这几个jsp文件拷贝至该目录下，然后在管理界面下添加该主题。该主题默认下就是 1024*768的。您可以开发多套主题，注意：请充分利用一些公共的资源，例如这些主题可能使用的是同样的版权信息，这样，您可以将 PageEnd.jsp页面放到themes/entention下，然后让所有的主题调用这个文件。Ol/X-o#B%~`cG
当然，为了保险起见，您可以在Default.jsp最外层的表格中这样写死：www.portalfan.com,\q1mL_7`
            
$^U^7Ih4dI n5.4.2         800*600分辨率下的主题6r9L O*l
jv.^H/rD
开发800下的主题说穿了非常简单，您可以会出这么一个表格：
yj'\5kue(^$h:V         oY2ekU%H5o
将这个表格覆盖到原来Default.jsp文件中最外层的表格就可以了。注意：在default.jsp中调用的各个文件中，可能都有表格存在，如果这些表格中有的宽度超过了800，或者两个并列一行的表格宽度超过了800，请适当调小。否则里面的表格辉将此表格向两侧撑开，从而导致表格不协调。
gb'@&_Twww.portalfan.com5.4.3         1024和800下自适应得主题
v1s$e&]4o*ww(uP2cwww.portalfan.com要开发自适应的主题就更简单了！请设定一个变量w,先写一个JavaScript，用来读取客户端的浏览器分辨率，如果是800的，则给变量赋值w= 800，反之如果是1024的，就给赋值为w=1024。这样Default.jsp初始化的表格宽度就以w来替代，对具体jsp的调用的单元格的长和宽都在原来的基础上乘以1或者乘以0.78。剩下的事，不用我说了吧！1nk;ie6?:\]P
5.5         高手过招：更改Portal系统的登录方式；Pm!I
RA(?}G
5.5.1         从首页上登录
#`1?6|l*D3C        {ZKzwww.portalfan.com您需要用wsad开发一个portlet，并在jsp中写一个代理，将用户凭证提交给系统自带的认证action中。这个portlet可以这样来设计：www.portalfan.com0CQ|5A$RxXc        ~9x
但是在上面这种情况下，可能会出现这种情况：当用户名或者密码错误的时候，系统会返回到系统自带的登录框上面，为避免这种情况，您可以封死这个开关。这个非常简单，我在这里顺便一提：yvH!g1f:Ex.f:ez/aA
系统自带的登录页面是.war/screen/html下的login.jsp文件，您可以删掉该文件里的所有内容，然后加入这么一句：&}6}#I;V*ds^q
  A        i~]r]b"th'X
呵呵，是不是带您又回到了首页呢？是的，确实如您所想，这样就封死了系统自带的登录页面。如果您的用户名和者密码错误，或者您通过myportal直接调用，都不起作用了吧！系统会带您回到首页的登录界面，请重新输入！从这里我们可以延伸开来，比如说Session过期，修改用户的个人信息等，都可以通过这种方式封掉这个接口。  ^FE(t.Z2nT
5.5.3         遗留问题：
-C/vBbj;s&K*ufk有人问，Portal系统的菜单可以用图片吗？答案是肯定的。例如：以下是某航天系统的Portal系统，菜单就是采用的图片，如下图：
HrxM'ku!{portal爱好者
'{q%S(@}1U-_YQ?portal爱好者!W;G%X
x9jts5\Mba

?2e-e4mL2H?6`其实开发起来倒是很简单，只要在PageBarInclude.jsp中判断一下，当字符匹配时就调用相应的图片也就可以了。
_
fr?u#s-@:tLwww.portalfan.com2. 在实际开发中，您也许会发现还有其他一些意想不到的问题，是的，这个地方确实有许多值得注意的地方，也许只有您亲自来试过了，才知道其中的细节。0?'q-\(BYS
Z4MtR
t
5.6         Portlet的皮肤开发
D`ckd�DC4}&Oportal爱好者5.6.1         更换标题背景图片
n@,dX:`%I)T({portal爱好者非常简单，请找到.war/skin/html下，发现系统已经存在了好几套皮肤，打开其中任意一个文件夹，您都能发现这个文件：^R N1f!},y"PO|
Control.jsp。
0md(i"R
U4W$r
uwww.portalfan.com该文件初始化一个小的表格，该table有两行：第一行用来显示portlet的标题，后面是最大化、最小化、编辑按钮；第二行是portlet的 body，用来显示portlet的内容。一般来说，用户喜欢在Portlet名称前面或者后面，放上个小图标等等之类的装饰，我们可以直接在这格单元格里面操作，符合基本的html语法。当然，如果portlet的名称是固定的话，我们也可以像上面开发portal主题的菜单时候一样，用图片来替代。其实只要判断一下portlet的标题，如果符合的话，就调用相应的图片，或者单独为这个标题的portlet开发一个皮肤，用于调用专门的图片。或者直接显示，或者作为背景，都很容易。T$OgVi
要换掉portlet标题的背景图片其实非常简单：在第一个<td>里面加上这么一句代码：
8{9`"R)I&{`        k&Ywww.portalfan.coma-cQk2]ZO)^        g
  就一切OK了。
fJ,F*g
Nr'MQportal爱好者下面这张页面是皮肤结合比较好的例子，大家可以思考一下如何实现。
)V csy)VS�F;\8K5.6.2         隐藏工具图标。
6NGtAV&WEw有些用户不喜欢portlet有着太复杂的操作界面，要求去掉“最大化”、“最小化”、“还原”等功能，当然，也就不显示了。其实这非常容易，请再打开我们的表格，看这么一段代码：PH+r5epefC
        www.portalfan.coma_ U$w/tk
这段代码是用来显示“最小化”按钮，不用说，直接去掉就行了！而且，您可以对此做任何编辑，包括添加什么显示内容，甚至添加什么新的事件等等。同样的道理，我们可以相同的来操作“最大化”、“还原”两个图标。
A~#F9}5l*J
d)TA5.6.3         个性化左侧菜单portal爱好者TZHu"U\,G
在项目实施中我发下这样一个有趣的现象：IBM产品的忠实用户，往往钟情于IBM系列产品的一贯风格。比如，某客户几年前实施的OA系统，使用的是“收件箱”、“发件箱”、“垃圾箱”等一系列菜单全部竖排在屏幕的左侧，那么，客户在实施Portal系统的时候，他就比较倾向于二级甚至以及菜单全在左侧竖排的情况。其实这个也很简单，只要我们不再调用原来用于显示一级菜单和二级菜单的jsp页面，一级菜单就会以竖排的方式自动的排列到屏幕的左侧。那么我们要想美化这种菜单呢？没关系，我们可以很容易的找到这个文件。
vkH._$L9[�S5c\f打开skin目录，你会发现有这样一个文件：LayeredContainer.jsp不错，就是它，它首先初始化一个表格：'V{BiY MFC

-WG%@"P}q["hqQ该表格左侧就是三级菜单（您如果再 Default.jsp中不再调用PageBar的话，这就是二级菜单；如果您链一级菜单PlaceBar都不调用了的话，她就是一级菜单了）。右边呢，则是整个Portal系统得Body部分，显示了所有的portlet。不晓得IBM为什么要这样安排，似乎有点不合理。不过，确实是在这里修改的，可能是把它看作一个容器了吧！在左侧的表格部分，您可以向编辑普通的网页一样，只要您稍微有些美工知识，就可以随心所欲的制作出个性化的左侧管理菜单了。
y        b@M
H+e%yIportal爱好者5.7        合理使用CSS样式表
U/e`?&w9HT)n([portal爱好者
&v2y/~a!a7sz�O
,[r        zO�lK8uoy3I6B.Rportal爱好者看上面的效果，是不是非常漂亮？
%{d!X!p8Qwww.portalfan.com其实这很简单，看LayeredContainer.jsp这个文件，下面是他的表格，稍微加一些CSS，就能实现这种效果了。比如皮肤右侧漂亮的弧线，其实只要这么简单的一句话就OK了：portal爱好者-v        j!Jt+I8G
portal爱好者Nz        sxB.q
     我们再来看看某电力公司的首页，这也是皮肤开发结合比较好的例子：
G|2XH#O:IVy.CSN1t0@RT1N&CCl
当然，这需要素质比较高的美工配合，也需要工程师在长期的开发中仔细琢磨。再次祝您在Portal开发中信手拈来、出神入化！portal爱好者KV.s~#b,b%us
5.8         主题与皮肤的安装portal爱好者3IhQ:fU�[
假设我们现在已经开发出一套主题，如何将这套主题部署到我们的门户系统？下面是详细的方法。
U(eYqG%oI#l(t.mwww.portalfan.comwww.portalfan.come\(ue*glq+j"C
u8l9|df"f0YZ9c
                  
:t+K/N@
yu4ex
*p8T-~a}'~C
KF
h        UV_V+q U!Tportal爱好者
&`W3^
wv        c~        dE1pportal爱好者5.9        主题与皮肤开发的调试方式
K)@z6e)zc|1PA7vwww.portalfan.com调试主题与皮肤一般采用两种方法，一是修改reload以便快速自动装载的方法，另一种是复制并添加主题/皮肤法：
3Bc
t;E1E6f
Ic(jPwww.portalfan.com5.9.1        自动装载法
F.d9{n/bufy我们知道，portal系统的主题一切都是从 default.jsp聚焦的，在通常的应用服务器上都有一个reload开关，用以控制服务器是否自动更新，ibm websphere portal也不例外。如果我们打开这个开关（这个开关您可以打开was,在管理控制台里面设定，完了还有重启一下机器），并设定了reload的时间，那么每个一个时间段，系统会自动读取主题与皮肤文件。换言之，只有我们把这个时间差设的足够小，就能立刻观察到我们的修改结果。（在这里要注意一种情况：就是既然是从default.jsp开始聚焦，那么，如果您修改了由default.jsp调用的别的文件比如说BeginPage.jsp，而单单没有修改default.jsp的话，系统会默认您没有做任何修改，所以也就没有任何改动了）同时我也想声明一点，这种做法带来的系统开销特别大，只可是用于开发环境，在生产环境中是万万不可的！
"t@Y9X\-Zrportal爱好者5.9.2        复制目录法portal爱好者7`*R({^
W
如果您对某一主题做了部分修改，可以复制一下这个文件夹并换个名字，然后添加这个主题到系统并配置给相应的页面。第一次安装的新主题，当然后重新编译了。看得出来这种方法比较不方便，只适用于特殊情况。