快速业务通道

Eclipse中的API Tools:简介 - 编程入门网

作者 佚名技术 来源 NET编程 浏览 发布时间 2012-06-14
ipse 安装一样简单。当 API Tools 扫描插件时,它将为您动态生成一个基准。在设置基 准后,需要让 Eclipse 项目利用 API Tools。注意,此过程也可以作为构建系统的一部分以无序方式完 成,但是这不在本文讨论范围内,并且建议查阅 API Tools wiki 以获得更多信息(请参阅 参考资料) 。

图 2. 添加 API 基准

Eclipse中的API Tools:简介 - 编程入门网

Eclipse中的API Tools:简介(3)

时间:2011-11-09 IBM Chris Aniszczyk

添加 API Tools 项 目属性

要查看与 API Tools 相关的任何错误或警告,您的项目需要添加 API Analysis 属性和构 建器。这可以通过两种方法完成,并且依赖于是否要将 API Tools 应用到现有项目中。如果与现有项目 结合使用,建议的方法是使用 API Tooling Setup 向导(参见图 3)。右键单击项目并选择 PDE Tools > API Tooling Setup 可以访问该向导。在向导中,只需单击想要转换为使用 API Tools 的项目并单 击 Finish。这就完成了!

图 3. API Tooling Setup 向导

Eclipse中的API Tools:简介 - 编程入门网

也可以在创建插件 项目时利用 API Tools。在 Eclipse V3.4 中,New Plug-in Project 向导增加了额外的复选框 Enable API Analysis 把 API 分析属性添加到项目中。

图 4. 新插件项目向导中的 API Tools

Eclipse中的API Tools:简介 - 编程入门网

Eclipse中的API Tools:简介(4)

时间:2011-11-09 IBM Chris Aniszczyk

使用 API Tools

现在我们知道如何将项目设为使用 API Tools,让我们查看一些示例,了解 API Tools 是如何帮助我们的。API Tools 拥有一组注释,您可以在各个 API 元素中使用这些注释以增强限 制。

表 2. API 限制

注释 有效的 API 元素 描述
@noimplement 接口 表示客户端不能实现此接口。使用关联接口的 implements 或 extends 关键字的所有类将被标记为有问题。
@noextend 表示客户端不能扩展该类。使用关联类的 extends 关键字的所有类将被标记为有问题。
@noinstantiate 表示客户端不能初始化该类。用任何构造函数 初始化关联类的所有代码将被标记为有问题。
@nooverride 方法 表示客户端不能重新声明该方法。定义覆盖关联方法的方法的所有子类将被标记为有问题。
@noreference 方法、构造函数和字段(非最终) 表示客户端不能 引用此方法、构造函数或非最终字段。直接调用关联方法或构造函数,或者引用关联的非最终字段的所有 代码将被标记为有问题。

现在您已经知道了可用的 API 限制注释,让我们看 看一些示例,了解它们在现实世界中是如何工作的。

API 限制示例

让我们从一个非常简单 的示例开始,如带有允许生成小部件的 API 的插件。

清单 1. IWidget.java

package 

org.eclipse.example.widgetfactory;
/**
* A simple widget
*
* @noimplement
*/
public interface IWidget {
  
  public String getName();
  
  public long getId();
}

Eclipse中的API Tools:简介(5)

时间:2011-11-09 IBM Chris Aniszczyk

在本例中,小部件只有名称和标识符。用限制注释接口,可以告诉客户端不实现此接口,因为 我们需要客户端实现以下的抽象小部件。

清单 2. AbstractWidget.java

package 

org.eclipse.example.widgetfactory;
/**
* An abstract widget
*/
public abstract class AbstractWidget implements IWidget {
  
  /**
   * @nooverride
   */
  public lon

凌众科技专业提供服务器租用、服务器托管、企业邮局、虚拟主机等服务,公司网站:http://www.lingzhong.cn 为了给广大客户了解更多的技术信息,本技术文章收集来源于网络,凌众科技尊重文章作者的版权,如果有涉及你的版权有必要删除你的文章,请和我们联系。以上信息与文章正文是不可分割的一部分,如果您要转载本文章,请保留以上信息,谢谢!

分享到: 更多

Copyright ©1999-2011 厦门凌众科技有限公司 厦门优通互联科技开发有限公司 All rights reserved

地址(ADD):厦门软件园二期望海路63号701E(东南融通旁) 邮编(ZIP):361008

电话:0592-5908028 传真:0592-5908039 咨询信箱:web@lingzhong.cn 咨询OICQ:173723134

《中华人民共和国增值电信业务经营许可证》闽B2-20100024  ICP备案:闽ICP备05037997号