examples/Qt/qtbluetoothapp/servicediscoverer.h

/*
 * Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved.
 *    
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *    
 *  * Redistributions of source code must retain the above copyright notice, this
 *    list of conditions and the following disclaimer.
 *  * Redistributions in binary form must reproduce the above copyright notice,
 *    this list of conditions and the following disclaimer in the documentation
 *    and/or other materials provided with the distribution.
 *  * Neither the name of Nokia Corporation nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *    
 *    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 *    AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 *    IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 *    DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
 *    FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 *    DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 *    SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 *    CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 *    OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 *    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *    
 *    Description:  
 */

#ifndef SERVICEDISCOVERER_H
#define SERVICEDISCOVERER_H

// INCLUDES
#include <e32base.h>
#include <es_sock.h>
#include <btdevice.h>
#include <bt_sock.h>
#include <btsdp.h>

#include "Common.h"

class MServiceDiscoObserver
{

public:
    virtual void HandleServiceDiscoveryCompleteL()=0;
    virtual void ReportServiceDiscoveryErrorL(TInt aError)=0;
};


class CServiceDiscoverer : public CBase,
                           public MSdpAgentNotifier,
                           public MSdpAttributeValueVisitor
{
public:

    static CServiceDiscoverer* NewL(MServiceDiscoObserver& aObserver);

    static CServiceDiscoverer* NewLC(MServiceDiscoObserver& aObserver);

    ~CServiceDiscoverer();

    void DiscoverServicesOnDeviceL(TDeviceData* aDevData);

    void DiscoverServicesL(TDeviceDataList* aDevDataList);

    void FinishDiscovery();

    TBool HasServices();


private:

    CServiceDiscoverer(MServiceDiscoObserver& aObserver);

    void ConstructL();

    void HandleServiceDiscoveryCompleteL();

/*
 * NextRecordRequestComplete()
 *
 * discussion called when an service record
 *            (CSdpAgent::NextRecordRequestL()) operation completes.
 * param aError KErrNone, or an SDP error
 * param aHandle service record for which the query was made
 * param aTotalRecordsCount total number of matching records
 */
    void NextRecordRequestComplete(
        TInt aError,
        TSdpServRecordHandle aHandle,
        TInt aTotalRecordsCount);

/*
 * AttributeRequestResult()
 *
 * discussion Called by the attribute request
 *            (CSdpAgent::AttributeRequestL()) to pass the results of
 *            a successful attribute request.
 *
 * param aHandle service record for which the query was made
 * param aAttrID ID of the attribute obtained
 * param aAttrValue attribute value obtained
 */
    void AttributeRequestResult(
        TSdpServRecordHandle aHandle,
        TSdpAttributeID aAttrID,
        CSdpAttrValue* aAttrValue);

    void AttributeRequestComplete(
        TSdpServRecordHandle aHandle,
        TInt aError);

    void VisitAttributeValueL(CSdpAttrValue& aValue, TSdpElementType aType);
    // not needed -> not implemented
    void StartListL(CSdpAttrValueList &aList);
    // not needed -> not implemented
    void EndListL();

public:
    // Service Discovery is running
    TBool iRunning;

private:    // data

    // observer reference
    MServiceDiscoObserver& iObserver;
    // service discovery agent
    CSdpAgent* iAgent;
    // service discovery search pattern
    CSdpSearchPattern* iSpat;
    // last discovered uuid in the service attributes
    TUUID iLastUUID;
    // port (comm channel) found in the service attributes
    TUint iPort;
    // device data record reference
    TDeviceData* iDevData;
    // device data list reference
    TDeviceDataList* iDevDataList;
    // this indicates that a port number was found in the service attributes
    // and device data record for this device needs to be updated with the
    // port number.
    TBool iDevDataChanged;
    // index of device in device data list used for service discovery
    TInt iDeviceIdx;
};

#endif

---