Question

怎么把Java源代码封装成api的形式

比如我用javamail开发出了邮箱收发两个类怎么把封装成api?

Answer 1

1. 源代码应该是写在一个类里边的，通过myeclipse或者是eclipse来打包成jar包，

2. 然后把jar包导入到项目工程中，

3. 直接写类名，然后会提示导入该类所属的包，这样就可以的噢。

  平时的源码封装和使用是这样子的。

Answer 2

1.把你写的东西写好注释，java中的注释的集中格式你必须知道，那些注释或在API中出现，那些不在必须明白
公用方法和类前面的注释应该是
/**
* something... 这种格式的
*/
你应该是用的是eclipse把，或者myeclipse
点击右键，选择 export（到出）-》java-》jar
生成jar文件

点击右键，选择 export（到出）-》java-》javadoc
生成java API，也就是你看到的类似java API之类的东西
当然你还可以有其他方法。

Answer 3

留几个类开放一些静态方法，或者是public的构造方法
然后在文档里说明其用途
然后打个jar包就可以了嘛

被人要用直接导入你的jar包，然后调用你的类的静态方法，或者new一个你的类，按照那个类的对应的方法进行操作

Answer 4

为自己的类生成注释文档，即生成javadoc文件。
第二的介绍可以生成自己的类库了。但是时间久自己写的类和方法就会忘记，生成一个高质量的注释文档就很有必要的。庆幸的是Java自己就能很好的完成这一功能，能帮我们生成类似API的文档，即javadoc文档。下面介绍一下在Eclipse中如何生成javadoc文档：
1、对类进行注释
在生成javadoc文档之前首先要对类进行注释。注释有如下三种方式：
a，//注释内容；b，/*注释内容*/；（快捷键：选中要注释的内容后按“shift+Ctrl+/”,取消注释是“shift+Ctrl+\”）
c，
/**
*注释内容。
*/
其中只有c方式在生成javadoc中才有用。以我自己写的ArrayQueue类为例说明一下几种注释，只需要对public方法和变量进行注释，因为只有public类型才能被其他类访问。
（1）、在类前面注释类说明和创作者，如

[java] view plaincopy
/**
* 文件的复制，字符串输入到文件中，将文件内容打印到控制台
*
* @author xiaoxu
*
*/
（2）、在public方法前面注释方法的说明，如public static String readFile(File file)方法注释：
/**
* 读取一个文件里的内容
*
* @param file
* 要读的文件
* @return 返回读取文件的字符串
*/
（3）、注释对public变量进行注释，假设有一表示窗口宽度的变量WIDTH，如下注释
/**
* 主窗口的宽度
*/
public static final int WIDTH = 1000;

部分结果如下

图八（1）
2、用Eclipse生成javadoc文档
选中要生成javadoc文档的项目，再在菜单栏中的选择菜project\Generate Javadoc…。打开对话框后“javadoc command”的默认路径是C:\jdk\bin\javadoc.exe，如果没有该路径就自己添加，找到自己安装JDK的根目录下的bin\javadoc.exe，如下图

图8（2）

选择要生成javadoc的文件，然后选择导出的路径，一般选择默认的项目下的doc文件夹，改成其他路径可能会有错。如下：

图8（3）
之后就一路next，最后点finish就OK了。在这期间可能会出现警告，如下图

图8（4）
选择“Yes To All”。

四、如何使用自己创建的类库？
通过一、二、三，已经能够创建自己的类库了。下面说明一下如何使用自己的类库。
方法一：
假设现在要创建一个项目Test,里面要用到自己类库tools.jar中的S类。新建一个类Test.java,里面的main方法是这样的：

[java] view plaincopy
public static void main(String[] args) {
S.pl("java"); //S类中的S.pl()封装了System.out.println(obj);
}

这时Eclipse会报错，会说S这个类不存在，是否要创建这个类。这是因为默认的JRE并不存在tools.jar这个包，如图八。

图八（5）
那么如何将这个包夹道默认的JRE System Library中呢？
选择Window\ Preferences,打开对话框，选择Java\Installed JREs，如图九

图九
接下来，点击“Add”添加一个新的JRE，选择Standard VM后点击下一步，在JRE home中点击Directory选择JDK按钮路径下的jre文件夹（即包含rt.jar的文件夹，rt.jar是jdk的根文件夹，里面包含了所有的基本类）如图，然后点击“Add External JARs”选择生成好的tools.jar文件（最好先别tools.jar放在一个比较访问，比较安全的文件夹内，我的是直接放在JDK安装路径下的D:\IT\JDK6.0\java(TM) SE Development Kit\myJar里），如图十

图十
点击finish。
然后，在Test项目中将默认的JRE System Library换成刚刚配置好的JRE，右击Test选择Build Path选择Configure Build Path…,打开对话框，将原有的JRE Remove掉，然后Add Library，选择JRE System Library，下一步，点击“Installed JREs”后选择刚刚配置好的那个JRE，点击finish。
现在就配置好了。此时的JRE就能看到tools.jar文件，如下图：

图十一
方法二：
将刚刚生成的自己的类库Tool.jar直接拷贝到JDK和JRE的安装目录中的jre/lib/ext/中，这时候我们需要重启一下Eclipse，这样才能将刚才的那个包加载进自动生成的系统库中。