物件Service

系統服務管理對象

繼承關係

建構函數

Service

系統服務管理物件建構函數

1
2
3
new Service(String name,
    Function worker,
    Object event = {});

呼叫參數:

• name: String, 服務名稱
• worker: Function, 服務運行函數
• event: Object, 服務事件處理

靜態函數

install

安裝服務到系統

1
2
3
4
static Service.install(String name,
    String cmd,
    String displayName = "",
    String description = "");

呼叫參數:

• name: String, 服務名稱
• cmd: String, 服務命令列
• displayName: String, 服務顯示名稱
• description: String, 服務描述訊息

---

remove

從系統中卸載服務

1
static Service.remove(String name);

呼叫參數:

• name: String, 服務名稱

---

start

啟動服務

1
static Service.start(String name);

呼叫參數:

• name: String, 服務名稱

---

stop

停止服務

1
static Service.stop(String name);

呼叫參數:

• name: String, 服務名稱

---

restart

重啟服務

1
static Service.restart(String name);

呼叫參數:

• name: String, 服務名稱

---

isInstalled

檢測服務是否安裝

1
static Boolean Service.isInstalled(String name);

呼叫參數:

• name: String, 服務名稱

回傳結果:

• Boolean, 服務安裝返回True

---

isRunning

檢測服務是否運行

1
static Boolean Service.isRunning(String name);

呼叫參數:

• name: String, 服務名稱

回傳結果:

• Boolean, 服務運行返回True

靜態屬性

defaultMaxListeners

Integer, 預設全域最大監聽器數

1
static Integer Service.defaultMaxListeners;

成員屬性

name

String, 查詢與設定服務名稱

1
String Service.name;

---

onstop

Function, 查詢與綁定服務停止事件，相當於on("stop", func);

1
Function Service.onstop;

---

onpause

Function, 查詢和綁定服務暫停事件，相當於on("pause", func);

1
Function Service.onpause;

---

oncontinue

Function, 查詢與綁定服務恢復事件，相當於on("continue", func);

1
Function Service.oncontinue;

成員函數

run

開始運作服務實體

1
Service.run() async;

---

on

綁定一個事件處理函數到對象

1
2
Object Service.on(String ev,
    Function func);

呼叫參數:

• ev: String, 指定事件的名稱
• func: Function, 指定事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

綁定一個事件處理函數到對象

1
Object Service.on(Object map);

呼叫參數:

• map: Object, 指定事件映射關係，物件屬性名稱將作為事件名稱，屬性的值將作為事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

addListener

綁定一個事件處理函數到對象

1
2
Object Service.addListener(String ev,
    Function func);

呼叫參數:

• ev: String, 指定事件的名稱
• func: Function, 指定事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

綁定一個事件處理函數到對象

1
Object Service.addListener(Object map);

呼叫參數:

• map: Object, 指定事件映射關係，物件屬性名稱將作為事件名稱，屬性的值將作為事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

prependListener

綁定一個事件處理函數到物件起始

1
2
Object Service.prependListener(String ev,
    Function func);

呼叫參數:

• ev: String, 指定事件的名稱
• func: Function, 指定事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

綁定一個事件處理函數到物件起始

1
Object Service.prependListener(Object map);

呼叫參數:

• map: Object, 指定事件映射關係，物件屬性名稱將作為事件名稱，屬性的值將作為事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

once

綁定一個一次性事件處理函數到對象，一次性處理函數只會觸發一次

1
2
Object Service.once(String ev,
    Function func);

呼叫參數:

• ev: String, 指定事件的名稱
• func: Function, 指定事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

綁定一個一次性事件處理函數到對象，一次性處理函數只會觸發一次

1
Object Service.once(Object map);

呼叫參數:

• map: Object, 指定事件映射關係，物件屬性名稱將作為事件名稱，屬性的值將作為事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

prependOnceListener

綁定一個事件處理函數到物件起始

1
2
Object Service.prependOnceListener(String ev,
    Function func);

呼叫參數:

• ev: String, 指定事件的名稱
• func: Function, 指定事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

綁定一個事件處理函數到物件起始

1
Object Service.prependOnceListener(Object map);

呼叫參數:

• map: Object, 指定事件映射關係，物件屬性名稱將作為事件名稱，屬性的值將作為事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

off

從物件處理佇列中取消指定函數

1
2
Object Service.off(String ev,
    Function func);

呼叫參數:

• ev: String, 指定事件的名稱
• func: Function, 指定事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

取消物件處理佇列中的全部函數

1
Object Service.off(String ev);

呼叫參數:

• ev: String, 指定事件的名稱

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

從物件處理佇列中取消指定函數

1
Object Service.off(Object map);

呼叫參數:

• map: Object, 指定事件映射關係，物件屬性名稱作為事件名稱，屬性的值作為事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

removeListener

從物件處理佇列中取消指定函數

1
2
Object Service.removeListener(String ev,
    Function func);

呼叫參數:

• ev: String, 指定事件的名稱
• func: Function, 指定事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

取消物件處理佇列中的全部函數

1
Object Service.removeListener(String ev);

呼叫參數:

• ev: String, 指定事件的名稱

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

從物件處理佇列中取消指定函數

1
Object Service.removeListener(Object map);

呼叫參數:

• map: Object, 指定事件映射關係，物件屬性名稱作為事件名稱，屬性的值作為事件處理函數

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

removeAllListeners

從物件處理佇列中取消所有事件的所有監聽器， 如果指定事件，則移除指定事件的所有監聽器。

1
Object Service.removeAllListeners(String ev);

呼叫參數:

• ev: String, 指定事件的名稱

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

從物件處理佇列中取消所有事件的所有監聽器， 如果指定事件，則移除指定事件的所有監聽器。

1
Object Service.removeAllListeners(Array evs = []);

呼叫參數:

• evs: Array, 指定事件的名稱

回傳結果:

• Object, 傳回事件物件本身，便於鍊式調用

---

setMaxListeners

監聽器的預設限制的數量，僅用於相容

1
Service.setMaxListeners(Integer n);

呼叫參數:

• n: Integer, 指定事件的數量

---

getMaxListeners

取得監聽器的預設限制的數量，僅用於相容

1
Integer Service.getMaxListeners();

回傳結果:

• Integer, 回傳預設限制數量

---

listeners

查詢物件指定事件的監聽器陣列

1
Array Service.listeners(String ev);

呼叫參數:

• ev: String, 指定事件的名稱

回傳結果:

• Array, 傳回指定事件的監聽器數組

---

listenerCount

查詢物件指定事件的監聽器數量

1
Integer Service.listenerCount(String ev);

呼叫參數:

• ev: String, 指定事件的名稱

回傳結果:

• Integer, 傳回指定事件的監聽器數量

---

查詢物件指定事件的監聽器數量

1
2
Integer Service.listenerCount(Value o,
    String ev);

呼叫參數:

• o: Value, 指定查詢的對象
• ev: String, 指定事件的名稱

回傳結果:

• Integer, 傳回指定事件的監聽器數量

---

eventNames

查詢監聽器事件名稱

1
Array Service.eventNames();

回傳結果:

• Array, 傳回事件名稱數組

---

emit

主動觸發一個事件

1
2
Boolean Service.emit(String ev,
    ...args);

呼叫參數:

• ev: String, 事件名稱
• args: ..., 事件參數，將會傳遞給事件處理函數

回傳結果:

• Boolean, 回傳事件觸發狀態，有回應事件回傳true，否則回傳false

---

toString

傳回物件的字串表示，一般回傳"[Native Object]"，物件可以根據自己的特性重新實現

1
String Service.toString();

回傳結果:

• String, 傳回物件的字串表示

---

toJSON

傳回物件的JSON 格式表示，一般傳回物件定義的可讀屬性集合

1
Value Service.toJSON(String key = "");

呼叫參數:

• key: String, 未使用

回傳結果:

• Value, 傳回包含可JSON 序列化的值