使用IDEA插件新建SOFA工程

1,519 阅读2分钟

不推荐使用 Eclipse 来开发 SOFA 工程,使用 Intellij IDEA 来开发工程能够达到更好的效果。
新建系统推荐使用 JDK8。

注意:

  1. 当前主站新建工程推荐使用 SOFABoot ,参考 SOFABoot 快速开始

  2. 新建应用的存放路径中不能包含中文!

环境安装

安装 Intellij IDEA

到 Intellij IDEA 的官网下载 Intellij IDEA 进行安装,可以选择 Community 版,有条件的同学可以购买 Ultimate 的版本。

安装 SOFA 的 Intellij IDEA 插件

参考 SOFA 的 Intellij IDEA 的安装插件的教程 安装 SOFA Intellij IDEA 插件

新建 SOFA4 工程

使用 Intellij IDEA 插件创建

点击 Intellij IDEA 的 File 菜单栏, 依次选择 New -> Project, 然后选择新建 SOFA 工程, 如下图所示(注意,为了能够立即看到运行效果,这里选择了 Web 工程):

填好 Maven 相关的信息,关于GroupID和ArtifactID命名规范,见链接
选择好工程类型,这里我们选择创建一个 Web 工程,点击 Next, 选择好工程名以及工程的路径:

点击 Finish, Intellij IDEA 会自动开始导入工程。到此,一个新的 SOFA4 的工程就新建好了。

目前新建的系统都默认使用新的打包方式,不再有 assmbely 目录, 具体见 Sofa Assembly 之间接依赖不再痛

使用 mvn 指令创建

如果在这之前,你还没有配置过 maven,请先下载蚂蚁 maven 配置文件下载后重命名成 settings.xml,并置于目录 ~/.m2/ 下。

core 工程

mvn org.apache.maven.plugins:maven-archetype-plugin:2.2.alipay.1:generate \
        -DarchetypeRepository=http://mvn.dev.alipay.net:8080/artifactory/repo \
        -DarchetypeGroupId=com.alipay.sofa -DarchetypeArtifactId=sofa-archetype \
        -DarchetypeVersion=sofa4-SNAPSHOT \
        -Dproject_type=core -D__output_encoding=UTF-8

web 工程

mvn org.apache.maven.plugins:maven-archetype-plugin:2.2.alipay.1:generate \
        -DarchetypeRepository=http://mvn.dev.alipay.net:8080/artifactory/repo \
        -DarchetypeGroupId=com.alipay.sofa -DarchetypeArtifactId=sofa-archetype \
        -DarchetypeVersion=sofa4-SNAPSHOT \
        -Dproject_type=web -D__output_encoding=UTF-8

rest 工程

mvn org.apache.maven.plugins:maven-archetype-plugin:2.2.alipay.1:generate \
        -DarchetypeRepository=http://mvn.dev.alipay.net:8080/artifactory/repo \
        -DarchetypeGroupId=com.alipay.sofa -DarchetypeArtifactId=sofa-archetype \
        -DarchetypeVersion=sofa4-SNAPSHOT \
        -Dproject_type=rest -D__output_encoding=UTF-8

按照提示输入模块的 goupIdartifactId 等信息即可,创建好的工程在输入的 artifactId 目录下。

看到以下信息,表示应用创建成功了。

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 12.550 s
[INFO] Finished at: 2017-10-25T23:58:48+08:00
[INFO] Final Memory: 17M/222M
[INFO] ------------------------------------------------------------------------

使用指令创建完后,需要将工程导入到 IDE 中,因为 SOFA4 工程是标准的 Maven 工程,可以使用 IDE 的 Maven 工程导入功能将其导入:

  • IDEA 中:选择 File -> Open -> 选择工程根路径下的 pom.xml , 打开就可以了

  • Eclipse 中:选择 File > Import > Existing Maven Projects,选择工程所在根目录,点击 “确定”。

启动工程

导入完成以后,等待 Intellij IDEA 将索引构建完毕,右键工程根目录,选择 Run SOFA Application,如下图所示:

等待应用启动完毕,如果启动没有错误,mac用户可以通过访问如下的链接来确定是否启动成功:http://localhost:7777/sample.htm,Windows 用户可以通过访问如下的链接来确定是否启动成功:http://localhost/sample.htm

注意 Windows 下请访问:http://localhost/sample.htm

慎用阿里郎加速,可能导致你的工程无法启动!