/*

* Copyright (c) 2002 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:  Server part of basic printing profile

*

*/

#ifndef BTSBPP_OBJECT_SERVER_H

#define BTSBPP_OBJECT_SERVER_H

//  INCLUDES

//#include "BTSBPPPasskeyRequest.h"

#include <obex.h>       // Obex

#include <badesca.h>    // CDesCArray

#include <btengdiscovery.h>

#include "BTServiceStarter.h"

// FORWARD DECLARATIONS

class CBTSBPPObjectRequest;

// CLASS DECLARATION

/**

*  An interface used to inform about CBTSBPPObjectServer events.

*/

class MBTSBPPObjectServerObserver

    {

    public:

        /**

        * Informs the observer that an error has been occurred.

        * @param aError The error.

        * @return None.

        */

        virtual void ServerError( TInt aError ) = 0;

        /**

        * Informs the observer that the server connection has been established.

        * @param None.

        * @return None.

        */

        virtual void ServerConnectionEstablished() = 0;

        /**

        * Informs the observer that the server connection has been closed.

        * @param None.

        * @return None.

        */

        virtual void ServerConnectionClosed() = 0;

    };

// CLASS DECLARATION

/**

*  A class managing the Obex Server.

*/

NONSHARABLE_CLASS (CBTSBPPObjectServer) : public CBase, 

                            public MObexServerNotify,                    

                            public MObexAuthChallengeHandler

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        static CBTSBPPObjectServer* NewL( MBTSBPPObjectServerObserver* aObserver,

                                          CBTEngDiscovery* aBTEngDiscoveryPtr,

                                          const TBTDevAddr& aExpectedClient );

        /**

        * Destructor.

        */

        virtual ~CBTSBPPObjectServer();

    public: // New functions

        /**

        * Gives the server a list of referenced objects that can be requested.

        * by the printer. This method should be called always before sending

        * any documents. 

        * @param aRefObjectList A pointer to the list.

        * @return None.

        */

        void SetReferencedObjectList( const CDesCArray* aRefObjectList );

        /**

        * Tells whether the current referenced object list has any items.

        * @param aRefObjectList A pointer to the list.

        * @return None.

        */

        TBool HasReferencedObjects();

    private: // Functions from base classes

        /**

        * From MObexAuthChallengeHandler Get's called when Obex Password is 

        * requested.

        * @param aRealm The realm/challenge specified by the unit forcing 

        *               the authentication.

        * @return None.

        */

        void GetUserPasswordL( const TDesC& aRealm );

    private: // Functions from MObexServerNotify

        /**

        * Informs about an error in Obex connection.

        * @param aError The occurred error.

        * @return None.

        */

        void ErrorIndication( TInt aError );

        /**

        * Informs that Obex transport layer is up.

        * @return None.

        */

        void TransportUpIndication();

        /**

        * Informs that Obex transport layer is down.

        * @return None.

        */

        void TransportDownIndication();

        /**

        * Informs about Obex connect request.

        * @param aRemoteInfo Information about the remote party.

        * @param aInfo Information about the connection request.

        * @return Symbian OS error code.

        */

        TInt ObexConnectIndication( const TObexConnectInfo& aRemoteInfo, 

                                    const TDesC8& aInfo );

        /**

        * Informs about Obex disconnect request.

        * @param aInfo Information about the disconnect request.

        * @return None.

        */

        void ObexDisconnectIndication( const TDesC8& aInfo );

        /**

        * Informs about Obex put request.

        * @return The requested object or NULL;

        */

        CObexBufObject* PutRequestIndication();

        /**

        * Informs that part of the put object is sent.

        * @return Symbian OS error code.

        */

        TInt PutPacketIndication();

        /**

        * Informs that the put request is completed.

        * @return Symbian OS error code.

        */

        TInt PutCompleteIndication();

        /**

        * Informs about Obex put request.

        * @param aRequiredObject The Get request object.

        * @return The response object or NULL;

        */

        CObexBufObject* GetRequestIndication( 

        CObexBaseObject* aRequiredObject );

        /**

        * Informs that part of the get response object is sent.

        * @return Symbian OS error code.

        */

        TInt GetPacketIndication();

        /**

        * Informs that the get request is completed.

        * @return Symbian OS error code.

        */

        TInt GetCompleteIndication();

        /**

        * Informs about Obex Set Path request.

        * @param aPathInfo Information about the path.

        * @param aInfo Information about the Set Path request.

        * @return Symbian OS error code.

        */

        TInt SetPathIndication( const CObex::TSetPathInfo& aPathInfo, 

                                const TDesC8& aInfo );

        /**

        * Informs about Obex Abort operation.

        * @return None.

        */

        void AbortIndication();

    private:

        /**

        * C++ default constructor.

        */

        CBTSBPPObjectServer( MBTSBPPObjectServerObserver* aObserver,

                             CBTEngDiscovery* aBTEngDiscoveryPtr,

                             const TBTDevAddr& aExpectedClient );

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL();

    private:    // Data

        TInt                            iObjectChannel;

        TSdpServRecordHandle            iSDPHandle;

        CObexServer*                    iServer;

        CBTSBPPObjectRequest*           iObjectRequest;

        //CBTSBPPPasskeyRequest*        iPasskeyRequest;        

        // Not owned

        //

        const CDesCArray*               iObjectListPtr;

        const TBTDevAddr*               iExpectedClientPtr;

        CBTEngDiscovery*                iBTEngDiscoveryPtr;

        MBTSBPPObjectServerObserver*    iObserverPtr;

    };

#endif      // BTSBPP_OBJECT_SERVER_H

// End of File