jdk的文档让我无语

Question

JDK帮助很丰富，但是却不详细，甚至可以说是相当不人性化，　比如我要查一个Color.getColor的帮助，得到如下内容：public static Color getColor(String nm)查找系统属性中的一种颜色。 ...
　　　　　　其中的参数　nm 是颜色属性的名称　，　它是字符串，那么它可以取哪些值呢，显然，我无从查起，

Answer 1

jdk 也只是起一个辅助作用.
具体问题还的靠自己解决.

Answer 2

java的帮助的确不够人性化,不是很明了...

Answer 3

nm 这是系统属性的名称，在使用 java -D 参数时进行配置的比如：
java -Dmy.color=0xff0000 Test在 Test 中用：
Color color = Color.getColor("my.color");就可以得到所配置的红色了。当然了，类库把  System.getProperty("my.color"); 得到字符串值，再转换成数字，
再将数字构造成 Color 就在内部完成了。数字转化成 Color 是采用 Color(int r, int g, int b) 这个构造来完成的。PS：如果不明白的话，看看源代码就知道怎么回事了。

Answer 4

看了下,确实很恶心.
     * @param    nm the name of the color property
     * @param    v    the default <code>Color</code>
     * @return   the <code>Color</code> converted from the system
     * property, or the specified <code>Color</code>.
     * @see      java.lang.System#getProperty(java.lang.String)
     * @see      java.lang.Integer#getInteger(java.lang.String)
     * @see      java.awt.Color#Color(int)
     * @since    JDK1.0
1.0年代的产物
这里只有小小的暗示
通过java.lang.System#getProperty可以知道这是要取系统标准颜色
通过查java.awt.Color#Color发现取系统标准颜色其实可以这样
Color.BLUE;
最后发现其实这个方法没啥用哈哈还不如用这个呢
Color.getHSBColor(h, s, b);

Answer 5

晕死哦，死人的 CSDN 我昨晚打了半天的字，在 13 楼，今天竟然没了，从 12 楼直接跳到 14 楼了？？？实际上 public static Color getColor(String nm) 这个方法是获得系统参数配置的颜色。需要在运行时设定系统参数，这样使用：
F:\Java>java -Dbutton.bgColor=0xff0000 Test在 Test 代码中可以使用
Color color = Color.getColor("button.bgColor");得到所配置的红色了，这样做的好处是可以很方便地进行颜色的配置。归根溯源，这个方法实际上做了以下几件事情：
1，使用 System.getProperty 获得系统参数；
2，使用 Integer 的静态方法将其转为一个 Integer 数字；
3，最后使用 Color(int r, int g, int b) 这个构造将数字转为 Color。PS-1：有些东西看不明白的话，可以解开 src.zip 看看他们的源代码就可以了，呵呵。
PS-2：希望这次回复时不会没有。

Answer 6

高手就是不一样啊,同样的文字理解就差远了,呵呵,我还以为像swt中的系统标准颜色呢.还在奇怪为什么property 中没有,晕倒啊.

Answer 7

其实应该说jdk的大部分基本内容比较简单，但是学习的时候很吃力。
感觉不是jdk晦涩、而是英文的隔阂以及我们和外国同行的差异导致。

Answer 8

JDK的javadoc工具也该更新一下了，生成的HTML代码完全没遵守现有HTML或XHTML任意版本的标准，中文版的翻译实在可怜，现在不得不看英文版的，阅读速度虽然慢，但不致出现歧义，好在还有类库源码！