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; 預設 = []
這個註解處理工具在執行期間需要的檔案。
generates_api 預設值 = 否
這個註解處理工具產生 API 程式碼時,設為 true。

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

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

api_generating_plugins

JavaPluginData JavaPluginInfo.api_generating_plugins

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

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

api_generating_pluginsplugins 的子集。

java_outputs

list JavaPluginInfo.java_outputs

傳回這個 Java/Java 型目標的輸出內容。

外掛程式

JavaPluginData JavaPluginInfo.plugins

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

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

java_library 會執行註解處理,且這個欄位中的所有外掛程式都會顯示在 depsplugins 屬性中。

to_json

string JavaPluginInfo.to_json()

已淘汰,這個 API 已淘汰,並將在近期移除。請勿仰賴這項功能。這項功能已停用 ---incompatible_struct_has_no_methods。請使用這個標記確認您的程式碼是否與即將移除的程式碼相容。
透過 struct 參數建立 JSON 字串。只有在所有 struct 元素 (遞迴) 為字串、整數、布林值、其他結構體、這些型別的清單,或含有這些型別的字串鍵和值的字典時,才適用此方法。系統會將字串中的引號和換行符號逸出。範例:
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,這適用於 struct 以外的值,而且不會汙染 struct 欄位命名空間。

to_proto

string JavaPluginInfo.to_proto()

已淘汰,這個 API 已淘汰,並將在近期移除。請勿仰賴這項功能。這項功能已停用 ---incompatible_struct_has_no_methods。請使用這個標記確認您的程式碼是否與即將移除的程式碼相容。
使用 struct 參數建立文字訊息。只有在所有 struct 元素 (遞迴) 為字串、整數、布林值、其他結構體、這些型別的 dict 或清單時,此方法才有效。系統會將字串中的引號和換行符號逸出。結構鍵會按照排序順序疊代。範例:
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)。