zhongjiajie commented on code in PR #10689:
URL: https://github.com/apache/dolphinscheduler/pull/10689#discussion_r914393150
##########
docs/docs/zh/guide/task/java.md:
##########
@@ -0,0 +1,50 @@
+# JAVA 节点
+
+## 综述
+
+该节点用于执行 java 类型的任务，支持使用单文件和jar包作为程序入口。
+
+## 创建任务
+
+- 点击项目管理 -> 项目名称 -> 工作流定义，点击”创建工作流”按钮，进入 DAG 编辑页面：
+
+- 拖动工具栏的JAVA任务节点到画板中。
+
+## 任务参数
+
+- 节点名称：设置任务的名称。一个工作流定义中的节点名称是唯一的。
+- 运行标志：标识这个节点是否能正常调度,如果不需要执行，可以打开禁止执行开关。
+- 描述：描述该节点的功能。
+- 任务优先级：worker 线程数不足时，根据优先级从高到低依次执行，优先级一样时根据先进先出原则执行。
+- Worker 分组：任务分配给 worker 组的机器机执行，选择 Default，会随机选择一台 worker 机执行。
+- 环境名称：配置运行任务的环境。
+- 失败重试次数：任务失败重新提交的次数，支持下拉和手填。
+- 失败重试间隔：任务失败重新提交任务的时间间隔，支持下拉和手填。
+- 延迟执行时间：任务延迟执行的时间，以分为单位。
+- 超时告警：勾选超时告警、超时失败，当任务超过"超时时长"后，会发送告警邮件并且任务执行失败。
+- 模块路劲：开启使用JAVA9+的模块化特性，把所有资源放入--module-path中，要求您的worker中的JDK版本支持模块化。
+- 主程序参数：作为普通Java程序main方法入口参数。
+- 虚拟机参数：配置启动虚拟机参数。
+- 脚本：若使用JAVA运行类型则需要编写JAVA代码。代码中必须存在public类，不用写package语句。
+- 资源：可以是外部JAR包也可以是其他资源文件，它们都会被加入到类路径或模块路径中，您可以在自己的JAVA脚本中轻松获取。
+- 自定义参数：是 http 局部的用户自定义参数，会替换脚本中以 ${变量} 的内容。
+- 前置任务：选择当前任务的前置任务，会将被选择的前置任务设置为当前任务的上游。
+
+## 任务样例
+
+HTTP 定义了与服务器交互的不同方法，最基本的方法有4种，分别是GET，POST，PUT，DELETE。这里我们使用 http 任务节点，演示使用
POST 向系统的登录页面发送请求，提交数据。
+
+主要配置参数如下：
+
+- 运行类型
+- 模块路径
+- 主程序参数
+- 虚拟机参数
+- 脚本文件
+
+
Review Comment:
both English and Chinese documents should use the English version screenshot
##########
docs/docs/en/guide/task/java.md:
##########
@@ -0,0 +1,67 @@
+# Overview
+
+This node is used to perform java-type tasks and supports the use of single
files and jar packages as program entries.
+
+# Create Tasks
+
+- Click on project management-> Project name-> workflow definition, click on
the“Create workflow” button, go to the DAG edit page:
+
+- Drag the toolbar's Java task node to the palette.
+
+# Task Parameters
+
+- Node Name: the name of the set task. The node name in a workflow definition
is unique.
+
+- Run Flag: indicates whether the node is scheduled properly and, if it is not
needed, turns on the kill switch.
+
+- Description: describes the functionality of the node.
+
+- Task Priority: when the number of worker threads is insufficient, the worker
is executed according to the priority from high to low. When the priority is
the same, the worker is executed according to the first in, first out principle.
+
+- Worker Group: The machine whose task is assigned to the Worker group
executes, and selecting Default will randomly select a Worker machine to
execute.
+
+- Environment Name: configure the environment in which the task runs.
+
+- Number Of Failed Retries: number of resubmitted tasks that failed, supported
drop-down and hand-fill.
+
+- Failed Retry Interval: the interval between tasks that fail and are
resubmitted, supported by drop-down and hand-fill.
+
+- Delayed Execution Time: the amount of time a task is delayed, in units.
+
+- Timeout Alarm: Check timeout warning, timeout failure, when the task exceeds
the“Timeout length”, send a warning message and the task execution fails.
+
+- Module Path: turn on the use of Java 9 + 's modularity feature, put all
resources into-module-path, and require that the JDK version in your worker
support modularity.
+
+- Main Parameter: as a normal Java program main method entry parameter.
+
+- Java VM Parameters: configure startup virtual machine parameters.
+
+- Script: you need to write Java code if you use the Java run type. The public
class must exist in the code without writing a package statement.
+
+- Resources: these can be external JAR packages or other resource files that
are added to the Classpath or module path and can be easily retrieved in your
JAVA script.
+
+- Custom parameter: a user-defined parameter that is part of HTTP and replaces
the contents of the script with the ${ variable } .
+
+- Pre Tasks: selecting a pre-task for the current task sets the selected
pre-task upstream of the current task.
+
+## Example
+
+HTTP defines the different methods of interacting with the server, and the
four most basic methods are GET, POST, PUT, and DELETE. Here we use the HTTP
task node to demonstrate the use of POST to send a request to the system's
login page and submit data.
+
+The main configuration parameters are as follows:
+
+- Run Type
+
Review Comment:
redundant blank line too
##########
docs/docs/en/guide/task/java.md:
##########
@@ -0,0 +1,67 @@
+# Overview
+
+This node is used to perform java-type tasks and supports the use of single
files and jar packages as program entries.
+
+# Create Tasks
+
+- Click on project management-> Project name-> workflow definition, click on
the“Create workflow” button, go to the DAG edit page:
+
+- Drag the toolbar's Java task node to the palette.
+
+# Task Parameters
+
+- Node Name: the name of the set task. The node name in a workflow definition
is unique.
+
+- Run Flag: indicates whether the node is scheduled properly and, if it is not
needed, turns on the kill switch.
+
+- Description: describes the functionality of the node.
+
+- Task Priority: when the number of worker threads is insufficient, the worker
is executed according to the priority from high to low. When the priority is
the same, the worker is executed according to the first in, first out principle.
+
+- Worker Group: The machine whose task is assigned to the Worker group
executes, and selecting Default will randomly select a Worker machine to
execute.
+
+- Environment Name: configure the environment in which the task runs.
+
+- Number Of Failed Retries: number of resubmitted tasks that failed, supported
drop-down and hand-fill.
+
+- Failed Retry Interval: the interval between tasks that fail and are
resubmitted, supported by drop-down and hand-fill.
+
+- Delayed Execution Time: the amount of time a task is delayed, in units.
+
+- Timeout Alarm: Check timeout warning, timeout failure, when the task exceeds
the“Timeout length”, send a warning message and the task execution fails.
+
+- Module Path: turn on the use of Java 9 + 's modularity feature, put all
resources into-module-path, and require that the JDK version in your worker
support modularity.
+
+- Main Parameter: as a normal Java program main method entry parameter.
+
+- Java VM Parameters: configure startup virtual machine parameters.
+
+- Script: you need to write Java code if you use the Java run type. The public
class must exist in the code without writing a package statement.
+
+- Resources: these can be external JAR packages or other resource files that
are added to the Classpath or module path and can be easily retrieved in your
JAVA script.
+
+- Custom parameter: a user-defined parameter that is part of HTTP and replaces
the contents of the script with the ${ variable } .
+
+- Pre Tasks: selecting a pre-task for the current task sets the selected
pre-task upstream of the current task.
+
+## Example
+
+HTTP defines the different methods of interacting with the server, and the
four most basic methods are GET, POST, PUT, and DELETE. Here we use the HTTP
task node to demonstrate the use of POST to send a request to the system's
login page and submit data.
+
+The main configuration parameters are as follows:
+
+- Run Type
+
+- Module Path
+
+- Main Parameters
+
+- Java VM Parameters
+
+- Script
+
+
+
+## Notice
Review Comment:
```suggestion
## Note
```
##########
docs/docs/en/guide/task/java.md:
##########
@@ -0,0 +1,67 @@
+# Overview
+
+This node is used to perform java-type tasks and supports the use of single
files and jar packages as program entries.
+
+# Create Tasks
+
+- Click on project management-> Project name-> workflow definition, click on
the“Create workflow” button, go to the DAG edit page:
+
+- Drag the toolbar's Java task node to the palette.
+
+# Task Parameters
+
+- Node Name: the name of the set task. The node name in a workflow definition
is unique.
+
Review Comment:
please remove the redundant blank line here
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
