資料流處理提供者 (WCF Data Services)
資料服務可以公開大型物件二進位資料。這項二進位資料可能代表視訊和音訊資料流、影像、文件檔案,或其他類型的二進位媒體。當資料模型中的實體包含一個或多個二進位屬性時,資料服務會在回應摘要的項目內,傳回這個 base-64 編碼形式的二進位資料。因為以這個方法載入及序列化大型二進位資料會影響效能,所以 Open Data Protocol (OData) 會定義一個機制來獨立擷取二進位資料,不論其所屬實體為何。只要將實體中的二進位資料分成一個或多個資料流就可以完成這項處理。
媒體資源 - 屬於實體的二進位資料,例如視訊、音訊、影像或其他類型的媒體資源資料流。
媒體連結項目 - 具有相關媒體資源資料流之參考的實體。
透過 WCF Data Services ,您可以實作資料流處理資料提供者來定義二進位資源資料流。資料流處理提供者實作會為資料服務提供與特定實體相關聯的媒體資源資料流當做 Stream 物件。這個實作可讓資料服務透過 HTTP 接受並傳回媒體資源當做指定之 MIME 類型的二進位資料流。
設定資料服務來支援二進位資料的資料流處理需要進行以下步驟:
將資料模型中的一個或多個實體歸類為媒體連結項目。這些實體不應該包含要進行資料流處理的二進位資料。實體的任何二進位屬性一定會在此項目中以 base-64 二進位編碼形式傳回。
實作 T:System.Data.Services.Providers.IDataServiceStreamProvider 介面。
定義資料服務來實作 IServiceProvider 介面。此資料服務會使用 GetService 實作來存取資料流處理資料提供者實作。這個方法會傳回適當的資料流處理提供者實作。
在 Web 應用程式組態中啟用大型訊息資料流。
啟用伺服器上或資料來源中之二進位資源的存取權。
本主題中的範例是以資料流處理相片服務範例為基礎 (資料服務資料流處理提供者系列:實作資料流處理提供者 (第 1 部分) 文章具有深度探討)。您可以在 MSDN Code Gallery 的資料流處理相片資料服務範例頁面上找到此範例服務的原始程式碼。
在資料模型中定義媒體連結項目
資料來源提供者會判斷實體如何定義為資料模型中的媒體連結項目。
Entity Framework 提供者
若要指出某個實體為媒體連結項目,請在概念模型中的實體類型定義內加上 HasStream 屬性,如下列範例所示:<EntityType xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata" Name="PhotoInfo" m:HasStream="true"> <Key> <PropertyRef Name="PhotoId" /> </Key> <Property Name="PhotoId" Type="Int32" Nullable="false" annotation:StoreGeneratedPattern="Identity" /> <Property Name="FileName" Type="String" Nullable="false" /> <Property Name="FileSize" Type="Int32" Nullable="true" /> <Property Name="DateTaken" Type="DateTime" Nullable="true" /> <Property Name="TakenBy" Type="String" Nullable="true" /> <Property Name="DateAdded" Type="DateTime" Nullable="false" /> <Property Name="Exposure" Type="PhotoData.Exposure" Nullable="false" /> <Property Name="Dimensions" Type="PhotoData.Dimensions" Nullable="false" /> <Property Name="DateModified" Type="DateTime" Nullable="false" /> <Property Name="Comments" Type="String" MaxLength="Max" FixedLength="false" Unicode="true" /> <Property Name="ContentType" Type="String" MaxLength="50" FixedLength="false" Unicode="true" /> </EntityType>
您也必須將命名空間
xmlns:m=https://schemas.microsoft.com/ado/2007/08/dataservices/metadata
加入至實體,或加入至定義資料模型之 .edmx 或 .csdl 檔案的根。如需使用 Entity Framework 提供者和公開媒體資源之資料服務的範例,請參閱資料服務資料流處理提供者系列:實作資料流處理提供者 (第 1 部分) 文章。
- 反映提供者
若要指出某個實體為媒體連結項目,請將 HasStreamAttribute 加入至在反映提供者內定義實體類型的類別。
- 自訂資料服務提供者
使用自訂服務提供者時,您必須實作 IDataServiceMetadataProvider 介面來定義資料服務的中繼資料。如需詳細資訊,請參閱自訂資料服務提供者 (WCF 資料服務)。您可以在代表實體類型 (媒體連結項目) 的 ResourceType 上,將 IsMediaLinkEntry 屬性設定為 true,藉以指出二進位資源資料流屬於 ResourceType。
實作 IDataServiceStreamProvider 介面
若要建立支援二進位資料流的資料服務,您必須實作 IDataServiceStreamProvider 介面。這個實作可讓資料服務將二進位資料以資料流形式傳回用戶端,並取用從用戶端傳來之資料流形式的二進位資料。每當資料服務需要存取資料流形式的二進位資料時,它就會建立此介面的執行個體。IDataServiceStreamProvider 介面會指定下列成員:
成員名稱 | 說明 |
---|---|
這個方法是由資料服務所叫用,在對應媒體資源的媒體連結項目遭到刪除時,一併刪除該媒體資源。當您實作 IDataServiceStreamProvider 時,這個方法所包含的程式碼會刪除與提供之媒體連結項目相關聯的媒體資源。 |
|
這個方法是由資料服務所叫用,以便將媒體資源以資料流形式傳回。當您實作 IDataServiceStreamProvider 時,這個方法所包含的程式碼會提供資料服務所使用的資料流,以便傳回與提供之媒體連結項目相關聯的媒體資源。 |
|
這個方法是由資料服務所叫用,以便傳回用來要求媒體連結項目之媒體資源的 URI。這個值是用來在媒體連結項目的內容項目中建立 src 屬性,也可用來要求資料流。當此方法傳回 null 時,資料服務就會自動決定 URI。當您必須為用戶端提供二進位資料的直接存取權,而不使用資料流提供者時,請使用此方法。 |
|
這個方法是由資料服務所叫用,以便傳回與指定之媒體連結項目相關聯之媒體資源的 Content-Type 值。 |
|
這個方法是由資料服務所叫用,以便傳回與指定之實體相關聯之資料流的 eTag。當您管理二進位資料的並行時,將會使用這個方法。當這個方法傳回 null 時,資料服務不會追蹤並行。 |
|
這個方法是由資料服務所叫用,可取得當接收從用戶端傳送的資料流時所使用的資料流。當您實作 IDataServiceStreamProvider 時,您必須傳回可寫入的資料流,資料服務會將接收的資料流資料寫入其中。 |
|
傳回命名空間限定的型別名稱,代表資料服務執行階段必須為媒體連結項目建立的型別,該連結項目與正在插入之媒體資源的資料流相關聯。 |
建立資料流處理資料服務
若要為 WCF Data Services 執行階段提供 IDataServiceStreamProvider 實作的存取權,您所建立的資料服務也必須實作 IServiceProvider 介面。下列範例將示範如何實作 GetService 方法來傳回實作 IDataServiceStreamProvider 之 PhotoServiceStreamProvider
類別的執行個體。
Partial Public Class PhotoData
Inherits DataService(Of PhotoDataContainer)
Implements IServiceProvider
' This method is called only once to initialize service-wide policies.
Public Shared Sub InitializeService(ByVal config As DataServiceConfiguration)
config.SetEntitySetAccessRule("PhotoInfo", _
EntitySetRights.ReadMultiple Or _
EntitySetRights.ReadSingle Or _
EntitySetRights.AllWrite)
' Named streams require version 3 of the OData protocol.
config.DataServiceBehavior.MaxProtocolVersion = DataServiceProtocolVersion.V3
End Sub
#Region "IServiceProvider Members"
Public Function GetService(ByVal serviceType As Type) As Object _
Implements IServiceProvider.GetService
If serviceType Is GetType(IDataServiceStreamProvider) _
Or serviceType Is GetType(IDataServiceStreamProvider2) Then
Return New PhotoServiceStreamProvider(Me.CurrentDataSource)
End If
Return Nothing
End Function
#End Region
End Class
public partial class PhotoData : DataService<PhotoDataContainer>, IServiceProvider
{
// This method is called only once to initialize service-wide policies.
public static void InitializeService(DataServiceConfiguration config)
{
config.SetEntitySetAccessRule("PhotoInfo",
EntitySetRights.ReadMultiple |
EntitySetRights.ReadSingle |
EntitySetRights.AllWrite);
// Named resource streams require version 3 of the OData protocol.
config.DataServiceBehavior.MaxProtocolVersion = DataServiceProtocolVersion.V3;
}
public object GetService(Type serviceType)
{
if (serviceType == typeof(IDataServiceStreamProvider2))
{
// Return the stream provider to the data service.
return new PhotoServiceStreamProvider(this.CurrentDataSource);
}
return null;
}
}
如需如何建立資料服務的一般資訊,請參閱設定資料服務 (WCF Data Services)。
在裝載環境中啟用大型二進位資料流
當您在 ASP.NET Web 應用程式中建立資料服務時,便會使用 Windows Communication Foundation (WCF) 來提供 HTTP 通訊協定實作。根據預設,WCF 會將 HTTP 訊息大小限制為只有 65 KB。為了要能夠與資料服務之間來回進行大型二進位資料的資料流處理,您也必須將 Web 應用程式設定為啟用大型二進位檔案及使用資料流進行傳輸。若要這樣做,請在應用程式 Web.config 檔案的 <configuration />
項目中加入下列程式碼:
<system.serviceModel>
<serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>
<services>
<!-- The name of the service -->
<service name="PhotoService.PhotoData">
<!--you can leave the address blank or specify your end point URI-->
<endpoint binding="webHttpBinding" bindingConfiguration="higherMessageSize"
contract="System.Data.Services.IRequestHandler"></endpoint>
</service>
</services>
<bindings>
<webHttpBinding>
<!-- configure the maxReceivedMessageSize value to suit the max size of
the request (in bytes) you want the service to receive-->
<binding name="higherMessageSize" transferMode="Streamed"
maxReceivedMessageSize="2147483647"/>
</webHttpBinding>
</bindings>
</system.serviceModel>
注意: |
---|
您必須使用 System.ServiceModel.TransferMode.Streamed 傳輸模式來確保要求和回應訊息中的二進位資料進行串流處理,而非由 WCF 進行緩衝處理。 |
如需詳細資訊,請參閱Streaming Message Transfer和Transport Quotas。
根據預設,Internet Information Services (IIS) 也會將要求的大小限制為 4MB。若要讓資料服務在 IIS 上執行時接收大於 4MB 的資料流,您也必須在 <system.web />
組態區段中設定 httpRuntime Element的 maxRequestLength 屬性,如下列範例所示:
<system.web>
<!-- maxRequestLength (in KB): default=4000 (4MB); max size=2048MB. -->
<httpRuntime maxRequestLength="2000000"/>
</system.web>
在用戶端應用程式中使用資料流
WCF Data Services 用戶端程式庫可讓您擷取和更新用戶端上二進位資料流形式的公開資源。如需詳細資訊,請參閱使用二進位資料 (WCF Data Services)。
使用資料流處理提供者的考量
下列是當您實作資料流處理提供者以及從資料服務存取媒體資源時,所要考量的事項。
媒體資源不支援 MERGE 要求。使用 PUT 要求可變更現有實體的媒體資源。
POST 要求不能用來建立新的媒體連結項目。您必須改為發出 POST 要求來建立新的媒體資源,而資料服務會使用預設值建立新的媒體連結項目。後續的 MERGE 或 PUT 要求可以更新這個新的實體。您也可以考慮快取實體,並在處置工具中進行更新,例如將屬性值設定為 POST 要求中 Slug 標頭的值。
當收到 POST 要求時,資料服務會呼叫 GetWriteStream 來建立媒體資源,然後再呼叫 SaveChanges 建立媒體連結項目。
GetWriteStream 的實作不應該傳回 MemoryStream 物件。當您使用這種資料流時,服務收到非常大型的資料流時將會發生記憶體資源問題。
以下是將媒體資源儲存在資料庫時所要考量的事項:
屬於媒體資源的二進位屬性不應該包含在資料模型中。資料模型中公開的所有屬性都會在回應摘要的項目中傳回。
為了改良大型二進位資料流的效能,我們建議您最好建立自訂資料流類別,將二進位資料儲存在資料庫中。這個類別是由 GetWriteStream 實作所傳回,而且會以區塊傳送二進位資料給資料庫。如果是 SQL Server 資料庫,我們建議您在二進位資料超過 1 MB 時,使用 FILESTREAM 將資料以資料流方式處理到資料庫中。
請確定資料庫設計為可儲存二進位大型資料流,而且您的資料服務將會收到這些資料流。
當用戶端傳送 POST 要求,將包含媒體資源的媒體連結項目插入單一要求時,將會呼叫 GetWriteStream 來取得資料流,然後資料服務才會將新的實體插入資料庫中。資料流處理提供者實作必須能夠處理這個資料服務行為。請考慮使用個別的資料表來儲存二進位資料或是將資料流儲存在檔案中,直到實體已經插入資料庫為止。
當您實作 DeleteStream、GetReadStream 或 GetWriteStream 方法時,您必須使用當做方法參數提供的 eTag 和 Content-Type 值。請勿在 IDataServiceStreamProvider 提供者實作中設定 eTag 或 Content-Type 標頭。
根據預設,用戶端會使用區塊式 HTTP Transfer-Encoding 來傳送大型二進位資料流。因為 ASP.NET 程式開發伺服器不支援這種編碼方式,所以您不能使用這個網頁伺服器來裝載必須接受大型二進位資料流的資料流處理資料服務。如需 ASP.NET 程式開發伺服器的詳細資訊,請參閱 Web Servers in Visual Web Developer。
版本控制需求
資料流處理提供者具有下列 OData 通訊協定版本控制需求:
- 資料流處理提供者要求資料服務支援 2.0 版的 OData 通訊協定和更新的版本。
如需詳細資訊,請參閱使用 WCF Data Services 的多個版本。
另請參閱
概念
資料服務提供者 (WCF 資料服務)
自訂資料服務提供者 (WCF 資料服務)
使用二進位資料 (WCF Data Services)