Jakarta EE中的规范范围
使用Eclipse Foundation Specification Process (EFSP),一個開放源代碼規(guī)范項目就有一個專門的提交者項目團(tuán)隊來創(chuàng)建和維護(hù)一個或多個規(guī)范。 創(chuàng)建和維護(hù)的周期跨越了該規(guī)范的多個版本,因此盡管各個成員可能來去去去,但團(tuán)隊仍然存在,由該團(tuán)隊負(fù)責(zé)創(chuàng)建的該規(guī)范的每個版本。
管理知識產(chǎn)權(quán)如何流經(jīng)規(guī)范的第一步是定義規(guī)范所涵蓋的工作范圍。 根據(jù)Eclipse 知識產(chǎn)權(quán)政策 ,需要很好地定義和捕獲這一工作范圍(稱為作用域 )。 定義范圍后,范圍將被有效鎖定(可以對范圍進(jìn)行更改,但很少更改,必須仔細(xì)管理;可以對規(guī)范的范圍進(jìn)行調(diào)整和更改,但這需要得到Jakarta EE工作組的 規(guī)范委員會的批準(zhǔn)) 。
關(guān)于范圍,EFSP聲明:
除其他事項外,規(guī)范項目的范圍旨在通知公司和個人,使他們可以確定是否對規(guī)范做出貢獻(xiàn)。 由于范圍的改變可能會改變對項目的貢獻(xiàn)的性質(zhì),因此對規(guī)格項目范圍的改變必須得到規(guī)格委員會的絕大多數(shù)同意。
通常,范圍聲明不應(yīng)太精確。 相反,它應(yīng)該廣義地描述本說明書的意圖。 將范圍聲明視為執(zhí)行摘要或“電梯提示”。
電梯間距:您的電梯門在地板上打開前有15秒鐘的時間; 告訴我您的規(guī)范所解決的問題。
作用域聲明必須回答以下問題:該規(guī)范的實現(xiàn)有什么作用? 范圍聲明必須是理想的,而不是試圖在任何特定時間點捕獲任何特定狀態(tài)。 范圍聲明不能只針對規(guī)范的任何特定版本計劃的工作,而應(yīng)定義規(guī)范旨在解決的問題空間。
例如:
Jakarta Batch提供了描述在Jakarta EE應(yīng)用程序中執(zhí)行和管理批處理過程的方法。
和:
Jakarta消息服務(wù)描述了Jakarta EE應(yīng)用程序通過松散耦合的可靠異步通信服務(wù)創(chuàng)建,發(fā)送和接收消息的方法。
對于scope語句,可以假定讀者對該領(lǐng)域有基本的了解。 例如,期望讀者理解“批處理”的含義是合理的。
我應(yīng)該注意,上面介紹的兩個示例只是形式的示例。 我非常確定它們是有道理的,但是請項目團(tuán)隊與他們的社區(qū)合作以整理出最終形式。
在整個規(guī)范生命周期中,作用域都是“粘性”的:它涵蓋了各個版本。 任何特定開發(fā)周期的計劃必須描述范圍內(nèi)的工作 ; 并且在檢查點(進(jìn)度和發(fā)布)審核中 ,項目團(tuán)隊必須準(zhǔn)備證明規(guī)范描述(并通過相應(yīng)的TCK測試)所描述的行為完全屬于范圍內(nèi)(請注意,規(guī)范項目的開發(fā)生命周期為在Eclipse Foundation Specification Process分步指南中進(jìn)行了介紹 。
除了Eclipse知識產(chǎn)權(quán)政策和EFSP所要求的規(guī)范范圍外,擁有并維護(hù)該規(guī)范的規(guī)范項目還需要一個項目范圍 。 我認(rèn)為項目范圍非常簡單:特定的規(guī)范項目定義并維護(hù)了一個規(guī)范。
例如:
Jakarta Batch項目定義并維護(hù)Jakarta Batch規(guī)范和相關(guān)工件。
像規(guī)范范圍一樣,項目范圍也應(yīng)該是理想的。 在這方面,規(guī)范項目永久負(fù)責(zé)特定的規(guī)范。 另外相關(guān)的工件,如API和第三文化孩子可以在沒有范圍實際上是由該項目現(xiàn)在管理。
例如,今天,大多數(shù)針對Jakarta EE規(guī)范的TCK都已納入Jakarta EE TCK項目。 但是,隨著時間的流逝,可能會分解單個怪獸TCK,并將各個TCK移至相應(yīng)的規(guī)格項目。 或不。 關(guān)鍵是,無論當(dāng)前在何處維護(hù)技術(shù)工件,它們有一天可能會成為規(guī)范項目的一部分,因此它們屬于范圍 。
我應(yīng)該備份一下,我們現(xiàn)在的意圖是將我們管理著與各種規(guī)范相關(guān)的工件的“ Eclipse Project for ...”項目轉(zhuǎn)變?yōu)閷嶋H的規(guī)范項目。 作為這項工作的一部分,我們將Git存儲庫添加到這些項目中,以提供規(guī)范文檔的目錄(稍后將對此進(jìn)行詳細(xì)介紹)。 目前,這些原型規(guī)范項目中有少數(shù)包含與多個規(guī)范相關(guān)的工件,因此我們必須理清對這些項目范圍語句要做什么。
例如,我們可能會考慮將Jakarta EE Stable API的項目范圍更改為簡單的內(nèi)容(請注意,我正在猜測將來的新項目名稱):
Jakarta EE穩(wěn)定API提供了穩(wěn)定的(舊式)Jakarta EE規(guī)范和相關(guān)工件的源頭,這些規(guī)范和相關(guān)工件不再被積極開發(fā)。
但是,除了所有關(guān)于規(guī)范項目的討論之外,我們的最初重點應(yīng)該是描述規(guī)范本身的范圍。 考慮到這一點,EE4J PMC創(chuàng)建了一個項目委員會,其中包含一些問題來跟蹤這項工作,我們將要求項目團(tuán)隊開始與他們的社區(qū)合作,將這些范圍聲明放在一起。 如果您對特定規(guī)范的范圍聲明有任何想法,請權(quán)衡一下。
請注意,我們現(xiàn)在處于一種奇怪的狀態(tài)。 在我們努力重命名規(guī)范(以及相應(yīng)的規(guī)范項目)時,尚不清楚我們應(yīng)該稱呼什么。 您會注意到,已經(jīng)創(chuàng)建的問題都使用了我們猜想最終將要使用的名稱(有關(guān)“ 重命名Jakarta EE的Java EE規(guī)范”中的更多信息)。
翻譯自: https://www.javacodegeeks.com/2019/04/specification-scope-jakarta-ee.html
總結(jié)
以上是生活随笔為你收集整理的Jakarta EE中的规范范围的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 带有Oracle Digital Ass
- 下一篇: 孕妇梦见老鼠是胎梦吗 孕妇梦见老鼠可能是