我正在编写一组函数,用于在我的Android应用程序中访问/写入SQLite数据库。由于我需要使用 getWritableDatabase()
来获取数据库实例,并且需要在非 UI 线程中调用它,我想知道是否有一种干净的方法来在这些函数的 java 文档中指定相同的警告?
另外,我需要进一步澄清有关使用 getWritableDatabase()
获取数据库实例句柄的信息。我应该在我需要将东西写入数据库的地方调用它,对吗?或者我可以在应用程序级别调用一次,并使用相同的句柄在应用程序中的不同位置访问 db?
这些事情没有固定的规则。您只能依靠约定/样式。
换句话说:尝试提出明确,明确的措辞,并确保这部分易于阅读并在javadoc中快速发现(检查生成的HTML以及这些属性(。
然后准备好忽略你的javadoc的人的错误报告。
与其在javadoc中留下警告,不如添加验证,即检测您是否在UI线程上(请参阅如何检查当前线程是否不是主线程(,然后抛出异常。
记录该异常。