javaextensions/bluetooth/bluetoothplugins/btspppushplugin/inc/btrfcommserverconnectionfactory.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 27 Apr 2010 16:30:29 +0300
branchRCL_3
changeset 19 04becd199f91
permissions -rw-r--r--
Revision: v2.1.22 Kit: 201017

/*
* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:
*
*/


#ifndef BTRFCOMMSERVERCONNECTIONFACTORY_H
#define BTRFCOMMSERVERCONNECTIONFACTORY_H

#include "javaosheaders.h"
#include "serverconnectionfactorybase.h"

/**
 * BTRFCOMMServerConnectionFactory used to create the ServerConnection.
 * It implements ServerConnectionFactoryBase.
 *
 * Internally it contains a Function Server that will be passed to every
 * ServerConnection object created.
 *
 *  @lib javabtsppscplugin.dll
 *  @
 */
class BTRFCOMMServerConnectionFactory: public java::push::ServerConnectionFactoryBase
{
    //Not implemented
    BTRFCOMMServerConnectionFactory(const BTRFCOMMServerConnectionFactory&);
    BTRFCOMMServerConnectionFactory &operator=(
        const BTRFCOMMServerConnectionFactory&);

public:
    OS_IMPORT BTRFCOMMServerConnectionFactory();
    OS_IMPORT ~BTRFCOMMServerConnectionFactory();

    /**
     * This operation creates ServerConnection if it is not already created.
     * @exception throws RuntimeException if type of the existing ServerConnection
     *            object is PUSH_LISTEN_BY_MIDLET || PUSH and isMultipleSrvConnAllowed()
     *            operation returns 'false'.
     */
    OS_IMPORT virtual java::push::ServerConnection* create(const std::wstring& aUri);

    /**
     * create serverconnection for the given Connection URI
     * @
     *
     * @return ServerConnection
     */
    OS_IMPORT
    virtual java::push::ServerConnection* createSrvConnObj(const std::wstring& aUri,
            const std::wstring& aFilter);

    /**
     * Checks for multiple server connection is allowed for the given
     * Connection URI
     *
     *
     * @return
     */
    OS_IMPORT virtual bool isMultipleSrvConnAllowed();

    /**
     * factory method to create the server connection factory
     * @
     *
     * @return BTRFCOMMServerConnectionFactory
     */
    OS_IMPORT static BTRFCOMMServerConnectionFactory& getFactory();

};

#endif // BTRFCOMMSERVERCONNECTIONFACTORY_H