如何更改公共方法簽名以及有哪些風險？

Question

我有一個舊方法很少被第三方客戶端使用，我想改變它的簽名（主要是重命名）。

我該怎么辦？ 有什么風險？ 有什么真正的優勢嗎？

一個簡單的例子：

Class Program
{
    public void OldMethodName(var oldVarName)
    {
        //Do something
    }
}

改成

Class Program    
{
    public void NewMethodName(var newVarName)
    {
        //Do the same thing
    }
}

Answer 1

當您的API公開使用時，您應該分兩個階段進行重構：

• 發布包含兩個API的版本 - 此版本的API應該提供新方法，並棄用舊方法。 這將為您的客戶提供遷移時間。
• 等待一段時間后，發布已刪除已棄用方法的版本 - 如果可能，請與您的客戶協調此版本，以確保他們已遷移到使用新方法。

有關如何棄用方法的信息，請參閱此問答 。

除了修復當前或潛在的命名沖突之外，更改公共方法的簽名沒有任何優勢。