portal学习（二）portlet开发之hello world-阿里云开发者社区

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

2017-05-17 1375

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介：

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

文章标签：

容器

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

热门文章

最新文章

相关电子书

相关实验场景