SharePoint Client Object Model API 介绍以及工作原理解析

zhaoh

CSOM和ServerAPI 的对比
　　SharePoint从2010开始引入了Client Object Model的API（后文中用CSOM来代替），从名字来看，我们可以简单的看出，该API是面向客户端的应用程序的。有这个这套API，使得所有SharePoint的终端用户 可以开发自己的应用程序来访问，修改SharePoint。下面的列表简述了CSOM和Server API的区别：

	COM	Server
运行端	可以在任何能够访问SharePoint的机器上运行 可以再浏览器上，.Net应用程序上，Silver light，JavaScript，Jscript运行	运行在SharePoint的服务器端
权限要求	必须指定一个用户，以该用户的权限操作SharePoint	运行Server代码本身有一定的权限要求，可以通过管理员身份来操作SharePoint数据
支持功能	较少，智能实现客户端常用的功能	更强大，实现大部分SharePoint管理操作

　　

COM工作原理
　　COM通过WCF来实现的，在SharePoint的服务器端寄宿在.../_vti_bin/client.svc，通过Web Binding来实现请求的批处理。处理的整个过程为：

• 把请求命令序列化成XML
  

• 通过HttpRequest的形式发送给服务器
  
• 服务器对于每一个命令，都会调用对于的Server 方法
  
• 服务器端将结果序列化成JSON格式返回给客户端
  
• CSOM将JSON转换成对于的Object给调用者
  

　　由于Http本身是无状态的，COM不需要和服务器一直保持一个连接。CSOM同时也具有WebRequest具有的一系列特点。
　　

COM实例介绍
　　本段简单的介绍一下COM的使用的基本方式，如果获取一个SiteCollection对象的Id：



        private static void Main(string[] args)
{
ServicePointManager.ServerCertificateValidationCallback = delegate
{
return true;
};

using (ClientContext clientContext = new ClientContext("https://cnblogtest.sharepoint.com"))
{
var pasword = new SecureString();
"abc123!@#".ToCharArray().ToList().ForEach(pasword.AppendChar);
clientContext.Credentials = new SharePointOnlineCredentials("test001@cnblogtest.onmicrosoft.com", pasword);//设置权限
var testsite = clientContext.Site;
clientContext.Load(testsite);//设置查询信息
//此处会出异常因为没有执行查询
//Console.WriteLine("Sitecollection info:" + testsite.Id);
clientContext.ExecuteQuery();//执行查询
//此处可以正常返回SiteId
Console.WriteLine("Sitecollection info:" + testsite.Id);
}
}

　　
　　下面我们简单看一下这段代码的请求：
　　Http的头信息：
　　POST https://cnblogtest.sharepoint.com/_vti_bin/client.svc/ProcessQuery HTTP/1.1
　　X-RequestDigest: 0x5EBACC6A87E51042B53355DCD0AC99A30F055126FC18752E5F2C9DFFAD327A37EB8818EE48677BF9434002DDA05E0F420106E17313DFF9F7A951D891A3021FE3,27 Sep 2014 10:41:29 -0000
　　Content-Type: text/xml
　　X-RequestForceAuthentication: true
　　X-FORMS_BASED_AUTH_ACCEPTED: f
　　Cookie: SPOIDCRL=77u/PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz48U1A+VHJ1ZSwwaC5mfG1lbWJlcnNoaXB8MTAwMzdmZmU4YjQ5Y2M3M0BsaXZlLmNvbSwwIy5mfG1lbWJlcnNoaXB8dGVzdDAwMUBjbmJsb2d0ZXN0Lm9ubWljcm9zb2Z0LmNvbSwxMzA1NjcyMDA4ODY4MTM0NTEsRmFsc2UsVDBJWUFlWVRiMEc0bHNuZVBIMTB4R3lvYVQyd3FIS3JMaTU0bXE0bXZNOGlKUXl0MlFFRjNTT29qWmI2Nk1iOVZjOUJjKzhPNkx3RG42UWtacGxzVGtHOUd5OHFiczhFUnYyK2NZQkJGeFlXWkNXSGxiV2wrUEdWc3FkeWJyOXZSYWFtQ3FLSkRrejVEYnZOYnFHTDcvRy9LWUF1RjV3LzNIK1RQbXFYaXJ2MUo4eWFEYzh3KzFyTmxRTG9objVma3NDWUdUNVVHcmdWNFNOd1UrTnRnQ2xUNEtqSE1yOHFSR0VnblJ0clp6MnU2VEVPMkZsRnFMSUtTY2hrSGdrU01OdzdTMzUzczdQMUY3MmhQVVErQ3pZQkU4VGVDTFovMy90VmZwdWdnOWkxS1dTenNEL0MwZ2ZIQnJRSExUS2RDVE9vYVo1VVlGYTZmczRVOFZmbmV3PT0saHR0cHM6Ly9jbmJsb2d0ZXN0LnNoYXJlcG9pbnQuY29tL192dGlfYmluL2lkY3JsLnN2Yy88L1NQPg==
　　Host: cnblogtest.sharepoint.com
　　Content-Length: 548
　　Expect: 100-continue
　　Accept-Encoding: gzip, deflate
　　这里面一些关键点我们可以看到：

• 请求方式HttpPost
  
• X-RequestForceAuthentication，需要Server端强制验证
  

　　Http请求内容：

　　这里面简单的解释一下：

• ObjectPathId=1 的对象为content.Current对象
  
• ObjectPathId=3的对象为content.Current.Site对象　　　　
  
• 我们对ObjectPathId为3的对象，请求所有的属性，因此SelectAllProperties=true
  

　　实际上，我们每一次在Client端创建一个对象的时候，都会分配一个对应ObjectPathId，这个Id是自增的。这个Id存储在Microsoft.SharePoint.Client.ObjectPath中，所有的Client API对象都从这个类中，继承ObjectPathId属性。

　　Reponse信息：
　　这个请求返回的Response的JSON内容如下：

　　可以看到，JSON对象里面包含了我们要请求的Site对象的所有属性信息，CSOM在接收到Response的时候，用JSON对象组装成COM对象，我们就可以调用了。因此Console.Writeline会显示出Site的Id。