From 49ae814f14b93fd6f0133280b814c05331f66e55 Mon Sep 17 00:00:00 2001
From: Zhang Lei <zhanglei1949@sjtu.edu.cn>
Date: Thu, 27 Oct 2022 14:46:40 +0800
Subject: [PATCH] [GAE-Java] Add necessary configurations in `pom.xml` to
 publish GRAPE jdk to maven central repo (#2166)

* Add configurations in `GRAPE jdk`'s pom.xml to deploy jar to maven central repo.
---
 .../java/grape-annotation/pom.xml             |  37 ++++-
 analytical_engine/java/grape-demo/pom.xml     |  45 ++++--
 analytical_engine/java/grape-giraph/pom.xml   |  32 ++++
 analytical_engine/java/grape-graphx/pom.xml   |  32 ++++
 analytical_engine/java/grape-jdk/pom.xml      |  47 ++++++
 analytical_engine/java/grape-runtime/pom.xml  |   1 -
 analytical_engine/java/pom.xml                | 150 +++++++++++++++++-
 docs/Makefile                                 |   2 +-
 8 files changed, 325 insertions(+), 21 deletions(-)

diff --git a/analytical_engine/java/grape-annotation/pom.xml b/analytical_engine/java/grape-annotation/pom.xml
index da3a50a08041..fa8c352fca5f 100644
--- a/analytical_engine/java/grape-annotation/pom.xml
+++ b/analytical_engine/java/grape-annotation/pom.xml
@@ -39,11 +39,40 @@
           <compilerArgument>-proc:none</compilerArgument>
         </configuration>
       </plugin>
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-source-plugin</artifactId>
-      </plugin>
     </plugins>
   </build>
 
+  <profiles>
+    <profile>
+      <id>release</id>
+      <activation>
+        <activeByDefault>false</activeByDefault>
+      </activation>
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-source-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-gpg-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-deploy-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-javadoc-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.sonatype.plugins</groupId>
+            <artifactId>nexus-staging-maven-plugin</artifactId>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+  </profiles>
+
 </project>
\ No newline at end of file
diff --git a/analytical_engine/java/grape-demo/pom.xml b/analytical_engine/java/grape-demo/pom.xml
index 021e2c467be8..ef62addf28db 100644
--- a/analytical_engine/java/grape-demo/pom.xml
+++ b/analytical_engine/java/grape-demo/pom.xml
@@ -111,18 +111,6 @@
           </execution>
         </executions>
       </plugin>
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-surefire-plugin</artifactId>
-        <executions>
-          <execution>
-            <goals>
-              <goal>test</goal>
-            </goals>
-            <phase>test</phase>
-          </execution>
-        </executions>
-      </plugin>
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-shade-plugin</artifactId>
@@ -158,4 +146,37 @@
       </plugin>
     </plugins>
   </build>
+
+  <profiles>
+    <profile>
+      <id>release</id>
+      <activation>
+        <activeByDefault>false</activeByDefault>
+      </activation>
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-gpg-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-deploy-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-javadoc-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-source-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.sonatype.plugins</groupId>
+            <artifactId>nexus-staging-maven-plugin</artifactId>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+  </profiles>
 </project>
diff --git a/analytical_engine/java/grape-giraph/pom.xml b/analytical_engine/java/grape-giraph/pom.xml
index 7147cb8a59f6..dbcc63503fd1 100644
--- a/analytical_engine/java/grape-giraph/pom.xml
+++ b/analytical_engine/java/grape-giraph/pom.xml
@@ -127,4 +127,36 @@
     </plugins>
   </build>
 
+  <profiles>
+    <profile>
+      <id>release</id>
+      <activation>
+        <activeByDefault>false</activeByDefault>
+      </activation>
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-source-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-gpg-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-deploy-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-javadoc-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.sonatype.plugins</groupId>
+            <artifactId>nexus-staging-maven-plugin</artifactId>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+  </profiles>
 </project>
diff --git a/analytical_engine/java/grape-graphx/pom.xml b/analytical_engine/java/grape-graphx/pom.xml
index 672a87e8ba5a..17a88020d42b 100644
--- a/analytical_engine/java/grape-graphx/pom.xml
+++ b/analytical_engine/java/grape-graphx/pom.xml
@@ -164,4 +164,36 @@
     </plugins>
   </build>
 
+  <profiles>
+    <profile>
+      <id>release</id>
+      <activation>
+        <activeByDefault>false</activeByDefault>
+      </activation>
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-source-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-gpg-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-deploy-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-javadoc-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.sonatype.plugins</groupId>
+            <artifactId>nexus-staging-maven-plugin</artifactId>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+  </profiles>
 </project>
diff --git a/analytical_engine/java/grape-jdk/pom.xml b/analytical_engine/java/grape-jdk/pom.xml
index 76469621a976..f29acd909d76 100644
--- a/analytical_engine/java/grape-jdk/pom.xml
+++ b/analytical_engine/java/grape-jdk/pom.xml
@@ -126,4 +126,51 @@
       </plugin>
     </plugins>
   </build>
+
+  <profiles>
+    <profile>
+      <id>javadoc</id>
+      <activation>
+        <activeByDefault>false</activeByDefault>
+      </activation>
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-javadoc-plugin</artifactId>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+    <profile>
+      <id>release</id>
+      <activation>
+        <activeByDefault>false</activeByDefault>
+      </activation>
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-source-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-gpg-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-deploy-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-javadoc-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.sonatype.plugins</groupId>
+            <artifactId>nexus-staging-maven-plugin</artifactId>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+  </profiles>
 </project>
diff --git a/analytical_engine/java/grape-runtime/pom.xml b/analytical_engine/java/grape-runtime/pom.xml
index 12c2613b98ee..e79df90a7cbe 100644
--- a/analytical_engine/java/grape-runtime/pom.xml
+++ b/analytical_engine/java/grape-runtime/pom.xml
@@ -138,5 +138,4 @@
       </plugin>
     </plugins>
   </build>
-
 </project>
diff --git a/analytical_engine/java/pom.xml b/analytical_engine/java/pom.xml
index fabca9cc92cc..16b920a6f33d 100644
--- a/analytical_engine/java/pom.xml
+++ b/analytical_engine/java/pom.xml
@@ -16,13 +16,42 @@
 -->
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
   <modelVersion>4.0.0</modelVersion>
+
   <groupId>com.alibaba.graphscope</groupId>
   <artifactId>grape-jdk-parent</artifactId>
   <version>${revision}</version>
-
   <packaging>pom</packaging>
 
   <name>Grape Java SDK</name>
+  <description>An efficient Java SDK for Grape</description>
+  <url>https://github.com/alibaba/GraphScope</url>
+  <organization>
+    <name>Alibaba Group Holding Ltd.</name>
+    <url>https://github.com/alibaba</url>
+  </organization>
+
+  <licenses>
+    <license>
+      <name>The Apache Software License, Version 2.0</name>
+      <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
+      <distribution>actable</distribution>
+    </license>
+  </licenses>
+
+  <developers>
+    <developer>
+      <name>Zhang Lei</name>
+      <email>xiaolei.zl@alibaba-inc.com</email>
+      <organization>Alibaba</organization>
+    </developer>
+  </developers>
+
+  <scm>
+    <tag>main</tag>
+    <url>git@github.com:alibaba/graphscope.git</url>
+    <connection>git@github.com:alibaba/graphscope.git</connection>
+    <developerConnection>git@github.com:alibaba/graphscope.git</developerConnection>
+  </scm>
 
   <modules>
     <module>grape-annotation</module>
@@ -51,7 +80,11 @@
     <maven-javadoc-plugin.version>3.0.0</maven-javadoc-plugin.version>
     <maven-shade-plugin.version>3.2.4</maven-shade-plugin.version>
     <maven-surefire-plugin.version>3.0.0-M4</maven-surefire-plugin.version>
+    <maven-source-plugin.version>2.2.1</maven-source-plugin.version>
+    <maven-deploy-plugin.version>3.0.0</maven-deploy-plugin.version>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    <nexus-staging-maven-plugin.version>1.6.7</nexus-staging-maven-plugin.version>
+    <maven-gpg-plugin.version>3.0.1</maven-gpg-plugin.version>
     <slf4j.version>1.7.30</slf4j.version>
     <log4j2.version>2.19.0</log4j2.version>
     <dep.netty.version>4.1.44.Final</dep.netty.version>
@@ -61,6 +94,8 @@
     <dep.kryo-serializers.version>0.42</dep.kryo-serializers.version>
     <spark.version>3.1.3</spark.version>
     <maven.javadoc.version>3.3.1</maven.javadoc.version>
+    <javadoc.output.directory>grape-jdk-javadoc</javadoc.output.directory>
+    <javadoc.output.destDir>grape-jdk-javadoc</javadoc.output.destDir>
   </properties>
   <dependencyManagement>
     <dependencies>
@@ -198,21 +233,88 @@
     </dependencies>
   </dependencyManagement>
 
+  <distributionManagement>
+    <snapshotRepository>
+      <id>ossrh</id>
+      <url>https://oss.sonatype.org/content/repositories/snapshots</url>
+    </snapshotRepository>
+    <repository>
+      <id>ossrh</id>
+      <url>https://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
+    </repository>
+  </distributionManagement>
+
   <build>
     <pluginManagement>
       <plugins>
+        <plugin>
+          <groupId>org.apache.maven.plugins</groupId>
+          <artifactId>maven-deploy-plugin</artifactId>
+          <version>${maven-deploy-plugin.version}</version>
+        </plugin>
+        <plugin>
+          <groupId>org.sonatype.plugins</groupId>
+          <artifactId>nexus-staging-maven-plugin</artifactId>
+          <version>${nexus-staging-maven-plugin.version}</version>
+          <extensions>true</extensions>
+          <configuration>
+            <serverId>ossrh</serverId>
+            <nexusUrl>https://oss.sonatype.org/</nexusUrl>
+            <autoReleaseAfterClose>true</autoReleaseAfterClose>
+          </configuration>
+        </plugin>
+        <plugin>
+          <groupId>org.apache.maven.plugins</groupId>
+          <artifactId>maven-source-plugin</artifactId>
+          <version>${maven-source-plugin.version}</version>
+          <executions>
+            <execution>
+              <id>attach-sources</id>
+              <goals>
+              <goal>jar-no-fork</goal>
+              </goals>
+            </execution>
+          </executions>
+        </plugin>
+        <plugin>
+          <groupId>org.apache.maven.plugins</groupId>
+          <artifactId>maven-gpg-plugin</artifactId>
+          <version>${maven-gpg-plugin.version}</version>
+          <executions>
+            <execution>
+              <id>sign-artifacts</id>
+              <phase>verify</phase>
+              <goals>
+                <goal>sign</goal>
+              </goals>
+            </execution>
+          </executions>
+        </plugin>
         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-javadoc-plugin</artifactId>
           <version>${maven.javadoc.version}</version>
           <configuration>
-            <excludePackageNames>com.alibaba.graphscope.graphx.*</excludePackageNames>
+            <javadocExecutable>${java.home}/bin/javadoc</javadocExecutable>
+<!--            <excludePackageNames>com.alibaba.graphscope.graphx.*</excludePackageNames>-->
+            <sourceFileExcludes>
+              <sourceFileExclude>**/*GenGen.java</sourceFileExclude>
+              <sourceFileExclude>**/Unused*.java</sourceFileExclude>
+            </sourceFileExcludes>
             <reportOutputDirectory>${javadoc.output.directory}</reportOutputDirectory>
             <destDir>${javadoc.output.destDir}</destDir>
             <failOnError>false</failOnError>
             <failOnWarnings>false</failOnWarnings>
             <locale>en_US</locale>
           </configuration>
+          <executions>
+            <execution>
+              <id>attach-javadocs</id>
+              <goals>
+                <goal>jar</goal>
+              </goals>
+            </execution>
+          </executions>
         </plugin>
         <plugin>
           <groupId>net.alchim31.maven</groupId>
@@ -268,7 +370,49 @@
         </plugin>
       </plugins>
     </pluginManagement>
-
   </build>
 
+  <profiles>
+    <profile>
+      <id>javadoc</id>
+      <activation>
+        <activeByDefault>false</activeByDefault>
+      </activation>
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-javadoc-plugin</artifactId>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+    <profile>
+      <id>release</id>
+      <activation>
+        <activeByDefault>false</activeByDefault>
+      </activation>
+      <build>
+        <plugins>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-gpg-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-deploy-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-javadoc-plugin</artifactId>
+          </plugin>
+          <plugin>
+            <groupId>org.sonatype.plugins</groupId>
+            <artifactId>nexus-staging-maven-plugin</artifactId>
+          </plugin>
+        </plugins>
+      </build>
+    </profile>
+  </profiles>
+
 </project>
diff --git a/docs/Makefile b/docs/Makefile
index 257d3d9092f6..07bdb8430619 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -41,7 +41,7 @@ clean:
 	cd ${WORKING_DIR}/../analytical_engine/java && \
 	if [ -d "${M2_REPO}/com/alibaba/fastffi" ]; then \
 		mvn clean install -Dmaven.antrun.skip=true -DskipTests -pl :grape-jdk -am && \
-		mvn javadoc:aggregate -pl :grape-jdk -am -Djavadoc.output.directory=${WORKING_DIR}/$(BUILDDIR)/${TAG}/$@/reference -Djavadoc.output.destDir=gae_java --quiet; \
+		mvn -P javadoc javadoc:aggregate -pl :grape-jdk -am -Djavadoc.output.directory=${WORKING_DIR}/$(BUILDDIR)/${TAG}/$@/reference -Djavadoc.output.destDir=gae_java --quiet; \
 	else \
 		echo "Can not generate javadoc without fastffi"; \
 	fi