portal学习（二）portlet开发之hello world

portal开发的一个重要工作就是portlet的开发，网上一大堆hello world，都是最简单的，用PrintWriter输出字符串。今天介绍一下稍微复杂的，用户转到portlet的edit Model，该页面是有一个输入框和一个按钮，输入你的名字，然后提交，将转到此portlet的view Model并输出hello,your name。     portlet与servlet非常相似，因为portlet就是在servlet规范的基础上扩展的，并且portlet容器也是在servlet容器的基础上扩展，同serlvet一样，我们的HelloWorldPorlet需要强制继承自GenericPortlet类，GenericPortlet实现了Portlet接口,看看完整代码： package  net . rubyeye . portlets; import  javax . portlet . ActionResponse; import  javax . portlet . GenericPortlet; import  javax . portlet . PortletException; import  javax . portlet . PortletRequestDispatcher; import  javax . portlet . RenderRequest; import  javax . portlet . RenderResponse; public class HelloWorldPortlet extends GenericPortlet {          @Override         protected void doEdit(RenderRequest req ,  RenderResponse res)                         throws PortletException ,  IOException {                 res . setContentType( " text/html " );                  // 获取初始参数，在init - param中定义                 String jspName  =  getPortletConfig() . getInitParameter( " edit-jsp " );                 PortletRequestDispatcher rd  =  getPortletContext() . getRequestDispatcher(                                 jspName);                 rd . include(req ,  res);         }          @Override         protected void doView(RenderRequest req ,  RenderResponse res)                         throws PortletException ,  IOException {                 res . setContentType( " text/html " );                  // 执行完processAction后设置了renderParamter，这里得到                 String msg  =  req . getParameter( " msg " );                                 PrintWriter out  =  res . getWriter();                  System . out . println(msg);                  // 有就输出                  if  (msg  !=  null)                         out . write (msg);                  // 默认输出是Hello World                  else                         out . write ( " Hello World! View!" );         }          // actionURL调用的processAction          @Override         public void processAction(ActionRequest req ,  ActionResponse res)                         throws PortletException ,  IOException {                  //  TODO Auto - generated method stub                 String name  =  req . getParameter( " name " );                  System . out . println(name);                 res . setRenderParameter( " msg " ,   " hello, "   +  name);         } }     解释下代码,portlet默认有三种Model：view、edit和help，顾名思义分别对照浏览、编辑和帮助状态，其中只有view是必须的，当然还可以自定义model。在portlet就有相应的doXXX方法用于呈现相应的片段，portlet还有一个render(RenderRequest，RenderResponse),这个方法与doView等方法的关系类似serlvet中service与doGet、doHelp的关系，一般我们都不直接覆写render，而是实现具体的doXXX方法。回到这个例子,HelloWorldPortlet有两个Model：view和edit。     在doView方法中很简单，首先需要设置ContentType，然后获取前面processAction设置的renderParamter，当然，一开始进入portlet是view，这个值根本没有，默认就用PrintWriter输出Hello World。     processAction用于处理ActionRequest的方法，和一般的servlet编程没有什么不同，请注意，processAction执行之后才是执行相应的render方法，并且与render 不共享parameter，因此为了在doView中获得msg参数，我们需要通过ActionResponse的setRenderParameter来设定RenderRequest的Parameter。     doEdit方法就比较简单了，通过PortletConfig的getInitParameter(与ServletConfig一样了）获得属性edit-jsp的值——编辑页面的位置，然后将该页面include进portlet。     portlet需要一个配置文件来告诉portlets容器具体信息，这个文件同样放在WEB-INF目录下，并且名为portlet .xml： <? xml version="1.0" encoding="UTF-8" ?> < portlet-app  version ="1.0"         xmlns ="http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd"         xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance" >          < portlet >                  < portlet-name > HelloWorldPorlet_1 </ portlet-name >                  < portlet-class >                         net.rubyeye.porlets.HelloWorldPorlet                  </ portlet-class >                  < init-param >                          < name > edit-jsp </ name >                          < value > /portlets/edit.jsp </ value >                  </ init-param >                  < supports >                          < mime-type > text/html </ mime-type >                          < portlet-mode > view </ portlet-mode >                          < portlet-mode > edit </ portlet-mode >                  </ supports >                  < portlet-info >                          < title > HelloWorld </ title >                  </ portlet-info >          </ portlet > </ portlet-app >   信息非常清楚，就不多做解释了，edit-jsp的值是/portlets/edit.jsp，portlets容器就会去portlets目录下寻找edit.jsp。supports元素指定了portlet支持的Model以及Mime类型。更详细的配置请参考官方规范    最后就是edit.jsp，需要用到portlets规范规定的标签，我们这里用到了actionURL，该标签用于form的action的生成，触发带有参数的request请求的processAction调用，当然还有一个renderURL，顾名思义仅是用于呈现，而非action的触发。请注意，form的method必须是post，因为portlets容器可能将一些状态信息写在url，使用post提交避免冲突。 <% @taglib uri = " http://java.sun.com/portlet "  prefix = " portlet "   %> < portlet:defineObjects /> < div > < form  method ="post"  action ="<portlet:actionURL portletMode=" view" windowState ="normal" /> " > please input your name: < input  type ="text"  name ="name"  size ="10" /> < input  type ="submit"  value ="submit" /> </ form >

  在使用portlet规范规定的标签前，一定要先使用<portlet:defineObjects/> 标签，以便定义下列变量让jsp使用： renderRequest renderResponse portletConfig     我们通过actionURL标签产生指向本portlet的url，并且指定没有错误发生时这个portlet应该具有的Model是view，窗口大小为normal。最后部署并运行，因为不同的portal的部署方式和所需要的其他配置文件各不相同，这里就不详细介绍了。下面是在Bea Portal 10.0上的效果图： 1.一开始看到的是view Model，输出Hello World!View!: 2.点击左上角的edit链接进入edit model: 3.输入dennis,提交，转到view model:

文章转自庄周梦蝶  ，原文发布时间2007 7 15

相关资源：敏捷开发V1.0.pptx