Postcat IDEA 外掛，最全的使用教程

圓圓大姐頭發表於2023-04-18
Idea

Postcat 外掛不會入侵到程式碼內部，無需新增任何jar包依賴，這個真的很香！

下面說一說，這個外掛如何使用，是時候展現真正的技術了~

如何安裝配置？

IDEA 版本需大於 IntelliJ IDEA 2022.03

在 IDEA “設定-外掛-Marketplace” 中搜尋 Postcat，找到 Postcat 外掛安裝即可。同時也可在IDEA外掛市場上進行下載安裝，本地的IDEA沒有自動喚起時，可以直接把zip包拖入IDEA中即可完成安裝/更新。

  1. 填寫配置資訊

首次上傳需要填寫配置資訊，配置資訊專案之間獨立。
配置資訊獲取途徑：登陸 Postcat 進入專案中獲取 Token、WorkspaceID 和 ProjectID。

  1. Server 預設填寫：https://postcat.com/api， 使用者無需修改
  2. Token獲取

  3. WorkspaceID 和 ProjectID 獲取

    1. 進入專案設定頁面，點選專案名右側“問號”

  1. StringType 決定出入參的字串型別，只有引數名一開始就是遵守駝峰規範才會發現改變，預覽視窗可看到變化結果

    1. 當引數名為userInfo，選擇 camelCase，依舊是userInfo，這是預設選項
    2. 當引數名為userInfo，選擇 lower_underscore，會變成user_info
    3. 當引數名為userInfo，選擇 UPPER_UNDERSCORE，會變成USER_INFO

2. 注意事項

  1. 進行解析上傳前，請確保 IDEA 在專案中已經構建完，相關依賴已經下載好。
  2. 強烈推薦使用外掛定義的註釋，外掛有強大的生成註釋功能，強烈建議先生成外掛的註釋進行編輯再上傳，註釋可以在設定也進行自定義。
  3. 在識別不到外掛註釋時，僅對Spring MVC、Swagger.v2和Swagger(OpenAPI).v3的註解只做部分簡單支援。為避免必要引數的缺失，推薦使用外掛註釋。
  4. 生成註釋功能會對Spring MVC、Swagger.v2 和Swagger(OpenAPI).v3的註解只做部分簡單支援，而不會讓你重頭編寫。
  5. HTTP介面透過路由和請求方式判斷唯一做覆蓋更新處理
  6. 對於已經上傳的 API，在 web 上進行過手動修改，不建議再使用上傳功能，因為外掛上傳會覆蓋掉之前的內容。
  7. 在生成/手敲了外掛javadoc後，對介面uri，請求方式（GET/POST）等做了修改，需要手動修改外掛javadoc，否則外掛還是會識別到舊的外掛javadoc資訊。

  8. 自動生成的類註釋預設會上傳到預設分組，請使用者自行填寫真實的分組，分組透過名字識別。

    1. 如多級分組，則用.隔開，比如需要把介面傳到第三方分組下的使用者分組，則 group-name 填寫 第三方.使用者。
  9. @group-name註釋 支援到方法級別，預設不生成，可手動新增到方法註釋，外掛會幫你將當前方法存到對應分組中。
  10. 專案級別的 api 掃描和上傳，頂部選單[Tools -> Upload Project Api Doc]，具體使用規則看 專案級上傳。
  11. 生成類註釋不在預設生成@required註釋，只會針對有javax.validation.constraints.NotNull註解的欄位才生成。
  12. 不推薦使用@remark註釋，外掛保留了識別功能且將內容拼接到欄位說明中，生成類註釋不會自動生成。
  13. 透過@PathVariable，POST方法預設把引數識別成 Formdata 型別，GET方法預設把引數識別成 query 型別。
  14. //標識的註釋無法被識別出來，請使用/* /標識。

這款外掛透過分析使用者註釋進行介面解析，最終生成介面文件並上傳至 Postcat 伺服器，使得開發者可以在 Postcat 上進行 API 管理和分享，提高協作能力和開發速度。

Postcat 提供了多種擴充註釋，如@path、@url、@method、@name、@hidden和@required，這些註釋可以在設定介面進行自定義或相容現有註釋。

此外，Postcat 還提供了註釋生成功能，對於沒有或僅有少量註釋的類和方法，開發者無需費力手動新增，該功能可以分析方法欄位含義並自動生成註釋。開發者只需要檢查或根據實際場景進行微調，即可生成一份較完善的API文件。

如果原有註釋不足，Postcat 會透過新增方式補充註釋，移除註釋時只會移除Postcat提供的那些擴充性註釋，不會破壞使用者自身的註釋。同時，開發者還可以使用"意圖"功能區域性生成外掛註釋，並進行調整和修改。

Postcat提供了多種 API 上傳方式，方便開發者在不同的場景下使用。

關於 Postcat

Postcat 是一個強大的開源、跨平臺（Windows、Mac、Linux、Browsers...）的 API 開發測試工具，支援 REST、Websocket 等協議（即將支援 GraphQL、gRPC、TCP、UDP），幫助你加速完成 API 開發和測試工作。

好了，如果你對這個外掛感興趣，不妨去市場搜一搜，覺得專案還不錯的話，不妨去Github Star 支援一波！

Github ：
https://github.com/Postcatlab/postcat

相關文章