说明:以下内容和官方文档相差不大,如果您英文较好,建议直接去读官方文档,地址是:https://dev.liferay.com/develop/tutorials/-/knowledge_base/6-1/adding-friendly-url-mapping-to-the-portlet。如果没有操作成功,再回来看一看,相信您会有所收获。
如果我们要在liferay中跳转到一个jsp界面。我们可能会这样写
<portlet:renderURL var="editGreetingURL"> <portlet:param name="mvcPath" value="XXX" /> </portlet:renderURL> <a href="<%= editGreetingURL %>">跳转到jsp界面</a>
其中XXX表示我们要跳转的jsp界面的全路径,比如:/html/portlet3/view.jsp。
这个时候它的url路径是类似于这样的:
这样的路径又臭又长,而且也看不懂什么意思,那么能不能把它变得好看一点呢?肯定是能的,可以把它变成类似于下面的形式:
http://localhost:8080/zh/web/guest/what-we-do/-/portlet3/view
接下来我们一起来把它改造一下:
1. 新建一个Portlet,名称为Portlet3
2. 在liferay-portlet.xml文件中找到Portlet3对应的代码,在 </icon>标签后面并且在<instanceable>标签前面加上以下内容:
<friendly-url-mapper-class>com.liferay.portal.kernel.portlet.DefaultFriendlyURLMapper</friendly-url-mapper-class> <friendly-url-mapping>portlet3</friendly-url-mapping> <friendly-url-routes>com/liferay/samples/portlet3-url-routes.xml</friendly-url-routes>
3. 新建文件portlet3-url-routes.xml,全路径为: /WEB-INF/src/com/liferay/samples/portlet3-url-routes.xml ,文件内容如下。
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE routes PUBLIC "-//Liferay//DTD Friendly URL Routes 6.1.0//EN" "http://www.liferay.com/dtd/liferay-friendly-url-routes_6_1_0.dtd"> <routes> <route> <pattern>/{mvcPathName}</pattern> <generated-parameter name="mvcPath">/html/portlet3/{mvcPathName}.jsp</generated-parameter> </route> </routes>
注意:
1)文件的全路径要和第二步中<friendly-url-routes>标签的内容对应。
2)把<generated-parameter>标签的内容替换成您要跳转的jsp页面的全路径。以“/”开头,代表当前项目。
4. 重新部署您的portlet,刷新页面,并再次尝试如下的链接是。
http://localhost:8080/zh/web/guest/what-we-do/-/portlet3/view
http://localhost:8080/zh/web/guest/what-we-do/-/portlet3/edit
效果如下
解析:
- http://localhost:8080/zh/web/guest/what-we-do/-/portlet3/view 中的what-we-do要和当前页面对应(空格可以使用-来代替)。portlet3和liferay-portlet.xml中的<friendly-url-mapping>里面的内容对应。Edit要和jsp文件名称对应。
- portlet3-url-routes.xml中类似于RESTFUL风格。
- liferay对于 http://localhost:8080/zh/web/guest/what-we-do/-/portlet3/view 路径的寻找过程如下:
先是what-we-do找到页面,然后寻找liferay-portlet.xml文件中<friendly-url-mapping>是portlet3的元素,找出对应的<friendly-url-routes>标签的内容:com/liferay/samples/portlet3-url-routes.xml,然后寻找对应的xml文件,在把xml文件中的{ mvcPathName }替换成view,然后去寻找/html/portlet3/view.jsp。找到具体的jsp文件。