<portlet:namespace>标记的作用:
<namespace>标记的作用是为当前Portlet中的javascript函数,html元素以及js中的全局变量设定一个名字空间,并且这个名字空间最终会被某个字母-数字组成的字符串所替代,来防止当一个页面上组装了多个Portlet时候出现的名字冲突问题。
例如:
- <script type='text/javascript'>
- var <portlet:namespace/>someVar = 10;
- function <portlet:namespace/>confirmSave() {
- return confirm("Do you want to save Book information?");
- }
- </script>
这样在某页面上就定义了一段只属于该页面所在Portlet的javascript代码。方法很简单,在全局变量以及javascript函数前面加上<portlet:namespace/>标记就可以,这样,最后当这个portlet被merge到portal页面时候,somevar变量和confirmSave()方法就是唯一的,就算其他的portlet也定义了这个名字的变量和方法也不会有冲突。而且,就算一个页面上引用了某个Portlet的多个实例,也不会冲突。
页面上使用这些全局变量和js函数也必须给出<namespace>标记
- <a href="<portlet:actionURL name="save"/>"
- onclick="javascript: return <portlet:namespace/>confirmRemove()">Save</a>
----
使用误区:
这种加上<namespace>的标记只可以用在Portlet页面上直接书写js的情况,如果某个Portlet页面用外部资源引入的形式引进某个外部的javascript文件,比如:
- <script type="text/javascript" src="folder1/folder2/search/searchGadget.js"></script>
这种情况下,在外部的js中无需要<namespace>标记,因为名字空间问题会自动被jsp引擎所处理成内联的形式。
----
在表单中使用<namespace>
为了让Portlet所包含的html里面的表单元素在portal页面唯一,同样也要给表单以及表单里面的元素加上<namespace>前缀:
- <form name="<portlet:namespace/>addBookForm">
- <tr>
- <td>
- <input type="text" name="<portlet:namespace/>bookTitle"/>
- </td>
- <td>
- <div id="<portlet:namespace/>bookErrorMessage"></div>
- </td>
- </tr>
- ...
- </form>
这时候,假如在最终merge的portal页面上有多个同样的输入框为book的元素,那么取得这个表单(我们想要的Portlet)中的输入值呢?
方法是在Portlet处理代码中,也要给每个这个元素名加上名字空间前缀 (Liferay的处理方法)
- @ProcessAction(name = "addBookAction")
- public void addBook(ActionRequest request, ActionResponse response)
- throws PortletException, IOException {
- //这里我们可以看到用response.getNamespace()则自动加上了名字空间,于是这个名字空间和表单元素名拼接起来的字符串就是在Portal页面上唯一并且只属于当前Portlet的了
- String bookTitle =
- request.getParameter(response.getNamespace() + "bookTitle");
- ...
- }
本文转自 charles_wang888 51CTO博客,原文链接:http://blog.51cto.com/supercharles888/844898,如需转载请自行联系原作者