This is an automated email from the ASF dual-hosted git repository.
jermy pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-hugegraph-doc.git
The following commit(s) were added to refs/heads/master by this push:
new e768bf27 fix: enhance the code reading experience for lacking RPC
generated files (#353)
e768bf27 is described below
commit e768bf27068ff8216f38a826c7e4f61a2fb594cc
Author: Jerry Hu <[email protected]>
AuthorDate: Sat Apr 13 11:47:40 2024 -0400
fix: enhance the code reading experience for lacking RPC generated files
(#353)
Co-authored-by: JerryHu87 <[email protected]>
Co-authored-by: imbajin <[email protected]>
---
.../contribution-guidelines/hugegraph-server-idea-setup.md | 9 ++++++++-
.../contribution-guidelines/hugegraph-server-idea-setup.md | 14 ++++++++++----
2 files changed, 18 insertions(+), 5 deletions(-)
diff --git
a/content/cn/docs/contribution-guidelines/hugegraph-server-idea-setup.md
b/content/cn/docs/contribution-guidelines/hugegraph-server-idea-setup.md
index ede7b87f..74c3e424 100644
--- a/content/cn/docs/contribution-guidelines/hugegraph-server-idea-setup.md
+++ b/content/cn/docs/contribution-guidelines/hugegraph-server-idea-setup.md
@@ -147,7 +147,14 @@ curl
"http://localhost:8080/graphs/hugegraph/graph/vertices"; | gunzip
1. 在 IntelliJ IDEA 的 `Preferences/Settings` 中找到 `Java Compiler` 面板，然后关闭
`--release` 选项 (推荐)
2. 或者将项目的 SDK 版本设置为 8 (Deprecated soon)
-#### 2. Log4j2 日志无法打印 %l 等位置信息
+#### 2. java: *.store.raft.rpc.RaftRequests does not exist (RPC Generated
Files)
+
+原因是源代码没有包含 `RPC-generated` 文件。可以尝试两种方法来解决：
+1. [命令] 在根目录下运行 `mvn clean compile -DskipTests` (**推荐**)
+2. [UI] 在 IDEA 中，右键点击 `hugegraph` 模块，选择 `Manve -> Generate Sources and Update
Folders`
+
+
+#### 3. Log4j2 日志无法打印 %l 等位置信息
这是因为 Log4j2 中使用了 asynchronous
loggers，可以参考[官方文档](https://logging.apache.org/log4j/2.x/manual/layouts.html#LocationInformation)进行配置
diff --git
a/content/en/docs/contribution-guidelines/hugegraph-server-idea-setup.md
b/content/en/docs/contribution-guidelines/hugegraph-server-idea-setup.md
index 56f2df15..7152f26f 100644
--- a/content/en/docs/contribution-guidelines/hugegraph-server-idea-setup.md
+++ b/content/en/docs/contribution-guidelines/hugegraph-server-idea-setup.md
@@ -15,9 +15,9 @@ The core steps for local startup are the same as starting
with **scripts**:
1. Initialize the database backend by executing the `InitStore` class to
initialize the graph.
2. Start HugeGraph-Server by executing the `HugeGraphServer` class to load the
initialized graph information and start the server.
-Before proceeding with the following process, make sure that you have cloned
the source code of HugeGraph
-and have configured the development environment, such as `Java 11` & you could
config your local environment
-with this
[config-doc](https://github.com/apache/incubator-hugegraph/wiki/The-style-config-for-HugeGraph-in-IDEA)
+Before proceeding with the following process, make sure that you have cloned
the source code of HugeGraph
+and have configured the development environment, such as `Java 11` & you could
config your local environment
+with this
[config-doc](https://github.com/apache/incubator-hugegraph/wiki/The-style-config-for-HugeGraph-in-IDEA)
```bash
git clone https://github.com/apache/hugegraph.git
@@ -146,7 +146,13 @@ The reason may be that cross-compilation is triggered when
using Java 11 to comp
1. In IntelliJ IDEA, go to `Preferences/Settings` and find the `Java Compiler`
panel. Then, disable the `--release` option (recommended).
2. Set the Project SDK to 8 (Deprecated soon).
-#### 2. Unable to Print Location Information (%l) in Log4j2
+#### 2. java: *.store.raft.rpc.RaftRequests does not exist (RPC Generated
Files)
+
+The reason is that the source code didn't include the `RPC-generated` files.
You could try 2 ways to fix it:
+1. [CMD]`mvn clean compile` in the **root** directory (Recommend)
+2. [UI] right click on the `hugegraph` repo and select `Maven->Generate
Sources and Update Folders`. This will rebuild the repo and correctly generate
the required files.
+
+#### 3. Unable to Print Location Information (%l) in Log4j2
This is because Log4j2 uses asynchronous loggers. You can refer to the
[official
documentation](https://logging.apache.org/log4j/2.x/manual/layouts.html#LocationInformation)
for configuration details.
