禁止されているサードパーティの方法について警告する

注：この質問は、JavaまたはC＃で記述されたコードに関するものです。

私はいくつかの大規模なプロジェクトを管理しており、サードパーティ/ SDKのメソッドで問題（必ずしもバグではない）を発見し、代わりに使用する必要がある独自の拡張機能を作成しました。これらの方法を使用することは、このプロジェクトでは推奨されないことを開発者に覚えておいてください。

独自のライブラリを使用していた場合は、そのメソッドを簡単に削除したり、廃止/非推奨にしたりできますが、自分で作成していないライブラリに対してはそうすることはできません。

例として、2つのオーバーロードを提供するライブラリを使用します。

acme.calculate(int quantity_, double priceInUsDollars_);
acme.calculate(int quantity_, string currencyCode_, double priceInCurrency_);

私たちは開発者が常に最初のものを使用して、私たち自身の標準的な為替レートシステムから米ドルで価格を得ることを望んでいます。そして、IDE（Eclipse / Visual Studio）が最初の開発者を使用するときに開発者に警告するのは良いことです。コンパイラの警告でも十分です。

今のところ、現状では、コードレビュー担当者にそのようなエラーを発見してもらう必要があります。ご覧のとおり、これは信頼できるアプローチではありません。

準備ができている1つの方法は、独自のチェックスタイルチェック（http://checkstyle.sourceforge.net/writingchecks.html）を記述することです。でも、何か使えるシンプルなものはないのかと思っていました。私が説明したようなIDE /コンパイラの警告を達成する方法を知っている人はいますか？

IDE /コンパイラ以外のソリューションは大歓迎です。

NDepend / JavaDependなどのツールを使用して、カスタムCQLクエリを記述し、これらの非常に特殊なケースに対して警告を生成できます。

質問で、IDE /コンパイラに開発者に警告することを望んでいると述べました。NDepend / JDependはIDEと緊密に統合されているので、これで問題が解決するかもしれません。

「ホワイトリストアプローチ」：ラッパーライブラリをライブラリに書き込みます。ライブラリ自体と基本的に同じインターフェイスシグネチャを使用しますが、禁止されている関数は除外します。ラッパーは、各メソッド呼び出しを対応するライブラリ呼び出しに委任する必要があります。次に、開発者が元のlibではなく、そのラッパーのみを使用/リンクできるようにします。ラッパーは、ライブラリー拡張の適切な場所でもあります。

libが数百の関数を持つ非常に大きなAPIを持っている場合、それは実用的ではないかもしれません。次に、提案した「チェックスタイル」ソリューションのような「ブラックリストアプローチ」を実装します。

JavaのReflectionの強力な機能の1つは、実行時にメソッドのプロパティを変更できることです。使用方法の1つは、プライベートメソッドをパブリックにして、とにかくそれを使用できるようにすることです。実行時に不要なメソッドをプライベートにすることで、逆にうまく機能する可能性があります。コンパイル時には表示されませんが、プロジェクトがテストされるとすぐに表示されます。

この記事では、実行時にメソッドのプロパティを変更する方法を示します。ここに興味深い部分があります：

Class theClass = MyClass.class;
Class[] paramTypes = { Integer.TYPE, String.class };
Method method = theClass.getDeclaredMethod("myMethodName", paramTypes);
method.setAccessible(false); // this makes the metod private
System.out.println("Making method  myMethodName(int,String) private");

これらの方法を使用することは、このプロジェクトでは推奨されないことを開発者に覚えておいてください。

場合によっては、すでに置換メソッドを作成する必要があるため。ライブラリ全体のラッパークラスを作成し、ラッパークラスのみを使用します。

ライブラリが更新された場合は、とにかくコードを更新する必要があります。ラッパークラスは更新が簡単です。

それでも、開発者が間違ったメソッドを使用するのを回避できます。開発者は、使用することを想定していないメソッドを覚えておくことができるはずです。