Adaptive AUTOSAR CM模块介绍(三)

上个模块介绍了CM模块大体的框架，这一小节，聊一下ara::com的API
（一）API简介
1.API设计的一个目标是使其尽可能精简.。这是设计的原则之一，既然AP的CM模块的通讯是SOME/IP，那么它的API设计就是仅提供支持基于服务的通讯的基本机制：
方法、事件、字段。
因此，ara:：com不提供任何类型的组件模型或框架工作。这些负责模型或框架的组件生命周期、程序流管理需要调用ara:：comneneneba API对象

2.为了增强可用性、舒适性和优雅感，ara:：com API利用C++智能指针、模板函数、异步运算和运算符重载。

（二）数据类型

• 指针：传递一个指针
• 结构体：传递一个结构体
• 异步通信的结果：c++ 应用std::future/std::promise
• 函数包装：std::function

(三) 错误通知
ara::core::ErrorCode
ara::core::Result
当调用函数封装的时候，错误通知是以ara::core::Result 和 ara::core::Future

(四）API元素设计
这里给了一个例子说明interface是怎么设计的，interface应该是ARXML类型的，不好阅读，AUTOSAR给出了更好阅读的demo:
RadarService{
type RadarObjects{
active：bool
objects: array{
element: uint8
size: variable
}
}
}

event BrakeEvent{
type: RadarObjects
}
解释下：
RadarService是定义了一个服务接口， 服务接口里面定义接口的数据类型。
event事件定义的时候就会调用这个接口，在上边的例子中，BrakeEvent就调用了RadarObjects结构体类型。
error CalibrationFailed{
errorCode: 1
errorContext:{
failureText: string
}
}
method Calibrate{
param configuration{
type: string
direction: in
}
param result{
type: bool
direction:out
}
raises{
CalibrationFailed
}
}
解释下：上面定义了error类型和method方法的类型。在method方法定义里面需要定义的是方法的输入输出以及方法的输入输出的类型，direction是输入输出类型，in是输入， out是输出。 type是其结构类型。
raises类似于捕捉，捕捉错误的，这里调用了上面的error, 说明捕捉了上面的error
CalibrationFailed.