ServiceStack 项目实例 007 ServiceStack.Examples - 1

      ServiceStack的官网提供了很多的项目案例下载，不过有的示例不能拿来即用，并且案例中还有用的是用VS2010开发的，SS的版本也比较旧，要调整一下才能够运行。

       

      官方示例项目下载地址 https://github.com/ServiceStack/ServiceStack.Examples/tree/v3

      其中包含以下示例项目（第一个目录是升级到VS2013的升级记录）：

       

        在《StarterTemplates》目录下有 一些项目起始模板

        

 

        SS框架能够在.net3.5以上的VS开发环境下使用，也就是最低要求VS2008，示例项目中有少数是VS2010的，大部分是VS2012的。

 

        这里说明一下《ServiceStack.Examples》这个项目，

        

 

         方案中共包含7个项目，在Host目录下的三个项目

         ServiceStack.Examples.Clients  Web版的客户端项目

         ServiceStack.Examples.Host.Console 控制台版的服务端项目

         ServiceStack.Examples.Host.Web  Web版的服务端项目

 

         在Test目录下的两个项目

         ServiceStack.Examples.Tests  基本功能测试

         ServiceStack.Examples.Tests.Integration  整合方式测试（客户端和服务端整合使用）

 

         ServiceStack.Examples.ServiceInterface  提供服务的项目（Service写在这个项目）

 

         ServiceStack.Examples.ServiceModel  模型定义的项目（包含有路由）

 

         这个项目在最后发布时仅须要发布Hosts目录下的文件便可，其余的项目基本是类库和测试项目。这个项目当中服务的调用使用了旧式的写法，好比

       

1 2 3 4 5 6 7

public class GreetService : IService<Greet> { public object Execute(Greet request) { return new GreetResponse { Result = "Hello " + request.Name }; } }

        其中的 GreetService : IService<Greet>  的建议新式写法为 GreetService : Service，Execute(Greet request) 的新式写法为 Get(Greet request) 。此外由于项目中使用了ServiceStack.Examples 和框架的 ServiceStack. 有冲突， 因此 GreetService : Service的继承不能直接写，须要写成  GreetService : : ServiceStack.ServiceInterface.Service。

 

      注意其中的ServiceStack.Examples.ServiceModel 中的Types中实体类模型的定义：

1 2 3 4 5 6 7 8 9

public class CustomerOrders     {         public CustomerOrders()         {             this.Orders = new List<Order>();         }                   public Customer Customer { get; set; }         public List<Order> Orders { get; set; }

     

    CustomerOrders 表包含有Customer 和 Orders 两个表中外键关联方式的数据，但在3.x的示例中，并无实现外键关联方式获取关联表的数据，而是经过在实体类中设置关联的内部类，在服务中获取数据时候组合多表数据实现，这是一种和NoSQL使用的方法和思路相一致的实现。

   （在本示例中没有演示获取多表数据时候的组合合并过程，而是直接用一组样本数据示例，样本数据中已经设置好子类的数据，针对CustomerOrders 取得的数据是Customer 加上一组Order的List，组合好后直接返回给服务 ，详见《ServiceStack.Examples.ServiceInterface》 项目下的GetNorthwindCustomerOrdersService）

 

     值得特别强调和说明是《ServiceStack.Examples.ServiceInterface》 项目下的GetUsersService.cs文件中根据一组ID或者用户名获取用户列表的服务实现：

     根据逗号分隔的id获取一组User数据的页面：

      

      获取用户列表的程序代码： （修复后）

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

public object Any(GetUsers request)         {             using (var dbConn = ConnectionFactory.OpenDbConnection())             {                 var users = new List<User>();                 if (request.UserIds != null && request.UserIds.Count > 0)                 {                     users.AddRange(dbConn.GetByIds<User>(request.UserIds));                 }                 if (request.UserNames != null && request.UserNames.Count > 0)                 {                     users.AddRange(dbConn.Select<User>(                         "UserName IN ({0})", request.UserNames.SqlInValues()));                 }                 return new GetUsersResponse { data = users };             }         }