使用 JAX-RS 2.0 環境定義物件,來取得要求的其他資訊
Java API for RESTful Web Services (JAX-RS) 2.0 提供不同類型的環境定義給應用程式子類別、根目錄資源類別和提供者。您可以使用 @Context 註釋,將環境定義物件(例如 HttpHeaders、UriInfo、HttpServletRequest)注入至應用程式子類別、根目錄資源類別和提供者中的類別欄位或方法參數。
關於這項作業
您可以使用下列環境定義物件,它們可用於提供者(用戶端與伺服器)、資源類別(僅伺服器)和應用程式子類別(僅伺服器):
環境定義物件 | 類型 | 說明 |
---|---|---|
Application | 類別 | 應用程式提供的 Application 子類別的實例可以透過 @Context 註釋,注入至類別欄位或方法參數。存取 Application 子類別實例,可將配置資訊集中放在該類別中。 註: 這個 Application 子類別無法注入至
Application 子類別本身中,因為這會產生循環相依關係。
|
UriInfo | 介面 | UriInfo 介面會針對個別的要求,提供要求 URI 元件的靜態和動態資訊。 |
HttpHeaders | 介面 | HttpHeaders 介面可讓您以對映形式或透過強制型簡便方法,來存取要求標頭資訊。 |
Request | 介面 | Request 介面可讓呼叫端判斷最符合的表示法變式,以及評估資源的現行狀態是否符合要求的任何前置條件。 |
SecurityContext | 介面 | SecurityContext 介面可讓您存取現行要求的安全環境定義資訊。 |
Providers | 介面 | Providers 介面可讓您根據一組搜尋準則,來查閱提供者實例。 |
ResourceContext | 介面 | ResourceContext 介面可讓您存取預設個別要求範圍中之資源或子資源類別的實例化與起始設定。 |
Configuration | 介面 | 透過 @Context,就能同時注入用戶端和伺服器執行時期的配置。這些配置可供注入至提供者(用戶端或伺服器)和資源類別(僅伺服器)中。 |