java新手有四问
我是不理解。谢谢了，请高手指点一番：
1。为何所有的函数在java api中，而不是叫java Manal手册，因为php,css,html5都用自己的权威规范手册。
2。为何java api中每个函数连个示例都没有？如String 中的equals
3。所有已实现的接口是何意？我老师说过，一个类内的接口要全部实现，才是成功正确的类。其java api中写明“所有已实现的接口：”是何意？
4。java api的组织方式为何要这般乱：包->类->函数？为何不能像php,css手册的一样，即所有的函数名列在一起，直接搜索即可。

------最佳解决方案--------------------
1。为何所有的函数在java api中，而不是叫java Manal手册，因为php,css,html5都用自己的权威规范手册。
——Java的API说明，一样是权威规范的。而且是用JavaDoc自动生成的。此外Java还有语言规范和虚拟机规范，都是官方站点的，同样权威：http://docs.oracle.com/javase/specs/

2。为何java api中每个函数连个示例都没有？如String 中的equals
—— 又不是开发指南或教学文档。

3。所有已实现的接口是何意？我老师说过，一个类内的接口要全部实现，才是成功正确的类。其java api中写明“所有已实现的接口：”是何意？
—— 不知道你是哪里看来的这句话，不能理解其上下文。另外不清楚你是否知道 接口 跟 类 的区别和关系。

4。java api的组织方式为何要这般乱：包->类->函数？为何不能像php,css手册的一样，即所有的函数名列在一起，直接搜索即可。
—— Java功能众多，如果没有包进行划分，类名怕是要长达50～60个字母还不够用。
—— Java是面向对象的，所以所有的能力都必须基于某对象（类的实例）。
—— 总的来说：你想想CSS有几个标签，然后Java的API总共有多少类和函数？
------其他解决方案--------------------
2。为何java api中每个函数连个示例都没有？如String 中的equals

其实我觉得API已经说明的还详细了，为什么非有举例你才能明白的？你可以通过自己尝试，这样印象更深。
------其他解决方案--------------------
2。为何java api中每个函数连个示例都没有？如String 中的equals
—— 又不是开发指南或教学文档。

其实对这一点我也有些不爽，像Qt的API文件就做得非常好。
------其他解决方案--------------------
这只是文档的深入有所区别罢了