这是跟系上学弟在讨论java後 , 有感於api的重要以及对於新手时期的窒碍， 所以顺手写的文件 , 分享给各位新入门的同好. 对任何 java JDK default 的Class 如果有疑惑 , 一定要先好好翻过api document. API 网址 (for jdk 1.5 , 不过1.5後版本差异对新手应该还好.) http://java.sun.com/j2se/1.5.0/docs/api/ ──────────────────────────────── 左下角是全部Class的名字 点选後会出现介绍在右边 右边最重要的是 Method Summary 那区 前面的int/String 是回传的型态(return type) , 蓝字的是包含传入参数 (parameter) 的函式名称(method name). 注：要阅读 api document , 最起码最起码应该对 method 有最基本的认识, 了解什麽是传入参数 (parameter) 跟 回传型态 (return type). ──────────────────────────────── 一张简单的结构简图 , 预设右方是显示packagelist , 不过此处讲的是点选左下特定类别名称(class name)之後的查询画面. ┌─────┬────────────────────┐ │package │ class name │ │ │ implements interface │ ├─────┤ 类别的说明... │ │ │ │ │ClassName │ Field Summary │ │ │ 静态成员变数表 │ │ List │ Constructor Summary │ │ │ 建构子一览表 │ │ │ Method Summary │ │ │ 类别函数一览表 │ │ │ Methods inherited from │ │ │ 继承来的函数一览表 │ │ │ │ │ │ Field Detail │ │ │ 静态成员详细资料 │ │ │ Constructor Detail │ │ │ 建构子详细资料 │ │ │ Method Detail │ │ │ 函式详细资料 │ └─────┴────────────────────┘ *深灰色字是新手还可以不用太花脑力去了解的区域. ──────────────────────────────── 一开始会不太习惯，但只要你知道如何查类别函式(method) 用途後 ，它会变得很亲切 。 底下是一个step by step的查询体验 以查询 String.indexOf() 为例 ──────────────────────────────── 1.左下角找到名字确实符合String的资料後点选 (hint. 可以先点左下角的区域 , 再用ctrl+f打类别名称搜寻 ,ex.String. ) 2.右边往下翻到有indexOf字眼的位置 你应该会在 method Summary 区找到几个符合的,底下列出其中两个做说明。 int 回传型态 indexOf(int ch) 函数名称 Returns the index within this string of the first occurrence of 函数摘要 the specified character. 注：回传这个char在指定字串出现的第一个位置索引值 常用的会是这个 indexOf(String str) 我觉得需要介绍的是这个 indexOf(String str, int fromIndex) int indexOf(String str, int fromIndex) Returns the index within this string of the first occurrence of the specified substring, starting at the specified index. 注：return 这索引值在这字串中的特定位置 , 从指定的索引指开始. ──────────────────────────────── 最少最少，它可以很快的告诉你它这个函式的 input / output， 还有它设计的目的与用意，当然它还有提供更多能详细参考的资料， 但这部份可能要读者研究 javadoc 的格式与那些资料的意义才比较好说明。 api 算是扮演着你设计时或者是在别人丢了keyword或函数名之後 , 你可以去查询的方向 ,新手想要精进自己功力 , 一开始请千万务必要跟api document好好相处. -- 文末补注：对英文有困扰者，请善用雅虎字典 http://tw.dictionary.yahoo.com/ ， 并发挥中文训练中的有边读边没边读中间的试误精神来阅读， 通常都不会差的太离谱. -- What do you want to have ? / What do you have? 从书本中，你可以发现我的各种兴趣。 从ＣＤ中，你可以了解我所喜欢的偶像明星。 或许从文字你很难以了解一个人，但从物品可以。 My PPolis , My past. http://ppolis.tw/user/Tony --

※ 发信站: 批踢踢实业坊(ptt.cc) ◆ From: 221.169.78.140 修饰几行写得太随性的句子...:p ※ 编辑: TonyQ 来自: 221.169.78.140 (11/29 18:05) ※ 编辑: TonyQ 来自: 221.169.78.140 (11/29 18:07)