JBossportal入门手册.docx

内部公开jboss portal 入门手册目录jboss portal 入门手册11.概述22.jboss portal的安装与配置32.1下载jboss portal32.2运行jboss portal32.3配置jboss portal33.eclipse3.6.2中安装jboss tools 插件53.1下载jboss tools53.2安装jboss tools54.创建和部署java portlet74.1创建一个jboss portlet 的web项目74.2在java portlet中添加一个web项目134.3将一个portlet部署到jboss portal141. 概述portal 顾名思义就是门户，随着web应用技术的成熟和企业对门户网站的需求增大，需求的复杂性和变化性增加，原先的基本web开发技术慢慢难以应付这些变化中的需求，比如我们经常可能会需要局部修改某个页面的一小部分的形状与内容，有时候可能有需要修改页面的布局，而内容并不需要改变，那么在这样变化频繁的需求时代，以前的web应用开发技术让程序感觉力不从心，常常抱怨客户的需求随心所欲。 此时为了能够让应用尽量满足用户的可变需求，于是很多人开始开发一些框架来对页面和其中的内容进行定制，比如让布局由某一个子程序模块来完成，并且做到可配置，这样，即使用户提出需求也容易做到了。但是这样的程序每一个程序员的实现过程、标准都完全不同，为了能够让这样框架有一个统一的标准，于是出现了portal，基于java的portal的标准发展到今天已经是2.0的规范了（jsr-286），遵守这一规范的服务器框架实现也有了不少，商业产品中有ibm的websphere portal，oracle的bea weblogic portal，开源应用中最为流行的是jbossportal。 portal 中最常用的就是jboss portal。jbossportal提供了一个开源符合标准的门户平台，可以用其搭建/布局一个门户网站的web界面，发布和管理内容以及定制它的用户体验。jbossportal最新版本中在个性化设置，身份验证，工作流都进行重大更进。此外还集成了google gadgets，以提高用户工作效率。2. jboss portal的安装与配置2.1 下载jboss portal 首先我们安装jboss portal与jboss as捆绑的版本，这个是最简单的安装方式（下载地址：/jbossportal/download），按照如下步骤进行安装：将下载的zip文件（jboss-portal-2.7.2-bundled.zip）解压缩到您期望的目录中，比如说：c:jboss-portal-2.7.2，解压缩之后，目录结构如下图所示：2.2 运行jboss portal运行jboss portal安装目录下的bin文件夹中的启动脚本，在windows下是run.bat，在linux下是run.sh。在启动过程中服务器使用的default配置。如果需要采用其它可选的配置，在运行run.bat的时候需要指定-c选项。2.3 配置jboss portal打开您的浏览器，输入http:/localhost:8080/portal，您将会看到portal的缺省主页，portal提供了两个帐号供用户登录。第一个帐号的用户名和密码都是user，第二个帐号的用户名和密码都是admin，每一个帐号都有自己相应的主题与访问权限。关于权限我们将会在后续章节讨论安全的部分来讨论。现在使用这两个帐号已经足够我们做实验了。默认主页如下图所示：此时，您打开控制台可能会看见一下错误与警告。如下图所示： 这些错误是因为我们还没有配置后台的数据库，所以不用担心。有时候启动过程中可能会汇报outofmemoryerror错误，这可以通过调整maxpermsize来消除，在启动脚本中的java_opts中添加-xx:maxpermsize=128m 。 为了能够让jboss portal将数据保存在我们自己定义的数据库中便于管理，我们需要配置一下数据源的设置，现在您可以先停止jboss服务器，然后打开jboss portal的安装目录，打开下面的serverdefaultdeploy目录，在其中您应该可以找到一个文件：portal-hsqldb- ds.xml，我们将这个文件复制一份，取名为：portal-mysql-ds.xml，将原来的文件删除或者放到其他地方去备份起来，接下来我们准备做的事情是将portal访问的数据库配置成为mysql的数据库。如果您对mysql的操作不熟悉请参考关于mysql的资料。 首先在mysql中创建一个database，比如这里我创建了一个名为：portaldb的数据库，并且为这个数据库准备了一个帐号，用户名和密码都是 jp，确保能够使用这个用户名和密码连接mysql数据库。然后修改portal-mysql-ds.xml的内容如下： portalds jdbc:mysql:/localhost:3306/portaldb com.mysql.jdbc.driver jp jp 保存这个xml文件，然后重新启动您的portal，在命令行中，您可能还是会看见很多错误或警告，不要紧那是因为portal需要在数据库中查找表和数据，而我们刚刚创建的数据库中并不存在相应的表和数据，所以会产生异常，不过放心，在portal找不到数据内容的情况下，portal会自己创建数据库中的表并插入初始数据，您可以使用user帐号或者admin帐号登录，您会发现登录没有问题，这就说明您的配置是成功的，好了，到这里，我们已经成功地将portal的服务器安装和配置成功了。3. eclipse3.6.2中安装jboss tools 插件3.1 下载jboss tools 下载安装jboss tools插件一定得注意版本对应，本文使用eclipse3.6.2 对应的jboss tools 版本为 jboss tools 3.2。下载地址：/tools/download3.2 安装jboss tools下载完成以后打开eclipse1) 打开help-install new software.2) add - archive 然后打开刚下载完的zip包jbosstools-3.2.0.ga.aggregate-update-2011-02-16_18-30-44-h329.zip（如图a）或者你也可以直接在地址栏里输入/jbosstools/updates/stable/helios/ （如图b）ab3) 选择要安装的功能，然后单击下一步。（不建议您选择全部的功能，这样做可能导致崩溃的eclipse的安装过程。如果发生这种情况，只需重新启动，然后再试一次 。）4) 如果你遇到问题的解决依赖关系，你可以点击“available software sites”来添加有效的网址。5) 获取的所有功能和安装的插件后，你将被提示选择包含未签名的jars这是正常的，而不应被视为“不安全”的安装。6) 出现提示时重新启动完成安装。4. 创建和部署java portlet4.1 创建一个jboss portlet 的web项目1） 找到file-new - dynamic webproject2） 指定项目的名称3） 单机“new.”创建一个jboss runtime，选择jboss community jboss 4.2 runtime，并选择create a new local server，点击next。4） 出现“new server runtime environment”的向导，单击“browse.”找到jboss位置，点击“next”继续5） 然后，一个新的jboss服务器实例将被创建 。在接下来的页面中，您可以验证定义的运行时信息。如果是不正确的信息，然后按“back”返回到以前的向导页 。点击“finish”完成。6） 点击“modify.”在project facets对话框中，检查jboss core portlet，然后点“ok”。7） 最后一个向导页面会要求您添加jboss portlet capabilities的项目 。选择portlet target runtime provider，并单击“finish”来完成项目的创建。项目创建成功，增加了jboss core portlet 的项目，创建了一个空的portlet.xml文件，并添加到项目的类路径中的jboss portlet的classpath。4.2 在java portlet中添加一个web项目在上一节，您已经创建了一个web项目，接下来告诉你如何添加一个新的java portlet项目。1） 右键单击该项目，new other jboss tools web portlet java portlet2） 填写java package和class name，单击“next.”接下来的向导保持默认值就行，最后单击“finish”。一旦创建了一个java portlet，新的资源添加到项目结构：一个java portlet类（testportlet.java），default-object.xml和portlet-instan