Edit on GitHub

v4.5.2 Release Notes

ServiceStack now available on .NET Core!

We’re super excited to announce support for .NET Core which was both the ServiceStack’s Community and ours most anticipated feature request of all time! We’re especially pleased with ServiceStack’s near entire feature-set and level of integration we’ve been able to bring to .NET Core, all maintained within a single code-base offering high source-code compatibility to maximize existing knowledge and code-reuse and reducing portability efforts, all without breaking changes to existing .NET 4.5 Customers - realizing our primary goal.

.NET Core - the future of .NET on Linux

Whilst the development and tooling experience is still in a transitionary period we believe .NET Core puts .NET Web and Server App development on the cusp of an exciting future - the kind .NET hasn’t seen before. The existing Windows hosting and VS.NET restraints have been freed, now anyone can develop using .NET’s productive expertly-designed and statically-typed mainstream C#/F# languages in their preferred editor and host it on the most popular server Operating Systems, in either an all-Linux, all-Windows or mixed ecosystem. Not only does this flexibility increase the value of existing .NET investments but it also makes .NET appeal to the wider and highly productive developer ecosystem who’ve previously disregarded .NET as an option.

As one of the first high-level .NET Web Frameworks to run cross-platform on Windows, OSX and Linux, the allure of developing cross-platform .NET Web Apps on OSX/Windows and hosting on Linux was something we’ve dedicated a lot of effort in supporting, but ultimately never came to pass. The inherent performance and instability issues with Mono’s HTTP Stack under heavy loads and few resources dedicated to supporting ASP.NET on Mono meant we couldn’t recommend it for production workloads - resulting in a weak developer ecosystem with relatively few installations running ASP.NET Mono in production.

This changes with .NET Core which offers significant performance and stability improvements over Mono that’s derived from a shared cross-platform code-base and supported by a well-resourced, active and responsive team. If you’re currently running ServiceStack on Mono, we strongly recommend upgrading to .NET Core to take advantage of its superior performance, stability and its top-to-bottom supported Technology Stack.

and with that let’s jump into seeing some ServiceStack Live Demos running on .NET Core in Linux…

ServiceStack .NET Core Apps running in Docker!

Hosting .NET Core Apps immediately exposes us to the benefits of .NET Core. We’ve ported the Live Demos using the most productive IDE and tooling combination we’ve found for us - which is still VS.NET with ReSharper. But for deployments and hosting we now have an array of options at our disposal, including joining the thriving state-of-the-art ecosystem around building Linux Docker images and deploying them to the cloud.

For .NET Core Live Demos we’ve settled on the popular power combo of:

We’ve published a step-by-step guide around our AWS ECS deployment story where ultimately packaging .NET Core Apps inside Docker images enables a higher-level of abstraction letting you define your entire App Server Instance with a repeatable recipe that lets you treat and deploy instances like opaque self-contained units.

With our .NET 4.5 Windows Live Demos we’re effectively mutating a static Windows Server VM that required pre-configuring with IIS Virtual Hosts. Any infrastructure Servers each Live Demo needs, are set up out-of-band and to minimize the System administration burden, all Demos share the same Redis server instance.

Repeatable, Isolated, no-touch automated Deployments

But for our .NET Core Docker deployments we have proper isolation and repeatable no-touch deployments where any infrastructure services each App needs are declared in configuration and deployed in a separate Docker container along side each App to an ECS cluster - decoupling your deployments from static EC2 instances. This lets you treat your server infrastructure and deployment automation story like code, where it’s checked-in with your Repo and run with your CI who packages it in a Docker Container, publishes it as an opaque Image and deploys it to the AWS EC2 Container Service.

Linux Cost Savings

In addition to the thriving ecosystem and superior automation, another benefit of hosting .NET Core Apps on Linux is the considerable cost savings of hosting on a Linux infrastructure. Docker instances enable isolation with considerably more efficiency than VM’s allowing you to pack them with greater density. For .NET Core Live Demos the single T2 medium instance ($25 /month) is hosting 15 Docker Images whilst running at ~50% Memory Utilization and <1% CPU Utilization in its current idle state.

.NET Core Live Demos!

To showcase ServiceStack features running on .NET Core we’ve forked several of our existing Live Demos and ported them to .NET Core and listed them side-by-side with their original ASP.NET 4.5 code-bases so they can be easily compared.

The Live Demos cover a broad spectrum of ServiceStack features including:

Redis GEO - simple example showing how to make use of Redis 3.2.0 new GEO features
Features - Redis Client, ServiceStack.Redis GEO APIs
.NET Core
Live Demo: redisgeo.netcore.io
Github: github.com/NetCoreApps/redis-geo
ASP.NET 4.5
Live Demo: redisgeo.servicestack.net
Github: github.com/ServiceStackApps/redis-geo
Chat - Single Page Chat App with real-time Server Events + Simple OAuth in <190 lines of JavaScript
Features - Real-time Server Events and JavaScript Client, Twitter, Facebook and Github OAuth Providers
.NET Core
Live Demo: chat.netcore.io
Github: github.com/NetCoreApps/Chat
ASP.NET 4.5
Live Demo: chat.servicestack.net
Github: github.com/ServiceStackApps/Chat
SimpleAuth.Mvc - Simple demo showcasing integration and authentication with ServiceStack & .NET Core MVC
Features - Simple Auth and OAuth Providers, Role-based Security, MVC Integration, ss-utils.js
.NET Core
Live Demo: mvc.netcore.io
Github: github.com/NetCoreApps/SimpleAuth.Mvc
ASP.NET 4.5
Live Demo: mvc.servicestack.net
Github: github.com/ServiceStack/Test
Stack Apis - AngularJS Single Page App leveraging AutoQuery in <50 lines of JavaScript + 1 AutoQuery DTO
Features - Fully-queryable RDBMS AutoQuery Services, OrmLite.Sqlite, AutoQuery Viewer
.NET Core
Live Demo: stackapis.netcore.io
Github: github.com/NetCoreApps/StackApis
ASP.NET 4.5
Live Demo: stackapis.servicestack.net
Github: github.com/ServiceStackApps/StackApis
Imgur - Resize uploaded images in all iOS Resolutions in <30 lines of JavaScript + 1 ServiceStack ImageService
Features - File Uploads, HTTP Utils
.NET Core
Live Demo: imgur.netcore.io
Github: github.com/NetCoreApps/Imgur
ASP.NET 4.5
Live Demo: imgur.servicestack.net
Github: github.com/ServiceStackApps/Imgur
Todos - Backbone.js TODO App powered by a C# Redis Client back-end
Features - Redis Client
.NET Core
Live Demo: todos.netcore.io
Github: github.com/NetCoreApps/Todos
ASP.NET 4.5
Live Demo: todos.servicestack.net
Github: github.com/ServiceStackApps/Todos
Razor Rockstars - showcasing ServiceStack's Smart Razor Views and Pages support
Features - Smart Razor Pages, OrmLite.Sqlite, Markdown
.NET Core
Live Demo: razor.netcore.io
Github: github.com/NetCoreApps/RazorRockstars
ASP.NET 4.5
Live Demo: razor.servicestack.net
Github: github.com/ServiceStackApps/RazorRockstars
REST Files - GitHub-like browser with remote file management over REST APIs in 1 jQuery and 1 FileService.cs
Features - REST File Management and Virtual File System
.NET Core
Live Demo: restfiles.netcore.io
Github: github.com/NetCoreApps/RestFiles
ASP.NET 4.5
Live Demo: restfiles.servicestack.net
Github: github.com/ServiceStackApps/RestFiles
Northwind - database viewer, effortless data-driven, AutoQuery and Cached services with ServiceStack + OrmLite
Features - RDBMS AutoQuery Services, AutoQuery Viewer, HTTP Caching and CacheResponse attributes
.NET Core
Live Demo: northwind.netcore.io
Github: github.com/NetCoreApps/Northwind
ASP.NET 4.5
Live Demo: northwind.servicestack.net
Github: github.com/ServiceStackApps/Northwind
Redis StackOverflow - StackOverflow-like ajax website powered by ServiceStack and Redis
Features - Redis Client
.NET Core
Live Demo: redisstackoverflow.netcore.io
Github: github.com/NetCoreApps/RedisStackOverflow
ASP.NET 4.5
Live Demo: redisstackoverflow.servicestack.net
Github: github.com/ServiceStackApps/RedisStackOverflow

Exceptional Code reuse

We’re especially pleased with how little effort was required to port existing ServiceStack code-bases where essentially all Service implementations were able to be reused as-is.

The primary changes required were due to supporting .NET Core’s new project structure, conventions and bootstrapping, primarily:

Most of the changes ended up resulting from .NET Core’s new convention of hosting Websites from the /wwwroot WebRoot Folder, requiring copying all servable static resources in /wwwroot and fixing all affected path references.

.NET Core ServiceStack packages

We’ve extended the .NET Core support of the Redis and Service Clients in our last release to now include OrmLite (SQL Server, Sqlite, PostgreSQL), ServiceStack, MVC Integration with Razor Pages, Swagger API, AutoQuery, AutoQuery Viewer, Stripe, AWS Integration with PocoDynamo and SQS, RedisMq, RabbitMq, ProtoBuf and Wire formats:

ServiceStack features that won’t be supported in .NET Core

Whilst we were able to make most of ServiceStack’s features available in .NET Core there are a number of features that we’re not able to support, these include:

Whilst we lost our beloved ServiceStack.Razor support we developed a completely new implementation backed by .NET Core MVC where we were able to implement most of ServiceStack.Razor user-facing features so porting should still be relatively straightforward with some minor syntax and configuration changes needed. This new implementation is available in ServiceStack.Mvc.Core package and can be seen in action in the Razor Rockstars .NET Core demo.

Referencing .NET Core Packages

After this release we’ll be bringing any remaining .NET Core compatible packages as well as focusing on profiling and performance whilst resolving any issues reported by Customers running on .NET Core. In the meantime the .NET Core packages are kept isolated from .NET 4.5 packages with a *.Core suffix which enables us to make frequent .NET Core releases during the next release cycle without affecting existing .NET 4.5 Customers.

As we expect our latest version to be the best version of .NET Core available we recommend referencing ServiceStack packages using the 1.0.* wildcard scheme, e.g:

"dependencies": {
    "Microsoft.NETCore.App": {
      "version": "1.0.1",
      "type": "platform"
    },
    "ServiceStack.Core": "1.0.*",
    "ServiceStack.Redis.Core": "1.0.*",
    "ServiceStack.Common.Core": "1.0.*",
    "ServiceStack.Client.Core": "1.0.*",
    "ServiceStack.Interfaces.Core": "1.0.*",
    "ServiceStack.Text.Core": "1.0.*"
  },
}

This will allow your next dotnet restore to fetch the latest version of ServiceStack without config changes.

Merging into main NuGet packages

Once we’re satisfied ServiceStack .NET Core has been battle-tested in the wild we’ll merge the .Core packages back into the main NuGet packages and convert them to use NuGet v3 .nuspec format and bump the major version to v5.0.0.

AppSelfHostBase Source-compatible Self-Host

ServiceStack.Kestrel is a new NuGet package which encapsulates .NET Core’s Kestrel HTTP Server dependency behind a source-compatible AppSelfHostBase which can be used to create source-compatible Self Hosted Apps. This is especially valuable for creating Self Host Integration Tests that can run on both .NET 4.5 and .NET Core platforms. E.g. the stand-alone CustomerRestExample on ServiceStack’s Project Home Page is run as-is on both .NET 4.5 and .NET Core without modification.

AppHostBase .NET Core Module

Whilst AppSelfHostBase enables the same development experience for developing Self-Hosted ServiceStack Solutions, when developing .NET Core-only Web Apps we instead recommend inheriting from AppHostBase and registering ServiceStack as a .NET Core module in order to remain consistent with all other .NET Core solutions.

In ASP.NET 4.5, AppHostBase is used to create an ASP.NET ServiceStack Host, but in .NET Core all Web Apps are Console Apps, AppHostBase in this case just refers to a normal ServiceStack AppHost you’ll use to idiomatically register your ServiceStack AppHost into .NET Core’s IApplicationBuilder pipeline as a standard .NET Core Module.

Binding to .NET Core

To see how ServiceStack integrates with .NET Core we’ll walk through porting the stand-alone Todos Live Demo which contains the entire implementation of a functional Todos Web App back-end in a single Startup.cs that we created using the ASP.NET Core Web Application (.NET Core) Empty VS.NET Template.

The Program class remains unchanged from the template and defines the entry-point for your Console Application that just Configures and Starts a Kestrel HTTP Server behind an IIS Reverse Proxy via the AspNetCoreModule HTTP Handler configured in your web.config:

public class Program
{
    public static void Main(string[] args)
    {
        var host = new WebHostBuilder()
            .UseKestrel()
            .UseContentRoot(Directory.GetCurrentDirectory())
            .UseIISIntegration()
            .UseStartup<Startup>()
            .Build();

        host.Run();
    }
}

.NET Core Startup

The Startup class is what you’ll use to configure your .NET App. The only difference from the default VS.NET Template is the single line to Register your ServiceStack AppHost in .NET Core’s IApplicationBuilder pipeline:

public class Startup
{
    // This method gets called by the runtime. Use this method to add services to the container.
    // For more information on how to configure your application, visit http://go.microsoft.com/fwlink/?LinkID=398940
    public void ConfigureServices(IServiceCollection services)
    {
    }

    // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
    public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
    {
        loggerFactory.AddConsole();

        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }

        app.UseServiceStack(new AppHost()); //Register your ServiceStack AppHost as a .NET Core module

        app.Run(async (context) =>
        {
            await context.Response.WriteAsync("Hello World!");
        });
    }
}

This shows the minimum code required to configure ServiceStack to run in .NET Core. It works similarly to the Wildcard HttpHandler configuration in your ASP.NET Web.config telling ASP.NET to route all requests to ServiceStack. The difference here is that ServiceStack is registered in a pipeline and only receives requests that weren’t handled in any of the preceding modules. Likewise ServiceStack will just call the next Module in the pipeline for any Requests that it’s not configured to handle, this is in contrast to ASP.NET 4.5 where ServiceStack was designed to handle all requests it receives, so it instead returns a NotFoundHandler and responds with a 404 Response.

In the above configuration any Request that ServiceStack doesn’t handle gets passed on to the next module registered, which in this case will return a Hello World! plain text response.

.NET Core AppHost Integration

Once inside your AppHost you’re back in ServiceStack-land where it’s business as usual and your AppHost configuration remains the same as before. The only differences from .NET 4.5 Todos AppHost is that .NET Framework introduced source-incompatible breaking changes to its Reflection APIs where instead of resolving a Types Assembly with typeof(TodoService).Assembly you’re instead required to call typeof(TodoService).GetTypeInfo().Assembly.

To combat this unfortunate design decision we’ve added Platform Extension Methods providing unified Reflection APIs like Type.GetAssembly() allowing you to configure source-compatible AppHost’s that can be used in both .NET 4.5 and .NET Core platforms, e.g:

// Create your ServiceStack Web Service with a singleton AppHost
public class AppHost : AppHostBase
{
    // Initializes your AppHost Instance, with the Service Name and assembly containing the Services
    public AppHost() : base("Backbone.js TODO", typeof(TodoService).GetAssembly()) { }

    // Configure your AppHost with the necessary configuration and dependencies your App needs
    public override void Configure(Container container)
    {
        //Register Redis Client Manager singleton in ServiceStack's built-in Func IOC
        container.Register<IRedisClientsManager>(new BasicRedisClientManager("localhost"));
    }
}

This minor change was all it took to port the Todos back-end Services to run on .NET Core which was able to reuse the entire existing Service implementation as-is.

The other change needed outside the Todos ServiceStack implementation was to match .NET Core’s default convention of serving static files from the WebRootPath which just required moving all static resources into the /wwwroot folder.

And with that the Todos port was complete, which you can view from the deployed locations below:

Seamless Integration with .NET Core

In addition to running flawlessly on .NET Core we’re also actively striving to find how we can best integrate with and leverage the surrounding .NET Core ecosystem and have made several changes to that end:

CamelCase

The JSON and JSV Text serializers are following .NET Core’s default convention to use camelCase properties by default. This can be reverted back to PascalCase with:

SetConfig(new HostConfig { UseCamelCase = false })

We also agree with this default, .NET Core seems to be centered around embracing the surrounding developer ecosystem where .NET’s default PascalCase protrudes in a sea of camelCase and snake_case JSON APIs. This won’t have an impact on .NET Service Clients or Text Serialization which supports case-insensitive properties, however Ajax and JS clients will need to be updated to use matching properties. You can use ss-utils normalize() methods to help with handling both conventions by recursively normalizing and converting all properties to lowercase.

.NET Core Container Adapter

Like ServiceStack, .NET Core now has a built-in IOC where you can register any dependencies you need in your Startup ConfigureServices(), e.g:

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddTransient<IFoo, Foo>()
                .AddScoped<IScoped, Scoped>()
                .AddSingleton<IBar>(c => new Bar { Name = "bar" });
    }
}

In .NET Core ServiceStack is pre-configured to use a NetCoreContainerAdapter where it will also resolve any dependencies declared in your .NET Core Startup using app.ApplicationServices. One side-effect of this is that when resolving Scoped dependencies it resolves them in a Singleton scope instead of the Request Scope had they instead been resolved from context.RequestServices.GetService<T>().

If you need to resolve Request Scoped .NET Core dependencies you can resolve them from IRequest, e.g:

public object Any(MyRequest request)
{
    var requestScope = base.Request.TryResolve<IScoped>();
}

Alternatively you can just register the dependencies in ServiceStack’s IOC instead, e.g:

public override void Configure(Container container)
{
    services.RegisterAutoWiredAs<Scoped,IScoped>()
        .ReusedWithin(ReuseScope.Request);
}

Note: any dependencies registered .NET Core Startup are also available to ServiceStack but dependencies registered in ServiceStack’s IOC are only visible to ServiceStack.

Consistent Registration APIs

To retain the same nomenclature that .NET Core uses to register dependencies we’ve added several Overloads to ServiceStack’s IOC letting you use a single consistent API to register dependencies in both ServiceStack and .NET Core IOC’s making it easy to move registrations between the two, e.g:

public void Configure(Container container)
{
    container.AddTransient<IFoo, Foo>()
             .AddScoped<IScoped, Scoped>()
             .AddSingleton<IBar>(c => new Bar { Name = "bar" });
}

ServiceStack’s Container also implements .NET Core’s IServiceProvider interface giving it access to .NET Core’s conveneince extension methods for resolving dependencies, e.g:

var foo = container.GetService<IFoo>();

ServiceStack.Logging Adapters

Logging is an example of an abstraction which didn’t make sense to maintain a separate implementation as any adapter would only be able to support logging within ServiceStack. With logging you’ll want to configure it one place and have it apply to your whole application, so we’ve instead pre-configured ServiceStack.Logging to proxy all messages to .NET Core’s logging abstraction where you’ll only need to configure logging once in Startup and have it handle all logging solution-wide.

WebRootPath and ContentRootPath

Classic ASP.NET serves static resources from your Host project’s folder but in .NET Core this has been moved to your App’s /wwwroot folder, separated from your App’s non-public assets which remain in your projects root folder.

To match this convention we’ve configured the read-only VirtualFileSources to point to the /wwwroot WebRootPath whilst the read/write IVirtualFiles is configured to your projects ContentRootPath folder.

MapProjectPath

As ServiceStack can be hosted in variety of different platforms encompassing several AppHost’s, we’ve added a new IAppHost.MapProjectPath() API that can be used to consistently resolve an absolute file path using a virtualPath from your Host Project root folder, e.g:

var filePath = appHost.MapProjectPath("~/path/to/settings.txt");

HostContext.TryGetCurrentRequest()

ASP.NET Web Applications let you resolve the IRequest of the current executing HTTP Request with:

IRequest req = HostContext.TryGetCurrentRequest();

Which is a wrapper over accessing the HttpContext.Current singleton but as there’s no equivalent in HttpListener self hosts this returns null. .NET Core also doesn’t enable singleton access to the current HttpRequest by default but can be enabled by registering:

services.AddSingleton<IHttpContextAccessor, HttpContextAccessor>();

Although this should only be registered if needed as it has non-trivial performance costs.

OrmLite LIKE Queries

One of our primary goals with ServiceStack providers is compatibility which lets you easily switch providers without having to change any call-site logic using the abstraction.

One case where this has an impact on performance is in OrmLite LIKE queries where some RDBMS providers will perform case-sensitive LIKE queries so in order to retain consistent behavior across all RDBMS providers OrmLite generates queries using UPPER(Field) to ensure case-insensitive searches.

However given .NET Core’s strong focus on performance we’ve removed this feature and reverted to the behavior of the underlying RDBMS so it no longer invalidates any DB Indexes on Fields. A more efficient alternative to get case-insensitive LIKE queries (where it’s not the default) is to use a case-insensitive collation.

This behavior also applies to AutoQuery LIKE queries and can be reverted with:

OrmLiteConfig.StripUpperInLike = false;

Register ServiceStack HttpHandlers as .NET Core Modules

Under the hood ServiceStack’s functionality is split into different HTTP Handlers that implements ASP.NET’s IHttpAsyncHandler and is also adapted to support HttpListener self-hosts behind ServiceStack’s IRequest abstractions.

We’re happy to report that ServiceStack’s HTTP Handlers can also be registered as a .NET Core module in the IApplicationBuilder pipeline. This lets you for instance return the same information as ServiceStack’s ?debug=requestinfo route for any unhandled requests by registering the RequestInfoHandler as the last module in .NET Core’s IApplicationBuilder pipeline, e.g:

public class Startup
{
    // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
    public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
    {
        loggerFactory.AddConsole();

        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }

        app.UseServiceStack(new AppHost());

        app.Use(new RequestInfoHandler());
    }
}

Some other examples of HTTP Handlers you could use is returning an image by registering a StaticFileHandler configured with the virtualPath of the image (from ContentRootPath):

app.Use(new StaticFileHandler("wwwroot/img/404.png"));

Or you can even render an MVC Razor View by returning it in a RazorHandler, e.g:

app.Use(new RazorHandler("/login"));

Which will render the /wwwroot/login.cshtml Razor Page using our new MVC-Based Smart Razor Pages support…

Smart Razor Pages

Driven by our preference for API-first style of Web Development we never saw value in the boilerplate required in MVC’s forced Controller and Action pattern so we instead developed our own ServiceStack Razor Pages which let you develop dynamic Web Pages using Razor to generate the HTML view of your existing Services - saving you from maintaining a parallel Controller implementation that’s limited to just Web Pages. The benefits of an API-first approach is that you’ll naturally get a well-defined servicified interface which can be consumed by all consumers including Web, Native Mobile and Desktop Apps whilst also enabling simplified B2B Integrations, Automation, Integration testing, etc.

No Ceremony Dynamic Pages without Controllers

In a lot of cases where you’re not developing Web Forms accepting User Input (e.g. generating a dynamic page using simple page-specific db queries) you won’t need a Controller or Service at all. For this scenario we developed Controller-less Razor Pages, where if you specify a Typed @model, ServiceStack automatically populates it from the HTTP Request Params and when no @model exists ServiceStack instead populates the Request params in a ViewDataDictionary - in both cases letting you access any Request Params using @Model.Name notation.

Razor Pages also lets you layout your Razor Views in whatever structure you want under /wwwroot which it will let you call using Pretty URLs by default so you’re not led into following the MVC-specific {Controller}/{Action} pattern or made to define Custom Routes.

.NET Core Razor Pages implementation also lets you structure your Razor Pages under /Views/Pages as an alternative to maintaining them under /wwwroot.

MVC Razor Pages

Unfortunately in .NET Core we weren’t able to reuse any of our existing ServiceStack.Razor implementation, but as we found the development model and end-user experience of Razor without MVC Controllers and Actions much more productive we investigated how it could best be implemented in .NET Core. Unfortunately .NET Core’s Razor support is tightly coupled to MVC’s implementation, but fortunately for us MVC also provided the necessary APIs where we could re-implement ServiceStack.Razor’s user-facing features using just MVC Razor Views.

In many ways this turned out to be a blessing in disguise as by using MVC’s implementation we also get access to new MVC .NET Core features and its surrounding ecosystem like Tag Helpers. MVC also takes care of live-reloading Razor Views behind-the-scenes so we’re also able to get the same iterative development experience we’re used to. By using MVC Views we also naturally get good tooling support which can be a dark art in .NET 4.5 which was tightly coupled to Web.config configuration and therefore poorly supported in Self-Hosting Console Apps.

Currently ReSharper’s tooling has issues with Razor Views inheriting Custom base classes - which can be resolved by installing the latest EAP or disabling its ASP.NET Razor support.

Overall we’re ecstatic with the end-result, we retain our Controller-free development model whilst Razor under .NET Core executes noticeably quicker than ASP.NET and significantly faster on Linux vs using Mono.

RazorFormat Usage

You can find .NET Core Razor features documented in razor.netcore.io which is maintained in our MVC NuGet package that can be installed with:

PM> Install-Package ServiceStack.Mvc.Core 

Then to enable, register the RazorFormat plugin:

public override void Configure(Container container)
{
    Plugins.Add(new RazorFormat());
}

Feedback Welcome

That wraps up the introduction to ServiceStack on .NET Core. We’re currently on Standby keen to help any Customers moving to .NET Core. Please report any issues you find in our Issue Tracker or if you have any general questions about porting your existing code-base to .NET Core please drop us a line in the Customer Forums, or even just to let us know if your ServiceStack Apps are running smoothly on .NET Core - we’d love to hear from you :)

New Docs Website!

After that delayed introduction, we’d like to welcome you to our new Documentation website!

We’re using Github’s new Publish Your Documentation with GitHub Pages feature to statically generate this website from our Markdown documentation which is now being maintained in the github.com/ServiceStack/docs repo. With this feature we’re able to treat documentation like source code where we can accept contributions via pull-requests and have them automatically show up on the Website.

Whilst this initial release is primarily a port of our old Wiki, having a dedicated website with direct control over the JavaScript and CSS allows us to provide a more optimized browsing experience which we intend on taking advantage of in the future.

New fast Wire binary format

Wire is a new fast Binary Serializer from the Akka Team with comparable performance to ProtoBuf but like MsgPack doesn’t require your POCO’s to be annotated with [DataContract] attributes making it more suitable for code-first POCO DTOs.

Usage

Wire can be installed from NuGet with:

PM> Install-Package ServiceStack.Wire

And registered in your AppHost with:

Plugins.Add(new WireFormat());

Which like other formats can be consumed using the WireServiceClient generic Typed Service Client, e.g:

var client = new WireServiceClient(baseUrl);
var response = client.Send(request);

Special thanks to Scott Mackay for contributing ServiceStack’s WireFormat.

MongoDB AuthRepository Updated

The MongoDbAuthRepository has been upgraded to use the latest v2.3.0 of the mongocsharpdriver. It was also upgraded to implement IManageApiKeys so it can now also be used as the persistent back-end for the API Key AuthProvider.

Special thanks to @ivanfioravanti for contributing the upgrade.

Add ServiceStack Reference

Kotlin Add ServiceStack Reference was upgraded to support the latest v1.04 release of Kotlin.

TypeScript Add ServiceStack Reference

TypeScript classes are now being generated in dependency order where any dependent classes are generated first. We’ve also removed ExportAsTypes as an inline config option. When preferred you can generate ambient Type declarations from the VS.NET Add TypeScript Reference Dialog.

All Add ServiceStack Reference Providers now lets you control which Types you want to export with the static FilterTypes function, e.g:

TypeScriptGenerator.FilterTypes = types => types
    .Where(x => x.Name != "ExcludeType")
    .OrderBy(x => x.Name).ToList();

Facebook AuthProvider upgraded to 2.8

The FacebookAuthProvider has been upgraded to use the Facebook’s latest v2.8 APIs.

Please note Facebook will be deprecating their older v2.1 API on October 30.

Other ServiceStack Changes

Potential Breaking Changes

OrmLite

DELETE FROM Table JOIN

OrmLite added support for deleting rows by querying from a joined table using a Typed SqlExpression, e.g:

var q = db.From<Person>()
    .Join<PersonJoin>((x, y) => x.Id == y.PersonId)
    .Where<PersonJoin>(x => x.Id == 2);

db.Delete(q);

Not supported in MySql

Case-insensitive field filters

The insertFields and updateFields for limiting which fields should Inserted or Updated are now case-insensitive to match the behavior of SELECT custom fields.

v4.5.4 Recovery Release

v4.5.4 is just a quick-fix release to fix to some NuGet packages so they reference the same dependency version.

v4.5.0 Release Notes