庄周梦蝶

生活、程序、未来
   :: 首页 ::  ::  :: 聚合  :: 管理

portal学习(二)portlet开发之hello world

Posted on 2007-07-15 21:02 dennis 阅读(4817) 评论(1)  编辑  收藏 所属分类: java
    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:



评论

# re: portal学习(二)portlet开发之hello world  回复  更多评论   

2010-07-17 12:01 by lss
很好 很强大 顶

只有注册用户登录后才能发表评论。


网站导航: