[Sharepoint2007对象模型]第三回:Web应用程序(SPWebApplication)
在Sharepoint的管理中心创建一个网站的顺序大致如下:创建Web应用程序-〉创建网站集。所以Web应用程序是网站的一个基础,在一个Web应用程序下可以创建多个网站,本回就主要来介绍Web应用程序这个对象模型以及如何使用对象模型来创建一个Web应用程序。
首先来看看Web应用程序主要包含哪些内容:
1、网站集,指的是这个Web应用程序包含哪些网站,我们可以通过Sharepoint的管理中心看到:
对应的对象模型为:SPSite
TreeNode nodeSite = nodeWeb.Nodes.Add("网站集");
foreach (SPSite site in application.Sites)
{
nodeSite.Nodes.Add(site.Url);
}
foreach (SPSite site in application.Sites)
{
nodeSite.Nodes.Add(site.Url);
}
2、网站功能集,指的是这个web应用程序下包含哪些Feature,Feature是Sharepoint中一个比较重要的功能,可以参看我之前的文章,它对应的对象模型是:SPFeature
TreeNode nodeFeature = nodeWeb.Nodes.Add("网站功能集");
foreach (SPFeature feature in application.Features)
{
nodeFeature.Nodes.Add(GetFeatureName(feature.Definition));
}
foreach (SPFeature feature in application.Features)
{
nodeFeature.Nodes.Add(GetFeatureName(feature.Definition));
}
3、作业,指的是这个web应用程序有哪些计时器作业,它的对象模型是:SPRunningJob
TreeNode nodeRunningJob = nodeWeb.Nodes.Add("作业");
foreach (SPRunningJob job in application.RunningJobs)
{
nodeRunningJob.Nodes.Add(job.JobDefinitionTitle);
}
foreach (SPRunningJob job in application.RunningJobs)
{
nodeRunningJob.Nodes.Add(job.JobDefinitionTitle);
}
在Sharepoint的管理中心可以看到:
4、作业定义,是包含作业的一些定义信息,对应的对象模型为:SPJobDefinition
TreeNode nodeJobDef = nodeWeb.Nodes.Add("作业定义");
foreach (SPJobDefinition jobDef in application.JobDefinitions)
{
nodeJobDef.Nodes.Add(jobDef.DisplayName);
}
foreach (SPJobDefinition jobDef in application.JobDefinitions)
{
nodeJobDef.Nodes.Add(jobDef.DisplayName);
}
执行后的截图如下:
创建Web应用程序
在Sharepoint的管理中心可以通过界面创建Web应用程序,在界面上我们可以看到创建时主要需要如下属性:IIS 网站、安全性配置、负载平衡的 URL、应用程序池、数据库名称和验证。通过对象模型同样可以实现以上操作
首先需要取得创建Web应用程序的创建类
SPWebApplicationBuilder webAppBlder = new SPWebApplicationBuilder(CurrentFarm);
设置IIS站点属性:
webAppBlder.Id = Guid.NewGuid();
webAppBlder.Port = 9002;
webAppBlder.RootDirectory = new System.IO.DirectoryInfo(@"C:\Inetpub\wwwroot\wss\VirtualDirectories\9002");
这里我们指定创建的web站点的端口为9002webAppBlder.Port = 9002;
webAppBlder.RootDirectory = new System.IO.DirectoryInfo(@"C:\Inetpub\wwwroot\wss\VirtualDirectories\9002");
设置应用程序池的属性:
webAppBlder.ApplicationPoolId = "TestApp Pool-9012";
webAppBlder.IdentityType = IdentityType.SpecificUser;
webAppBlder.ApplicationPoolUsername = @"****\****";
SecureString appPoolPwd = new SecureString();
appPoolPwd.AppendChar('*');
appPoolPwd.AppendChar('*');
appPoolPwd.AppendChar('*');
appPoolPwd.MakeReadOnly();
webAppBlder.ApplicationPoolPassword = appPoolPwd;
主要是指定IIS应用程序池的名称和访问用户名、密码等属性webAppBlder.IdentityType = IdentityType.SpecificUser;
webAppBlder.ApplicationPoolUsername = @"****\****";
SecureString appPoolPwd = new SecureString();
appPoolPwd.AppendChar('*');
appPoolPwd.AppendChar('*');
appPoolPwd.AppendChar('*');
appPoolPwd.MakeReadOnly();
webAppBlder.ApplicationPoolPassword = appPoolPwd;
web应用程序的安全性设置:
webAppBlder.UseNTLMExclusively = true;
webAppBlder.AllowAnonymousAccess = false;
webAppBlder.UseSecureSocketsLayer = false;
在这里设置为使用NTLM验证,在Sharepoint中使用了NTLM和Kerberos两种验证方式,Kerberos相对来说比较复杂一点的。不使用SSL,不允许匿名访问webAppBlder.AllowAnonymousAccess = false;
webAppBlder.UseSecureSocketsLayer = false;
设置负载平衡的 URL:
webAppBlder.DefaultZoneUri = new Uri("http://*****:9002");
设置web应用程序的数据库属性:
webAppBlder.CreateNewDatabase = true;
webAppBlder.DatabaseServer = "*****";
webAppBlder.DatabaseName = "TestApp9002";
webAppBlder.DatabaseUsername = string.Empty;
这里数据库用户名设为空值,表示使用Windows集成认证的方式webAppBlder.DatabaseServer = "*****";
webAppBlder.DatabaseName = "TestApp9002";
webAppBlder.DatabaseUsername = string.Empty;
创建Web应用程序:
SPWebApplication webApp = webAppBlder.Create();
实际的在Sharepoint的服务器场中创建一个web应用程序设置Web应用程序的常规属性:
webApp.DefaultTimeZone = 45;
webApp.Name = "TestApp-9002";
webApp.Update();
webApp.Name = "TestApp-9002";
webApp.Update();
这里的时区45表示的是GMT+08:00北京时区
这里的设置主要是模拟sharepoint管理中心里<Web应用程序常规设置>中的配置
创建 IIS Web 应用程序和应用程序池:
webApp.Provision();
通过以上步骤就可以创建一个标准的Web应用程序了,当然现在创建的Web应用程序还是一个空壳子,没有实质内容。在下一回中我会重点介绍网站集(SPSite)这个对象模型,在Web应用程序里创建网站集来实现Web网站的访问。