1. 程式人生 > >Jersey 2.x 前言和約定的文字格式

Jersey 2.x 前言和約定的文字格式

這是Jersey 2.x 的使用者指南。我們極力將它能與我們新增的功能保持一致。當閱讀本指南,作為補充,也請移步至 Jersey API documentation 檢視 Jersey 的特性和 API。

歡迎任何對本指南的建議和提問,可以聯絡[email protected],同樣的,發現勘誤,也可以在Jersey JIRA Issue Tracker 提問,請注意需要在 docs 文件元件部分中進行提問。

請注意,在提問的時候需要註明你有疑問的 Jersey 使用者指南的版本,你在哪裡發現的錯誤,同時請註明影響到的那個版本。

約定的文字格式

首先需要說明的是,任何 Jersey 和 JAX-RS API 的元件將會在參考元件中連結到 API 文件。任何元件下面的子元件將會使用非寸線字型。

Emphasised 字型被使用在第一次出現的介紹中。

在一些程式碼的列表中,有些程式碼太長而不能在一行中完整顯示下來的話,程式碼行將會擴充套件到下一頁或者下一段中,我們將會用  '\'  標識在每一行的頁尾部用於表示這些內容應該是在一行中顯示的。

例如:

This is an overly long line that \
might not fit the available page \
width and had to be broken into \
multiple lines.

This line fits the page width. (這一行的字元能夠在一行中完整顯示)

上面的內容應該閱讀成下面的內容:

This is an overly long line that might not fit the available page width and had to be broken into multiple lines.

This line fits the page width.

換句話說如果每一行的尾部有斜槓,則表示的是需要將下一行的內容拼接到上以後來進行完整的閱讀。

 

https://www.cwiki.us/display/JERSEYZH/Preface