方法文档中

Question

有些时候，我发现Java doc和Android doc在方法文档中存在问题差异。例如，在大约setReadable (boolean readable, boolean ownerOnly)方法中，您可以看到java doc说：

  

抛出：SecurityException - 如果存在安全管理器及其   SecurityManager.checkWrite（java.lang.String）方法拒绝写入   访问文件

但Android docs没有说任何关于抛出异常的事情。我们也知道Docs say：

  

方法可以抛出的任何异常都是方法的一部分   公共编程接口。那些称之为方法的人必须知道   方法可以抛出的异常，以便他们可以决定要做什么   做他们。

因此，当我们在方法的Android文档中没有看到任何抛出条件时，

1. 这是否意味着方法不会以任何方式抛出异常？或者它可能会被遗忘？
2. 我们是否需要检查文档以获取Java和Android之间概率差异的任何简单方法？是否可以？

Answer 1

您可能已经知道，由于代码的关闭，代码可能会在运行时出现异常。简而言之，您可能正在安全且正确地使用方法，但是围绕它的特定代码块可能容易受到某些异常和条件的影响。此外，Android文档可能会受到本机java库和apis的糟糕引用的影响。因为他们认为您是一位经验丰富的Java开发人员并且熟悉使用javadoc。

Answer 2

如果您转到setReadable（bool，bool）的声明，您将看到异常被捕获并返回false。因此，在这种情况下，Android文档取代了Javadoc。