使用IDEA插件新建SOFA工程

不推荐使用 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
复制代码

按照提示输入模块的 goupId， artifactId 等信息即可，创建好的工程在输入的 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

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