Broadleaf IntelliJ Setup

IntelliJ设置

除Eclipse外， Intellij IDE也是一个开发Broadleaf Commerce 很好的工具（Broadleaf平台的大部分开发人员都使用它）。这个教程将逐步指导你在Intellij IDE中设置Broadleaf Commerce社区版，以便您有能力修改、构建、运行。

必要条件

• Intellij 10以上版本（2017.1.2）
• 推荐使用拥有Spring和Database支持的旗舰版
• JRebel 插件用来开发工作流增强
• JDK 1.8

获取Heat Clinic源码

首先，你需要得到项目文件、确保你可以依据本地运行指南在本地运行他们。

Intellij 设置

• 在欢迎界面点击Import Project:

• 选择在本地运行步骤提前的root项目的pom.xml文件。

• 你将看到导入项目设置。你可以使用默认设置，如下所示：

• 你无需修改任何剖面，点击Next.
• com.mycompany-community:boot-community-demo:1.0.0-SNAPSHOT将默认选择。保持选中，并点击Next.

• 如果你从未添加SDK，你将被询问添加一个。如果你已添加了一个或多个SDK，SDK会被默认选择，你不会看到询问窗口。下文将让你进一步理解如何更新SDK信息。
• 点击窗口左上方的+号：

• Intellij 将有机会在path中查找jdk1.8，所以你可以点击Open 添加SDK。如果找不到，可以使用目录导航找到SDK并Open 。

• JDK1.8将列出并选择，点击Next

• 你可以选择填写新的项目名，或在使用默认名称。如果你使用默认名称，项目文件位置将指向正确的位置。如果你修改了项目名称，你可能需要重新选择你提取的项目文件位置。点击Finish。

• 在初始化索引完成后，将在右下角弹出一个JPA框架配置，点击Configure。

• 这会弹出一个窗口，并且persistence-core.xml已被选择。点击OK

• 此时，你将拥有如下的项目结构（我重名名项目为boot-community-demo，你的可能不同）。

• 如你需要修改项目SDK，你可以点击项目右上角的Project Structure按钮。

• 在这里，你可以选择项目的默认SDK和语言版本。

创建运行配置

运行配置是我们如何在IntelliJ中实际运行社区starter项目。我们将为每一个可运行模块（admin、site、api）设置一个运行时配置。一旦设置，你可以同时运行一个或多个项目，这些项目将使用同一个HSQL数据库实例。

• 在IDE右上角，点击运行配置下拉菜单并选择Edit Configurations

• 在右上角弹出的新窗口中，点击+号并创建一个新的Spring Boot运行配置。
• 命名这个运行配置为Admin，或者你喜欢的其他名字。
• 点击...查找Main Class，并选择AdminApplication。
• 添加 VM Options值：-Xmx1536M -javaagent:target/agents/spring-instrument.jar
• 在Working Directory 框中选择admin文件夹
• 选择admin模块，在我的用例中为boot-community-demo-admin，在Use classpath of module:下拉菜单中。
• 点击Before launch框的+号，并选择 Run Maven Goal
• 在Select Maven Goal 窗口中：为Working directory目录选择admin模块;在Command line中填写值：dependency:copy@copy-agent;点击OK。

• 选中新建的Run Maven Goal，并提升到build上方
• 最终配置如下图所示：

• 重复以上步骤，设置site和api模块：

• 点击OK

运行程序

运行我们刚刚添加的运行配置非常简单，只需单击配置名称右侧的运行按钮。当然，你也可以单击测试按钮，以启动测试。这两个操作都会为您自动构建项目。

开始并选择Admin运行配置，点击运行按钮，我们将看到下面的运行步骤。
当程序启动完毕，你将看到下面的日志输出：

不要现在运行这个程序，因我们不需要这个程序保持运行状态，但可以在未来作为参考。你可以通过点击调试窗口的stop按钮停止程序运行，输出日志如下：

• 在浏览器中，你可以查看下列链接：
  Admin: localhost:8081/admin (username/password is admin/admin)
  Site: localhost:8080

连接到本地数据库

连接到运行时的本地数据库，可以参考Connect to the Local Database

JRebel 开发增强

Broadleaf Commerce团队在开发平台期间广泛使用JRebel，我们建议用户在开发基于Broadleaf的项目时也这样做。通过安装JRebel插件，向IntelliJ添加JRebel支持相对简单：
https://zeroturnaround.com/software/jrebel/quickstart/intellij/
社区初学者构建的默认配置将为项目的模块生成rebel.xml文件，因此，除了在IntelliJ中安装和配置插件之外，您无需担心任何问题。成功安装插件后，您将看到几个新的按钮选项（运行和调试），以便在启用JRebel支持时启动。我们通常建议在开发期间使用JRebel支持运行调试。

单击JRebel调试按钮后，IntelliJ将以调试模式启动应用程序并支持JRebel。这将允许您在实现中添加/编辑Java类，并立即查看更改的效果，而无需重新启动应用程序，这可能会节省大量时间。您只需单击Build Project，运行配置选择器左侧的按钮，IntelliJ + JRebel将负责其余部分。