使用Liferay IDE 3.0创建支持Service Builder的portlet module

转载博客，现在Liferay的中文的资料太少了。

原文地址：https://web.liferay.com/web/zhao.jin/blog/-/blogs/%E4%BD%BF%E7%94%A8liferay-ide-3-0%E5%88%9B%E5%BB%BA%E6%94%AF%E6%8C%81service-builder%E7%9A%84portlet-module

Liferay IDE 下载页面: https://web.liferay.com/downloads/liferay-projects/liferay-ide

Liferay IDE 3针对Liferay 7.0 (Liferay DXP) 做了很多的改变。其中一项就是在Liferay Blade，Eclipse Gradle和BND tool的基础上完成了创建OSGi module portlle的向导，通过向导就可以简单的创建出portlet module了。在我的客户和培训学院中，所有的技术人员在开始最关心的问题都是在Liferay 7中，怎么创建一个使用Service Builder的MVC portlet。在Liferay IDE 3中，实现起来其实非常简单。

 

首先需要创建一个Liferay Workspace项目.



Liferay Workspace更像是一个Liferay项目的容器，而不是一个类似于eclipse workspace的工作空间。在Liferay Workspace中可以开发和管理Liferay插件。

接下来点击File -> New -> Liferay Module Project，然后选择servicebuilder为项目模板。



在Liferay Workspace视图模式下



我们可以看到在新建service builder的项目下有两个gradle项目。API项目包括了各种接口和服务定义。在6.2的项目中这些文件通常是在service文件夹下。Service项目中包含了服务的具体实现源码和服务配置。在6.2中是在src文件夹下面。



在service项目中，包含了service.xml。可以根据需求改变。接下来就可以在Gradle Task窗口中，运行service项目中的buildservice任务了，这样就可以生成所需的服务了。



那么，接下来的问题是，怎么调用这个服务呢。

在7.0的项目中，我们使用gradle来管理依赖。

我们可以创建一个mvc portlet类型的Liferay Module Project。然后修改build.gradle文件。按照我们文章中的示例，我们可以添加下列代码来声明依赖。

compile project(":modules:service-builder-project:service-builder-project-api")

这样在mvc portlet项目中就可以引用服务了。如果IDE的编辑器依然报告有依赖的错误，可以右键点击项目，然后gradle -> refreash gradle project，这样编辑器就会重新计算依赖了。

在部署项目的时候，需要部署三个jar，分别是api，service和mvc portlet。