Skip to content
dotob edited this page Jul 20, 2012 · 21 revisions

It's very easy to host ServiceStack in a console app or in a windows service. You just have to derive from AppHostHttpListenerBase instead of AppHostBase:

Complete C# Console Host Example

	using ServiceStack.ServiceInterface;
	using ServiceStack.WebHost.Endpoints;

	class Program {

		public class Hello {
			public string Name { get; set; }
		}

		public class HelloResponse {
			public string Result { get; set; }
		}

		public class HelloService : ServiceBase<Hello> 
		{
			protected override object Run(Hello request) 
			{
				return new HelloResponse { Result = "Hello, " + request.Name };
			}
		}

		//Define the Web Services AppHost
		public class AppHost : AppHostHttpListenerBase {
			public AppHost() : base("StarterTemplate HttpListener", typeof(HelloService).Assembly) { }

			public override void Configure(Funq.Container container) {
				Routes
	                            .Add<Hello>("/hello")
	                            .Add<Hello>("/hello/{Name}");
			}
		}

		//Run it!
		static void Main(string[] args)
		{
			var listeningOn = args.Length == 0 ? "http://*:1337/" : args[0];
			var appHost = new AppHost();
			appHost.Init();
			appHost.Start(listeningOn);

			Console.WriteLine("AppHost Created at {0}, listening on {1}", DateTime.Now, listeningOn);
			Console.ReadKey();
		}
	}

Complete F# Console Host Example

	open System
	open ServiceStack.ServiceHost
	open ServiceStack.WebHost.Endpoints
	 
	type Hello = { mutable Name: string; }
	type HelloResponse = { mutable Result: string; }
	type HelloService() =
	    interface IService<Hello> with
	        member this.Execute (req:Hello) = { Result = "Hello, " + req.Name } :> Object
	 
	//Define the Web Services AppHost
	type AppHost =
	    inherit AppHostHttpListenerBase
	    new() = { inherit AppHostHttpListenerBase("Hello F# Services", typeof<HelloService>.Assembly) }
	    override this.Configure container =
	        base.Routes
	            .Add<Hello>("/hello")
	            .Add<Hello>("/hello/{Name}") |> ignore
	 
	//Run it!
	[<EntryPoint>]
	let main args =
	    let host = if args.Length = 0 then "http://*:1337/" else args.[0]
	    printfn "listening on %s ..." host
	    let appHost = new AppHost()
	    appHost.Init()
	    appHost.Start host
	    Console.ReadLine() |> ignore
	    0

When either of those are running you can call your hello service at http://localhost:1337/hello/World!

Host as a Windows or Linux Console Host, Windows Service or Linux Daemon

This will run in as a Console Host in any Operating System with .NET 3.5 or Mono installed. In addition this can also be wrapped-up and run inside a Windows Service or run as a Linux Daemon which you can optionally elect to serve behind Apache or Nginx reverse proxies.

Easily Convert to an ASP.NET Web Service

As both AppHostBase and AppHostHttpListenerBase follow the same API they are easily convertible between the two. Here's some step-by-step instructions showing you how to convert an F# Console Host to an ASP.NET Web Service on OSX!



  1. Getting Started
    1. Create your first webservice
    2. Your first webservice explained
    3. ServiceStack's new API Design
    4. Designing a REST-ful service with ServiceStack
    5. Example Projects Overview
  2. Reference
    1. Order of Operations
    2. The IoC container
    3. Metadata page
    4. Rest, SOAP & default endpoints
    5. SOAP support
    6. Routing
    7. Service return types
    8. Customize HTTP Responses
    9. Plugins
    10. Validation
    11. Error Handling
    12. Security
  3. Clients
    1. Overview
    2. C# client
    3. Silverlight client
    4. JavaScript client
    5. Dart Client
    6. MQ Clients
  4. Formats
    1. Overview
    2. JSON/JSV and XML
    3. ServiceStack's new HTML5 Report Format
    4. ServiceStack's new CSV Format
    5. MessagePack Format
    6. ProtoBuf Format
  5. View Engines 4. Razor & Markdown Razor
    1. Markdown Razor
  6. Hosts
    1. IIS
    2. Self-hosting
    3. Mono
  7. Security
    1. Authentication/authorization
    2. Sessions
    3. Restricting Services
  8. Advanced
    1. Configuration options
    2. Access HTTP specific features in services
    3. Logging
    4. Serialization/deserialization
    5. Request/response filters
    6. Filter attributes
    7. Concurrency Model
    8. Built-in caching options
    9. Built-in profiling
    10. Messaging and Redis
    11. Form Hijacking Prevention
    12. Auto-Mapping
    13. HTTP Utils
    14. Virtual File System
    15. Config API
    16. Physical Project Structure
    17. Modularizing Services
    18. MVC Integration
  9. Plugins 3. Request logger 4. Swagger API
  10. Tests
    1. Testing
    2. HowTo write unit/integration tests
  11. Other Languages
    1. FSharp
    2. VB.NET
  12. Use Cases
    1. Single Page Apps
    2. Azure
    3. Logging
    4. Bundling and Minification
    5. NHibernate
  13. Performance
    1. Real world performance
  14. How To
    1. Sending stream to ServiceStack
    2. Setting UserAgent in ServiceStack JsonServiceClient
    3. ServiceStack adding to allowed file extensions
    4. Default web service page how to
  15. Future
    1. Roadmap

Clone this wiki locally