Javaのドキュメントで、メソッドが非UIスレッドから呼び出されるように指定する方法はありますか？

Question

私はAndroidアプリケーションでSQLiteデータベースにデータをアクセス/書き込みするための関数を書いていました。私はgetWritableDatabase()を使用してデータベースインスタンスを取得する必要があります。これはUI以外のスレッドで呼び出す必要があるため、これらの関数のjavaドキュメントで同じ警告を指定する明確な方法があるのだろうかと思いました。

さらに、getWritableDatabase()を使用してデータベースインスタンスを処理する方法についてもう少し明確にする必要がありました。私はデータベースに物事を書き込むために必要なところでこれを呼び出すべきですか？または、アプリケーションレベルでこれを一度呼び出すことができますし、同じハンドルを使用して、アプリケーションのさまざまな場所でdbにアクセスできますか？

Answer 1

このようなものには一定の規則はありません。あなたはコンベンション/スタイルだけに頼ることができます。

言い換えれば、明白で明確な用語を思いついて、この部分が読みやすく、javadocですばやく見つかるようにしてください（生成されたHTMLもこれらのプロパティでチェックしてください）。

そして、javadocを無視している人からのバグレポートを用意してください。

Answer 2

javadocに警告を出すのではなく、検証を追加することができます。つまり、UIスレッド（How to check if current thread is not main threadを参照）にいるかどうかを検出して例外をスローします。

例外を文書化してください。