CommFactory Class

CommFactory *cf1 = Comm::factory;
CommFactory *cf2 = CommFactory::defaultFactory();
qDebug() << (cf1 == cf2); // true
AbstractComm *chd = cf1->createComm("CommHalfDuplex");  // chd is an instance of ComHalfDuplex

CommFactory *cf3 = new CommFactory;
AbstractComm *ac = cf3->createComm("CommHalfDuplex");  // ac is an instance of ComFullDuplex instead of ComHalfDuplex

Comm::factory->add(ImplComm::staticMetaObject, ImplComm::commInfo);
...
Comm::manager->resetMode("ImplComm");  // Communicator has been changed to ImplComm

Member Function Documentation

CommFactory::CommFactory(QObject *parent = 0)

Default constructs an instance of CommFactory.

CommFactory::CommFactory(const CommFactory &cf)

Copy constructor.

void CommFactory::addComm(const QMetaObject &metaObject, const CommInfo &info)

CommFactory::addComm \param metaObject \param info 添加一个可用的 AbstractComm 元对象，存放相应的信息，用于构造 AbstractComm 实现类

example:

CommFactory factory;
factory.addComm(ComFullDuplex::staticMetaObject, ComFullDuplex::commInfo);  // factory can generate an Object points to ComFullDuplex
factory.createComm("CommFactory");

See also CommFactory::createComm(const QString &).

const QString CommFactory::commClassName(const QString &type, const bool halfDuplex)

根据通讯器类型和工作模式（是否为半双工）返回相应的通讯器类名 类名在构造通讯器时中用到

example:

factory = new ComFactory;
factory.addComm(ComHalfDuplex::staticMetaObject, ComHalfDuplex::commInfo);  // type: SerialPort, mode: half duplex
QString className = factory.commClassName("SerialPort", true); // ComHalfDuplex

QList<CommInfo> CommFactory::commInfo()

提供接口用于显示可用的通讯模式 返回的 comm 对象用于界面显示 m_commMap 包含的键值对中，键位类名，值为对应的 commInfo

example: 假设 m_commMap 中只存有 ComFullDuplex 这个类

QMapIterator<QString, CommInfo> it(m_commMap);
while(it.hasNext()) {
    it.next();
    qDebug() << it.key();           // output: "ComFullDuplex"
    qDebug() << it.value().type;    // output: "SerialPort"
    qDebug() << it.value().desc;    // output: "Full Duplex"
}

AbstractComm *CommFactory::createComm(const QString &className)

根据 className 例化相应的通讯实现类

目前支持的通讯类模式有

• 串口全双工模式
• 串口半双工模式
• 网络模式（全双工）
• 测试模式

className 对应的是 AbstractComm 子类的类名，根据类名构造子类对象， 若子类对象此前已经构造过，那么将会从保存的列表中直接取出子类对象的指针

CommFactory  *cf  = Comm::factory;
AbstractComm *ac  = cf->createComm("ComFullDuplex");
AbstractComm *ac2 = cf->createComm( "ComHalfDuplex" );
AbstractComm *ac3 = cf->createComm("ComFullDuplex");
Q_ASSERT( ac  != 0 );   // true
Q_ASSERT( ac2 != 0 );   // true
Q_ASSERT( ac2 != ac );  // true
Q_ASSERT( ac3 != 0 );   // true
Q_ASSERT( ac3 == ac );  // true
Q_ASSERT( ac3 != ac2 ); // true

See also Comm.

[static] CommFactory *CommFactory::defaultFactory()

CommFactory::defaultFactory \return 返回默认的工程对象

Note: 也可以使用 Comm::factory 对象指针作为默认的工厂

CommFactory *f = CommFactory::defaultFactory();  // f is a pointer to default Factory

bool CommFactory::supportHalfDuplex(const QString &type)

根据通讯器的类型 type（SerialPort，Network） 判断其是否支持半双工模式 用于界面，方便选择具体的通讯器

example:

CommFactory factory;
factory.addComm(ComHalfDuplex::staticMetaObject, ComHalfDuplex::commInfo);  // type: SerialPort
bool shd = factory.supportHalfDuplex("SerialPort");   // true
bool shd2 = factory.supportHalfDuplex("Network");     // false

QVector<QMetaObject> CommFactory::usableComm() const

CommFactory::usableComm \return 返回可用的元对象列表，用于动态构造对象

void CommFactory::operator=(const CommFactory &cf)

Copy-assignment operator.