Skip to content
This repository was archived by the owner on Jun 30, 2025. It is now read-only.

Commit a3d1618

Browse files
committed
更新文档, 移动 LuaTableBuilder.java 至 api包下
1 parent 5551d23 commit a3d1618

File tree

6 files changed

+124
-53
lines changed

6 files changed

+124
-53
lines changed

docs/api/LuaTableBuilder.md

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
2+
### put
3+
+ **Description**: 增加一个键值对.
4+
+ **Return Type**: **LuaTableBuilder<T>**
5+
+ **Return Desc**: 本实例对象.
6+
+ **Usage**: `put(key:String, value:Object)`
7+
8+
|Name|Type|Description|
9+
|-|-|-|
10+
|key|**String**|LuaTable中的键名.|
11+
|value|**Object**|键名对应的值.|
12+
### putAll
13+
+ **Description**: 通过Map增加多个键值对.
14+
+ **Return Type**: **LuaTableBuilder<T>**
15+
+ **Return Desc**: 本实例对象.
16+
+ **Usage**: `putAll(String:Map<?extends, map:?>)`
17+
18+
|Name|Type|Description|
19+
|-|-|-|
20+
|String|**Map<?extends**|null|
21+
|map|**?>**|键为字符串类型的map.|
22+
### clear
23+
+ **Description**: 清空当前表.
24+
+ **Return Type**: **LuaTableBuilder<T>**
25+
+ **Return Desc**: 本实例对象.
26+
+ **Usage**: `clear()`
27+
28+
|Name|Type|Description|
29+
|-|-|-|
30+
31+
### remove
32+
+ **Description**: 移除指定键的值.
33+
+ **Return Type**: **LuaTableBuilder<T>**
34+
+ **Return Desc**: 本实例对象.
35+
+ **Usage**: `remove(key:String)`
36+
37+
|Name|Type|Description|
38+
|-|-|-|
39+
|key|**String**|要移除的键名.|
40+
### build
41+
+ **Description**: 建立Lua中的表.
42+
+ **Return Type**: **T**
43+
+ **Return Desc**: 返回所建立的表.
44+
+ **Usage**: `build()`
45+
46+
|Name|Type|Description|
47+
|-|-|-|
48+
49+
### buildGlobal
50+
+ **Description**: 建立Lua中的表, 并加入到当前环境的全局变量中.
51+
+ **Return Type**: **void**
52+
+ **Return Desc**:
53+
+ **Usage**: `buildGlobal(key:String)`
54+
55+
|Name|Type|Description|
56+
|-|-|-|
57+
|key|**String**|全局变量的变量名.|
Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
package tk.smileyik.luainminecraftbukkit.api.luatablebuilder;
2+
3+
import tk.smileyik.luainminecraftbukkit.util.luaenvironment.LuaEnvironment;
4+
import tk.smileyik.luainminecraftbukkit.util.luaenvironment.LuaEnvironmentInside;
5+
import tk.smileyik.luainminecraftbukkit.util.luaenvironment.LuaEnvironmentOutside;
6+
import tk.smileyik.luainminecraftbukkit.util.luatablebuilder.LuaTableBuilderInside;
7+
import tk.smileyik.luainminecraftbukkit.util.luatablebuilder.LuaTableBuilderOutside;
8+
9+
import java.util.Map;
10+
11+
public interface LuaTableBuilder<T> {
12+
static LuaTableBuilder<?> getBuilder(LuaEnvironment<?> luaEnvironment) {
13+
if (luaEnvironment instanceof LuaEnvironmentOutside) {
14+
return new LuaTableBuilderOutside(
15+
(LuaEnvironmentOutside) luaEnvironment);
16+
} else {
17+
return new LuaTableBuilderInside(
18+
(LuaEnvironmentInside) luaEnvironment);
19+
}
20+
}
21+
22+
/**
23+
* 增加一个键值对.
24+
* @param key LuaTable中的键名.
25+
* @param value 键名对应的值.
26+
* @return 本实例对象.
27+
*/
28+
LuaTableBuilder<T> put(String key, Object value);
29+
30+
/**
31+
* 通过Map增加多个键值对.
32+
* @param map 键为字符串类型的map.
33+
* @return 本实例对象.
34+
*/
35+
LuaTableBuilder<T> putAll(Map<? extends String, ?> map);
36+
37+
/**
38+
* 清空当前表.
39+
* @return 本实例对象.
40+
*/
41+
LuaTableBuilder<T> clear();
42+
43+
/**
44+
* 移除指定键的值.
45+
* @param key 要移除的键名.
46+
* @return 本实例对象.
47+
*/
48+
LuaTableBuilder<T> remove(String key);
49+
50+
/**
51+
* 建立Lua中的表.
52+
* @return 返回所建立的表.
53+
*/
54+
T build();
55+
56+
/**
57+
* 建立Lua中的表, 并加入到当前环境的全局变量中.
58+
* @param key 全局变量的变量名.
59+
*/
60+
void buildGlobal(String key);
61+
}

src/main/java/tk/smileyik/luainminecraftbukkit/util/luatablebuilder/LuaTableBuilder.java

Lines changed: 2 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -6,54 +6,7 @@
66

77
import java.util.Map;
88

9-
public interface LuaTableBuilder <T> {
10-
static LuaTableBuilder<?> getBuilder(LuaEnvironment<?> luaEnvironment) {
11-
if (luaEnvironment instanceof LuaEnvironmentOutside) {
12-
return new LuaTableBuilderOutside(
13-
(LuaEnvironmentOutside) luaEnvironment);
14-
} else {
15-
return new LuaTableBuilderInside(
16-
(LuaEnvironmentInside) luaEnvironment);
17-
}
18-
}
9+
@Deprecated
10+
public interface LuaTableBuilder <T> extends tk.smileyik.luainminecraftbukkit.api.luatablebuilder.LuaTableBuilder <T> {
1911

20-
/**
21-
* 增加一个键值对.
22-
* @param key LuaTable中的键名.
23-
* @param value 键名对应的值.
24-
* @return 本实例对象.
25-
*/
26-
LuaTableBuilder<T> put(String key, Object value);
27-
28-
/**
29-
* 通过Map增加多个键值对.
30-
* @param map 键为字符串类型的map.
31-
* @return 本实例对象.
32-
*/
33-
LuaTableBuilder<T> putAll(Map<? extends String, ?> map);
34-
35-
/**
36-
* 清空当前表.
37-
* @return 本实例对象.
38-
*/
39-
LuaTableBuilder<T> clear();
40-
41-
/**
42-
* 移除指定键的值.
43-
* @param key 要移除的键名.
44-
* @return 本实例对象.
45-
*/
46-
LuaTableBuilder<T> remove(String key);
47-
48-
/**
49-
* 建立Lua中的表.
50-
* @return 返回所建立的表.
51-
*/
52-
T build();
53-
54-
/**
55-
* 建立Lua中的表, 并加入到当前环境的全局变量中.
56-
* @param key 全局变量的变量名.
57-
*/
58-
void buildGlobal(String key);
5912
}

src/main/java/tk/smileyik/luainminecraftbukkit/util/luatablebuilder/LuaTableBuilderInside.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
public class LuaTableBuilderInside extends AbstractLuaTableBuilder<LuaValue> {
88
private final LuaEnvironmentInside luaEnvironment;
99

10-
protected LuaTableBuilderInside(LuaEnvironmentInside luaEnvironment) {
10+
public LuaTableBuilderInside(LuaEnvironmentInside luaEnvironment) {
1111
this.luaEnvironment = luaEnvironment;
1212
}
1313

src/main/java/tk/smileyik/luainminecraftbukkit/util/luatablebuilder/LuaTableBuilderOutside.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
public class LuaTableBuilderOutside extends AbstractLuaTableBuilder<LuaObject> {
99
private final LuaEnvironmentOutside luaEnvironment;
1010

11-
protected LuaTableBuilderOutside(LuaEnvironmentOutside luaEnvironment) {
11+
public LuaTableBuilderOutside(LuaEnvironmentOutside luaEnvironment) {
1212
this.luaEnvironment = luaEnvironment;
1313
}
1414

src/test/java/tk/smileyik/JavadocToMarkdown.java

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,8 +32,8 @@ public String toString() {
3232

3333

3434
public static void main(String[] args) throws IOException {
35-
String outName = "api/LuaConfigEntity.md";
36-
String file = "/home/miskyle/workspace/idea-space/LuaInMinecraftBukkt/src/main/java/tk/smileyik/luainminecraftbukkit/api/luaconfig/LuaConfigEntity.java";
35+
String outName = "api/LuaTableBuilder.md";
36+
String file = "/home/miskyle/workspace/idea-space/LuaInMinecraftBukkt/src/main/java/tk/smileyik/luainminecraftbukkit/util/luatablebuilder/LuaTableBuilder.java";
3737
List<String> strings = Files.readAllLines(Paths.get(file));
3838

3939
List<String> aPart = new ArrayList<>();

0 commit comments

Comments
 (0)