src/include/common/spds/AccessConfig.h

/*
 * Copyright (C) 2003-2007 Funambol
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
#ifndef INCL_ACCESS_CONFIG
#define INCL_ACCESS_CONFIG

#include "base/fscapi.h"
#include "spds/constants.h"


/*
 * -------------------------- AccessConfig class -----------------------------
 * This class groups all configuration properties to estabilish a 
 * connection with a sync server.
 * AccessConfig is a part of SyncManagerConfig (along with DeviceConfig 
 * and an array of SyncSourceConfig).
 *
 * Class members:
 * --------------
 * username             : string for username
 * password             : string for password
 * useProxy             : Should the sync engine use a HTTP proxy?
 * proxyHost            : the host for proxy connection
 * proxyPort            : the port for proxy connection
 * proxyUsername        : the proxy username (if proxy needs authentication)
 * proxyPassword        : the proxy password (if proxy needs authentication)
 * beginTimestamp       : The beginSync timestamp
 * endTimestamp         : The endSync timestamp
 * firstTimeSyncMode    : The SyncMode that the sync engine should use 
 *                        the first time a source is synced
 * serverNonce          : The server nonce value: from client to server
 * clientNonce          : The client nonce value: from server to client
 * serverID             : the server ID value
 * serverPWD            : the server password
 * clientAuthType       : the type of client authentication used by client
 * isServerAuthRequired : Does the server require authentication?
 * maxMsgSize           : The maximum message size (Byte) accepted for XML 
 *                        messages received from server (server to client)
 * maxModPerMsg         : The maximum number of modifications sent in each XML 
 *                        message from client to server
 * readBufferSize       : Specifies the value for the size of the buffer used 
 *                        to store the incoming stream from server (byte)
 * userAgent            : The user agent string, will be attached to http 
 *                        messages to identify the client on server side.
 *                        It shoud be a short description with the client 
 *                        name plus its version
 * checkConn            : Do we need to check if the GPRS connection is available?          <-- **** still used? ****
 * responseTimeout      : The number of seconds of waiting response timeout
 * dirty                : The dirty flag, used to select which properties 
 *                        have been modified. Not used by now (T.B.D)
 */
class AccessConfig {
    private:
        char*           username            ;
        char*           password            ;
        BOOL            useProxy            ;
        char*           proxyHost           ;
        int             proxyPort           ;
        char*           proxyUsername       ;
        char*           proxyPassword       ;
        char*           syncURL             ;
        unsigned long   beginTimestamp      ;
        unsigned long   endTimestamp        ;
        SyncMode        firstTimeSyncMode   ;
        char*           serverNonce         ;
        char*           clientNonce         ;
        char*           serverID            ;
        char*           serverPWD           ;
        char*           clientAuthType      ;
        char*           serverAuthType      ;
        BOOL            isServerAuthRequired;
        unsigned long   maxMsgSize          ;
        unsigned long   maxModPerMsg        ;
        unsigned long   readBufferSize      ;
        char*           userAgent           ;
        BOOL            checkConn           ;
        unsigned int    responseTimeout     ;

        unsigned int dirty;

        void set(char* * buf, const char*  v) EXTRA_SECTION_02;

    public:

        AccessConfig() EXTRA_SECTION_02;
        AccessConfig(AccessConfig& s) EXTRA_SECTION_02;
        ~AccessConfig() EXTRA_SECTION_02;

        const char*  getUsername() const EXTRA_SECTION_02;

        void setUsername(const char*  username) EXTRA_SECTION_02;

        const char*  getPassword() const EXTRA_SECTION_02;

        void setPassword(const char*  password) EXTRA_SECTION_02;

        SyncMode getFirstTimeSyncMode() const EXTRA_SECTION_02;

        void setFirstTimeSyncMode(SyncMode syncMode) EXTRA_SECTION_02;

        BOOL getUseProxy() const EXTRA_SECTION_02;

        void setUseProxy(BOOL useProxy) EXTRA_SECTION_02;

        const char*  getProxyHost() const EXTRA_SECTION_02;

        void setProxyHost(const char*  proxyHost) EXTRA_SECTION_02;

        int getProxyPort() const EXTRA_SECTION_02;
        void setProxyPort(int v) EXTRA_SECTION_02;

        const char* getProxyUsername() const EXTRA_SECTION_02;

        void setProxyUsername(const char*  proxyUsername) EXTRA_SECTION_02;

        const char* getProxyPassword() const EXTRA_SECTION_02;

        void setProxyPassword(const char*  proxyPassword) EXTRA_SECTION_02;

        const char*  getSyncURL() const EXTRA_SECTION_02;

        void setSyncURL(const char*  syncURL) EXTRA_SECTION_02;

        void setBeginSync(unsigned long timestamp) EXTRA_SECTION_02;

        unsigned long getBeginSync() const EXTRA_SECTION_02;

        void setEndSync(unsigned long timestamp) EXTRA_SECTION_02;

        unsigned long getEndSync() const EXTRA_SECTION_02;

        BOOL getServerAuthRequired() const EXTRA_SECTION_02;

        void setServerAuthRequired(BOOL v) EXTRA_SECTION_02;

        const char*  getClientAuthType() const EXTRA_SECTION_02;

        void setClientAuthType(const char*  v) EXTRA_SECTION_02;

        const char*  getServerAuthType() const EXTRA_SECTION_02;

        void setServerAuthType(const char*  v) EXTRA_SECTION_02;

        const char*  getServerPWD() const EXTRA_SECTION_02;

        void setServerPWD(const char*  v) EXTRA_SECTION_02;

        const char*  getServerID() const EXTRA_SECTION_02;

        void setServerID(const char*  v) EXTRA_SECTION_02;

        const char*  getServerNonce() const EXTRA_SECTION_02;

        void setServerNonce(const char*  v) EXTRA_SECTION_02;

        const char*  getClientNonce() const EXTRA_SECTION_02;

        void setClientNonce(const char*  v) EXTRA_SECTION_02;

        void setMaxMsgSize(unsigned long msgSize) EXTRA_SECTION_02;

        unsigned long getMaxMsgSize() const EXTRA_SECTION_02;

        void setMaxModPerMsg(unsigned long msgSize) EXTRA_SECTION_02;

        unsigned long getMaxModPerMsg() const EXTRA_SECTION_02;
        
        void setReadBufferSize(unsigned long bufferSize);

        unsigned long getReadBufferSize() const EXTRA_SECTION_02;

        const char*  getUserAgent() const EXTRA_SECTION_02;

        void setUserAgent(const char*  v) EXTRA_SECTION_02;


        void setCheckConn(BOOL v) EXTRA_SECTION_02;
        BOOL getCheckConn() const EXTRA_SECTION_02;

        void setResponseTimeout(unsigned int bufferSize)    EXTRA_SECTION_02;
        unsigned int getResponseTimeout() const             EXTRA_SECTION_02;

        unsigned int getDirty() const EXTRA_SECTION_02;

        void assign(const AccessConfig& s) EXTRA_SECTION_02;

        /*
         * Assign operator
         */
        AccessConfig& operator = (const AccessConfig& ac) {
            assign(ac);
            return *this;
        }

};

#endif

---