Upgrade to v8.1

MyApp.ServiceModel/Hello.cs

@@ -2,14 +2,13 @@
 
 namespace MyApp.ServiceModel;
 
-[Route("/hello")]
 [Route("/hello/{Name}")]
-public class Hello : IReturn<HelloResponse>
+public class Hello : IGet, IReturn<HelloResponse>
 {
-    public string Name { get; set; }
+    public required string Name { get; set; }
 }
 
 public class HelloResponse
 {
-    public string Result { get; set; }
+    public required string Result { get; set; }
 }

MyApp/Configure.AppHost.cs

@@ -1,25 +1,18 @@
-using Funq;
-using ServiceStack;
-using MyApp.ServiceInterface;
-
-[assembly: HostingStartup(typeof(MyApp.AppHost))]
+[assembly: HostingStartup(typeof(MyApp.AppHost))]
 
 namespace MyApp;
 
-public class AppHost : AppHostBase, IHostingStartup
+public class AppHost() : AppHostBase("MyApp"), IHostingStartup
 {
     public void Configure(IWebHostBuilder builder) => builder
         .ConfigureServices(services => {
             // Configure ASP.NET Core IOC Dependencies
         });
 
-    public AppHost() : base("MyApp", typeof(MyServices).Assembly) {}
-
-    public override void Configure(Container container)
+    public override void Configure()
     {
-        // Configure ServiceStack only IOC, Config & Plugins
+        // Configure ServiceStack, Run custom logic after ASP.NET Core Startup
         SetConfig(new HostConfig {
-            UseSameSiteCookies = true,
         });
     }
 }

MyApp/MyApp.csproj

@@ -12,7 +12,11 @@
   </ItemGroup>
 
   <ItemGroup>
+    <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="8.*" />
+    <PackageReference Include="Swashbuckle.AspNetCore" Version="6.*" />
     <PackageReference Include="ServiceStack" Version="8.*" />
+    <PackageReference Include="ServiceStack.Extensions" Version="8.*" />
+    <PackageReference Include="ServiceStack.AspNetCore.OpenApi" Version="8.*" />
   </ItemGroup>
 
   <ItemGroup>

MyApp/Program.cs

@@ -1,15 +1,35 @@
-var builder = WebApplication.CreateBuilder(args);
+using MyApp.ServiceInterface;
+
+var builder = WebApplication.CreateBuilder(args);
+var services = builder.Services;
+
+services.AddServiceStack(typeof(MyServices).Assembly, c =>
+{
+    c.AddSwagger();
+});
+
+services.AddEndpointsApiExplorer();
+services.AddSwaggerGen();
 
 var app = builder.Build();
 
 // Configure the HTTP request pipeline.
-if (!app.Environment.IsDevelopment())
+if (app.Environment.IsDevelopment())
 {
-    app.UseExceptionHandler("/Error");
+    app.UseSwagger();
+    app.UseSwaggerUI();
+}
+else
+{
+    app.UseExceptionHandler("/Error", createScopeForErrors: true);
     // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
     app.UseHsts();
-    app.UseHttpsRedirection();
 }
-app.UseServiceStack(new AppHost());
+
+app.UseStaticFiles();
+
+app.UseServiceStack(new AppHost(), options => {
+    options.MapEndpoints();
+});
 
 app.Run();

MyApp/wwwroot/index.html

@@ -12,7 +12,6 @@
     h2, h3, strong { font-weight:500 }
 </style>
 <link rel="stylesheet" href="https://unpkg.com/@highlightjs/[email protected]/styles/atom-one-dark.min.css">
-<script async src="https://ga.jspm.io/npm:[email protected]/dist/es-module-shims.js"></script><!--safari polyfill-->
 <script type="importmap">
 {
     "imports": {
@@ -28,10 +27,10 @@ <h2><a href="/ui/Hello">Hello</a> API</h2>
 <div id="result"></div>
 
 <script type="module">
-import { JsonApiClient, $1, on } from '@servicestack/client'
+import { JsonServiceClient, $1, on } from '@servicestack/client'
 import { Hello } from '/types/mjs'
 
-const client = JsonApiClient.create()
+const client = new JsonServiceClient()
 on('#txtName', {
     /** @param {Event} el */
     async keyup(el) {
@@ -53,6 +52,10 @@ <h2><a href="/ui/Hello">Hello</a> API</h2>
 - [View API Details](/ui/Hello?tab=details)
 - [Browse API source code in different langauges](/ui/Hello?tab=code)
 
+## View in Swagger UI
+ - [Swagger UI](/swagger/index.html)
+ - [Open API v3 JSON](/swagger/v1/swagger.json)
+
 ### Using JsonServiceClient in Web Pages
 
 Easiest way to call APIs is to use [@servicestack/client](https://docs.servicestack.net/javascript-client) with

MyApp/wwwroot/js/dtos.mjs

@@ -1,6 +1,6 @@
 /* Options:
-Date: 2023-02-09 11:00:41
-Version: 6.60
+Date: 2024-02-06 15:04:23
+Version: 8.10
 Tip: To override a DTO option, remove "//" prefix before updating
 BaseUrl: https://localhost:5001
 
@@ -25,7 +25,7 @@ export class Hello {
     /** @type {string} */
     name;
     getTypeName() { return 'Hello' }
-    getMethod() { return 'POST' }
+    getMethod() { return 'GET' }
     createResponse() { return new HelloResponse() }
 }