Webes API-minták listája

HttpClient-minták

Bing Translate minta | VS 2012 forráskód

Bemutatja, hogyan hívhatja meg a Microsoft Translator szolgáltatást a HttpClient osztály használatával. A Microsoft Translator szolgáltatás API-jának OAuth-jogkivonatra van szüksége, amelyet az alkalmazás úgy szerez be, hogy minden kérést elküld az Azure-jogkivonat-kiszolgálónak a translator szolgáltatásnak. A token szerver eredményét a fordítási szolgáltatásnak küldött kérésbe továbbítják. A minta futtatása előtt be kell szereznie egy alkalmazáskulcsot az Azure Marketplace-ről , és meg kell adnia az AccessTokenMessageHandler mintaosztály adatait.

Google Maps-minta | részletes leírás | VS 2012-forrás

A HttpClient segítségével letölti Redmond, WA térképét a Google Maps API-ból, menti helyi fájlként, és megnyitja az alapértelmezett képmegjelenítőt.

Twitter-ügyfélminta | részletes leírás | VS 2012-forrás

Bemutatja, hogyan írhat egyszerű Twitter-ügyfelet a HttpClient használatával. A minta egy HttpMessageHandler használatával szúr be OAuth-hitelesítési adatokat a kimenő HttpRequestMessage-be. A Twitter eredménye JSON.NET használatával olvasható. A minta futtatása előtt be kell szereznie egy alkalmazáskulcsot a Twitterről, és meg kell adnia az OAuthMessageHandler mintaosztály adatait.

Világbank minta | részletes leírás | VS 2010-forrás | VS 2012-forrás

Bemutatja, hogyan lehet adatokat lekérni a Világbank adatwebhelyéről az eredmény elemzéséhez JSON.NET használatával.

Webes API-minták

A ASP.NET Webes API | használatának első lépéseiVS 2012-forrás

Bemutatja, hogyan hozhat létre olyan alapszintű webes API-t, amely támogatja a HTTP GET-kéréseket. Az Első ASP.NET Webes API oktatóanyag forráskódját tartalmazza.

ASP.NET Webes API JavaScript-forgatókönyvei – Megjegyzések | VS 2012-forrás

Bemutatja, hogyan lehet ASP.NET Web API-t használni webes API-k készítésére, amelyek támogatják a böngésző klienseket, és egyszerűen meghívhatók jQuery használatával.

Kapcsolatkezelő | VS 2010-forrás

Ez a minta ASP.NET Webes API-t használ egy egyszerű contact manager-alkalmazás létrehozásához. Az alkalmazás egy contact manager webes API-ból áll, amelyet egy ASP.NET MVC-alkalmazás és egy Windows Phone-alkalmazás használ a partnerek listájának megjelenítéséhez és kezeléséhez.

Kötegelési minta | részletes leírás | VS 2012-forrás

Bemutatja, hogyan implementálhatja a HTTP-kötegelést ASP.NET belül. A kötegelés lényege, hogy több HTTP-kérést helyez el egyetlen TÖBBrészes MIME entitástörzsben, amelyet aztán a rendszer HTTP POST-ként küld el a kiszolgálónak. A kérések feldolgozása egyenként történik, a válaszok pedig egy másik MIME többrészes entitástörzsbe kerülnek, amelyet a rendszer visszaad az ügyfélnek.

Tartalomvezérlő minta | részletes leírás | VS 2010-forrás | VS 2012-forrás

Bemutatja, hogyan olvashatók és írhatóak a kérés- és válaszentitások aszinkron módon streamek használatával. A mintavezérlő két művelettel rendelkezik: egy PUT művelettel, amely aszinkron módon olvassa be a kérelem entitástörzsét, és egy helyi fájlban tárolja, valamint egy GET műveletet, amely a helyi fájl tartalmát adja vissza.

Egyéni assembly feloldó példa | VS 2012 forráskód

Bemutatja, hogyan módosíthatja a ASP.NET Webes API-t a vezérlők dinamikusan betöltött kódtár-szerelvényből való felderítésének támogatásához. A minta egy egyéni IAssembliesResolvert implementál, amely meghívja az alapértelmezett implementációt, majd hozzáadja a kódtár-szerelvényt az alapértelmezett eredményekhez.

Egyéni médiatípus-formázó minta | részletes leírás | VS 2010-forrás

Bemutatja, hogyan hozhat létre egyéni médiatípus-formázót a BufferedMediaTypeFormatter alaposztály használatával. Ez az alaposztály elsősorban szinkron olvasási és írási műveleteket használó formázók számára készült. A médiatípus-formázó megjelenítése mellett a minta bemutatja, hogyan csatlakoztathatja azt azáltal, hogy regisztrálja az HttpConfiguration részeként az alkalmazásban. Vegye figyelembe, hogy a MediaTypeFormatter alaposztályt közvetlenül is használhatja olyan formázókhoz, amelyek elsősorban aszinkron olvasási és írási műveleteket használnak.

Egyéni paraméterkötési minta | részletes leírás | VS 2010-forrás

Bemutatja, hogyan szabhatja testre a paraméterkötési folyamatot, amely azt határozza meg, hogy a kérésből származó információk hogyan kötődnek a műveleti paraméterekhez. Ebben a mintában a Kezdőlap vezérlő négy műveletből áll:

1. A BindPrincipal bemutatja, hogyan köthet egy IPrincipal-paramétert egy egyéni általános tagtól, nem HTTP GET-üzenetből;
2. A BindCustomComplexTypeFromUriOrBody bemutatja, hogyan lehet olyan összetett típusú paramétert kötni, amely az üzenettörzsből vagy egy HTTP POST-üzenet kérési URI-jából származhat;
3. A BindCustomComplexTypeFromUriWithRenamedProperty bemutatja, hogyan köthet egy összetett típusú paramétert egy átnevezett tulajdonsággal, amely egy HTTP POST-üzenet kérési URI-jából származik;
4. A PostMultipleParametersFromBody bemutatja, hogyan köthet több paramétert a törzsből egy POST-üzenethez;

Fájlfeltöltési minta | részletes leírás | VS 2012-forrás

Bemutatja, hogyan tölthet fel fájlokat egy ApiControllerbe a MIME többrészes fájlfeltöltés használatával, és hogyan állíthat be állapotértesítéseket a HttpClienttel a ProgressNotificationHandler használatával. A vezérlő beolvassa egy HTML-fájl tartalmát aszinkron módon, és egy vagy több törzsrészt ír egy helyi fájlba. A válasz információkat tartalmaz a feltöltött fájlról (vagy fájlokról).

Fájlfeltöltés az Azure Blob Store-ba – minta | részletes leírás | VS 2012-forrás

Ez a minta hasonló a fájlfeltöltési mintához, de ahelyett, hogy a feltöltött fájlokat helyi lemezre mentené, aszinkron módon feltölti a fájlokat az Azure Blob Store-ba a Windows Azure SDK for .NET használatával. Emellett egy mechanizmust is biztosít az Azure Blob Storage-tárolóban jelenleg található blobok felsorolására. Kipróbálhatja az Azure Storage Emulatoron futó mintát, amely az Azure SDK-hoz tartozik. Ha rendelkezik Azure Storage-fiókkal, a tényleges tárolási szolgáltatást is használhatja.

Http-üzenetkezelő folyamatminta | részletes leírás | VS 2010-forrás

Bemutatja, hogyan kötheti be a HttpMessageHandler példányokat mind az ügyfélen (HttpClient), mind a kiszolgálón (ASP.NET Web API-n). A mintában ugyanazt a kezelőt használja az ügyfél és a kiszolgáló is. Bár ritkán fordul elő, hogy ugyanaz a kezelő mindkét helyen futna, az objektummodell ugyanaz az ügyfél- és kiszolgálóoldalon.

JSON-feltöltési minta | VS 2012-forrás

Bemutatja, hogyan töltheti fel és töltheti le a JSON-t egy ApiControllerbe és onnan. A minta egy minimálisan konfigurált ApiController-t használ, amelyet HttpClient segítségével ér el.

Mashup példa | részletes leírás | Visual Studio 2012 forrás

Bemutatja, hogyan érhet el több távoli helyet aszinkron módon egy ApiController-műveleten belül. Minden alkalommal, amikor a műveletet végrehajtják, a rendszer aszinkron módon teljesíti a kéréseket, elkerülve ezzel a szálak blokkolását.

Memóriakövetési minta | részletes leírás | VS 2010-forrás

Ez a mintaprojekt létrehoz egy Nuget-csomagot, amely egy egyéni memóriabeli nyomkövetési írót telepít ASP.NET webes API-alkalmazásokba.

MongoDB-minta | részletes leírás | VS 2012-forrás

Bemutatja, hogyan használhatja a MongoDB-t egy ApiController állandó tárolójaként egy adattárminta használatával.

Válasz törzsének processzormintája | VS 2012-forrás

Bemutatja, hogyan másolhat egy válaszentitást (azaz EGY HTTP-választörzset) egy helyi fájlba, mielőtt továbbítanák az ügyfélnek, és hogyan végezhet további feldolgozást a fájlon aszinkron módon. A minta egy HttpMessageHandlert implementál, amely a válaszentitást egy olyannal burkolja, amely a szokásos módon írja magát a kimenetbe és egy helyi fájlba.

XDocument minta feltöltése | részletes leírás | VS 2012 forrás

Bemutatja, hogyan tölthet fel XDocumentet egy ApiControllerbea PushStreamContent és a HttpClient használatával.

Érvényesítési minta | VS 2010-forrás

Bemutatja, hogyan használhat érvényesítési attribútumokat a modelleken a ASP.NET WebAPI-ban a HTTP-kérés tartalmának ellenőrzéséhez. Bemutatja, hogyan jelölheti meg a tulajdonságokat szükség szerint, hogyan használhatja a keretrendszer által definiált és az egyéni érvényesítési attribútumokat a modell megjegyzéseihez, és hogyan ad vissza hibaválaszokat érvénytelen modellállapotokra.

Webes űrlapminta | részletes leírás | VS 2010-forrás

Egy Web Forms-projekthez hozzáadott ApiControllert jelenít meg.

RestBugs-minta

A RestBugs egy egyszerű hibakövető alkalmazás, amely bemutatja, hogyan használható ASP.NET Web API és az új HTTP-ügyfélkódtár hipermédia-alapú rendszer létrehozásához. A minta ügyfél- és kiszolgáló-implementációkat is tartalmaz, ASP.NET Webes API használatával. A kiszolgáló egy egyéni Razor-formázót használ az erőforrás-reprezentációk létrehozásához. A minta egy node.js kiszolgálót is biztosít, amely bemutatja az ügyfelek és kiszolgálók leválasztásához használt hipermédia-kialakításból származó előnyöket.