JavaPluginInfo

提供 Java 外掛程式相關資訊的供應商。

目前唯一支援的外掛程式類型是註解處理工具。

成員

JavaPluginInfo

JavaPluginInfo JavaPluginInfo(runtime_deps, *, processor_class, data=[], generates_api=False)

JavaPluginInfo 建構函式。

參數

參數 說明
runtime_deps sequence of JavaInfos；必要
包含註解處理工具的程式庫。
processor_class string; or None；必要
Java 編譯器使用做為註解處理工具進入點的完整類別名稱。
data sequence of Files; or depset of Files; default = []
此註解處理工具在執行期間需要的檔案。
generates_api default = False
在這個註解處理工具產生 API 程式碼時，請設為 true。

這類註解處理工具會先套用至 Java 目標，再產生標頭 jar (包含方法簽章)。如果沒有 API 外掛程式，系統就會從來源產生標頭 jar，進而減少關鍵路徑。

警告：這個參數會影響建構效能，請只在必要時使用。

api_generating_plugins

JavaPluginData JavaPluginInfo.api_generating_plugins

傳回由這個目標定義或匯出的 API 產生外掛程式相關資料。

這些註解處理工具會在產生標頭 jar (含有方法簽章) 前套用至 Java 目標。如果沒有 API 外掛程式，系統就會從來源產生標頭 jar，藉此減少關鍵路徑。

api_generating_plugins 是 plugins 的子集。

java_outputs

list JavaPluginInfo.java_outputs

傳回此 Java/Java 類似目標的輸出資訊。

外掛程式

JavaPluginData JavaPluginInfo.plugins

傳回應套用目標所有外掛程式的相關資料。

這通常是 java_plugin 本身，或是匯出一或多個外掛程式的 java_library。

java_library 會使用這個欄位的所有外掛程式執行註解處理，這些外掛程式會顯示在 deps 和 plugins 屬性中。

to_json

string JavaPluginInfo.to_json()

已淘汰。這個 API 已淘汰，並將在近期內移除。請勿完全仰賴它。---incompatible_struct_has_no_methods 已停用這項功能。使用此旗標確認您的程式碼是否與即將移除的程式碼相容。
透過結構參數建立 JSON 字串。只有在所有結構元素 (遞迴) 是字串、整數、布林值、其他結構體、這些型別清單，或是含有這些類型字串鍵和值的字典時，才能使用此方法。字串中的引號和新行會逸出。範例：
struct(key=123).to_json()
# {"key":123}

struct(key=True).to_json()
# {"key":true}

struct(key=[1, 2, 3]).to_json()
# {"key":[1,2,3]}

struct(key='text').to_json()
# {"key":"text"}

struct(key=struct(inner_key='text')).to_json()
# {"key":{"inner_key":"text"}}

struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_json()
# {"key":[{"inner_key":1},{"inner_key":2}]}

struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_json()
# {"key":{"inner_key":{"inner_inner_key":"text"}}}
。

已淘汰：請改用 json.encode(x) 或 json.encode_indent(x)。這適用於結構體以外的值，不會影響結構欄位命名空間。

to_proto

string JavaPluginInfo.to_proto()

已淘汰。這個 API 已淘汰，並將在近期內移除。請勿完全仰賴它。---incompatible_struct_has_no_methods 已停用這項功能。使用此旗標確認您的程式碼是否與即將移除的程式碼相容。
透過 struct 參數建立簡訊。只有在所有結構元素 (遞迴) 是字串、整數、布林值、其他結構體、字典或這些類型的清單時，才能使用此方法。字串中的引號和新行會逸出。結構鍵會依排序順序疊代。範例：
struct(key=123).to_proto()
# key: 123

struct(key=True).to_proto()
# key: true

struct(key=[1, 2, 3]).to_proto()
# key: 1
# key: 2
# key: 3

struct(key='text').to_proto()
# key: "text"

struct(key=struct(inner_key='text')).to_proto()
# key {
#   inner_key: "text"
# }

struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_proto()
# key {
#   inner_key: 1
# }
# key {
#   inner_key: 2
# }

struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_proto()
# key {
#    inner_key {
#     inner_inner_key: "text"
#   }
# }

struct(foo={4: 3, 2: 1}).to_proto()
# foo: {
#   key: 4
#   value: 3
# }
# foo: {
#   key: 2
#   value: 1
# }

已淘汰：請改用 proto.encode_text(x)。