下面我建立一个服务的Operation,实现添加一条信息的功能,在SOA模式开发中,Operation相当于MVC框架中的一个Action,但是SOA服务中是没有视图层和显示页面的,它对外提供的是数据服务,通常为XML或JSON格式。

    这个功能实现需要在三个文件中分别添加代码:

    1  在SS服务端项目中添加一个类文件Submission.cs , 其中定义Submission类和SubmissionResponse类:

[Route("/Submission", "POST")]    public class Submission    {        [AutoIncrement]        public int Id { get; set; }        public DateTime SubmissionTime { get; set; }        public string Headline { get; set; }        public string Body { get; set; }    }    public class SubmissionResponse    {        public int Id { get; set; }    }

    Submission类是一个实体类,对应数据库中的表,其中[AutoIncrement]是主键字段的标记,SubmissionResponse是出口类,用来返回一个×××值,这个×××值返回新增的记录的ID。

   2  添加一个SubmissionService.cs类,这个类中定义一个服务,用来添加一条新闻。

 public class SubmissionService : Service    {        public DataRepository Repo { get; set; }        public object Any(Submission submission)        {            int id = Repo.AddSubmission(submission);            return new SubmissionResponse() {Id = id};        }    }

   DataRepository 是注入的数据库服务类,这个类的定义在DataRepository.cs中(后面将说明这个类),在服务类文件定义中,包含有三个关键的和接口相关的项,

public object Any(Submission submission)

    其中的object是出口类,也就是服务响应用户的请求后,返回给客户端的数据,这个数据是强类型的,可以在客户端自动转换为JSON、JSV、XML等格式。object可以返回任意类型数据,建议写成实际的数据类型,可以提高性能和可读性,这里实际的返回类型是SubmissionResponse,也就是出口类指定的数据类型。

  Any 是允许的HTTP请求类型,支持的类型有GET、POST、PUT和DELETE以及PATCH等,对应的数据库访问功能分别为读取、添加、修改和删除,Any表示支持所有类型操作,如果明确这项操作的类型,要求写成实际的操作类型。

   传入的参数Submission submission是入口类数据,对于新增和修改操作,一般入口类是实体类,对应会操作数据库的一个表。这里通过 Submission 操作数据库中的Submission 表。

    服务和入口出口类的说明图:

    

(注:图中的服务和类和代码中的并不是同一个,这里主要是用作结构和用法的说明)

    3   添加DataRepository.cs数据库访问类,在该类中添加一个IDbConnectionFactory 类型的属性,和添加新闻的服务。

        public IDbConnectionFactory DbConnectionFactory { get; set; }        //public IDbConnectionFactory DbFactory { get; set; }        public int AddSubmission(Submission request)        {            using (var db = DbConnectionFactory.OpenDbConnection())            {                db.CreateTable
();                db.Insert(request);                return (int) db.GetLastInsertId();            }        }

     

   主要参考资料 :  Getting Started with ASP.NET MVC, ServiceStack and Bootstrap