You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@skywalking.apache.org by ke...@apache.org on 2023/03/09 02:11:53 UTC

[skywalking] branch javadoc-940 updated (89f4c43a41 -> 13ad9aedb5)

This is an automated email from the ASF dual-hosted git repository.

kezhenxu94 pushed a change to branch javadoc-940
in repository https://gitbox.apache.org/repos/asf/skywalking.git


 discard 89f4c43a41 Fix javadoc error and run javadoc in CI
    omit a141ac0c1a Update menu.yml for 9.4.0
    omit eeacd464ca Update changes.md for 9.5.0
    omit 77cbdeeb81 Create changes-9.4.0.md
    omit 9ddb3c14c7 [maven-release-plugin] prepare for next development iteration
    omit 0c39a70ca0 [maven-release-plugin] prepare release v9.4.0
     new 13ad9aedb5 Fix javadoc error and run javadoc in CI

This update added new revisions after undoing existing revisions.
That is to say, some revisions that were in the old version of the
branch are not in the new version.  This situation occurs
when a user --force pushes a change and generates a repository
containing something like this:

 * -- * -- B -- O -- O -- O   (89f4c43a41)
            \
             N -- N -- N   refs/heads/javadoc-940 (13ad9aedb5)

You should already have received notification emails for all of the O
revisions, and so the following emails describe only the N revisions
from the common base, B.

Any revisions marked "omit" are not gone; other references still
refer to them.  Any revisions marked "discard" are gone forever.

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 apm-dist/pom.xml                                   |   2 +-
 apm-protocol/apm-network/pom.xml                   |   2 +-
 apm-protocol/pom.xml                               |   2 +-
 apm-webapp/pom.xml                                 |   2 +-
 docs/en/changes/changes-9.4.0.md                   | 161 ---------------------
 docs/en/changes/changes.md                         | 153 +++++++++++++++++++-
 docs/menu.yml                                      |   2 -
 oap-server-bom/pom.xml                             |   2 +-
 oap-server/analyzer/agent-analyzer/pom.xml         |   2 +-
 oap-server/analyzer/event-analyzer/pom.xml         |   2 +-
 oap-server/analyzer/log-analyzer/pom.xml           |   2 +-
 oap-server/analyzer/meter-analyzer/pom.xml         |   2 +-
 oap-server/analyzer/pom.xml                        |   2 +-
 oap-server/exporter/pom.xml                        |   2 +-
 oap-server/microbench/pom.xml                      |   2 +-
 oap-server/oal-grammar/pom.xml                     |   2 +-
 oap-server/oal-rt/pom.xml                          |   2 +-
 oap-server/pom.xml                                 |   2 +-
 oap-server/server-alarm-plugin/pom.xml             |   2 +-
 .../cluster-consul-plugin/pom.xml                  |   2 +-
 .../cluster-etcd-plugin/pom.xml                    |   2 +-
 .../cluster-kubernetes-plugin/pom.xml              |   2 +-
 .../cluster-nacos-plugin/pom.xml                   |   2 +-
 .../cluster-standalone-plugin/pom.xml              |   2 +-
 .../cluster-zookeeper-plugin/pom.xml               |   2 +-
 oap-server/server-cluster-plugin/pom.xml           |   2 +-
 .../server-configuration/configuration-api/pom.xml |   2 +-
 .../configuration-apollo/pom.xml                   |   2 +-
 .../configuration-consul/pom.xml                   |   2 +-
 .../configuration-etcd/pom.xml                     |   2 +-
 .../configuration-k8s-configmap/pom.xml            |   2 +-
 .../configuration-nacos/pom.xml                    |   2 +-
 .../configuration-zookeeper/pom.xml                |   2 +-
 .../grpc-configuration-sync/pom.xml                |   2 +-
 oap-server/server-configuration/pom.xml            |   2 +-
 oap-server/server-core/pom.xml                     |   2 +-
 .../kafka-fetcher-plugin/pom.xml                   |   2 +-
 oap-server/server-fetcher-plugin/pom.xml           |   2 +-
 oap-server/server-health-checker/pom.xml           |   2 +-
 oap-server/server-library/library-client/pom.xml   |   2 +-
 .../library-datacarrier-queue/pom.xml              |   2 +-
 .../library-elasticsearch-client/pom.xml           |   2 +-
 .../library-kubernetes-support/pom.xml             |   2 +-
 oap-server/server-library/library-module/pom.xml   |   2 +-
 oap-server/server-library/library-server/pom.xml   |   2 +-
 oap-server/server-library/library-util/pom.xml     |   2 +-
 oap-server/server-library/pom.xml                  |   2 +-
 oap-server/server-query-plugin/pom.xml             |   2 +-
 .../server-query-plugin/promql-plugin/pom.xml      |   2 +-
 .../query-graphql-plugin/pom.xml                   |   2 +-
 .../zipkin-query-plugin/pom.xml                    |   2 +-
 .../aws-firehose-receiver/pom.xml                  |   6 +-
 .../pom.xml                                        |   2 +-
 .../envoy-metrics-receiver-plugin/pom.xml          |   2 +-
 .../otel-receiver-plugin/pom.xml                   |   2 +-
 oap-server/server-receiver-plugin/pom.xml          |   2 +-
 .../server-receiver-plugin/receiver-proto/pom.xml  |   2 +-
 .../skywalking-browser-receiver-plugin/pom.xml     |   2 +-
 .../skywalking-clr-receiver-plugin/pom.xml         |   2 +-
 .../skywalking-ebpf-receiver-plugin/pom.xml        |   2 +-
 .../skywalking-event-receiver-plugin/pom.xml       |   2 +-
 .../skywalking-jvm-receiver-plugin/pom.xml         |   2 +-
 .../skywalking-log-recevier-plugin/pom.xml         |   2 +-
 .../skywalking-management-receiver-plugin/pom.xml  |   2 +-
 .../skywalking-mesh-receiver-plugin/pom.xml        |   2 +-
 .../skywalking-meter-receiver-plugin/pom.xml       |   2 +-
 .../skywalking-profile-receiver-plugin/pom.xml     |   2 +-
 .../skywalking-sharing-server-plugin/pom.xml       |   2 +-
 .../skywalking-telegraf-receiver-plugin/pom.xml    |   2 +-
 .../skywalking-trace-receiver-plugin/pom.xml       |   2 +-
 .../skywalking-zabbix-receiver-plugin/pom.xml      |   2 +-
 .../zipkin-receiver-plugin/pom.xml                 |   2 +-
 oap-server/server-starter/pom.xml                  |   2 +-
 oap-server/server-storage-plugin/pom.xml           |   2 +-
 .../storage-banyandb-plugin/pom.xml                |   2 +-
 .../storage-elasticsearch-plugin/pom.xml           |   2 +-
 .../storage-jdbc-hikaricp-plugin/pom.xml           |   2 +-
 .../storage-shardingsphere-plugin/pom.xml          |   2 +-
 .../storage-tidb-plugin/pom.xml                    |   2 +-
 oap-server/server-telemetry/pom.xml                |   2 +-
 oap-server/server-telemetry/telemetry-api/pom.xml  |   2 +-
 .../server-telemetry/telemetry-prometheus/pom.xml  |   2 +-
 oap-server/server-testing/pom.xml                  |   2 +-
 oap-server/server-tools/data-generator/pom.xml     |   2 +-
 oap-server/server-tools/pom.xml                    |   2 +-
 oap-server/server-tools/profile-exporter/pom.xml   |   4 +-
 .../tool-profile-snapshot-bootstrap/pom.xml        |   4 +-
 .../tool-profile-snapshot-exporter/pom.xml         |   4 +-
 .../tool-profile-snapshot-server-mock/pom.xml      |   4 +-
 pom.xml                                            |   4 +-
 90 files changed, 246 insertions(+), 258 deletions(-)
 delete mode 100644 docs/en/changes/changes-9.4.0.md


[skywalking] 01/01: Fix javadoc error and run javadoc in CI

Posted by ke...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

kezhenxu94 pushed a commit to branch javadoc-940
in repository https://gitbox.apache.org/repos/asf/skywalking.git

commit 13ad9aedb53b8bcefdcfdd13f6bd3e6099b33633
Author: kezhenxu94 <ke...@apache.org>
AuthorDate: Thu Mar 9 10:08:05 2023 +0800

    Fix javadoc error and run javadoc in CI
---
 .github/workflows/skywalking.yaml                  |  1 -
 .../oap/server/core/CoreModuleConfig.java          |  2 +-
 .../skywalking/oap/server/core/analysis/Layer.java |  2 +-
 .../server/core/storage/annotation/BanyanDB.java   |  5 ++--
 .../core/storage/annotation/SQLDatabase.java       | 16 +++++++-----
 .../StorageModuleElasticsearchConfig.java          |  2 +-
 pom.xml                                            | 29 ++++++++++++++++++++++
 7 files changed, 44 insertions(+), 13 deletions(-)

diff --git a/.github/workflows/skywalking.yaml b/.github/workflows/skywalking.yaml
index a84743275d..9ac0193790 100644
--- a/.github/workflows/skywalking.yaml
+++ b/.github/workflows/skywalking.yaml
@@ -163,7 +163,6 @@ jobs:
         run: |
           ./mvnw clean install -B -q \
             -Dmaven.test.skip \
-            -Dmaven.javadoc.skip \
             -Dcheckstyle.skip
       - uses: actions/upload-artifact@v3
         name: Upload distribution tar
diff --git a/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/CoreModuleConfig.java b/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/CoreModuleConfig.java
index 3e1d4e63a4..158f77ea04 100644
--- a/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/CoreModuleConfig.java
+++ b/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/CoreModuleConfig.java
@@ -112,7 +112,7 @@ public class CoreModuleConfig extends ModuleConfig {
      * load for memory, network of OAP and storage.
      *
      * But, being activated, user could see the name in the storage entities, which make users easier to use 3rd party
-     * tool, such as Kibana->ES, to query the data by themselves.
+     * tool, such as Kibana-&gt;ES, to query the data by themselves.
      */
     private boolean activeExtraModelColumns = false;
     /**
diff --git a/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/analysis/Layer.java b/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/analysis/Layer.java
index 2b0e7ce0df..7dc212ea75 100644
--- a/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/analysis/Layer.java
+++ b/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/analysis/Layer.java
@@ -124,7 +124,7 @@ public enum Layer {
     MYSQL(18, true),
 
     /**
-     * Cache conjectured by client side plugin(eg. skywalking-java -> JedisPlugin LettucePlugin)
+     * Cache conjectured by client side plugin(eg. skywalking-java -&gt; JedisPlugin LettucePlugin)
      */
     VIRTUAL_CACHE(19, false),
 
diff --git a/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/storage/annotation/BanyanDB.java b/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/storage/annotation/BanyanDB.java
index 9777c93263..a306cd8c5d 100644
--- a/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/storage/annotation/BanyanDB.java
+++ b/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/storage/annotation/BanyanDB.java
@@ -65,7 +65,6 @@ public @interface BanyanDB {
      * <p>
      * Only work with {@link Column}
      *
-     * @return non-negative if this column be used for sharding. -1 means not as a sharding key
      * @since 9.3.0 Rename as SeriesID.
      * @since 9.1.0 created as a new annotation.
      * @since 9.0.0 added in {@link Column}
@@ -84,7 +83,7 @@ public @interface BanyanDB {
          * considering OAP finds services by "layer", the "layer" 's index should be 0 to
          * trigger a prefix-scanning.
          *
-         * @return index, from zero.
+         * @return non-negative if this column be used for sharding. -1 means not as a sharding key
          */
         int index() default -1;
     }
@@ -158,7 +157,7 @@ public @interface BanyanDB {
 
     /**
      * StoreIDTag indicates a metric store its ID as a tag for searching.
-     * @Since 9.4.0
+     * @since 9.4.0
      */
     @Target({ElementType.TYPE})
     @Retention(RetentionPolicy.RUNTIME)
diff --git a/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/storage/annotation/SQLDatabase.java b/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/storage/annotation/SQLDatabase.java
index c45c19f12c..970cee0496 100644
--- a/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/storage/annotation/SQLDatabase.java
+++ b/oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/storage/annotation/SQLDatabase.java
@@ -59,15 +59,18 @@ public @interface SQLDatabase {
      * Support create additional tables from a model.<br>
      * <p>
      * Notice:
+     * <ul>
      * <li>This feature only support `Record` type.
      * <li>An additional table only supports one list-type field.
      * <li>Create `MultiColumnsIndex` on the additional table only when it contains all need columns.
+     * </ul>
      * <p>
      * The typical use is: when need to storage a `List` field, we can transform it to another table as row set.<br>
      * For example in SegmentRecord#tags create an additional table:
-     * <pre>{@code
-     *     @SQLDatabase.AdditionalEntity(additionalTables = {ADDITIONAL_TAG_TABLE})
-     *     private List<String> tags;}</pre>
+     * <pre>
+     *     {@code @SQLDatabase.AdditionalEntity(additionalTables = {ADDITIONAL_TAG_TABLE})}
+     *     {@code private List<String> tags;}
+     * </pre>
      * <p>
      * In H2TraceQueryDAO#queryBasicTraces query tags as condition from this additional table, could build sql like this:
      * <pre>{@code
@@ -95,18 +98,19 @@ public @interface SQLDatabase {
      *         }
      *         }</pre>
      * <p>
+     * <ul>
      * <li>If no tags condition, only query segment table, the SQL should be: select
      * column1, column2 ... from segment where 1=1 and colunm1=xx ...
      *
-     *<li> If 1 tag condition, query both segment and segment_tag tables, the SQL should be: select column1, column2 ...
+     * <li> If 1 tag condition, query both segment and segment_tag tables, the SQL should be: select column1, column2 ...
      * from segment inner join segment_tag segment_tag0 on segment.id=segment_tag0.id where 1=1 and colunm1=xx ... and
      * segment_tag0=tagString0
      *
-     *<li> If 2 or more tags condition, query both segment and segment_tag tables, the SQL should be: select column1,
+     * <li> If 2 or more tags condition, query both segment and segment_tag tables, the SQL should be: select column1,
      * column2 ... from segment inner join segment_tag segment_tag0 on segment.id=segment_tag0.id inner join segment_tag
      * segment_tag1 on segment.id=segment_tag1.id ... where 1=1 and colunm1=xx ... and segment_tag0=tagString0 and
      * segment_tag1=tagString1 ...
-     *
+     * </ul>
      */
     @Target({ElementType.FIELD})
     @Retention(RetentionPolicy.RUNTIME)
diff --git a/oap-server/server-storage-plugin/storage-elasticsearch-plugin/src/main/java/org/apache/skywalking/oap/server/storage/plugin/elasticsearch/StorageModuleElasticsearchConfig.java b/oap-server/server-storage-plugin/storage-elasticsearch-plugin/src/main/java/org/apache/skywalking/oap/server/storage/plugin/elasticsearch/StorageModuleElasticsearchConfig.java
index 26144be2dc..085cdc47e7 100644
--- a/oap-server/server-storage-plugin/storage-elasticsearch-plugin/src/main/java/org/apache/skywalking/oap/server/storage/plugin/elasticsearch/StorageModuleElasticsearchConfig.java
+++ b/oap-server/server-storage-plugin/storage-elasticsearch-plugin/src/main/java/org/apache/skywalking/oap/server/storage/plugin/elasticsearch/StorageModuleElasticsearchConfig.java
@@ -145,7 +145,7 @@ public class StorageModuleElasticsearchConfig extends ModuleConfig {
 
     /**
      * The number of threads for the underlying HTTP client to perform socket I/O.
-     * If the value is <= 0, the number of available processors will be used.
+     * If the value is {@code <= 0}, the number of available processors will be used.
      */
     private int numHttpClientThread;
 
diff --git a/pom.xml b/pom.xml
index 020e218613..aa53ae4593 100755
--- a/pom.xml
+++ b/pom.xml
@@ -473,6 +473,35 @@
                     </execution>
                 </executions>
             </plugin>
+
+            <plugin>
+                <groupId>org.projectlombok</groupId>
+                <artifactId>lombok-maven-plugin</artifactId>
+                <version>1.18.20.0</version>
+                <configuration>
+                    <sourceDirectory>${project.basedir}/src/main/java</sourceDirectory>
+                </configuration>
+                <executions>
+                    <execution>
+                        <phase>generate-sources</phase>
+                        <goals>
+                            <goal>delombok</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-javadoc-plugin</artifactId>
+                <configuration>
+                    <sourcepath>
+                        ${project.build.directory}/generated-sources/delombok;
+                        ${project.build.directory}/generated-sources/protobuf/java;
+                        ${project.build.directory}/generated-sources/protobuf/grpc-java;
+                        ${project.build.directory}/generated-sources/antlr4;;
+                    </sourcepath>
+                </configuration>
+            </plugin>
         </plugins>
     </build>
 </project>