标记的作用:

 标记的作用是为当前Portlet中的javascript函数,html元素以及js中的全局变量设定一个名字空间,并且这个名字空间最终会被某个字母-数字组成的字符串所替代,来防止当一个页面上组装了多个Portlet时候出现的名字冲突问题。

例如:

   
   
   
   
  1. <script type='text/javascript'> 
  2. var <portlet:namespace/>someVar = 10
  3. function <portlet:namespace/>confirmSave() { 
  4. return confirm("Do you want to save Book information?"); 
  5. script> 

这样在某页面上就定义了一段只属于该页面所在Portlet的javascript代码。方法很简单,在全局变量以及javascript函数前面加上标记就可以,这样,最后当这个portlet被merge到portal页面时候,somevar变量和confirmSave()方法就是唯一的,就算其他的portlet也定义了这个名字的变量和方法也不会有冲突。而且,就算一个页面上引用了某个Portlet的多个实例,也不会冲突。

页面上使用这些全局变量和js函数也必须给出标记

   
   
   
   
  1. <a href="<portlet:actionURL name="save"/>" 
  2. onclick="javascript: return confirmRemove()">Savea> 

----

使用误区:

这种加上的标记只可以用在Portlet页面上直接书写js的情况,如果某个Portlet页面用外部资源引入的形式引进某个外部的javascript文件,比如:

   
   
   
   
  1. <script type="text/javascript" src="folder1/folder2/search/searchGadget.js">script> 

 这种情况下,在外部的js中无需要标记,因为名字空间问题会自动被jsp引擎所处理成内联的形式。

----

 在表单中使用

为了让Portlet所包含的html里面的表单元素在portal页面唯一,同样也要给表单以及表单里面的元素加上前缀:

   
   
   
   
  1. <form name="addBookForm"> 
  2. <tr> 
  3. <td> 
  4. <input type="text" name="bookTitle"/> 
  5. td> 
  6. <td> 
  7. <div id="bookErrorMessage">div> 
  8. td> 
  9. tr> 
  10. ... 
  11. form> 

这时候,假如在最终merge的portal页面上有多个同样的输入框为book的元素,那么取得这个表单(我们想要的Portlet)中的输入值呢?

方法是在Portlet处理代码中,也要给每个这个元素名加上名字空间前缀 (Liferay的处理方法)

   
   
   
   
  1. @ProcessAction(name = "addBookAction"
  2. public void addBook(ActionRequest request, ActionResponse response) 
  3. throws PortletException, IOException { 
  4. //这里我们可以看到用response.getNamespace()则自动加上了名字空间,于是这个名字空间和表单元素名拼接起来的字符串就是在Portal页面上唯一并且只属于当前Portlet的了
  5. String bookTitle = 
  6. request.getParameter(response.getNamespace() + "bookTitle"); 
  7. ...