已发布的实体

From Apache OpenOffice Wiki
Jump to: navigation, search


OpenOffice.org 2.0 的一项新功能是 UNOIDL published 关键字。如果将(结构、接口、服务等的)声明标记为 published(已发布),必须保证在将来不更改声明,这样 API 客户才会信赖它。另一方面,不发布声明就如同给客户一个警告:在将来的 API 版本中,声明的实体可能会发生更改甚至消失。如果尝试在已发布的实体声明中使用未发布的实体,idlc 会给出错误,因为那样没有意义。


OpenOffice.org API 始终不欲更改成为不兼容的方式。现在,发布在以前的 API 版本中已存在的 OpenOffice.org 2.0 API 的所有实体正式说明了这一点。API 中新增的某些实体尚未发布,然而对于文档来说,它们可能还不是最终形式。使用这样的新增实体时,请牢记:使用 OpenOffice.org 的新版本时可能需要调整代码。但是,通常 OpenOffice.org API 的每一部分都不应随时间而变化,所以每一个新增实体最终都应该发布。在尝试尽快使新功能可用时可以考虑使用此方法,但同时也要确保 API 在被完善成为真正可用的实体之前不会贸然地被定形。

Content on this page is licensed under the Public Documentation License (PDL).
Personal tools
In other languages