下面我建立一个服务的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