XQNfcSeTransactionProvider Class Reference

#include <mw/xqnfcsetransactionprovider.h>

Link against: xqnfcsetransactionservice.lib

class XQNfcSeTransactionProvider : public QObject, public QObject

Inherits from

  • XQNfcSeTransactionProvider
    Protected Attributes
    XQNfcSeTransactionProviderPrivate *m_ProviderPrivate
    Public Member Functions
    XQNfcSeTransactionProvider(QObject *)
    virtual ~XQNfcSeTransactionProvider()
    Public Signals
    voidexternalReaderConnected()
    voidexternalReaderDisconnected()
    Inherited Attributes
    QObject::d_ptr
    QObject::objectName
    QObject::staticQtMetaObject
    Inherited Functions
    QObject::QObject(QObjectPrivate &,QObject *)
    QObject::blockSignals(bool)
    QObject::childEvent(QChildEvent *)
    QObject::children()const
    QObject::connect(const QObject *,const QMetaMethod &,const QObject *,const QMetaMethod &,Qt::ConnectionType)
    QObject::connect(const QObject *,const char *,const QObject *,const char *,Qt::ConnectionType)
    QObject::connect(const QObject *,const char *,const char *,Qt::ConnectionType)const
    QObject::connectNotify(const char *)
    QObject::customEvent(QEvent *)
    QObject::deleteLater
    QObject::destroyed
    QObject::disconnect(const QObject *,const QMetaMethod &,const QObject *,const QMetaMethod &)
    QObject::disconnect(const QObject *,const char *)
    QObject::disconnect(const QObject *,const char *,const QObject *,const char *)
    QObject::disconnect(const char *,const QObject *,const char *)
    QObject::disconnectNotify(const char *)
    QObject::dumpObjectInfo()
    QObject::dumpObjectTree()
    QObject::dynamicPropertyNames()const
    QObject::event(QEvent *)
    QObject::eventFilter(QObject *,QEvent *)
    QObject::findChild(const QString &)const
    QObject::findChildren(const QRegExp &)const
    QObject::findChildren(const QString &)const
    QObject::inherits(const char *)const
    QObject::installEventFilter(QObject *)
    QObject::isWidgetType()const
    QObject::killTimer(int)
    QObject::moveToThread(QThread *)
    QObject::objectName()const
    QObject::parent()const
    QObject::property(const char *)const
    QObject::receivers(const char *)const
    QObject::registerUserData()
    QObject::removeEventFilter(QObject *)
    QObject::sender()const
    QObject::senderSignalIndex()const
    QObject::setObjectName(const QString &)
    QObject::setParent(QObject *)
    QObject::setProperty(const char *,const QVariant &)
    QObject::setUserData(uint,QObjectUserData *)
    QObject::signalsBlocked()const
    QObject::startTimer(int)
    QObject::thread()const
    QObject::timerEvent(QTimerEvent *)
    QObject::userData(uint)const
    QObject::~QObject()

    Detailed Description

    This interface provides a notification to the application when external reader is connected or disconnected for Secure Element in card emulation mode. The notification indicates that the external reader might changed the data in the Secure Element, and the application which is listening the notification need to retrieve the data from the Secure Element to e.g. updata the UI. How to retrieve data from the Secure Element is not in the scope of this API, but should be done with APDU Qt API, please refer to APDU Qt API about how to access the Secure Element data.

    A external reader is a NFC Initiator that requests data from the device when the device works as a NFC Target in card emulation mode. For more detailed information about NFC Initiator and Target, please refer to 'NFC Digital Protocol' and 'NFC Activity' technical specifications.

    Example usage:
        // Create a instance of XQNfcSeTransactionProvider
        m_nfcSeTransactionProvider = new XQNfcSeTransactionProvider();
    
        // Create a instance of SE transaction listener, the listener class 
        // MySeTransactionListener is defined by the API user and it has two slots
        // onExternalReaderConnected() and onExternalReaderDisconnected() implemented 
        // to handle the externalReaderConnected() and externalReaderDisconnected() signals.
        m_transactionListener = new MySeTransactionListener();
    
        // Connect the listener's slots with the signals, after external reader 
        // connected/disconnected, the slots will be invoked, the listener should 
        // implement the data retrieving from the secure element using APDU Qt API
        // in the slots.
        QObject::connect(m_nfcSeTransactionProvider, SIGNAL(externalReaderConnected()), 
                         m_transactionListener, SLOT(onExternalReaderConnected()));
       
        QObject::connect(m_nfcSeTransactionProvider, SIGNAL(externalReaderDisconnected()), 
                         m_transactionListener, SLOT(onExternalReaderDisconnected()))

    Member Attribute Documentation

    m_ProviderPrivate

    XQNfcSeTransactionProviderPrivate *m_ProviderPrivate[protected]

    Private wrapper implementation instance.

    Constructor & Destructor Documentation

    XQNfcSeTransactionProvider ( QObject * )

    XQNfcSeTransactionProvider(QObject *parent = 0)

    constructor.

    ~XQNfcSeTransactionProvider ( )

    ~XQNfcSeTransactionProvider()[virtual]

    Destructor.

    Member Function Documentation

    externalReaderConnected ( )

    voidexternalReaderConnected()[signal]

    This signal is emitted when the device has been connected to an external reader. It is emitted after EVT_TRANSACTION received. Please refer to Technical Specification "ETSI TS 102 622" for more detailed infomation about EVT_TRANSACTION. The listener should implement the slot and connect its slot with this signal to receive the notification.

    externalReaderDisconnected ( )

    voidexternalReaderDisconnected()[signal]

    In current implementation, this signal will never be emitted, it is reserved for only future usage.