站点和站点服务

1.1       配置站点

在第二章中，我们介绍过站点由若干MapGuide服务器组成，MapGuide服务器包括站点服务器和支持服务器两类服务器。MapGuide服务器和Web应用服务器和MapGuide Web扩展部署到不同的计算机上，例如在图4-1中，站点由两台MapGuide服务器组成，其中一台用作站点服务器，一台用作支持服务器，这两台服务器和MapGuide Web扩展都部署在不同的计算机上。这时，它们都必须相互知道彼此的IP地址和通信端口，MapGuide Web扩展需要知道站点服务器的IP地址，这样才能够将来自客户端的请求转发给站点服务器；站点服务器也需要知道支持服务器的地址，这样才能将服务请求转发到部署了此服务的支持服务器。

图4-1 站点示例

 

通过MapGuide Web扩展配置文件webconfig.ini，MapGuide Web扩展能够找到站点服务器的IP地址和通信端口。打开这个文件，查看SiteConnectionProperties部分的内容，可以看到类似如下的信息，IpAddress和Port就是用来指定站点服务器的IP地址和通信端口。

[SiteConnectionProperties] # ***************************************************************************** # S I T E  C O N N E C T I O N # # Property Name                    Description # ----------------------------------------------------------------------------- # IpAddress                        The IP address of the site server #                                       0 < Length <= 255 # Port                             The port to use for site operations # #                                  WARNING: If you change the port # here you #                                           must also change the corresponding #                                           port # for the server configuration #                                           file. # # ***************************************************************************** IpAddress                          =127.0.0.1 Port                               = 2812

通过MapGuide 服务器配置文件serverconfig.ini，够找到站点服务器的IP地址和通信端口，以及当前服务器是否部署了某种服务。打开这个文件，查看SiteConnectionProperties部分的内容，IpAddress和Port就是用来指定站点服务器的IP地址和通信端口；查看HostProperties部分的内容，属性DrawingService、FeatureService、KmlService、MappingService、RenderingService、ResourceService、SiteService、TileService用于指定是否部署这些服务到当前服务器上。

[SiteConnectionProperties] # ***************************************************************************** # S I T E  C O N N E C T I O N # # Property Name                    Description # ----------------------------------------------------------------------------- # IpAddress                        IP address of the site server #                                       0 < Length <= 255 # MaxConnections                   Max # of open site connections #                                       0 < Value <= 1024 # Port                             Port to use for site operations # #                                  WARNING: If you change the port # here you #                                           must also change the corresponding #                                           port # for the web tier configuration #                                           file. # # QueueSize                        Max # of site operations to queue #                                       0 < Value <= 1024 # ThreadPoolSize                   # of threads available for processing #                                  site operations #                                       0 < Value <= 1024 # ***************************************************************************** IpAddress                          = 127.0.0.1 MaxConnections                     = 20 Port                               = 2812 QueueSize                          = 20 ThreadPoolSize                     = 10   [HostProperties] # ***************************************************************************** # H O S T # # Property Name                    Description # ----------------------------------------------------------------------------- # DrawingService                  0 = service unavailable, 1 = service available # FeatureService                   0 = service unavailable, 1 = service available # KmlService                      0 = service unavailable, 1 = service available # MappingService                  0 = service unavailable, 1 = service available # RenderingService                 0 = service unavailable, 1 = service available # ResourceService                  0 = service unavailable, 1 = service available # SiteService                      0 = service unavailable, 1 = service available # TileService                      0 = service unavailable, 1 = service available # ***************************************************************************** DrawingService                     = 1 FeatureService                      = 1 KmlService                        = 1 MappingService                    = 1 RenderingService                   = 1 ResourceService                    = 1 SiteService                        = 1 TileService                        = 1

1.2       站点服务

站点服务是MapGuide其他类型服务的基础，它主要用于：

l  认证用户信息，如用户是否存在，密码是否正确。

l  创建MapGuide提供的服务，如资源服务、要素服务等。

l  枚举用户、用户组、角色等信息。

l  管理Session。

1.2.1  创建到站点服务器的连接

类MgSiteConnection用于创建到站点服务器的连接，调用方法MgSiteConnection::Open(…)就可以创建一个到站点服务器的连接，在此我们需要通过MgUserInformation的一个实例提供用户认证信息，例如用户名、密码或Session ID。需要注意的是，在创建到站点服务器的连接之前，一定要确保调用MgInitializeWebTier(…)初始化了Web层。

void Open(MgUserInformation userInformation)

如下的代码展示了如何创建一个到站点服务器的连接。

// 初始化Web层 MgInitializeWebTier('C:/Inetpub/wwwroot/PhpMapAgent/webconfig.ini'); // 创建到站点的连接 $userInformation = new MgUserInformation('Administrator', 'admin'); $siteConnection = new MgSiteConnection(); $siteConnection->Open($userInformation);

1.2.2  创建MapGuide提供的服务

类MgServiceType定义了MapGuide提供的所有服务：

l  MgServiceType::ResourceService：资源服务

l  MgServiceType::DrawingService：制图服务

l  MgServiceType::FeatureService：制图服务

l  MgServiceType::MappingService：制图服务

l  MgServiceType::RenderingService：制图服务

l  MgServiceType::TileService：制图服务

l  MgServiceType::KmlService：KML服务

查看上面定义的服务，我们可以发现MgServiceType并没有定义站点服务，这是因为MgServiceType中定义的服务恰恰是由站点服务创建的。调用方法MgSiteConnection::CreateService(…)可以创建一个指定类型的服务，参数serviceType用来服务类型，它可以是MgServiceType中定义的任何一个值。需要注意的是，在使用此方法之前，要保证已经调用方法MgSiteConnection::Open(…)建立了一个到站点服务器的连接。

MgService CreateService(int serviceType)

下面的代码展示了如何创建一个要素服务。

$webconfigiDotIniPath = "C:/Program Files/MapGuideOpenSource/WebExtensions/www/webconfig.ini" MgInitializeWebTier($webconfigiDotIniPath); $adminUser = new MgUserInformation("Administrator", "admin"); $siteConnection = new MgSiteConnection(); $siteConnection->Open($adminUser); $siteConnection->CreateService(MgServiceType::FeatureService);

1.2.3  创建MgSite对象实例

类MgSite包含用来枚举用户、用户组和角色，以及管理Session的功能，但是MgSite并没有提供公有的构造方法，所以必须通过调用方法MgSiteConnection::GetSite()来获取一个MgSite对象的实例。需要注意的是，在调用此方法之前，要保证已经调用方法MgSiteConnection::Open(…)建立了一个到站点服务器的连接。

MgSite GetSite();

1.2.4  枚举用户、用户组和角色

方法MgSite::EnumerateGroups()用于返回一个XML格式的用户组列表, XML使用了文件GroupList-1.0.0.xsd指定的Schema。

MgByteReader EnumerateGroups();

在安装MapGuide服务器之后，如果没有添加任何用户组，调用此方法会返回如下的用户组列表，可以看到此时MapGuide服务器只创建了一个用户组“Everyone”。

<?xml version=”1.0” encoding=”UTF-8”?> <GroupList xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="GroupList-1.0.0.xsd">        <Group>               <Name>Everyone</Name>               <Description>Built-in group to include all users</Description>        </Group> </GroupList>

方法MgSite::EnumerateUsers(…)以XML格式返回指定用户组内的所有用户, XML使用了文件UserList-1.0.0.xsd指定的Schema，参数group用于指定一个用户组，如果将传入一个空的用户组名称，那么返回所有的用户。

MgByteReader EnumerateUsers(String group);

在安装MapGuide服务器之后，如果没有添加任何用户，调用此方法会返回如下的用户列表，可以看到此时MapGuide服务器创建了五个用户“Administrator”、“Anonymous”、“ Author”、“ WfsUser”和“WmsUser”。

<?xml version="1.0" encoding="UTF-8"?> <UserList xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="UserList-1.0.0.xsd">        <User>               <Name>Administrator</Name>               <FullName>Site Administrator</FullName>               <Description>Built-in account for administering the site</Description>        </User>        <User>               <Name>Anonymous</Name>               <FullName>Anonymous User</FullName>               <Description>Built-in account for guests with Viewer role</Description>        </User>        <User>               <Name>Author</Name>               <FullName>Map Author</FullName>               <Description>Built-in account for users with Author role</Description>        </User>        <User>               <Name>WfsUser</Name>               <FullName>WFS User</FullName>               <Description>Built-in account for WFS users with Viewer role</Description>        </User>        <User>               <Name>WmsUser</Name>               <FullName>WMS User</FullName>               <Description>Built-in account for WMS users with Viewer role</Description>        </User> </UserList>

方法MgSite::EnumerateRoles(…)用于返回指定用户所属的角色列表，参数user用于指定一个用户。

MgStringCollection EnumerateRoles(String user);

1.2.5  管理Session

在第二章，我们介绍过MapGuide在服务器层与Web层间引入了Session的概念，用来提高服务器层与Web层间请求和响应的性能。每个Session通过一个唯一的Session ID加以标识，例如“71b5d990-0000-1000-8000-005056c00008_eng”。调用方法MgSite::CreateSession()可以为当前用户创建一个Session，返回的字符串是新建Session的ID。在创建Session的同时，还会创建一个资源库，这个资源库绑定于当前用户，用于存储和当前用户相关的资源，例如临时图层等资源，它的生命周期和Session相同，当Session销毁的时候，它也同时销毁。关于资源和资源库的内容，我们会在后续章节进行介绍。

String CreateSession();

下面的代码展示了如何创建一个Session。

MgInitializeWebTier('C:/Inetpub/wwwroot/PhpMapAgent/webconfig.ini'); $userInformation = new MgUserInformation('Administrator', 'admin'); $siteConnection = new MgSiteConnection(); $siteConnection->Open($userInformation); $site = $siteConnection->GetSite(); $sessionID = $site->CreateSession(); $userInformation->SetMgSessionId($sessionID);

调用MgSite::DestroySession()可以销毁指定的Session，但是这个方法并不是必需的，当一个Session在设定的时间内没有任何和客户端的通信，那么MapGuide服务器会认为这个Session已经超时了，从而销毁它。通过服务器配置文件serverconfig.ini，我们可以设置这个值。打开这个文件serverconfig.ini，查看SiteServiceProperties部分的内容，可以看到类似如下的信息，SessionTimeOut用于设定超时阈值，SessionTimerIterval用于设定检查Session超时的时间间隔，它们的单位都为妙。

[SiteServiceProperties] # ***************************************************************************** # S I T E  S E R V I C E # # Property Name                    Description # ----------------------------------------------------------------------------- # SessionTimeout                   Time duration in seconds for when an idle #                                  session is expired #                                       0 < Value <= 86400 # SessionTimerInterval               Time interval in seconds for when the server #                                  checks for idle sessions #                                       0 < Value <= 2147483647 # ***************************************************************************** SessionTimeout                   = 1200 SessionTimerInterval               = 400

除了创建和销毁Session之外，还可以通过方法MgSite::GetCurrentSession()获得当前Session的ID，通过方法MgSite::GetUserForSession()获得当前Session对应的用户名称，例如如果以用户 “Administrator”登录创建了一个Session，那么调用此方法会返回字符串“Administrator”。

String GetCurrentSession();

String GetUserForSession();