[發(fā)明專利]接口文檔的生成方法、裝置、設(shè)備及計(jì)算機(jī)可讀存儲(chǔ)介質(zhì)

在審

• 申請?zhí)枺?/td>: 202010617452.X
• 申請日: 2020-06-29
• 公開（公告）號(hào): CN111767096A
• 公開（公告）日: 2020-10-13
• 發(fā)明（設(shè)計(jì)）人: 曾凱瑤;盧道和;黃葉飛;邊元喬;陳澄;周瑞哲;李建廷;黃彥淇;高銀川;呂定剛;李婷;陳小鋒;商市盛;畢玉龍
• 申請（專利權(quán)）人: 深圳前海微眾銀行股份有限公司
• 主分類號(hào): G06F9/448
• 分類號(hào): G06F9/448;G06F16/958
• 代理公司: 深圳市世紀(jì)恒程知識(shí)產(chǎn)權(quán)代理事務(wù)所 44287
• 代理人: 張婷

1.一種接口文檔的生成方法，其特征在于，所述接口文檔的生成方法包括：

獲取接口對應(yīng)的源文件；

從所述源文件中確定第一對象對應(yīng)的第一目標(biāo)參數(shù)，所述第一對象包括接口名、請求路徑以及資源處理方法；

從所述源文件中確定第二對象對應(yīng)的第二目標(biāo)參數(shù)，所述第二對象包括請求以及返回對象；

根據(jù)所述第一目標(biāo)參數(shù)以及所述第二目標(biāo)參數(shù)生成接口文檔。

2.如權(quán)利要求1所述的接口文檔的生成方法，其特征在于，所述從所述源文件中確定第一對象對應(yīng)的第一目標(biāo)參數(shù)的步驟包括：

從所述源文件中提取所述第一對象的第一參數(shù)；

在所述第一參數(shù)為字符串時(shí)，將所述第一參數(shù)確定為所述第一對象的第一目標(biāo)參數(shù)；

在所述第一參數(shù)為數(shù)組或者常量時(shí)，將所述第一參數(shù)分割為至少一個(gè)要素，并根據(jù)所述要素確定所述第一對象對應(yīng)的第一目標(biāo)參數(shù)。

3.如權(quán)利要求2所述的接口文檔的生成方法，其特征在于，所述根據(jù)所述要素確定所述第一對象對應(yīng)的第一目標(biāo)參數(shù)的步驟包括：

去除包括第一預(yù)設(shè)符號(hào)的所述要素得到剩余的各個(gè)所述要素；

根據(jù)剩余的各個(gè)所述要素確定所述第一對象對應(yīng)的第一目標(biāo)參數(shù)。

4.如權(quán)利要求2所述的接口文檔的生成方法，其特征在于，所述根據(jù)所述要素確定所述第一對象對應(yīng)的第一目標(biāo)參數(shù)的步驟包括：

在各個(gè)所述要素中確定第一要素，其中，所述第一要素設(shè)有引用對象；

獲取每個(gè)所述第一要素的引用對象對應(yīng)的第二參數(shù)；

根據(jù)各個(gè)所述第二參數(shù)以及各個(gè)第二要素，確定所述第一對象對應(yīng)的第一目標(biāo)參數(shù)，其中，除所述第一要素之外的所述要素為所述第二要素。

5.如權(quán)利要求1-4任一項(xiàng)所述的接口文檔的生成方法，其特征在于，所述從所述源文件中確定第二對象對應(yīng)的第二目標(biāo)參數(shù)的步驟包括：

從所述源文件中提取所述第二對象對應(yīng)的第三參數(shù)；

確定所述第三參數(shù)對應(yīng)的類型；

根據(jù)所述類型以及所述第三參數(shù)，確定所述第二對象對應(yīng)的第二目標(biāo)參數(shù)。

6.如權(quán)利要求5所述的接口文檔的生成方法，其特征在于，所述根據(jù)所述類型以及所述第三參數(shù)，確定所述第二對象對應(yīng)的第二目標(biāo)參數(shù)的步驟包括：

在所述類型為文檔類或字典類時(shí)，將所述第三參數(shù)確定為所述第二對象對應(yīng)的第二目標(biāo)參數(shù)。

7.如權(quán)利要求5所述的接口文檔的生成方法，其特征在于，所述確定所述第三參數(shù)對應(yīng)的類型的步驟之后，還包括：

在所述類型為目標(biāo)類，從所述第三參數(shù)中提取泛型變量參數(shù)，并將所述泛型變量轉(zhuǎn)換為實(shí)際類型參數(shù)，所述目標(biāo)類包括集合類或者class類；

將所述實(shí)際類型參數(shù)更新為第三參數(shù)，并返回執(zhí)行所述確定所述第三參數(shù)的類型的步驟，其中，在所述類型為文檔類或字典類時(shí)，將所述第三參數(shù)確定為所述第二對象對應(yīng)的第二目標(biāo)參數(shù)。

8.如權(quán)利要求7所述的接口文檔的生成方法，其特征在于，所述目標(biāo)類包括class類，所述從所述第三參數(shù)中提取泛型變量參數(shù)的步驟包括：

獲取所述第三參數(shù)對應(yīng)的父類參數(shù)；

從所述第三參數(shù)以及所述父類參數(shù)中提取泛型變量。

9.如權(quán)利要求8所述的接口文檔的生成方法，其特征在于，所述獲取所述第三參數(shù)對應(yīng)的父類參數(shù)的步驟之后，還包括：

確定所述父類參數(shù)是否包括預(yù)設(shè)符字；

在所述父類參數(shù)包括預(yù)設(shè)符字，執(zhí)行所述從所述第三參數(shù)以及所述父類參數(shù)中提取泛型變量參數(shù)的步驟；

在所述父類參數(shù)不包括預(yù)設(shè)符字，將所述父類參數(shù)確定為所述第二對象對應(yīng)的第二目標(biāo)參數(shù)，并執(zhí)行所述根據(jù)所述第一目標(biāo)參數(shù)以及所述第二目標(biāo)參數(shù)生成接口文檔的步驟。