1 /*

     2 * Copyright (c) 2002-2006 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Server-side sub-session of Accessory Single Connection

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef CACCSRVSUBSINGLECONNECTION_H

    21 #define CACCSRVSUBSINGLECONNECTION_H

    22 

    23 // INCLUDES

    24 #include "AsyProxyAPI.h"

    25 #include "AccSrvSubConnectionBase.h"

    26 #include <e32base.h>

    27 

    28 // CONSTANTS

    29 

    30 // MACROS

    31 

    32 // DATA TYPES

    33 

    34 // FUNCTION PROTOTYPES

    35 

    36 // FORWARD DECLARATIONS

    37 class CAccSrvMainSession;

    38 

    39 // CLASS DECLARATION

    40 

    41 /**

    42 *  Accessory Single Connection server-side sub-session implementation

    43 *

    44 *  AccServer.lib

    45 *  @since S60 3.1

    46 */

    47 NONSHARABLE_CLASS( CAccSrvSubSingleConnection ) : public CAccSrvSubConnectionBase

    48     {

    49     public: // Constructors and destructor

    50 

    51         /**

    52         * Two-phased constructor.

    53         * @since S60 3.1

    54         * @param aSession              Handle to the ASY Proxy.

    55         * @param aConnectionController Handle to the Connection Controller.

    56         * @param aServerModel          Handle to the Server Model.

    57         * @return Pointer to a new subsession

    58         */

    59         static CAccSrvSubSingleConnection* NewL( 

    60                     CASYProxyAPI* aSession,

    61                     CAccSrvConnectionController* aConnectionController,

    62                     CAccSrvServerModel* aServerModel );

    63 

    64         /**

    65         * Destructor.

    66         */

    67         ~CAccSrvSubSingleConnection();

    68 

    69     public: // New functions

    70 

    71     public: // Functions from base classes

    72 

    73         /**

    74         * From CAccSrvSubBase

    75         * Handles received messages from client.

    76         * @since S60 3.1

    77         * @param aMessage Client request.

    78         * @return void

    79         */

    80         void DispatchMessageL( const RMessage2& aMessage );

    81         

    82         /**

    83         * From MQueueObserver.

    84         * Called when Queue passes message completion handling to registered observers.

    85         *

    86         * @since S60 3.1

    87         * @param aMsgID     Message in question.

    88         * @param aErrorCode Error Code of the operation.

    89         * @param aUniqueID  Unique ID of the Generic ID in question.

    90         * @return ETrue if the message was consumpted by a observer.

    91         *               Call-back order must be renewed after consumption

    92         *               if further call-backs are needed.

    93         */

    94         TBool CompleteMessageL( TMsgID aMsgID, TInt aErrorCode, TInt aUniqueID );

    95 

    96     protected: // New functions

    97 

    98         /**

    99         * Symbian 2nd phase constructor.

   100         */

   101         void ConstructL();

   102 

   103         /**

   104         * C++ default constructor.

   105         */

   106         CAccSrvSubSingleConnection( CASYProxyAPI* aSession,

   107                                     CAccSrvConnectionController* aConnectionController,

   108                                     CAccSrvServerModel* aServerModel );

   109 

   110     private:  // new functions

   111 

   112         /**

   113         * Handles NotifyNewAccessoryConnected() client request.

   114         * If leave occurs, the client request is completed with that error code.

   115         *

   116         * @since S60 3.1

   117         * @param aMessage Client request.

   118         * @return void

   119         */

   120         void NotifyNewAccessoryConnected( const RMessage2& aMessage );

   121 

   122         /**

   123         * Handles NotifyAccessoryDisconnected() client request.

   124         * If leave occurs, the client request is completed with that error code.

   125         *

   126         * @since S60 3.1

   127         * @param aMessage Client request.

   128         * @return void

   129         */

   130         void NotifyAccessoryDisconnected( const RMessage2& aMessage );

   131 

   132         /**

   133         * Handles NotifyAccessoryValueChanged() TBool client request.

   134         * If leave occurs, the client request is completed with that error code.

   135         *

   136         * @since S60 3.1

   137         * @param aMessage Client request.

   138         * @return void

   139         */

   140         void NotifyAccessoryValueChangedTBoolL( const RMessage2& aMessage );

   141 

   142         /**

   143         * Handles NotifyAccessoryValueChanged() TInt client request.

   144         * If leave occurs, the client request is completed with that error code.

   145         *

   146         * @since S60 3.1

   147         * @param aMessage Client request.

   148         * @return void

   149         */

   150         void NotifyAccessoryValueChangedTIntL( const RMessage2& aMessage );

   151 

   152         /**

   153         * Handles NotifyAccessoryValueChanged() Object client request.

   154         * If leave occurs, the client request is completed with that error code.

   155         *

   156         * @since S60 5.2

   157         * @param aMessage Client request.

   158         * @return void

   159         */

   160         void NotifyAccessoryValueChangedObjectL( const RMessage2& aMessage );

   161 

   162         /**

   163         * Handles CancelNotifyNewAccessoryConnected() client request.

   164         * If leave occurs, the client request is completed with that error code.

   165         *

   166         * @since S60 3.1

   167         * @param aMessage Client request.

   168         * @return void

   169         */

   170         void CancelNotifyNewAccessoryConnected( const RMessage2& aMessage );

   171 

   172         /**

   173         * Handles CancelNotifyAccessoryDisconnected() client request.

   174         * If leave occurs, the client request is completed with that error code.

   175         *

   176         * @since S60 3.1

   177         * @param aMessage Client request.

   178         * @return void

   179         */

   180         void CancelNotifyAccessoryDisconnected( const RMessage2& aMessage );

   181 

   182         /**

   183         * Handles CancelNotifyAccessoryValueChanged() client request.

   184         * If leave occurs, the client request is completed with that error code.

   185         *

   186         * @since S60 3.1

   187         * @param aMessage Client request.

   188         * @return void

   189         */

   190         void CancelNotifyAccessoryValueChangedL( const RMessage2& aMessage );

   191 

   192         /**

   193         * Checks if NotifyAccessoryValueChanged() request was issued for

   194         * Accesory Capability Name and GID in question i.e. from SetValueL().

   195         *

   196         * @since S60 3.1

   197         * @return TBool indicating should this subsession be removed from queue

   198         */

   199         TBool HandleValueChangedTIntCompletionL();

   200 

   201         /**

   202         * Checks if NotifyAccessoryValueChanged() request was issued for

   203         * Accesory Capability Name and GID in question i.e. from SetValueL().

   204         * 

   205         * @since S60 3.1

   206         * @return TBool indicating should this subsession be removed from queue

   207         */

   208         TBool HandleValueChangedTBoolCompletionL();

   209 

   210         /**

   211         * Checks if NotifyAccessoryValueChanged() request was issued for

   212         * Accesory Capability Name and GID in question i.e. from SetValueL().

   213         * 

   214         * @since S60 5.2

   215         * @return TBool indicating should this subsession be removed from queue

   216         */

   217         TBool HandleValueChangedObjectCompletionL();

   218 

   219     public:     // Data

   220 

   221     protected:  // Data

   222 

   223     private:    // Data

   224 

   225         //Stored NotifyNewAccessoryConnected() client request for later completion.

   226         RMessage2 iNotifyNewAccessoryConnected;

   227 

   228         //Stored NotifyAccessoryDisconnected() client request for later completion.

   229         RMessage2 iNotifyAccessoryDisconnected;

   230 

   231         //Stored NotifyAccessoryValueChanged() TBool client request for later completion.

   232         RMessage2 iNotifyAccessoryValueChangedTBool;

   233 

   234         //Stored NotifyAccessoryValueChanged() TInt client request for later completion.

   235         RMessage2 iNotifyAccessoryValueChangedTInt;

   236 

   237         //Stored NotifyAccessoryValueChanged() Object client request for later completion.

   238         RMessage2 iNotifyAccessoryValueChangedObject;

   239 

   240     public:     // Friend classes

   241 

   242     protected:  // Friend classes

   243 

   244     private:    // Friend classes

   245 

   246     };

   247 

   248 #endif // CACCSRVSUBSINGLECONNECTION_H

   249 

   250 // End of File