今天一下午都在整java的api。
我的目标是在eclipse平台中用鼠标点击java的api就会自动显示出中文的注释。并且能在help中方便地搜索java的api。 这其实是使用bada开发平台后留下的后遗症。
最终结果是没有得到满意答案,发现最方便的方法还是另外开一个chm中文api文档。
下面我讲述一下整个下午我的三个收获。
Application Programming Interface,应用程序编程接口在安装jdk(java development kit)的时候,
图2.安装选项框
把中间两个功能选中就可以在安装完成后在根目录中看到两个文件夹Sample和Demo。里面就是示例程序。
图3,安装后出现的文件夹
并且可以在eclipse中把鼠标移到api自带方法时会弹出api说明。
图4,弹出api说明
二:在Eclipse帮助文档中加入API_doc文档。
首先下载API_doc文档。
地址:/f/7140029.html (2012.6.13) (感谢无偿贡献的网友)
文件有点大30M且只支持浏览器下载。
之后就是
||在eclipse/plugins/下建立一个目录org.sun.java.doc.sdk_1.5.0,然后在这个目录下创建两个文件 plugin.xml 和toc.xml。plugin.xml文件内容:<?xml version="1.0" encoding="UTF-8"?><?eclipse version="3.0"?>
provider-name="">
toc.xml文件内容:<?xml version="1.0" encoding="UTF-8"?><?NLS TYPE="org.eclipse.help.toc"?> 然后将下载的jdk1_50doc.zip改名为doc.zip后放在与刚创建的两个文件相同目录下。注意,文件名一定要是doc.zip,zip 文件里面应该有这样的目录层次结构:jdk1_50doc/index.html然后重启Eclipse即可在帮助文档中看到api||
(竖线分隔部分转自博客园Byron lee:
/byronlee/archive/2011/03/07/1975185.html 特此致谢,有部分改动)
图5,新出现的目录
可惜的是这个方法导进去的api并不能通过搜索的方法寻找对应方法。因此不如另外打开一个chm文件。
三:通过动态帮助打开api
这个方法比较接近于直接弹出说明。但是仍然不是很方便,下面说具体操作。
|| 1.打开首选项:Window-Perferences 2.定位到jre:Java-Installed JREs 选中你已有的要添加java API的jre或jdk(如果你有多个jre和jdk)。 3.编辑属性:单击右方的Edit,出现Edit JRE对话框,如果你是新建,出现New JRE对话框也一样。这时下方会出现一列jar包,例如X:/Program Files/Java/(jre/jdk版本)/jre/lib/rt.jar。单击rt.jar包选中,然后单击右方的Javadoc Location。 4.填写Java API位置,Javadoc URL方式是Java API的网络地址或本地Javadoc解压后的地址。Javadoc in archive是下载到本地的Javadoc压缩包地址,然后在Path within archive中填写API在压缩包内部的结构,一般为docs/API,也可以通过Browse更方便地导入。 5.试试在Eclipse中写几句代码,然后单击你要查API的类或方法名,F1一下,是不是能很快地定位到help,第