中文字幕精品三区,亚洲第一区中文99精品,成人三级毛片

帅子 — Thu, 14 Apr 2011 16:25:00 GMT

同样�Q�在介绍MapGuide 服务器如何处理枚举资源操作之前，让我们首先来看看MapGuide 服务器用于处理服务请求和操作的类�Q�图19�?昄��服务��h��处理器类的类图，�?9�?0昄��了操作处理器�cȝ��c�d��?/p>

�?span class="Apple-converted-space"> 19�?0 服务��h��处理器类的类�?/p>

�?span class="Apple-converted-space"> 19�?1 操作处理器类的类�?/p>

MapGuide提供了资源服务、要素服务等多种服务�Q�每�U�服务包含了大量操作。MapGuide为每�U�服务提供了一个服务请求处理器�c�，用于处理�q�些服务所提供的操作，例如MgResourceServiceHandler、MgFeatureServiceHanlder�{�。这些类都��承自IMgServiceHandler�Q��ƈ且实��C��Ҏ(gu��)��IMgServiceHandler::ProcessOperation(...)。MapGuide使用工厂�c�MgServiceHanlderFactory来创��Z��个服务请求处理器�cȝ��实例�Q�给定一个服务ID�Q�调用方法MgServiceHandlerFactory::GetHandler(...)可以创徏对应的服务请求处理器�cȝ��实例�?/p>

对于服务中的每种操作�Q�MapGuide也提供了相应的操作处理器�c�R��从�?9�?0可以看到�Q�操作处理器�c�d��为四个层�ơ，最高一层是�c�IMgOperationHandler�Q�它是所有操作处理类的基�c�，�W�二层是�c�MgServiceOperation�Q�第三层是类MgXXXOperation�Q�“XXX”代表服务名�U�ͼ�在这一层每�U�类型的服务都有一个对应的�c�，例如MgFeatureOperation、MgResourceOperation�{�，�W�四层�ؓ(f��)真正负责工作的操作处理器�c�，每种服务中的每个操作都有一个对应的操作处理器类�Q�某�U�服务中操作处理器类都��承自同一个父�c�，例如MgEnumerateResource、MgSetResource都��承自MgResourceOperation�?/p>

接下来让我们看看MapGuide服务器如何处理枚举资源操作，�q�个操作��程的时序图如图 19�?1所�C��?/p>

�?span class="Apple-converted-space"> 19�?2 MapGuide服务器处理枚举资源操作的时序�?/p>

1�Q?在线�E�池中找一个空闲的�U�程执行操作

MapGuide服务器��用了多线�E�和�U�程池的技术来提高操作处理和响应请求的性能。在MapGuide服务器启动时�Q�会(x��)创徏一个操作请求队列和一个用于处理操作请求的�U�程池。当一个操作请求进入操作队列，MapGuide服务器会(x��)在线�E�池中找一个空闲的�U�程执行操作。如果没有空闲的�U�程�Q�那么这个操作请求会(x��)处于�{�待状态，直到�U�程池中有了�I�闲的线�E��?/p>

首先�Q�让我们查看一下服务器的入口函数的源代码，看看服务器是如何启动的。MapGuide服务器可以像普通的应用�E�序一栯��行，�q�可以在Windows操作�pȝ��可以�q�行为Windows服务�Q�在Linux操作�pȝ��q�行为守护进�E�，下面的代码中只保留了�q�行为普通应用程序部分的代码�?/p>

typedef ACE_Singleton SERVER;

int ACE_TMAIN(int argc, ACE_TCHAR *argv[])

{

int nResult = 0;

......

// 初始化ACE服务

ACE::init();

......

// �Ҏ(gu��)��命��o(h��)行参数执行响应的操作

if((ACE_OS::strcasecmp(parameter, ACE_TEXT("?")) == 0) ||

(ACE_OS::strcasecmp(parameter,

MG_WCHAR_TO_TCHAR(MgResources::ServerCmdHelp)) == 0))

{

// 昄��服务器命令行参数

ShowCommandlineHelp();

......

}

else if((ACE_OS::strcasecmp(parameter,

MG_WCHAR_TO_TCHAR(MgResources::ServerCmdRun)) == 0) ||

(ACE_OS::strcasecmp(parameter,

MG_WCHAR_TO_TCHAR(MgResources::ServerCmdInteractive)) == 0))

{

ACE_OS::printf(MG_WCHAR_TO_CHAR(MgResources::ServerCmdRunInfo));

......

// 以普通应用程序的方式�q�行服务�?/p>

nResult = SERVER::instance()->init(argc, argv);

if(0 == nResult)

{

// 启动服务

nResult = SERVER::instance()->open();

// �l�止服务

SERVER::instance()->fini();

}

......

}

......

// �l�止ACE服务

ACE::fini();

return nResult;

}

在上面的代码中，我们可以看到大量以“ACE”�ؓ(f��)前缀的类�Q�这些类是ACE自适配通信环境�Q�Adaptive Communication Environment�Q�工具包中的�c�R��ACE是一个开源的工具包，它实��C��许多用于�q�发通信软�g的核心模式。ACE的目标用��h��在UNIX和W(xu��)in32�q�_��上开发高性能通信服务和应用的开发者。ACE��化了使用�q�程间通信、事件多路分��R��显式动态链接和�q�发的OO�|�络应用和服务的开发。ACE提供了一�l�丰富的可复用C++ Wrapper Facade�Q�包装外观）(j��)和框架组�Ӟ��可跨��多�U��^台完成通用的通信软�g��d��Q�其中包括：(x��)事�g多�\分离和事件处理器分派、信号处理、服务初始化、进�E�间通信、共享内存管理、消息�\由、分布式服务动态（重）(j��)配置、�ƈ发执行和同步�{��?/p>

�c�MgServer�l�承自AEC工具包中的类ACE_NT_Service或ACE_Service_Object�Q�对应于服务器的�ȝ��E�，�?9�?2昄��了服务器�ȝ��E�类的类图。MgServer::svc()是主�U�程的入口，调用�Ҏ(gu��)��MgServer::open()�?x��)启动主�U�程�q�且执行�Ҏ(gu��)��MgServer::svc()�Q�调用MgServer::fini()�?x��)终止主�U�程。MapGuide使用了Singleton模板ACE_Singleton��MgServer��装��Z��个单实例�c�，��Z��方便使用MapGuide使用typedef为ACE_Singleton定义了一个别名SERVER�Q�调用方法SERVER::instance()可以创徏�c�MgServer的一个实例�?/p>

�?span class="Apple-converted-space"> 19�?3 服务器主�U�程�cȝ��c�d��

MgServer::svc()是主�U�程的入口，该方法会(x��)创徏一个操作请求队列和一个用于处理操作请求的�U�程池，它的代码如下所�C�。事实上�Q�该�Ҏ(gu��)��q�定义了其它�c�d��的队列和�U�程池，��Z��便于理解我们省略掉了�q�些代码�?/p>

int MgServer::svc()

{

MgServerManager* pServerManager = MgServerManager::GetInstance();

// 创徏�U�程��理器和操作�U�程

ACE_Thread_Manager threadManager;

MgOperationThread clientThreads(threadManager,

pServerManager->GetClientThreads());

pServerManager->SetClientMessageQueue(clientThreads.msg_queue_);

MgClientAcceptor clientAcceptor(clientAddr, ACE_Reactor::instance(),

clientThreads.msg_queue_);

nResult = clientAcceptor.Initialize();

if(nResult == 0)

{

// 启动�U�程�?/p>

nResult = clientThreads.Activate();

if(nResult == 0)

{

// 通知操作�U�程停止执行

ACE_Message_Block* mb = new ACE_Message_Block(4);

if(mb)

{

mb->msg_type(ACE_Message_Block::MB_STOP);

clientThreads.putq(mb);

}

// 停止操作�U�程

clientThreads.close();

// �{�待所有操作线�E�执行完�?/p>

threadManager.wait();

threadManager.close();

}

return nResult;

}

上面的代码中创徏一个类MgOperationThread的实例，该对象创��Z��一个线�E�池�Q�维护了一个操作请求队列。类MgOperationThread �l�承自ACE工具包中的模板类AEC_Task�Q�对应于操作�U�程�Q�图19�?3昄��了操作线�E�类的类图。ACE_Task��装了�Q务，每个��d��都含有一或多个线�E�，以及(qi��ng)一个底层消息队列。方法ACE_Task::svc()是线�E�的启动入口�Q�调用方法ACE_Task::open()用于初始化�Q务，调用�Ҏ(gu��)��ACE_Task::close()用于�l�止��d��Q�调用方法ACE_Task::activate()用于启动�U�程�Q�调用方法ACE_Task::putq()攄��消息��C�Q务的消息队列中，调用�Ҏ(gu��)��ACE_Task::getq()从�Q务的消息队列中取出消息�?/p>

�?span class="Apple-converted-space"> 19�?4 操作�U�程�cȝ��c�d��

�Ҏ(gu��)��MgOperationThread::svc()是操作线�E�的入口�Q�它的代码如下所�C��?/p>

int MgOperationThread::svc()

{

INT32 nResult = 0;

while (m_bActive)

{

ACE_Message_Block* messageBlock = NULL;

// 从消息队列中取出消息

while (getq(messageBlock) == -1)

{

......

}

if(messageBlock->msg_type() == ACE_Message_Block::MB_STOP)

{

m_bActive = false;

ACE_Message_Block* mb = new ACE_Message_Block(4);

if(mb)

{

mb->msg_type(ACE_Message_Block::MB_STOP);

putq(mb);

}

else if(messageBlock->msg_type() == ACE_Message_Block::MB_DATA)

{

MgServerStreamData* pData =

dynamic_cast(messageBlock->data_block());

IMgServiceHandler::MgProcessStatus stat = ProcessMessage(messageBlock);

......

}

return nResult;

}

IMgServiceHandler::MgProcessStatus MgOperationThread::ProcessMessage(ACE_Message_Block* pMB)

{

IMgServiceHandler::MgProcessStatus stat = IMgServiceHandler::mpsError;

MgServerStreamData* pData = NULL;

pData = (MgServerStreamData*) pMB->data_block();

......

MgStreamParser::ParseStreamHeader(pData);

MgStreamParser::ParseDataHeader(pData);

MgPacketParser::MgPacketHeader pt = MgPacketParser::GetPacketHeader(pData);

switch ( pt )

{

case (MgPacketParser::mphOperation):

stat = ProcessOperation( pData );

break;

......

}

return stat;

}

从上面的代码可以看到�Q�方法MgOperationThread::svc()�?x��)调用方法getq(�?循环讉K��消息队列�Q�取出等待处理的消息。如果是数据�c�d��的消息，那么调用�Ҏ(gu��)��MgOperationThread:: ProcessMessage(...)处理�q�个消息。方法MgOperationThread::ProcessMessage(...)�?x��)解析这个消息的头和数据�Q�如果消息数据中包含了一个操作请求，那么调用�Ҏ(gu��)��MgOperationThread:: ProcessOperation(�?处理�q�个操作��h��?/p>

2�Q?处理服务��h��

�Ҏ(gu��)��MgOperationThread::ProcessOperation(�? 首先�?x��)解析消息数据中的服务ID、操作ID、操作的版本��L(f��ng)��信息�Q�然后根据服务ID使用工厂�c�MgServiceHanlderFactory来创��Z��个服务请求处理器�cȝ��实例�Q�最后调用这个服务请求处理器�cȝ��Ҏ(gu��)��IMgServiceHandler:: ProcessOperation(...)处理�q�个服务��h��?/p>

本节的示例中客户端发送的是一个枚举资源的操作��h��Q�所以工厂类�?x��)创��Z��个MgResourceServiceHandler的实例，调用�Ҏ(gu��)��MgResourceServiceHandler::ProcessOperation(...)处理�q�个服务��h��?/p>

IMgServiceHandler::MgProcessStatus

MgOperationThread::ProcessOperation(MgServerStreamData* pData)

{

IMgServiceHandler::MgProcessStatus stat = IMgServiceHandler::mpsError;

MgOperationPacket op;

MgStreamHelper* pHelper = NULL;

pHelper = pData->GetStreamHelper();

pHelper->GetUINT32(op.m_PacketHeader);

pHelper->GetUINT32(op.m_PacketVersion);

pHelper->GetUINT32(op.m_ServiceID);

pHelper->GetUINT32(op.m_OperationID);

pHelper->GetUINT32(op.m_OperationVersion);

IMgServiceHandler* pServiceHandler =

MgServiceHandlerFactory::Instance()->GetHandler(op.m_ServiceID, pData, op);

delete pServiceHandler;

pServiceHandler = NULL;

stat = pServiceHandler->ProcessOperation();

return stat;

}

3�Q?处理操作��h��

首先�Q�方法MgResourceServiceHandler::ProcessOperation(...)�?x��)根据操作请求的ID�Q�调用资源操作工厂类的方法MgResourceOperationFactory::GetOperation(�?创徏相应的资源服务操作类MgOpEnumerateResources的实例。然后，调用MgOpEnumerateResources:: Initialize(...)初始化枚举资源操作处理器�Q�调用方法MgServiceManager::RequestService(�?创徏服务器资源服务MgServerResourceService的实例。最后，调用�Ҏ(gu��)��MgOpEnumerateResources::Execute()处理操作��h��Q�该�Ҏ(gu��)��?x��)调用MgServerResourceService::EnumerateResources(�?实际执行枚�D资源的功能�?/p>

IMgServiceHandler::MgProcessStatus MgResourceServiceHandler::ProcessOperation()

{

IMgServiceHandler::MgProcessStatus status = IMgServiceHandler::mpsError;

auto_ptr handler;

MG_TRY()

handler.reset(MgResourceOperationFactory::GetOperation(

m_packet.m_OperationID, m_packet.m_OperationVersion));

assert(NULL != handler.get());

handler->Initialize(m_data, m_packet);

handler->Execute();

status = IMgServiceHandler::mpsDone;

MG_CATCH(L"MgResourceServiceHandler.ProcessOperation")

if (mgException != NULL && NULL != handler.get())

{

status = (handler.get()->HandleException(mgException) ?

IMgServiceHandler::mpsDone : IMgServiceHandler::mpsError);

}

if (IMgServiceHandler::mpsDone != status)

{

MG_THROW();

}

return status;

}

void MgOpEnumerateResources::Execute()

{

......

BeginExecution();

......

Validate();

Ptr byteReader = m_service->EnumerateResources(resource, depth,

type, properties, fromDate, toDate, computeChildren);

EndExecution(byteReader);

......

}

帅子 2011-04-15 00:25 发表评论

帅子 — Thu, 14 Apr 2011 16:24:00 GMT

本节中，我们��通过介绍如何完成枚�D资源功能来介�l�MapGuide Web扩展的部分源代码�?/p>

在浏览器端的地址栏输入类似如下字�W�串�Q�就�?x��)发送一个枚举资源的HTTP��h��?/p>

http://hostname/mapGuide/mapagent.fcig?OPERATION=EnumerateResources&VERSION=1.0.0& RESOURCEID=Library:// &TYPE=FeatureSource&DEPTH=3

下面我们来看看MapGuide Web扩展如何处理�q�个��h��?/p>

在介�l�MapGuide Web扩展如何处理枚�D资源HTTP��h��之前�Q�让我们首先来看看MapGuide Web扩展用于处理HTTP��h��和响应的�c�，�q�些�cȝ��c�d��如图19�?所�C��?/p>

�?19�? HTTP��h��和响应类的类�?/p>

�c�MgHttpRequest和类MgHttpResponse分别是对HTTP��h��和响应结果的抽象�Q�这两个�c�d��以用于�Q何类型的Web应用服务器，也就是说它们的代码不依赖于�Q何Web应用服务器API。在文�g夹“\MgDev\Web\src\HttpHandler”下可以扑ֈ�所有前�~�为“MgHttp”类的源代码�?/p>

�c�MgHttpRequest用于处理HTTP��h��Q�它包含了一个HTTP��h��头MgHttpHeader的实例、一个HTTP��h��参数HttpRequestParam的实例和一个HTTP��h��元数据HttpRequestMetadata的实例。调用方法MgHttpRequest::Execute()�?x��)将HTTP��h��转发�l�MapGuide服务器，当MapGuide服务器处理完�q�个��h��Q�将��h��l�果�q�回�l�Web扩展之后�Q�这个方法会(x��)�q�回一个MgHttpResponse对象�Q�它表示HTTP��h��的响应结果�?/p>

接下来让我们看看MapGuide Web扩展如何处理枚�D资源的HTTP��h��。大多数MapGuide用户都是使用IIS作�ؓ(f��)Web应用服务器，�q�且使用Web扩展模块isapi_MapAgent.dll来处理HTTP��h��Q�所以本节侧重于isapi_MapAgent.dll模块处理HTTP��h��的流�E�，�q�个处理��程的时序图如图19�?所�C��?/p>

�?span class="Apple-converted-space"> 19�? Web扩展处理枚�D资源��h��的时序图

1�Q?加蝲Web应用服务器扩展模�?/p>

如果使用的是IIS Web应用服务�Q�那么在接收到后�~�为“fcgi”的HTTP��h��后，IIS�?x��)加载Web应用服务器扩展模块isapi_MapAgent.dll或MapAgent.exe。其中，isapi_MapAgent.dll��Z��IIS API�Q�具有更好的性能�Q�MapAgent.exe��Z��CGI技术，性能要稍微差一些。如果��用的是Apache Web应用服务器，那么在Windows�q�_��上Apache�?x��)加载Web应用服务器扩展模块MapAgent.exe�Q�在Linux�q�_��上会(x��)加蝲模块mod_mgmapagent.so�?/p>

�q�三个Web服务器扩展模块实��C��c�M��的功能，它们的源代码位置如表19�?所�C��?/p>

服务器扩展模�?/strong>	源代码位�\|?/strong>
isapi_MapAgent.dll	\Web\src\IsapiAgent
MapAgent.exe	\Web\src\CgiAgent
mod_mgmapagent.so	\Web\src\ApacheAgent

�?span class="Apple-converted-space"> 19�? Web服务器扩展模块的源代码位�|?/p>

从图19�?中可以看到这三个Web服务器扩展模块提供了�c�M��的类�Q�这些类提供了相同的接口�Q�类XXXPostParser用于解析HTTP��h��中传入的参数�?qi��ng)参数��|��c?strong>XXXResponseHandler用于��HTTP��h��的响应结果发送给客户端。其中，�?strong>XXX”表�C�“Cgi”、“Isapi”或“Apache”�?/p>

�?span class="Apple-converted-space"> 19�? Web扩展的请求处理模�?/p>

对于模块isapi_MapAgent.dll�Q�每个“fcgi”类型的HTTP��h��?x��)调用此模块中的��?gu��)��HttpExtensionProc�Q�这个方法的代码如下所�C�，��Z��便于理解我们只保留了一些核心代码�?/p>

DWORD WINAPI HttpExtensionProc(EXTENSION_CONTROL_BLOCK *pECB)

{

Initialize(pECB);

// 调用GetServerVariable��d��诸如服务器名�U�、端口号�{�服务器变量信息

......

// 创徏MgHttpRequest的实例，用于处理HTTP��h��

Ptr request = new MgHttpRequest(wUrl);

// 解析HTTP��h��中的参数�Q��ƈ且将�q�些参数�|�入MgHttpRequest对象�?/p>

Ptr params = request->GetRequestParam();

......

IsapiPostParser postParser(pECB);

postParser.Parse(params);

......

// 创徏IsapiResponseHandler的实例，用于��响应请求返回给客户�?/p>

IsapiResponseHandler responseHandler(pECB);

......

// ��HTTP��h��转发�l�MapGuide服务器，当MapGuide服务器处理完�q�个��h��Q?/p>

// ��请求结果返回给Web扩展之后�Q�这个方法会(x��)�q�回一个MgHttpResponse对象�Q?/p>

// 它表�C�HTTP��h��的响应结果�?/p>

Ptr response = request->Execute();

// ��响应结果返回给客户�?/p>

responseHandler.SendResponse(response);

......

}

2�Q?创徏MgHttpRequest的实例，用于处理HTTP��h��

在加载Web应用服务器扩展模块后�Q�需要创��Z��个MgHttpRequest的实例用于处理HTTP��h��。类MgHttpRequest�q�不兌��与�Q何类型的Web应用服务器，所以Web应用服务器扩展模块会(x��)使用�c?strong>XXXPostParser解析HTTP��h��中传入的参数�?qi��ng)参数��|��这些参数设�|�到MgHttpRequest对象中�?/p>

3�Q?调用�Ҏ(gu��)��MgHttpRequest::Execute()处理HTTP��h��

�Ҏ(gu��)��MgHttpRequest::Execute()的源代码如下所�C�。�ؓ(f��)了便于理解，我们同样只保留了一些核心代码�?/p>

MgHttpResponse* MgHttpRequest::Execute()

{

Ptr hResponse;

Ptr result;

// 创徏MgHttpResponse对象�Q�用于返回HTTP��h��响应�l�果

hResponse = new MgHttpResponse();

result = hResponse->GetResult();

// 获得HTTP��h��中参数“OPERATION”的�?/p>

STRING sParamValue = m_requestParam->GetParameterValue(MgHttpResourceStrings::reqOperation);

......

// �Ҏ(gu��)��参数“OPERATION”的值取得对应操作的��h��响应处理�?/p>

Ptr rrHandler =

CreateRequestResponseHandler(sParamValue, result);

.......

// 处理HTTP��h��

if(rrHandler != NULL) rrHandler->Execute(*hResponse);

......

// �q�回响应�l�果

return SAFE_ADDREF((MgHttpResponse*)hResponse);

}

每个HTTP��h��中包含一个参数“OPERATION”，它用于代表操作的�c�d��。对于不同的操作�Q�MapGuide定义了不同的��h��响应处理器类�Q�这个类�?x��)调用MapGuide服务中对应的�Ҏ(gu��)��处理�q�个操作�Q�这些请求响应处理器�cȝ��c�d��如图19�?所�C�。从�?9�?可以看到�Q�所有请求响应处理器�c�都�l�承自类MgHttpRequestResponseHandler�Q�每一�U�操作都有一个对应的子类�Q�例如枚举资源操作��用了�c�MgHttpEnumerateResources�Q�描�q�模式操作��用了�c�MgHttpDescribeSchema�?/p>

�?span class="Apple-converted-space"> 19�? HTTP��h��响应处理器的�c�d��

MapGuide定义了一个全局map对象用于存放每种操作对应的请求响应处理器�c�d��象，它的键是操作的名�U�ͼ�值是��h��响应处理器类对象�?/p>

// 定义一个全局map对象�Q�用于存放每�U�操作对应的��h��响应处理器类对象

static map

httpClassCreators;

bool InitializeStaticData()

{

httpClassCreators[MgHttpResourceStrings::opGetMap] =

MgHttpGetMap::CreateObject;

httpClassCreators[MgHttpResourceStrings::opGetMapUpdate] =

MgHttpGetMapUpdate::CreateObject;

httpClassCreators[MgHttpResourceStrings::opGetDrawing] =

MgHttpGetDrawing::CreateObject;

......

httpClassCreators[MgHttpResourceStrings::opDescribeDrawing] = MgHttpDescribeDrawing::CreateObject;

httpClassCreators[MgHttpResourceStrings::opEnumerateResources] = MgHttpEnumerateResources::CreateObject;

......

}

调用�Ҏ(gu��)��MgHttpRequest::CreateRequestResponseHandler(...)可以�Ҏ(gu��)��操作的名�U�获得对应的��h��响应处理器类对象。对于枚举资源操作，它会(x��)�q�回一个类MgHttpEnumerateResources的对象�?/p>

调用�q�些��h��响应处理器类的Execute(�?�Ҏ(gu��)��Q�会(x��)创徏一个代理服务类对象�Q�然后调用代理服务中对应的方法。�ؓ(f��)什么说创徏的是一个代理服务类对象呢？我想看完�?9�?之后大家�?x��)有所明白。从�?9�?中可以看刎ͼ�所有的MapGuide服务有两个子�c�，一个是名称为MgProxyXXXService的代理服务类�Q�它是MapGuide Web扩展端的一个类�Q�另一个是名称为MgServerXXXService的服务器服务�c�，它是MapGuide服务器端的一个类。MgProxyXXXService最�l�会(x��)��服务请求�{发给服务器端�c�MgServerXXXService�Q�所以说真正处理服务��h��的类是MgServerXXXService�Q�MgProxyXXXService仅仅起到一个�{发的作用�Q�这也就是�ؓ(f��)什么称�c�MgProxyXXXService��Z��理服务类的原因�?/p>

�?span class="Apple-converted-space"> 19�? 代理服务和服务器服务�cȝ��c�d��

对于枚�D资源操作�Q�MgHttpEnumerateResources::Execute(...)的源代码如下所�C�。调用这个方法会(x��)创徏一个代理资源服务类MgProxyResourceService的对象，然后调用MgProxyResourceService::EnumerateResources(...)枚�D资源�Q�最后将操作的执行结果放入MgHttpResponse对象中�?/p>

void MgHttpEnumerateResources::Execute(MgHttpResponse& hResponse)

{

Ptr hResult;

hResult = hResponse.GetResult();

// ��(g��)查HTTP��h��中的参数

ValidateCommonParameters();

// 创徏MgProxyResourceService实例

Ptr mgprService =

(MgResourceService*)(CreateService(MgServiceType::ResourceService));

......

// 执行枚�D资源操作

Ptr byteReader = mgprService->

EnumerateResources(&mgrIdentifier, m_depth, m_type, m_computeChildren);

// 如果需要，转换响应��h��的格�?/p>

ProcessFormatConversion(byteReader);

// ��操作结果放入响应请求中的MgHttpResult对象

hResult->SetResultObject(byteReader, byteReader->GetMimeType());

}

MgByteReader* MgProxyResourceService::EnumerateResources(

MgResourceIdentifier* resource, INT32 depth, CREFSTRING type,

INT32 properties, CREFSTRING fromDate, CREFSTRING toDate,

bool computeChildren)

{

MgCommand cmd;

cmd.ExecuteCommand(m_connProp,

MgCommand::knObject,

MgResourceService::opIdEnumerateResources,

Resource_Service,

BUILD_VERSION(1,0,0),

MgCommand::knObject, resource,

MgCommand::knInt32, depth,

MgCommand::knString, &type,

MgCommand::knInt32, properties,

MgCommand::knString, &fromDate,

MgCommand::knString, &toDate,

MgCommand::knInt8, (int)computeChildren,

MgCommand::knNone);

SetWarning(cmd.GetWarningObject());

return (MgByteReader*)cmd.GetReturnValue().val.m_obj;

}

4�Q?��HTTP��h��的响应结果返回给客户�?/p>

调用MgHttpRequest::Execute()�?x��)返回一个MgHttpResponse对象�Q�这个对象包含了HTTP��h��的响应结果。不�q�，�q�需要调用方�?strong>XXXResponseHandler::SendResponse(...)�Q�这样Web应用服务器才�?x��)将�q�个响应�l�果�q�回�l�客��L(f��ng)��?/p>

帅子 2011-04-15 00:24 发表评论

帅子 — Thu, 14 Apr 2011 16:23:00 GMT

MapGuide 代码的修改可以分��Z��大类�Q�功能增�?/span> (Ehancement) 和缺陷修�?/span> (Defect) �Q?/span> MapGuide 使用 Tickets 来管理和跟踪�q�些修改�Q�访�?/span> http://trac.osgeo.org/mapguide/report 可以��览和查询活动的和已�l�关闭的 Tickets �Q�对于功能增�?/span> MapGuide �q��用了 RFC �q�行��理。需要注意的是无论创�?/span> Tickets �q�是 RFC �Q�都需要有一�?/span> OSGeo 的帐��P��使用 OSGeo 帐户��d��后才可以创徏 Tickets �?/span> RFC �Q�访�?/span> https://www.osgeo.org/cgi-bin/ldap_create_user.py 可以注册一�?/span> OSGeo 的用戗��?/span>

1�Q?/span> �~�陷修正

如果你在使用 MapGuide 的过�E�中发现了一�?/span> Bug �Q�那么可以考虑创徏一�?/span> Ticket 。在创徏 Ticket 之前�Q�最好访�?/span> http://trac.osgeo.org/mapguide/search 查找是否已经有其他�h提交�q�类似的 Ticket �Q�或者给 mapguide-users 邮�g列表�?/span> email 问询是否见到�q�类似问题。在��Z��?/span> Bug 创徏 Ticket 之时�Q�需要提供一个完整的、可以重�?/span> Bug 的步骤，如果可能的话最好提供一�D�代码用于重�?/span> Bug �Q�最后填�?/span> �?/span> 18 �?span style="LINE-HEIGHT: 19px">3 所�C�的 Ticket 属性。其中， Priority 代表 Bug 的优先��Q?/span> Component 代表 Bug 所属的功能�l��g�Q?/span> Severity 代表 Bug 的严重性， Milestone 代表修正�?/span> Bug 的版本， Version 代表可以重现 Bug 的版本。最重要的是要填写正��的 Version ��|��如果不清楚需要�ؓ(f��)其他属性填写什么样的��|��那么可以��其他��g��留�ؓ(f��)�I�，在其他�h��(g��)阅和分配�q�个 Bug 时会(x��)��些属性填写合适的倹{�?/span>

�?span class="Apple-converted-space"> 18 �?/span> 3 Ticket的属�?/span>

2�Q?/span> 功能增强

如果要改�q?/span> MapGuide 现有的功能，或者添加一些新的功能，那么需要创��Z��?/span> RFC 。访�?/span> http://trac.osgeo.org/mapguide/wiki/MapGuideRfcs 可以��览现有�?/span> RFC �Q�通过�q�些 RFC 我们可以了解 MapGuide 的每个版本添加了哪些功能�Q�甚至下一个版本会(x��)��d��哪些新的功能�?/span> RFC ��面使用 Wiki 的方式进行维护，使用如下的步骤可以创��Z��个新�?/span> RFC �?/span>

1�Q?/span> 点击�?/span> login ”登录�?/span>

2�Q?/span> 点击�?/span> Edit this page ”编�?/span> RFC 列表��面�?/span>

3�Q?/span> 加入如下 Wiki 格式的字�W�串。其中，�?/span> XX ”代�?/span> RFC 的序��P��?/span> V.V ”代表实�?/span> RFC �?/span> MapGuide 版本受��?/span>

||[wiki:MapGuideRfcXX MapGuide RFC XX - xxxxxxxxxxxx]||draft||V.V||

4�Q?/span> 点击�?/span> Submit changes ”按钮提交修攏V�?/span>

5�Q?/span> 点击��链接�?/span> MapGuide RFC XX ”会(x��)出现一个新的页面用于创建新�?/span> RFC �?/span>

6�Q?/span> 在按�?/span> RFC 模板的格式创建完成新�?/span> RFC 之后�Q�发 email �l?/span> MapGuide 邮�g列表 mapguide-internals@lists.osgeo.org 要求 MapGuide 开源社区的��Z��评阅�?/span> RFC �?/span>

7�Q?/span> �?/span> RFC 发布一周后�Q��ƈ且解�{�了 MapGuide 开源社��Z�h们的所有问题之后，可以要求 PSC 的成员对�?/span> RFC 投票。如果由多于两个 PSC 成员同意�?/span> RFC �Q�没有�Q�?/span> PSC 成员反对�?/span> RFC �Q�那么此 RFC ��投��通过可以实现了�?/span>

8�Q?/span> 创徏一个类型�ؓ(f��)�?/span> enhancement ”的 Ticket 用于跟踪�q�个修改�?/span>

在修正了一个缺��h��实现了一�?/span> RFC 之后�Q�需要将相应的代码修改创��Zؓ(f��)一�?/span> SVN Patch 文�g�Q�将其上传到相应�?/span> Ticket 上便于开源社区的��Z��评阅此修改，在评阅完成之后就可以提交代码了。如果你不是��目开�?/span> 人员�Q�没有提交权限， ��目开�?/span> 人员�?x��)帮助你提交代码的�?/span>

帅子 2011-04-15 00:23 发表评论

帅子 — Thu, 14 Apr 2011 16:22:00 GMT

作�ؓ(f��) OSGeo 的一个子��目�Q?/span> MapGuide 遵守与其�?/span> OSGeo ��目的类似的��理方式�Q�由如下四类�l�织和角色进行项目的开发和��理�?/span>

1�Q?/span> ��目�{�划指导委员 �?span lang="EN-US" style="LINE-HEIGHT: 19px">(Project Steering Committee)

��目�{�划指导委员�?x��)简�U�Cؓ(f��) PSC �Q�负�?/span> MapGuide 开源项目的��理工作�Q�决�?/span> MapGuide 开源版的发布日期、哪些功能和�~�陷修正整合到那个发布版本、那些�h可以成�ؓ(f��)��目开发�h员等�Q�而且 PSC �q�负责定期�ؓ(f��) OSGeo 委员�?x��)提供项目状冉|��告�?/span>

2�Q?/span> ��目开�?/span> 人员(Project Developer)

��目开发�h员具�?/span> MapGuide 源代码的��d��权限�Q�能够直接修�?/span> MapGuide 的源代码�Q��ƈ且负责检阅项目捐助�h员的代码�Q�帮助他们提交代码�?/span>

3�Q?/span> ��目捐助人员(Project Contributor)

��目捐助人员也是 MapGuide 的开发�h员，但是没有 MapGuide 源代码的修改权限�Q�他们通过��目跟踪 (Tracker) 工具�?/span> MapGuide 贡献补丁 (Patch) 、代码、文档等�Q�项目开发�h员会(x��)��(g��)阅他们的修改�Q�和他们�q�行交流�Q�最后帮助他们提交代码。通常情况下，��目开发�h员是从项目捐助�h员着手做��P��在项目捐助�h员�A(ch��)献了大量有�h(hu��n)值的补丁 (Patch) 之后�Q�他�?x��)被提名为项目开发�h员，�?/span> PSC 投票同意之后�Q�他��׃��(x��)正式成�ؓ(f��)��目开发�h员，��h��?/span> MapGuide 代码的修�Ҏ(gu��)��限�?/span>

4�Q?/span> �?/span> �?span lang="EN-US" style="LINE-HEIGHT: 19px">(Users)

用户�?/span> MapGuide 的��用者，他们��Z�� MapGuide �q�行二次开发�?/span>

帅子 2011-04-15 00:22 发表评论

�~�译MapGuide

帅子 — Thu, 14 Apr 2011 16:21:00 GMT

如果惌��q��?span lang="EN-US" style="LINE-HEIGHT: 19px">MapGuide的源代码和运�?span lang="EN-US" style="LINE-HEIGHT: 19px">MapGuide�Q�那么请参�?span lang="EN-US" style="LINE-HEIGHT: 19px">MapGuide开源版的文�?span lang="EN-US" style="LINE-HEIGHT: 19px"> (http://mapguide.osgeo.org/documentation.html)�Q�各个版�?span lang="EN-US" style="LINE-HEIGHT: 19px">MapGuide的编译步骤基本相同，但是�l�节却不��相同，所以要扑ֈ�使用的源代码所对应的文档，严格按照文档中描�q�的步骤�~�译MapGuide�?/span>

因�ؓ(f��)MapGuide服务器和Web扩展是两个独立的�l��g�Q�所以它们也是独立编译的。编�?span lang="EN-US" style="LINE-HEIGHT: 19px">MapGuide服务器组件的基本步骤如下�Q?/span>

1�Q?/span> �~�译FDO

MapGuide 使用�?span lang="EN-US" style="LINE-HEIGHT: 19px">FDO来访�?span lang="EN-US" style="LINE-HEIGHT: 19px">GIS数据�Q�但�?span lang="EN-US" style="LINE-HEIGHT: 19px">MapGuide的源代码中�ƈ没有包含FDO的源代码�Q�所以需要开发�h员自�׃��?span lang="EN-US" style="LINE-HEIGHT: 19px">FDO的源代码和编�?span lang="EN-US" style="LINE-HEIGHT: 19px">FDO�?/span>

2�Q?/span> 讄��环境变量

需要注意的是不同版本的MapGuide源代码需要设�|�不同的环境变量�Q�所以要注意参考对应版本的文档�?/span>

3�Q?/span> �~�译CS-MAP

�?span lang="EN-US" style="LINE-HEIGHT: 19px">MapGuide开源版2.1之后�Q?span lang="EN-US" style="LINE-HEIGHT: 19px">MapGuide使用CS-MAP替代�?span lang="EN-US" style="LINE-HEIGHT: 19px">PROJ4来处理坐标系。现�?span lang="EN-US" style="LINE-HEIGHT: 19px">CS-MAP也是OSGeo的一个开源项目，在��?span lang="EN-US" style="LINE-HEIGHT: 19px">SVN下蝲MapGuide源码的时候会(x��)自动下蝲CS-MAP的代码，不过需要用��L(f��ng)��立编�?span lang="EN-US" style="LINE-HEIGHT: 19px">CS-MAP�?/span>

4�Q?/span> �~�译OEM

OEM ��是MapGuide所依赖的第三方�l��g�Q�例�?span lang="EN-US" style="LINE-HEIGHT: 19px">ACE�?span lang="EN-US" style="LINE-HEIGHT: 19px">SWIG�?span lang="EN-US" style="LINE-HEIGHT: 19px">DWF Toolkit�?span lang="EN-US" style="LINE-HEIGHT: 19px">FDO�?span lang="EN-US" style="LINE-HEIGHT: 19px">Oracle Berkeley DB XML�{�，MapGuide服务器和Web扩展都依赖于OEM�Q�所以在�~�译MapGuide服务器和Web扩展旉��需要编�?span lang="EN-US" style="LINE-HEIGHT: 19px">OEM�Q�但是只需要编译一�ơ�?/span>

�?span lang="EN-US" style="LINE-HEIGHT: 19px">Windows�q�_��上，打开文�g�?span lang="EN-US" style="LINE-HEIGHT: 19px">\MgDev\Oem\下的Visual Studio Solution文�goem.sln��可以编�?span lang="EN-US" style="LINE-HEIGHT: 19px">OEM�l��g�?/span>

5�Q?/span> �~�译MapGuide服务�?/span>

�q�部分代码是MapGuide服务器真正的代码�Q�在Window�q�_��上打开文�g�?span lang="EN-US" style="LINE-HEIGHT: 19px">\MgDev\Server\下的Visual Studio Solution文�gServer.sln��可以编�?span lang="EN-US" style="LINE-HEIGHT: 19px">MapGuide服务器�?/span>

�~�译MapGuide Web扩展的步骤如下：(x��)

1�Q?/span> 安装JDK

MapGuide Web 扩展需要安�?span lang="EN-US" style="LINE-HEIGHT: 19px">Java JDK 1.3或更高的版本�Q�如果没有安�?span lang="EN-US" style="LINE-HEIGHT: 19px">JDK�Q�请讉K��http://java.sun.com下蝲安装它�?/span>

2�Q?/span> 讄��环境变量

需要注意的是不同版本的MapGuide源代码需要设�|�不同的环境变量�Q�所以要注意参考对应版本的文档�?/span>

3�Q?/span> �~�译OEM

OEM �l��g只需要编译一�ơ，如果在编�?span lang="EN-US" style="LINE-HEIGHT: 19px">MapGuide服务器时已经�~�译�?span lang="EN-US" style="LINE-HEIGHT: 19px">OEM�Q�那么无需重新�~�译�?/span>

4�Q?/span> �~�译MapGuide Web扩展

�q�部分代码是MapGuide Web扩展真正的代码，�?span lang="EN-US" style="LINE-HEIGHT: 19px">Window�q�_��上打开文�g�?span lang="EN-US" style="LINE-HEIGHT: 19px">\MgDev\Web\src下的Visual Studio Solution文�gWebTier.sln��可以编�?span lang="EN-US" style="LINE-HEIGHT: 19px">MapGuide Web扩展�?/span>

帅子 2011-04-15 00:21 发表评论

帅子 — Thu, 14 Apr 2011 16:20:00 GMT

MapGuide 源代码的目录�l�构�?/span> �?/span> 18 �?span style="LINE-HEIGHT: 19px">1 �?/span> �?/span> 18 �?span style="LINE-HEIGHT: 19px">2 所�C�，在后�l�的章节中我们将重点介绍 Common �?/span> OEM 、服务器�?/span> Web 扩展部分的源代码�?/span>

文�g�?/span>	描述
Installer	MapGuide 安装�E�序的源代码�?/span>
MgDev	MapGuide 服务器和 Web 扩展的源代码�?/span>
BuildTools	l �~�译 MapGuide 需要��用的一些工兗��?/span>
Common	l MapGuide 服务器和 Web 扩展共同依赖的一些模块�?/span>
Doc	l MapGudie 文档、应用程序示例和生成 MapGuide 文档需要用到的工具�?/span>
OEM	l MapGuide 所依赖的第三方�l��g�?/span>
Server	l MapGuide 服务器的源代码�?/span>
UnitTest	l MapGuide Web 扩展单元��试代码�?/span>
Web	l MapGuide Web 扩展的源代码�?/span>
Tools	MapGuide Maestro 的源代码�Q�关�?/span> Maestro 更详�l�的信息请参�?/span> 2.1.3.2.2 �?/span>

�?span class="Apple-converted-space"> 18 �?/span> 1 MapGuide源代码目录结�?/span>

帅子 2011-04-15 00:20 发表评论

MapGuide源码分析

帅子 — Thu, 14 Apr 2011 16:20:00 GMT

如果要访�?/span> MapGuide 的源代码�Q�需要先安装一�?/span> Subversion 的客��L(f��ng)��Q�通过 Subversion 的网�?/span> ( http://subversion.tigris.org/ ) 可以了解到关�?/span> Subversion 最��的信息。一般情况下�Q�推荐大家��?/span> TortoiseSVN 讉K�� MapGuide 的源代码�Q�它?y��u)?/span> SVN 客户端和 Windows Shell 很好地整合在一��P��?/span> TortoiseSVN 的网�?/span> ( http://tortoisesvn.tigris.org/ ) 上可以下载到最新版本的 TortoiseSVN �?/span>

Subversion 仓储的位�|��ؓ(f��) http://svn.osgeo.org/mapguide/ �Q�在 Windows Shell 中点击鼠标右键，选择菜单�?/span> SVN Checkout ”将昄��?/span> �?/span> 18 �?span style="LINE-HEIGHT: 19px">1 所�C�的用户界面�Q�在�?/span> Checkout Directory ”中输入代码下蝲位置�Q�然后点几Z�?/span> OK ”按钮就可以下蝲 MapGuide 的源代码。在�?/span> Trunk ”目录下包含的是 MapGuide 最新的源代码，在�?/span> branches ”目录下包含�?/span> MapGuide 从版�?/span> 1.0.0 �?/span> 2.1 的所有源代码�?/span>

�?span class="Apple-converted-space"> 18 �?/span> 1 TortoiseSVN用于Checkout代码的用��L(f��ng)��?/span>

如果仅仅是希望浏�?/span> MapGuide 的源代码�Q�可以访�?/span> http://trac.osgeo.org/mapguide/browser 在浏览器中浏�?/span> MapGuide 的源代码�?/span>

帅子 2011-04-15 00:20 发表评论

MapGuide Web API

帅子 — Thu, 14 Apr 2011 16:18:00 GMT

许多人都知道MapGuide提供�?NET、PHP和Java三种�c�d��的Web API�Q�但是不知道MapGuide是如何创��三种�c�d��的API的。试想一下，如果分别��d��三种API�Q�这��是一个很隄��护的工作。每�ơ增加或修改一些功能，��需要对三种�c�d��的API都进行修攏V��所以，MapGuide使用了SWIG来自动生成这三种�c�d��的API。我惌��个时候许多�h�?x��)问�Q�什么是SWIG呢？我怎么从来没有听说�q�这个东东呢�Q�其实，我也是在做MapGuide开发的时候才开始了解SWIG的。所以，首先让我们来认识一下SWIG�Q�然后再来看MapGuide是如何��用SWIG来生成API的�?/p>

1. SWIG��?/strong>

    SWIG是Simple Wrapper and Interface Generator的羃写，是一个帮助��用C或者C++�~�写的��Y件创建其他编语言的API的工兗��例如，我想要�ؓ(f��)一个C++�~�写的程序创�?NET API�Q�一般情况下我必��M��用托��C++(Managed C++)�ȝ��写大量的代码才能生成它的.NET API。有了SWIG�Q�这个机械的工作��变得非常简单。你只须要��用一个接口文件告诉SWIG要�ؓ(f��)那些�c�d��?NET API�Q�SWIG��׃��(x��)自动帮你生成它的.NET API。是不是非常的酷啊？

    当然�Q�SWIG不仅仅支持创�?NET API。最新版本的SWIG支持常用脚本语言Perl、PHP、Python、Tcl、Ruby和非脚本语言C#, Common Lisp (CLISP, Allegro CL, CFFI, UFFI), Java, Modula-3, OCAML以及(qi��ng)R�Q�甚��x��~�译器或者汇�~�的计划应用�Q�Guile, MzScheme, Chicken�Q��?/p>
    下面我们通过一个例子来看看SWIG是如何帮我们创徏API的。假设我打算为如下的C++�c�d��建C#和Java的API�?/p>
    /* SwigTest.h */

    class CSwigTest {
    public:
        CSwigTest();
        virtual ~CSwigTest();
        int Add(int a, int b) { return a + b; }
        int Substract(int a, int b) { return a - b; }

        int Multiple(int a, int b) { return a * b; }
        float Divide(int a, int b) { return (float)a / (float)b; }
    };

1.1 接口文�g

    首先�Q�你需要写一个接口文�?Interface File)�Q�告诉SWIG要�ؓ(f��)那些�cȝ��那些�Ҏ(gu��)��创徏API。如下的接口文�g只�ؓ(f��)�c�CSwigTest的方法Add(...)和Subtract(...)生成API�Q�因为在接口文�g的接口声明部分只声明了两个方法�?/p>
    /* SwigTest.i */
    %module SwigTest
    %{
    #include "SwigTest.h"
    %}

/* --- 接口声明部分 ---*/
    class CSwigTest {
    public:
        int Add(int a, int b);

        int Substract(int a, int b);

    };

    注解�Q?module标记用于定义SWIG生成的模块的名称�Q?{%}标记中的内容�?x��)被一字不差地插入SWIG自动生成的文件xxx_wrapper.c中，其中xxx代表�?module指定的模块名�U�。这个文件会(x��)在下面介�l�，不必着急去理解它究竟有什么作用�?/p>
    如果打算为类中所有方法创建API�Q�那么有一个非常简单的办法�Q�在接口文�g的类声明部分使用%include标记。SWIG��对%include所指定的文件进行语法分析，�c�M��所有公有方�?Public Method)都将在API中暴霌Ӏ?/p>
    /* SwigTest.i */
    %module SwigTest
    %{
    #include "SwigTest.h"
    %}
    #include “SwigTest.h”�?/p>
1.2 �~�译模块

    有了接口文�g之后�Q�剩下的事就是执行几条命令。下面我们以Windows�q�_��上生�?NET API��Z��介绍�q�些命��o(h��)�?/p>
    (a) 调用SWIG自动生成代码

    swig -csharp SwigTest.i

    执行上面的命令会(x��)产生一个C语言文�gSwigTest_wrapper.c和多个C#文�g。在文�gSwigTest_wrapper.c中，SWIG为接口文件中接口声明部分指定的每个方法��生一个全局�Ҏ(gu��)��Q�以便C#使用Pinvoke调用�q�些函数。而那些C#文�g��是用来生成.NET API的�?/p>
    (b) 为C++代码生成DLL(动态链接库)

    cl SwigTest_wrapper.c *.cpp

    link *.obj /out:SwigTest.dll

    执行上面的命令，�?x��)��?f��)我们�~�写C(j��)++代码生成DLL。在�~�译C++文�g�Ӟ��一定要包括SWIG为我们生成的C++文�gSwigTest_wrapper.cpp�?/p>
    注意�Q��ؓ(f��)了让大家便于理解上述命��o(h��)�Q�这些命令�ƈ没有列出完整的编译和链接选项�?/p>
    (C) 生成.NET模块

    csc /out:SwigTestNotNetAPI.dll /target:library *.cs

    执行上面的命令就生成�?NET API模块SwigTestNotNetAPI.dll。如果用��h��使用�q�些API�Q�只需要添加对SwigTestNotNetAPI.dll的引�?Reference)��可以了�?/p>
    生成其它语言�c�d��API的命令基本类��|��下面我们再以Java在Unix�q�_��下的命��o(h��)��Z��l�束对SWIG的介�l�。事实上�Q�SWIG也是一个开源项目。如果想了解更多关于SWIG的信息，大家可以登陆SWIG的官方网�?a style="COLOR: rgb(51,102,153); TEXT-DECORATION: none" >www.swig.org�Q�那里有SWIG最详细的资料�?br />    $ swig -java SwigTest_wrapper.i
   $ gcc -c *.cpp SwigTest_wrapper.c -I/c/jdk1.3.1/include -I/c/jdk1.3.1/include/win32
   $ gcc -shared *.o -mno-cygwin -Wl,--add-stdcall-alias -o SwigTest.dll

2. SWIG在MapGuide中的应用

    我们在前面已�l�提到过�Q�MapGuide使用了SWIG来自动生�?NET、Java和PHP�q�三�U�类型的API。但是，SWIG也有不少限制和缺��P��所以MapGuide对SWIG源代码进行了大量的修改，以满��q��要求。下面，我们看看�q�些改进�?/p>
2.1 IMake工具

    SWIG要求开发�h员编写一个接口文�Ӟ��那么能否让接口文件自动生成呢�Q�借用一句中国移动的�q�告词，我能�Q�虽然SWIG没有提供�q�方面的工具�Q�但是我们可以自己开发吗�Q�IMake(Interface Maker)��是��Z��满��q�样的要求而开发一个工��P��l�定一个XML文�g�Q�它能帮你自动生成SWIG接口文�g。登录MapGuide开源版的代码浏览页�?http://trac.osgeo.org/mapguide/browser)�Q�在root/trunk/MgDev/BuildTools/WebTools/IMake文�g夹下可以扑ֈ�IMake的源代码�?/p>
     下面我们以MapGuide中��用的XML文�g/trunk/MgDev/Web/src/MapGuideApi/MapGuideApiGen.xml��Z��Q�介�l�一下IMake的用法。�ؓ(f��)了便于理解，在此我删掉了文�g中的部分内容�?/p>










        #include <string>
        #include <map>
        #include "MapGuideCommon.h"
        #include "WebApp.h"
        ......










        %include "language.i"   //typemaps specific for each language
        ......






        ......



    执行命��o(h��)“IMake MapGuideApiGen.xml”，IMake��帮我们自动生成了如下SWIG接口文�gMapGuideApi.i�?/p>
    /* MapGuideApi.i */
    %module MapGuideApi
    %{
        #include ;
        #include ;
        #include "MapGuideCommon.h"
        #include "WebApp.h"
        ......
    %}

    %include "language.i"   //typemaps specific for each language
    ......

    class MgProperty: public MgNamedSerializable
    {
    public:
        virtual INT16 GetPropertyType();
        STRING GetName();
        void SetName(CREFSTRING name);
    };

    ......

    如果打开文�gProper.h�Q�我们可以看到MgProperty有更多的�Ҏ(gu��)��Q�例如CanSetName(...)。�ؓ(f��)什么只有三个方法添加到了SWIG接口文�g中？IMake在生成接口文件时�Q�它�?x��)查找C++头文件中的宏PUBLISHED_API。只有被PUBLISHED_API修饰的方法，才会(x��)��d��到接口文件中�?/p>
    注：(x��)宏PUBLISHED_API和INTERNAL_API的定义如下�?/p>
    #define PUBLISHED_API public

    #define INTERNAL_API public

    class MG_FOUNDATION_API MgProperty : public MgNamedSerializable
    {
    PUBLISHED_API:

        virtual INT16 GetPropertyType() = 0; /// __get
        STRING GetName(); /// __get, __set
        void SetName(CREFSTRING name);

    INTERNAL_API:
        virtual bool CanSetName();

    protected:
        INT32 GetClassId();
        MgProperty();
        virtual ~MgProperty();
        virtual void Dispose();
        virtual void ToXml(string &str, bool includeType = true, string rootElmName = "Property") = 0;

    private:
        friend class MgPropertyCollection;
        STRING m_propertyName;

    CLASS_ID:
        static const INT32 m_cls_id = Foundation_Property_Property;
    };
    �l�定一个C++帔R��定义文�g�Q�IMake�q�可以自动生成对应的其他语言的常量定义文件。MapGuide .NET Web API中的所有常量都是��用IMake来生成的�Q�例如MgMineType、MgPropertyType�{�。下面我们以MapGuide中��用的XML文�g/trunk/MgDev/Web/src/MapGuideApi/Constants.xml��Z��Q�介�l�如何自动生成各�U�语�a�的常量定义文件。同��P��Z��便于理解�Q�在此我删掉了文件中的部分内宏V��与MapGuideApiGen.xml不同�Q�Constants.xml包含一个新的元素Classes用来指出需要在目标语言中��生对应的帔R��cȝ��C++�c�R�?br />








        ......




        ......




        ......


    OSGeo.MapGuide
    org.osgeo.mapguide






        ......







        ......




    执行命��o(h��)“IMake.exe Constants.xml C# Constants.cs”，IMake��帮我们自动生成了一个C#帔R��文�gConstants.cs。对于文�?trunk/MgDev/Common/Foundation/Data/PropertyType.h中定义了如下帔R��Q?/p>
    class MgPropertyType
    {
    PUBLISHED_API:
       static const int Null     = 0;
       static const int Boolean = 1;
       static const int Byte     = 2;
       static const int DateTime = 3;
       static const int Single   = 4;
       ......
    };

    在生成的Constants.cs文�g中，有如下的�c�d��义�?br />    class MgPropertyType
    {
       static const int Null     = 0;
       static const int Boolean = 1;
       static const int Byte     = 2;
       static const int DateTime = 3;
       static const int Single   = 4;
       ......
    };

    �q�个文�g可以被C#的编译器直接�~�译�Q�所以MapGuide没有使用SWIG生成帔R��的API�Q�而是直接使用IMake。如果想生成PHP或Java的常量定义文�Ӟ��只需要将IMake命��o(h��)的参�?C#"替换�?PHP"�?Jave"��可以了�?/p>
2.2 MapGuide对SWIG的修�?/strong>
    在MapGuide开始��用SWIG的时候，可用的SWIG的最高版本是1.3.21�Q�从那以后MapGuide在没有升�U�过SWIG。所以，到现在�ؓ(f��)止，MapGuide的SWIG版本仍然�?.3.21。这个版本的SWIG有不��限制和�~�陷�Q?/p>

无法创徏��Z��自定义根异常�c�MgException的异常处理机制�?/li>
无法创徏属�?Property)�?/li>
�Ҏ(gu��)��些方法无法��生正��的API。例如，如果�Ҏ(gu��)��GetA(...)�q�回的是�c�A的子�c�B的实例，SWIG创徏的API�q�回的仍然是A�cȝ��实例。此时如果你把返回��D�{换�ؓ(f��)�c�B�Q�那么�{换会(x��)��p�|�?br />    A* GetA();

......

    事实上最新的SWIG版本也没有全部解册��些问题，所以MapGuide对SWIG源代码进行了大量的修改，以满��q��要求。看看MapGuide在��用SWIG命��o(h��)是传入的参数�Q�我们可以发现有许多参数不是SWIG标准的参敎ͼ�例如proxydir、clsidcode、clsiddata、catchallcode�{��?/p>

swig -c++ -csharp -dllname MapGuideUnmanagedApid -namespace OSGeo.MapGuide -proxydir .\custom -baseexception MgException -clsidcode getclassid.code -clsiddata m_cls_id -catchallcode catchall.code -dispose "((MgDisposable*)arg1)->Release()" -rethrow "e->Raise();" -nodefault -noconstants -module MapGuideApi -o MgApi_wrap.cpp -lib ..\..\..\Oem\SWIGEx\Lib MapGuideApi.i

    在此�Q�我们不打算一一介绍�q�些参数�Q�因为在多数情况下你没有必要对了解参数的含义。我们只介绍MapGuide是如何来解决上述SWIG的第二和�W�三个问题的�Q�因为在扩展MapGuide Web API的时候你可能�?x��)用得着�?/p>

2.2.1 创徏属�?/strong>
    如果你看�q�MapGuide源代码的话，你会(x��)发现有许多方法声明之后有“__get”、“__set”或“__get, __set”这��L(f��ng)��注释�Q�如�c�MgProperty中的�Ҏ(gu��)��?br />    class MgProperty : public MgNamedSerializable
    {
    PUBLISHED_API:
        virtual INT16 GetPropertyType() = 0; /// __get
        STRING GetName(); /// __get, __set
        void SetName(CREFSTRING name);
        ......
};
    �q�些注释是有�Ҏ(gu��)��含义的，它们��是用来解决上述SWIG的第二个问题的。当IMake工具扫描C++头文件时发现�q�注释后�Q�会(x��)在目录�?\custom”下为每个类产生一个帮助创建属性的代码文�g。例如，如果要类MgProperty生成.NET API�Q�IMake�?x��)在�?\custom”生成一个文件名为MgProperty的C#代码文�g�Q�它的内容如下：(x��)
    public int PropertyType {
        get {return GetPropertyType(); }
    }
    public int Name {
        get { return GetPropertyType(); }
        set { setName(value);}
    }
    如果在SWIG的命令行中��用了参数proxydir�Q�那么SWIG在�ؓ(f��)每个�cȝ��成代码的时候，�?x��)在proxydir所指定的目录下查找和类名相同的文�g�Q��ƈ且将�q�个文�g中的代码插入�cȝ��目标代码中。通过�q�种办法�Q�就解决了上�q�SWIG的第二个问题�?/p>
2.2.2 ClassId
    MapGuide Web API中的所有类都是从MgObject�l�承而来的，在类MgObject中有一个方法GetClassId()用来�q�回每个�c�d��一的ID倹{��MapGuide��是用这个方法来解决上述SWIG的第三个问题的，所以如果要在MapGuide Web API中增加一个新�c�，一定要覆盖(override)�q�个�Ҏ(gu��)��Q��ƈ且提供一个唯一的ID倹{�?br />    class MgObject
    {
    EXTERNAL_API:
        virtual INT32 GetClassId();
        virtual STRING GetClassName();
    INTERNAL_API:
        virtual ~MgObject();
        bool IsOfClass(INT32 classId);
    };

3. 扩展MapGudie Web API

    如果你发现现有的MapGuide Web API无法满��你的要求�Q�没有关�p�，你可以去��试扩展它，因�ؓ(f��)MapGuide是开源的�?/p>
    如果要新�ȝ��Q�基本步骤如下：(x��)
    (a) 修改C++代码�Q�添加新的类。对于需要暴露于API的方法，使用宏PUBLISHED_API修饰�?br />    (b) 修改XML文�g/trunk/MgDev/Web/src/MapGuideApi/MapGuideApiGen.xml的Headers部分�Q��ؓ(f��)每个新添加类所在的C++头文件增加一个Header元素。下面的�C�Z��中，"path"代表C++头文件的路径�Q?filename.h"代表文�g的名�U��?br />


        ......

    (c) 重新�~�译MapGuide的Web模块(/trunk/MgDev/Web/src/)�?br />
    如果要增加一些新的方法到现有的类中，基本步骤如下�Q?br />    (a) 修改C++代码�Q�添加新的方法，�q�且使用宏PUBLISHED_API修饰�q�些�Ҏ(gu��)��?br />    (b) 重新�~�译MapGuide的Web模块(/trunk/MgDev/Web/src/)�?/p>
    如果要新增常量类�Q�基本步骤如下：(x��)
    (a) 修改C++代码�Q�添加新的常量类�?br />    (b) 修改XML文�g/trunk/MgDev/Web/src/MapGuideApi/Constants.xml�Q�在Classes部分为每个新��d��帔R��c�d��加一个Class元素�Q�在Headers部分为每个新��d��帔R��c�L��在的C++头文件增加一个Header元素。下面的�C�Z��中，"ClassName"代表新添加的C++帔R��cȝ��名称�?/p>


        ......




        ......

    (c) 重新�~�译MapGuide的Web模块(/trunk/MgDev/Web/src/)�?/p>

帅子 2011-04-15 00:18 发表评论