MYCP开发指南系列之：开发第一个C++ APP

1

开发第一个
C++ APP

C++ APP
是MYCP
业务层组件，用于处理业务逻辑。

1.1

cspApp.cpp

文件

新建一个cspApp.cpp
文件，或者利用VC
新建一个普通DLL
类型工程项目。

1.2

添加头文件

#include
<CGCBase/httpapp.h>

#include
<CGCBase/cgcServices.h>

using
namespace
cgc;

1.3

实现应用服务接口

class
CAppService


: public
cgcServiceInterface

{

public
:


typedef
boost::shared_ptr<CAppService> pointer;


static
CAppService::pointer create(void
)


{


return
CAppService::pointer(new
CAppService());


}


virtual
tstring serviceName(void
) const
{return
_T("AppService"
);}

protected
:


virtual
bool
callService(int
function, const
cgcValueInfo::pointer&
inParam, cgcValueInfo::pointer outParam)


{


theApplication->log(LOG_INFO,
"AppService callService = %d/n"
,
function);


return
true
;


}


virtual
bool
callService(const
tstring& function, const
cgcValueInfo::pointer& inParam, cgcValueInfo::pointer outParam)


{


theApplication->log(LOG_INFO,
"AppService callService = %s/n"
,
function.c_str());


return
true
;


}


virtual
cgcAttributes::pointer getAttributes(void
) const
{return
theAppAttributes;}

};

定义CappService
服务接口，继承于cgcServiceInterface
，实现callService
函数，getAttributes
函数用于实现组件的参数管理，详细代码请看samples/cspApp/cspApp.cpp
文件。

1.4

导出应用服务接口

extern
"C"
void
CGC_API
CGC_GetService(cgcServiceInterface::pointer & outService, const
cgcValueInfo::pointer& parameter)

{


CAppService::pointer appService
= CAppService::create();


appService->initService();


outService = appService;


cgcAttributes::pointer
attributes = theApplication->getAttributes();


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


theAppAttributes->setAttribute(ATTRIBUTE_NAME,
outService.get(), appService);

}



extern
"C"
void
CGC_API CGC_ResetService(cgcServiceInterface::pointer
inService)

{


if
(inService.get() == NULL) return
;


theAppAttributes->removeAttribute(ATTRIBUTE_NAME,
inService.get());


inService->finalService();

}

1.5

编译部署

编译cspApp
工程，生成cspApp.dll
或者libcspApp.so
文件，复制文件到$(MYCP_BINPATH)/modules
目录。

修改$(MYCP_BINPATH)/conf/modules.xml
文件，在app
配置项增加一个组件配置项；

<app>

…

<module>

<file>cspApp</file>

<allowall>1</allowall>

</module>

…

</app>

设置组件文件，允许开放所有函数。

1.6

CSP

调用
cspApp

组件

以下内容为调用cspApp
组件的CSP
代码，详细请看bin/web/samples/csp-app.csp
文件：

    
<csp:define type="app" id="$var_app" name="cspApp" />

<h1>Call APP Function</h1>

call $var_app "info" function.<br>

    
<csp:app:call id="$var_app" name="info" />

call result: <%=_$result%><br>

<br>

<b>See MYCP console print info.</b><br>

cspApp SourceCode see Samples/cspApp/cspApp.cpp<br>

<h1>APP Get/Set Function</h1>

set $var_app p1 = 1111111<br>

    
<csp:app:set id="$var_app" name="p1" in="1111111" />

get $var_app p1 to $var_p2<br>

    
<csp:app:get id="$var_app" name="p1" out="$var_p2" />

$var_p2 = <%=$var_p2%><br>

<h1>Final APP</h1>

    
<csp:reset id="$var_app" />

$var_app reset ok<br>

浏览器访问如下图：

1.7

配置访问
C++ APP

组件

以上例子演示如何定义一个C++ APP
组件，在页面退出的时候需要清空该组件变量；为了方便开发者使用C++ APP
应用组件；MYCP
支持通过配置apps.xml
文件，部署好所有的C++ APP
应用组件，配置好的应用组件，直接在CSP
页面用A$
变量直接使用，不需要定义，和清空操作。

配置例子请看conf/HttpServer/apps.xml
文件；

使用例子请看bin/web/samples/csp-app-fs.csp
文件等例子；

1.8

总结

本节学习如何开发一个C++ APP
应用组件，包括定义实现服务接口、实现接口函数、接口参数管理和导出服务接口等。