浏览 10460 次
精华帖 (0) :: 良好帖 (0) :: 新手帖 (0) :: 隐藏帖 (0)
|
|
---|---|
作者 | 正文 |
发表时间:2008-07-07
概述 Apache Pluto 是 JSR-168 和JSR-268的参考实现(pluto 2.0基于JSR-268(Java Portlet Specification V2.0),之前的版本基于JSR-168(Java Portlet Specification V1.0)),是实现了 Portlet API 的 Portlet 容器,充当Portlet 的运行时环境,与 Web 应用服务器的 Servlet 容器的运行时环境支持 Servlet 的情形非常相似。根据Java Portlet Specification,Portlet 容器是Servlet 容器的扩展,并且需要servlet 2.3 以上支持。 Apache Pluto 常作为验证portlet的容器,不作为产品生产的容器,目前比较流行的产品级容器有Liferay,eXo,Jetspeed,当然还有老大哥级别的Bea和IBM都有自己的portlet容器产品,有兴趣可以查阅一下相关资料。 “吾常整日而思矣,不如须臾之所学” 废话少说,让我们先动手来做一个Demo来感受一下Portlet是为何物。说明一下,Java Portlet Specification v2 (JSR 286)2008年3月份刚出来,所以本文基于Java Portlet Specification v1 (JSR 168),以后在讨论JSR 286的新特性。 开始前请准备下列产品: •JDK 1.5 或者更高版本 •Apache Tomcat 5.5.x或更高版本 •Apache Pluto 1.1.4 •Apache Maven 2.x(可选) •Eclipse Europa(Eclipse V3.3) for JavaEE Developers或更高 Portlet 运行环境的搭建 Apache Pluto 官方当前发布的版本为1.4.1,包含以下四个下载选项: • pluto-current-bundle – 该包提供了一个与Tomcat 5.x绑定的pluto版本,你可以将你的portlet应用直接部署在里面,跟你平常部署一般web应用没有什么差别。 • pluto-current-bin – 包含了pluto lib 包、portal 和 测试应用。 • pluto-current-container-bin – 仅包含pluto容器 lib 包 • pluto-current-src – 包含了pluto 源文件 1.安装JDK、Maven 2、安装 Tomcat并设定相应的环境变量 此步骤不再熬述,具体请查阅相关文档 Jdk:http://java.sun.com/ Maven2:http://maven.apache.org/ Tomcat:http://tomcat.apache.org/ 2.下载安装 Apache Pluto 1.1.4 安装方法有三种:第一种是二进制安装,第二种是从源代码安装,第三种是手动配置,我喜欢第三种,不过这里还是一一介绍一下。 方法一:二进制安装 1.下载pluto-current-bundle,并解压(如,d:\ pluto-1.1.4),得到的目录结构如下: 其中的PlutoDomain即为容器配置的Portal和测试两个应用war包,当此Tomcat启动时会自动部署。这个如果你看着奇怪,可以看一下:D:\pluto-1.1.4\conf\Catalina\localhost 下的pluto.xml和testsuite.xml就明白了。 2.在D:\pluto-1.1.4\bin中执行,startup.bat (Windows) or startup.sh (Unix)。请注意:现在D:\pluto-1.1.4 其实就是个tomcat 5.5, 按此方法安装不需要再下载Tomcat。其默认端口为8080,如果该端口被占用,请更改端口。(在D:\pluto-1.1.4\conf 下的server.xml中修改)。这里假设不更改。 3.在浏览器中输入:http://localhost:8080/pluto/portal 即可访问pluto portal. 4. 默认设置了两个帐号: User: pluto password: pluto User: tomcat password: tomcat 安装成功后就可以体验什么是portal了。 方法二:由源代码构建 先觉条件,请确认已经安装并配置好了Maven2,可以打开命令行,输入: C:\Documents and Settings\db2admin>mvn -version Maven version: 2.0.9 Java version: 1.6.0_10-beta OS name: "windows 2000" version: "5.0" arch: "x86" Family: "windows" 如果能看到这些内容,则说明Maven2已经安装好了。 1.下载pluto-current-src,并解压(如:D:\pluto-1.1.4),得到的目录结构如下: 此目录就是pluto的项目模块了,熟悉Maven的话一点困难都没有,本人也是因为刚刚接触,就不在此班门弄斧了。 2.编辑 %MAVEN_HOME%\conf 或者~/.m2/settings.xml目录下的settings.xml 文件,增加 <pluginGroups> 元素: <settings> …… <pluginGroups> <pluginGroup>org.apache.pluto</pluginGroup> </pluginGroups> …… </settings> 如果没有做好这一步,执行安装是会失败的。 3.在命令行控制台,切换到D:\pluto-1.1.4,并执行如下命令: D:\>cd pluto-1.1.4 D:\pluto-1.1.4>mvn install D:\pluto-1.1.4>mvn pluto:install -DinstallDir=D:/Tomcat6.0 本机安装的为Tomcat6。0,之前安装的Tomcat5.5也丝毫没有问题,需要注意的是,如果你的服务器路径包含空格的话,需要用引号将服务器路径包含起来,不然空格在控制台中乱码,造成编译失败。如下所示: C:\pluto> mvn pluto:install -DinstallDir="C:\Program Files\Apache Software Foundation\Tomcat 5.5" 待构建成功后部署就完成了。 其实Pluto的容器安装部署没那么麻烦,但是现在Maven大行其势,很多开源软件也基于Maven来构件,有点要冷落Ant的嫌疑。不管Ant 还是 Maven,都大大提高了初学者的门槛。整个容器部署构建过程其实就拷贝了几个包到相应的目录,部署了一个Pluto portal 和一个测试套件。具体我们在手工安装中讲解到底是如何来安装Pluto容器。 方法三:手工安装 手工安装就跟部署一般的web应用程序没有什么差别。 在方法二中执行mvn install后,会下载一系列的包含jar的lib包,当然这些包可以在pluto-current-bundle、pluto-current-bin、pluto-current-container-bin中找到。下面具体描述: 步骤1,部署容器,拷贝下列文件至(Tomcat 5.5)<TOMCAT_HOME>/shared/lib或者(Tomcat 6.0)<TOMCAT_HOME>/lib •castor-1.1.1.jar •pluto-container-1.1.4.jar •pluto-descriptor-api-1.1.4.jar •pluto-descriptor-impl-1.1.4.jar •pluto-taglib-1.1.4.jar •portlet-api-1.0.jar 步骤2. 拷贝下列文件至(Tomcat 5.5)<TOMCAT_HOME>/common/endorsed或者(Tomcat 6.0)<TOMCAT_HOME>/endorsed (endorsed目录为新建目录) •xercesImpl-2.6.2.jar •xmlParserAPIs-2.6.2.jar 这个主要是用来兼容Java 1.4 环境运行Pluto 1.1。 步骤3. 从pluto-1.1.4-bundle\pluto-1.1.4\conf\Catalina\localhost 或者 D:\pluto-1.1.4\pluto-portal\src\main\resources\pluto.xml D:\pluto-1.1.4\ pluto-testsuite\src\main\resources\testsuite.xml 中拷贝pluto.xml、testsuite.xml 至<TOMCAT_HOME>/conf/Catalina/localhost目录下。这两个就是Context,熟悉的话可以在<TOMCAT_HOME>\conf\Server.xml (Tomcat 6.0默认没有此目录,需要建立此目录) 步骤4. 部署pluto-portal.war、pluto-testsuite.war,可以在下列目录找到这两个应用: D:\pluto-1.1.4\pluto-portal\target\pluto-portal.war D:\pluto-1.1.4\pluto-testsuite\target\pluto-testsuite.war 或者 pluto-1.1.4-bundle\pluto-1.1.4\PlutoDomain 根据pluto.xml、testsuite.xml中的docBase指定的路径将pluto-portal.war、pluto-testsuite.war拷贝到相应的目录,如果pluto.xml、testsuite.xml来自Maven构件的则把pluto-portal.war、pluto-testsuite.war放在<TOMCAT_HOME>/webapps,如果pluto.xml、testsuite.xml来自 pluto-1.1.4-bundle\pluto-1.1.4\conf\Catalina\localhost,则放在 <TOMCAT_HOME>\PlutoDomain目录下。 说明:为了能够在应用范围使用Pluto的PortletSession 属性,需要修改<TOMCAT_HOME>/conf/server.xml 中默认8080端口的Connector元素,增加属性:emptySessionPath="true",但是如果设为true,所有path的session cookie将设为/。这对portlet规范的实现非常有用,但是在服务器需要同时提供多个被访问的应用时,会对性能造成很大的影响。如果没有设置,该值为false。另外pluto-current-bundle里面已经做了设置,但是通过Maven构建时并没有设置,需要手动设置。 步骤5. 配置用户和角色 编辑<TOMCAT_HOME>/conf/tomcat-users.xml,增加一个用户和角色。 <?xml version="1.0" encoding="utf-8"?> <tomcat-users> <role rolename="manager"/> <role rolename="pluto"/> <role rolename="tomcat"/> <role rolename="role1"/> <user username="tomcat" password="tomcat" roles="tomcat,pluto,manager"/> <user username="role1" password="tomcat" roles="role1"/> <user username="both" password="tomcat" roles="tomcat,role1"/> <user username="pluto" password="pluto" roles="pluto,manager"/> </tomcat-users> 该配置为Pluto 配置了pluto 和 tomcat两个帐号。 请不要忘记配置<user username="both" password="tomcat" roles="tomcat,role1"/> 到此,Portlet的运行环境搭建完成 3.验证安装 启动 Tomcat 服务器。浏览器访问http://localhost:8080/pluto/portal 输入用户名和密码(如: pluto/pluto),进入 Pluto 的 Portal 页面: 大家一定要注意编辑D:\Tomcat6.0\conf\ tomcat-users.xml添加角色和用户,而且<TOMCAT_HOME>/conf/Catalina/localhost 下的pluto.xml、 testsuite.xml 的应用路径配置:docBase="../PlutoDomain/pluto-portal-1.1.4.war" 则表示pluto-portal-1.1.4.war 应该放置在D:\Tomcat6.0\PlutoDomain目录下。 能成功登陆,说明Portlet环境已经配置成功了。 建立开发环境 IDE其实可以自己选择,这里使用Eclipse 3.4 for J2EE Developers, 2008年6月26号刚出炉的,来体验一下。 为项目开发配置动态web项目的运行时(Runtime Server)服务器配置。 启动 Eclipse, 打开菜单项目 Window -> Preferences,在Preferences 对话框,选择 Server-> Runtime Environments 项 点击 Add 按钮,将 Tomcat 6 添加为运行时, 设置Tomcat 6的安装路径,其他不需要更改 单击 Finish 结束配置,单击 OK 关闭 Preferences 对话框。 在 Eclipse 的 Servers 视图中单击鼠标右键,选择 New -> Server。 弹出的窗口中选择目标运行服务器 Apache Tomcat 6.0 Server,运行时呈现 Apache Tomcat V6.0,如点击Finish 在 Servers 视图中双击刚刚新建的 Tomcat 服务器,打开服务器配置页面。 在 Server Locations 中选择 Use Tomcat Installation, DeployPath 选择 D:\Tomcat6.0\webapps,如所示。至此开发环境设置完毕。 Portlet 程序示例 1.在eclipse中新创建一个 Dynamic Web Project, 设置项目属性,项目名称 HelloPortal, 目标运行时 Apache Tomcat V6.0,保留默认设置,点击 Finish 2.创建一个HelloWorldPortlet类,该类继承javax.portlet.GenericPortlet 代码如下: // HelloWorldPortlet.java package com.ccsee.portal.portlet; import java.io.IOException; import javax.portlet.GenericPortlet; import javax.portlet.PortletException; import javax.portlet.RenderRequest; import javax.portlet.RenderResponse; public class HelloWorldPortlet extends GenericPortlet { @Override protected void doView(RenderRequest request, RenderResponse response) throws PortletException, IOException { response.setContentType("text/html"); response.getWriter().println("Hello, This is the portal world!"); } } 3. 在WEB-INF目录下新建portlet.xml 配置文件 <?xml version="1.0" encoding="UTF-8"?> <portlet-app xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd" version="1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd"> <portlet> <description>Hello World Portlet Description</description> <portlet-name>HelloWorldPortlet</portlet-name> <display-name>Hello World</display-name> <portlet-class>com.ccsee.portal.portlet.HelloWorldPortlet</portlet-class> <expiration-cache>-1</expiration-cache> <supports> <mime-type>text/html</mime-type> <portlet-mode>VIEW</portlet-mode> </supports> <supported-locale>en</supported-locale> <portlet-info> <title>Hello World Portlet</title> <short-title>Hello Portlet</short-title> <keywords>Hello World</keywords> </portlet-info> </portlet> </portlet-app> 4.配置web.xml <?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5"> <display-name>HelloPortal</display-name> <servlet> <servlet-name>HelloWorldPortlet</servlet-name> <servlet-class>org.apache.pluto.core.PortletServlet</servlet-class> <init-param> <param-name>portlet-name</param-name> <param-value>HelloWorldPortlet</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>HelloWorldPortlet</servlet-name> <url-pattern>/PlutoInvoker/HelloWorldPortlet</url-pattern> </servlet-mapping> </web-app> 5. 在 META-INF 下新建 context.xml 文件,内容如下: <Context path="/helloportal" docBase="HelloPortal" crossContext="true" /> 示列部署 在 Eclipse 的 Servers 视图中,右键单击 Tomcat 服务器,点击 Add and Remove Projects,在弹出的对话框中将 HelloPortal 项目添加到右侧栏目中,点击 Finish 确认。 在 Servers 视图中启动服务器,Console 视图中输出 Tomcat 启动信息。 浏览器中输入相应 url 访问 pluto 的 portal 页面,登录,点击 Pluto Admin 导航栏 使用该工具新建一个 page,如 "HelloPortal"。导航栏中马上新增一项 "HelloPortal ",点击进入该页面可以见到目前该页面没有内容。 选择 HelloPortal应用程序中的 HelloWorldPortlet,选择上一步新建的页面,点击 Add Portlet 按钮,将 HelloWorldPortlet布局到 "HelloPortal" 页面。 进入 "HelloPortal" 页面,该页面新增了一个 Portlet,并打印出“Hello, This is the portal world!”。 本示列为一个极小的HelloWorld应用,旨在感性的认识Portlet的开发。示例中涉及的文件,仅仅四个: 1.HelloWorldPortlet.java 2.porlet.xml 3.web.xml 4.helloportal.xml 花了一个下午写了这篇文档,本来是图文并茂的,谁知从word中沾过来,图片都消失了。格式也乱了,稍微整理了一下,在此抛砖引玉,期望跟大家一起进步。 声明:ITeye文章版权属于作者,受法律保护。没有作者书面许可不得转载。
推荐链接
|
|
返回顶楼 | |
发表时间:2008-07-08
以前也试过Apache Pluto作为测试用portlet容器,可惜兼容性不太好, 一些jsr-168的portlet发布之后提示不可用。只好远程到ibm portal上去发布和测试了。
|
|
返回顶楼 | |
发表时间:2008-07-08
兼容性确实太差,在Java 6u10b 环境编译,放到Java 5u10 就报Class Version之类的错误,甚至用Java 5u1b 环境编译,放到Java 5 u10都一样不兼容,报同样的错误。不过当作一个验证Java Portlet Special 的容器他确实有他的轻巧之处。先不说Tomcat 本身小巧,就是你所需要做的工作,仅仅是在web.xml加一些和portlet.xml中portlet对应的servlet配置而已。还是比较方便的容器。
|
|
返回顶楼 | |
发表时间:2008-09-05
你好,我按照和你一样的步骤直接下载最新版的二进制版本成功运行pluto,但是用第二种方法由源代码构建pluto时总是失败,报错信息:Error loading supplemental data models: String index out of range: -1在网上搜不到什么相关有用的信息,不知道怎么排查这个问题,你能帮我看看吗?
我的环境配置是:windows xp sp2 JAVA_HOME=D:\JAVA\jdk1.6.0 M2=%M2_HOME%\bin M2_HOME=D:\JAVA\apache-maven-2.0.9 Path=......;%M2% 我将pluto-current-src.zip解压缩至 C:\pluto-1.1.6 然后在cmd下进入C:\pluto-1.1.6\mvn install 下面是输出: C:\pluto-1.1.6>mvn install [INFO] Scanning for projects... [INFO] Reactor build order: [INFO] Apache Pluto [INFO] Pluto Descriptor Service API [INFO] Pluto Descriptor Service Implementation [INFO] Pluto Portlet Container [INFO] Pluto Portlet Tag Library [INFO] Pluto Portal Driver [INFO] Pluto Portal Driver Implementation Classes [INFO] Pluto Portal [INFO] Pluto Utilities [INFO] Maven Pluto Installer Plugin [INFO] Pluto Testsuite Portlet [INFO] Pluto Ant Tasks [INFO] Pluto Website Skin [INFO] ------------------------------------------------------------------------ [INFO] Building Apache Pluto [INFO] task-segment: [install] [INFO] ------------------------------------------------------------------------ [INFO] [site:attach-descriptor] [INFO] [install:install] [INFO] Installing C:\pluto-1.1.6\pom.xml to C:\Documents and Settings\yun\.m2\re pository\org\apache\pluto\pluto\1.1.6\pluto-1.1.6.pom [INFO] ------------------------------------------------------------------------ [INFO] Building Pluto Descriptor Service API [INFO] task-segment: [install] [INFO] ------------------------------------------------------------------------ [INFO] Setting property: classpath.resource.loader.class => 'org.codehaus.plexus .velocity.ContextClassLoaderResourceLoader'. [INFO] Setting property: velocimacro.messages.on => 'false'. [INFO] Setting property: resource.loader => 'classpath'. [INFO] Setting property: resource.manager.logwhenfound => 'false'. [INFO] [remote-resources:process {execution: default}] [ERROR] Error loading supplemental data models: String index out of range: -1 java.lang.StringIndexOutOfBoundsException: String index out of range: -1 at java.lang.String.substring(String.java:1938) at org.codehaus.classworlds.UrlUtils.normalizeUrlPath(UrlUtils.java:28) at org.codehaus.classworlds.DefaultClassRealm.getResource(DefaultClassRe alm.java:284) at org.codehaus.classworlds.RealmClassLoader.getResource(RealmClassLoade r.java:237) at java.lang.ClassLoader.getResourceAsStream(ClassLoader.java:1159) at org.codehaus.plexus.resource.loader.ThreadContextClasspathResourceLoa der.getResourceAsInputStream(ThreadContextClasspathResourceLoader.java:56) at org.codehaus.plexus.resource.DefaultResourceManager.getResourceAsInpu tStream(DefaultResourceManager.java:77) at org.codehaus.plexus.resource.DefaultResourceManager.getResourceAsFile (DefaultResourceManager.java:117) at org.apache.maven.plugin.resources.remote.ProcessRemoteResourcesMojo.l oadSupplements(ProcessRemoteResourcesMojo.java:724) at org.apache.maven.plugin.resources.remote.ProcessRemoteResourcesMojo.e xecute(ProcessRemoteResourcesMojo.java:290) at org.apache.maven.plugin.DefaultPluginManager.executeMojo(DefaultPlugi nManager.java:451) at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoals(Defa ultLifecycleExecutor.java:558) at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoalWithLi fecycle(DefaultLifecycleExecutor.java:499) at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoal(Defau ltLifecycleExecutor.java:478) at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoalAndHan dleFailures(DefaultLifecycleExecutor.java:330) at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeTaskSegmen ts(DefaultLifecycleExecutor.java:291) at org.apache.maven.lifecycle.DefaultLifecycleExecutor.execute(DefaultLi fecycleExecutor.java:142) at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:336) at org.apache.maven.DefaultMaven.execute(DefaultMaven.java:129) at org.apache.maven.cli.MavenCli.main(MavenCli.java:287) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl. java:39) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAcces sorImpl.java:25) at java.lang.reflect.Method.invoke(Method.java:597) at org.codehaus.classworlds.Launcher.launchEnhanced(Launcher.java:315) at org.codehaus.classworlds.Launcher.launch(Launcher.java:255) at org.codehaus.classworlds.Launcher.mainWithExitCode(Launcher.java:430) at org.codehaus.classworlds.Launcher.main(Launcher.java:375) [INFO] ------------------------------------------------------------------------ [ERROR] BUILD ERROR [INFO] ------------------------------------------------------------------------ [INFO] Error loading supplemental data models: String index out of range: -1 [INFO] ------------------------------------------------------------------------ [INFO] For more information, run Maven with the -e switch [INFO] ------------------------------------------------------------------------ [INFO] Total time: 11 seconds [INFO] Finished at: Fri Sep 05 16:24:47 CST 2008 [INFO] Final Memory: 14M/25M [INFO] ------------------------------------------------------------------------ |
|
返回顶楼 | |
发表时间:2008-09-06
你换pluto-1.1.4吧,我今天整了一个上午1.1.6,错误跟你一样的,但是官方的说明也都是针对pluto-1.1.4的。用对比软件看了半天也没看出个苗头来。你先用pluto-1.1.4吧。
其实几种方式,结果是一样的,你重点最好是掌握手工安装部署,这个是根本,工具和插件毛病多多,整死人 |
|
返回顶楼 | |
发表时间:2008-09-07
谢谢:)虽然在windows下报错,但换成了ubuntu却部署成功。
|
|
返回顶楼 | |