[Sharepoint2007对象模型]第三回:Web应用程序(SPWebApplication)

在Sharepoint的管理中心创建一个网站的顺序大致如下:创建Web应用程序-〉创建网站集。所以Web应用程序是网站的一个基础,在一个Web应用程序下可以创建多个网站,本回就主要来介绍Web应用程序这个对象模型以及如何使用对象模型来创建一个Web应用程序。
首先来看看Web应用程序主要包含哪些内容:
1、网站集,指的是这个Web应用程序包含哪些网站,我们可以通过Sharepoint的管理中心看到:

[Sharepoint2007对象模型]第三回:Web应用程序(SPWebApplication)对应的对象模型为:SPSite

            TreeNode nodeSite = nodeWeb.Nodes.Add("网站集");
            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));
            }


3、作业,指的是这个web应用程序有哪些计时器作业,它的对象模型是:SPRunningJob

            TreeNode nodeRunningJob = nodeWeb.Nodes.Add("作业");
            foreach (SPRunningJob job in application.RunningJobs)
            {
                nodeRunningJob.Nodes.Add(job.JobDefinitionTitle);
            }

在Sharepoint的管理中心可以看到:
[Sharepoint2007对象模型]第三回:Web应用程序(SPWebApplication)

4、作业定义,是包含作业的一些定义信息,对应的对象模型为:SPJobDefinition

            TreeNode nodeJobDef = nodeWeb.Nodes.Add("作业定义");
            foreach (SPJobDefinition jobDef in application.JobDefinitions)
            {
                nodeJobDef.Nodes.Add(jobDef.DisplayName);
            }


执行后的截图如下:
[Sharepoint2007对象模型]第三回:Web应用程序(SPWebApplication) 

创建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站点的端口为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;

[Sharepoint2007对象模型]第三回:Web应用程序(SPWebApplication)

主要是指定IIS应用程序池的名称和访问用户名、密码等属性

web应用程序的安全性设置:

            webAppBlder.UseNTLMExclusively = true; 
            webAppBlder.AllowAnonymousAccess = false;
            webAppBlder.UseSecureSocketsLayer = false;

在这里设置为使用NTLM验证,在Sharepoint中使用了NTLM和Kerberos两种验证方式,Kerberos相对来说比较复杂一点的。不使用SSL,不允许匿名访问

设置负载平衡的 URL:

            webAppBlder.DefaultZoneUri = new Uri("http://*****:9002");


设置web应用程序的数据库属性:

            webAppBlder.CreateNewDatabase = true;
            webAppBlder.DatabaseServer = "*****";
            webAppBlder.DatabaseName = "TestApp9002";
            webAppBlder.DatabaseUsername = string.Empty;

这里数据库用户名设为空值,表示使用Windows集成认证的方式

创建Web应用程序

SPWebApplication webApp = webAppBlder.Create();

实际的在Sharepoint的服务器场中创建一个web应用程序

设置Web应用程序的常规属性

           webApp.DefaultTimeZone = 45;
            webApp.Name = "TestApp-9002";
            webApp.Update();

这里的时区45表示的是GMT+08:00北京时区
这里的设置主要是模拟sharepoint管理中心里<Web应用程序常规设置>中的配置

创建 IIS Web 应用程序和应用程序池

webApp.Provision();


通过以上步骤就可以创建一个标准的Web应用程序了,当然现在创建的Web应用程序还是一个空壳子,没有实质内容。在下一回中我会重点介绍网站集(SPSite)这个对象模型,在Web应用程序里创建网站集来实现Web网站的访问。