Eclipse RCP教程 – 04 – Eclipse API和内部API

4 Eclipse API和内部API

OSGi允许开发者将Java包标记包为公开(Public)、临时(Provisional)或内部(Internal)API。Internal API是私有(Private)的,因此是不可见的。Provisional API用于测试非finalized(no-finalized)API,因此它们是可见的,但并不可靠。Public API或者被称为简单API是可见且稳定的API,它们可以被其它组件重用。

20170319_003

Eclipse平台工程(Eclipse Platform Project)会将包标记为Public 或Provisional API,使得所有的Java类对Eclipse开发者都是可见的。如果Eclipse Platform Project发布了一个API,则会尽量确保该API是稳定的。

如果API是Internal且可用的,即被标记为Provisional,则平台项目组可以在未来改变此API。如果你使用了这种API,则你必须做好心理准备,可能在未来的Eclipse发布后需要对你的应用程序进行调整。

如果你使用了未发布的API,你会在Java编辑器中看到一个不建议访问的警告(Discouraged access: The …​is not API (restriction on required project …​))。

 20170319_004 你可以在工作空间中关闭这些警告,通过Window ▸ Preferences ▸ Java ▸ Compiler ▸ Errors/Warnings菜单项将Discouraged reference (access rules)标记设置为Ignore。20170319_005

另外,你还可以在每个工程上关闭这些警告,通过右键单击项目,选择弹出菜单的Properties ▸ Java Compiler菜单项,然后访问与上面全局设置相同的参数路径进行设置。你可能需要勾选在Error/Warnings设置页面上方的Enable project specific settings单选框。

打赏一下
支付宝
微信
除非注明,博客文章均为原创,转载请标明文章地址
本文地址: http://www.javafxchina.net/blog/2017/05/eclipse-rcp-04/
百度已收录