Skip to content

Commit d451a4d

Browse files
committed
fix javadoc when release
1 parent 7d0ec31 commit d451a4d

File tree

197 files changed

+2652
-245
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

197 files changed

+2652
-245
lines changed

.github/workflows/koupleless_runtime_snapshot_2.0.x.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# This workflow will build a Java project with Maven, and cache/restore any dependencies to improve the workflow execution time
22
# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-maven
33

4-
name: Koupleless Snapshot Release for 2.0.x
4+
name: Koupleless Runtime Snapshot for 2.0.x
55

66
## https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#release
77
## trigger manually
@@ -127,4 +127,4 @@ jobs:
127127
env:
128128
MAVEN_USERNAME: ${{ secrets.MAVEN_USERNAME }}
129129
MAVEN_PASSWORD: ${{ secrets.MAVEN_PASSWORD }}
130-
MAVEN_GPG_PASSPHRASE: ${{ secrets.MAVEN_GPG_PASSPHRASE }}
130+
MAVEN_GPG_PASSPHRASE: ${{ secrets.MAVEN_GPG_PASSPHRASE }}

.github/workflows/koupleless_runtime_snapshot_2.1.x.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# This workflow will build a Java project with Maven, and cache/restore any dependencies to improve the workflow execution time
22
# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-maven
33

4-
name: Koupleless Snapshot Release for 2.1.x
4+
name: Koupleless Runtime Snapshot for 2.1.x
55

66
## https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#release
77
## trigger manually
@@ -128,4 +128,4 @@ jobs:
128128
env:
129129
MAVEN_USERNAME: ${{ secrets.MAVEN_USERNAME }}
130130
MAVEN_PASSWORD: ${{ secrets.MAVEN_PASSWORD }}
131-
MAVEN_GPG_PASSPHRASE: ${{ secrets.MAVEN_GPG_PASSPHRASE }}
131+
MAVEN_GPG_PASSPHRASE: ${{ secrets.MAVEN_GPG_PASSPHRASE }}

arklet-core/src/main/java/com/alipay/sofa/koupleless/arklet/core/ArkletComponent.java

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,10 @@
1919
/**
2020
* * Arklet component interface, managed by registry
2121
* * @see ArkletComponentRegistry
22+
*
2223
* @author mingmen
23-
* @date 2023/6/8
24+
* @since 2023/6/8
25+
* @version 1.0.0
2426
*/
2527
public interface ArkletComponent {
2628

arklet-core/src/main/java/com/alipay/sofa/koupleless/arklet/core/ArkletComponentRegistry.java

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,11 @@
3737
import com.google.inject.multibindings.Multibinder;
3838

3939
/**
40+
* <p>ArkletComponentRegistry class.</p>
41+
*
4042
* @author mingmen
41-
* @date 2023/6/14
43+
* @since 2023/6/14
44+
* @version 1.0.0
4245
*/
4346
public class ArkletComponentRegistry {
4447

@@ -75,18 +78,38 @@ private static void destroyComponents() {
7578
ArkletLoggerFactory.getDefaultLogger().info("finish destroy components");
7679
}
7780

81+
/**
82+
* <p>getOperationServiceInstance.</p>
83+
*
84+
* @return a {@link com.alipay.sofa.koupleless.arklet.core.ops.UnifiedOperationService} object
85+
*/
7886
public static UnifiedOperationService getOperationServiceInstance() {
7987
return componentInjector.getInstance(UnifiedOperationService.class);
8088
}
8189

90+
/**
91+
* <p>getCommandServiceInstance.</p>
92+
*
93+
* @return a {@link com.alipay.sofa.koupleless.arklet.core.command.CommandService} object
94+
*/
8295
public static CommandService getCommandServiceInstance() {
8396
return componentInjector.getInstance(CommandService.class);
8497
}
8598

99+
/**
100+
* <p>getHealthServiceInstance.</p>
101+
*
102+
* @return a {@link com.alipay.sofa.koupleless.arklet.core.health.HealthService} object
103+
*/
86104
public static HealthService getHealthServiceInstance() {
87105
return componentInjector.getInstance(HealthService.class);
88106
}
89107

108+
/**
109+
* <p>getApiClientInstance.</p>
110+
*
111+
* @return a {@link com.alipay.sofa.koupleless.arklet.core.api.ApiClient} object
112+
*/
90113
public static ApiClient getApiClientInstance() {
91114
return componentInjector.getInstance(ApiClient.class);
92115
}

arklet-core/src/main/java/com/alipay/sofa/koupleless/arklet/core/api/ApiClient.java

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,8 +33,11 @@
3333
import com.google.inject.multibindings.Multibinder;
3434

3535
/**
36+
* <p>ApiClient class.</p>
37+
*
3638
* @author mingmen
37-
* @date 2023/6/8
39+
* @since 2023/6/8
40+
* @version 1.0.0
3841
*/
3942

4043
@Singleton
@@ -53,6 +56,7 @@ public class ApiClient implements ArkletComponent {
5356
}
5457
}
5558

59+
/** {@inheritDoc} */
5660
@Override
5761
public void init() {
5862
for (Tunnel tunnel : tunnelList) {
@@ -61,13 +65,19 @@ public void init() {
6165
}
6266
}
6367

68+
/** {@inheritDoc} */
6469
@Override
6570
public void destroy() {
6671
for (Tunnel tunnel : tunnelList) {
6772
tunnel.shutdown();
6873
}
6974
}
7075

76+
/**
77+
* <p>getTunnels.</p>
78+
*
79+
* @return a {@link java.util.List} object
80+
*/
7181
public List<Tunnel> getTunnels() {
7282
return tunnelList;
7383
}

arklet-core/src/main/java/com/alipay/sofa/koupleless/arklet/core/api/model/Response.java

Lines changed: 74 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,11 @@
1919
import com.alipay.sofa.koupleless.arklet.core.command.meta.Output;
2020

2121
/**
22+
* <p>Response class.</p>
23+
*
2224
* @author mingmen
23-
* @date 2023/6/26
25+
* @since 2023/6/26
26+
* @version 1.0.0
2427
*/
2528
public class Response {
2629

@@ -44,6 +47,12 @@ public class Response {
4447
*/
4548
private String errorStackTrace;
4649

50+
/**
51+
* <p>fromCommandOutput.</p>
52+
*
53+
* @param output a {@link com.alipay.sofa.koupleless.arklet.core.command.meta.Output} object
54+
* @return a {@link com.alipay.sofa.koupleless.arklet.core.api.model.Response} object
55+
*/
4756
public static Response fromCommandOutput(Output output) {
4857
Response response = new Response();
4958
response.code = output.getCode();
@@ -52,27 +61,51 @@ public static Response fromCommandOutput(Output output) {
5261
return response;
5362
}
5463

64+
/**
65+
* <p>success.</p>
66+
*
67+
* @param data a {@link java.lang.Object} object
68+
* @return a {@link com.alipay.sofa.koupleless.arklet.core.api.model.Response} object
69+
*/
5570
public static Response success(Object data) {
5671
Response response = new Response();
5772
response.code = ResponseCode.SUCCESS;
5873
response.data = data;
5974
return response;
6075
}
6176

77+
/**
78+
* <p>failed.</p>
79+
*
80+
* @param message a {@link java.lang.String} object
81+
* @return a {@link com.alipay.sofa.koupleless.arklet.core.api.model.Response} object
82+
*/
6283
public static Response failed(String message) {
6384
Response response = new Response();
6485
response.code = ResponseCode.FAILED;
6586
response.message = message;
6687
return response;
6788
}
6889

90+
/**
91+
* <p>notFound.</p>
92+
*
93+
* @return a {@link com.alipay.sofa.koupleless.arklet.core.api.model.Response} object
94+
*/
6995
public static Response notFound() {
7096
Response response = new Response();
7197
response.code = ResponseCode.CMD_NOT_FOUND;
7298
response.message = "please follow the doc";
7399
return response;
74100
}
75101

102+
/**
103+
* <p>internalError.</p>
104+
*
105+
* @param message a {@link java.lang.String} object
106+
* @param errorStackTrace a {@link java.lang.String} object
107+
* @return a {@link com.alipay.sofa.koupleless.arklet.core.api.model.Response} object
108+
*/
76109
public static Response internalError(String message, String errorStackTrace) {
77110
Response response = new Response();
78111
response.code = ResponseCode.CMD_PROCESS_INTERNAL_ERROR;
@@ -81,34 +114,74 @@ public static Response internalError(String message, String errorStackTrace) {
81114
return response;
82115
}
83116

117+
/**
118+
* <p>Getter for the field <code>message</code>.</p>
119+
*
120+
* @return a {@link java.lang.String} object
121+
*/
84122
public String getMessage() {
85123
return message;
86124
}
87125

126+
/**
127+
* <p>Setter for the field <code>message</code>.</p>
128+
*
129+
* @param message a {@link java.lang.String} object
130+
*/
88131
public void setMessage(String message) {
89132
this.message = message;
90133
}
91134

135+
/**
136+
* <p>Getter for the field <code>data</code>.</p>
137+
*
138+
* @return a {@link java.lang.Object} object
139+
*/
92140
public Object getData() {
93141
return data;
94142
}
95143

144+
/**
145+
* <p>Setter for the field <code>data</code>.</p>
146+
*
147+
* @param data a {@link java.lang.Object} object
148+
*/
96149
public void setData(Object data) {
97150
this.data = data;
98151
}
99152

153+
/**
154+
* <p>Getter for the field <code>code</code>.</p>
155+
*
156+
* @return a {@link com.alipay.sofa.koupleless.arklet.core.api.model.ResponseCode} object
157+
*/
100158
public ResponseCode getCode() {
101159
return code;
102160
}
103161

162+
/**
163+
* <p>Setter for the field <code>code</code>.</p>
164+
*
165+
* @param code a {@link com.alipay.sofa.koupleless.arklet.core.api.model.ResponseCode} object
166+
*/
104167
public void setCode(ResponseCode code) {
105168
this.code = code;
106169
}
107170

171+
/**
172+
* <p>Getter for the field <code>errorStackTrace</code>.</p>
173+
*
174+
* @return a {@link java.lang.String} object
175+
*/
108176
public String getErrorStackTrace() {
109177
return errorStackTrace;
110178
}
111179

180+
/**
181+
* <p>Setter for the field <code>errorStackTrace</code>.</p>
182+
*
183+
* @param errorStackTrace a {@link java.lang.String} object
184+
*/
112185
public void setErrorStackTrace(String errorStackTrace) {
113186
this.errorStackTrace = errorStackTrace;
114187
}

arklet-core/src/main/java/com/alipay/sofa/koupleless/arklet/core/api/model/ResponseCode.java

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,10 +17,12 @@
1717
package com.alipay.sofa.koupleless.arklet.core.api.model;
1818

1919
/**
20+
* <p>ResponseCode class.</p>
21+
*
2022
* @author mingmen
21-
* @date 2023/6/26
23+
* @since 2023/6/26
24+
* @version 1.0.0
2225
*/
23-
2426
public enum ResponseCode {
2527
SUCCESS(200), FAILED(400), CMD_NOT_FOUND(404), CMD_PROCESS_INTERNAL_ERROR(500);
2628

@@ -30,6 +32,11 @@ public enum ResponseCode {
3032
this.code = code;
3133
}
3234

35+
/**
36+
* <p>Getter for the field <code>code</code>.</p>
37+
*
38+
* @return a int
39+
*/
3340
public int getCode() {
3441
return code;
3542
}

arklet-core/src/main/java/com/alipay/sofa/koupleless/arklet/core/api/tunnel/Tunnel.java

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,14 +19,28 @@
1919
import com.alipay.sofa.koupleless.arklet.core.command.CommandService;
2020

2121
/**
22+
* <p>Tunnel interface.</p>
23+
*
2224
* @author mingmen
23-
* @date 2023/6/8
25+
* @since 2023/6/8
26+
* @version 1.0.0
2427
*/
2528
public interface Tunnel {
2629

30+
/**
31+
* <p>init.</p>
32+
*
33+
* @param commandService a {@link com.alipay.sofa.koupleless.arklet.core.command.CommandService} object
34+
*/
2735
void init(CommandService commandService);
2836

37+
/**
38+
* <p>run.</p>
39+
*/
2940
void run();
3041

42+
/**
43+
* <p>shutdown.</p>
44+
*/
3145
void shutdown();
3246
}

arklet-core/src/main/java/com/alipay/sofa/koupleless/arklet/core/api/tunnel/http/HttpTunnel.java

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,8 +31,11 @@
3131
import com.google.inject.Singleton;
3232

3333
/**
34+
* <p>HttpTunnel class.</p>
35+
*
3436
* @author mingmen
35-
* @date 2023/6/8
37+
* @since 2023/6/8
38+
* @version 1.0.0
3639
*/
3740

3841
@Singleton
@@ -50,6 +53,7 @@ public class HttpTunnel implements Tunnel {
5053
private final AtomicBoolean run = new AtomicBoolean(false);
5154
private CommandService commandService;
5255

56+
/** {@inheritDoc} */
5357
@Override
5458
public void init(CommandService commandService) {
5559
if (init.compareAndSet(false, true)) {
@@ -69,6 +73,7 @@ public void init(CommandService commandService) {
6973
}
7074
}
7175

76+
/** {@inheritDoc} */
7277
@Override
7378
public void run() {
7479
if (run.compareAndSet(false, true)) {
@@ -84,6 +89,7 @@ public void run() {
8489
}
8590
}
8691

92+
/** {@inheritDoc} */
8793
@Override
8894
public void shutdown() {
8995
if (shutdown.compareAndSet(false, true)) {

0 commit comments

Comments
 (0)