ServiceStack/はじめに/最初のWebサービスを作ってみる

ステップ１： プロジェクトを作る

ServiceStackはいくつかの方法でホストすることができる。

• コンソールアプリケーション
• Windowsサービス
• ASP.NETやASP.NET MVCなどの一部として同化する

このチュートリアルでは「空のASP.NET（ASP.NET MVCじゃないよ）」上にServiceStackを使ったWebアプリを作ってみる。

ステップ２： ServiceStackをインストールする

プロジェクトがServiceStackを使えるようにするには大きく２種類の方法がある。

NuGetを利用する

PM> Install-Package ServiceStack

これ一行でServiceStack関連のNuGetパッケージがどっさり再帰的にプロジェクトに追加され、Web.configなどある程度は自動設定される。なお、ServiceStackのNuGetパッケージは機能ごとに個別に提供されているので、本格的にServiceStackを使う際には必要なパッケージのみを入れるようにするとよい。

なお、MonoDevelopやXamarin StudioでもNuGet Addin for MonoDevelop and Xamarin Studioを用いることこの方法で簡単に環境構築することができる。

手動で頑張る

最新のソースコードをダウンロードして自分でビルドし、できあがったアセンブリをプロジェクトに追加する。

アセンブリを追加したら、次にWeb.configファイルを編集してServiceStackを登録する。ServiceStackを使ったWebアプリがWebサーバーのルートパスに配置されるのであれば以下のような感じである。

<system.web>
  <httpHandlers>
    <add path="*" type="ServiceStack.WebHost.Endpoints.ServiceStackHttpHandlerFactory, ServiceStack" verb="*"/>
  </httpHandlers>
</system.web>

<!-- Required for IIS 7.0 (and above?) -->
<system.webServer>
  <validation validateIntegratedModeConfiguration="false" />
  <handlers>
    <add path="*" name="ServiceStack.Factory" type="ServiceStack.WebHost.Endpoints.ServiceStackHttpHandlerFactory, ServiceStack" verb="*" preCondition="integratedMode" resourceType="Unspecified" allowPathInfo="true" />
  </handlers>
</system.webServer>

他のWebフレームワーク（ASP.NET MVCを含む）と競合を避けつつカスタムパスにServiceStackアプリをホストする場合は以下を参照するとよい。 https://github.com/ServiceStack/ServiceStack/wiki/Run-servicestack-side-by-side-with-another-web-framework

外部リンク

• https://github.com/ServiceStack/ServiceStack/wiki/Create-your-first-webservice