hxurl.h
上传用户:zhongxx05
上传日期:2007-06-06
资源大小:33641k
文件大小:6k
源码类别:

Symbian

开发平台:

C/C++

  1. /* ***** BEGIN LICENSE BLOCK ***** 
  2.  * Version: RCSL 1.0/RPSL 1.0 
  3.  *  
  4.  * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
  5.  *      
  6.  * The contents of this file, and the files included with this file, are 
  7.  * subject to the current version of the RealNetworks Public Source License 
  8.  * Version 1.0 (the "RPSL") available at 
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed 
  10.  * the file under the RealNetworks Community Source License Version 1.0 
  11.  * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
  12.  * in which case the RCSL will apply. You may also obtain the license terms 
  13.  * directly from RealNetworks.  You may not use this file except in 
  14.  * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
  15.  * applicable to this file, the RCSL.  Please see the applicable RPSL or 
  16.  * RCSL for the rights, obligations and limitations governing use of the 
  17.  * contents of the file.  
  18.  *  
  19.  * This file is part of the Helix DNA Technology. RealNetworks is the 
  20.  * developer of the Original Code and owns the copyrights in the portions 
  21.  * it created. 
  22.  *  
  23.  * This file, and the files included with this file, is distributed and made 
  24.  * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
  25.  * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
  26.  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
  27.  * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
  28.  * 
  29.  * Technology Compatibility Kit Test Suite(s) Location: 
  30.  *    http://www.helixcommunity.org/content/tck 
  31.  * 
  32.  * Contributor(s): 
  33.  *  
  34.  * ***** END LICENSE BLOCK ***** */ 
  35. /*******************************************************************************************
  36.     CHXURL.H
  37.   
  38.     A class to parse and store the contents of an URL
  39.     Usage:
  40.     - The constructor parses the url.
  41.     - The various components of the url may be accessed via their
  42.       respective access methods or via get_event, for events
  43.     - Use send_client_events to stuff all the client events in the 
  44.       outgoing event queue
  45. *******************************************************************************************/
  46. #ifdef __MWERKS__
  47. #pragma once
  48. #endif
  49. #ifndef _CHXURL_H_
  50. #define _CHXURL_H_
  51. #include "hxcom.h"
  52. // option signal/separator
  53. #define OPTION_SIGNAL '?'
  54. #define OPTION_SEPARATOR '&'
  55. #define OPTION_ASSIGNMENT '='
  56. // URL properties
  57. #define PROPERTY_URL "url"
  58. #define PROPERTY_PROTOCOL "protocol"
  59. #define PROPERTY_SCHEME "scheme"
  60. #define PROPERTY_HOST "host"
  61. #define PROPERTY_PORT "port"
  62. #define PROPERTY_PATH "path"
  63. #define PROPERTY_FULLPATH       "fullpath"
  64. #define PROPERTY_RESOURCE "resource"
  65. #define PROPERTY_FRAGMENT "fragment"
  66. #define PROPERTY_USERNAME "username"
  67. #define PROPERTY_PASSWORD "password"
  68. enum 
  69. {
  70.     unknownProtocol = 0,
  71.     httpProtocol,
  72.     pnmProtocol,
  73.     rtspProtocol,
  74.     fileProtocol,
  75.     fnordProtocol,
  76.     httpsProtocol,
  77.     helixSDPProtocol
  78. };
  79. typedef _INTERFACE IHXCommonClassFactory IHXCommonClassFactory;
  80. typedef _INTERFACE IHXValues IHXValues;
  81. class CHXURL
  82. {
  83. public:
  84.     CHXURL (const char* /* IN */ pszURL);
  85.     CHXURL (const char* /* IN */ pszURL, IUnknown* pContext);
  86.     ~CHXURL ();
  87.     CHXURL(const CHXURL& rhs);
  88.     CHXURL& operator=(const CHXURL& rhs);
  89.     // called to retrieve URL properties/options
  90.     IHXValues* GetProperties(void);
  91.     IHXValues* GetOptions(void);
  92.     // determine if it needs network protocol
  93.     BOOL IsNetworkProtocol() {return m_bNetworkProtocol;}
  94.     UINT16 GetProtocol() const { return m_unProtocol; };
  95.     HX_RESULT GetLastError() {return m_LastError;}
  96.     
  97.     void AddOption(char* pKey, char* pValue);
  98.     void AddOption(char* pKey, UINT32 ulValue);
  99.     char* GetAltURL(BOOL& bDefault);
  100.     const char* GetURL() const {return (const char*) m_pActualURL;};
  101.     const char* GetEscapedURL() const {return (const char*) m_pszEscapedURL;};
  102.     static HX_RESULT GeneratePrefixRootFragment(
  103. const char* pURL,   CHXString& urlPrefix, 
  104. CHXString& urlRoot, char*& pURLFragment);
  105.     BOOL      CompressURL(const char* pURL, char*& pCompressURL);
  106.     static HX_RESULT encodeURL(const char* pURL, CHXString& encodedURL);    
  107.     static HX_RESULT decodeURL(const char* pURL, CHXString& unencodedURL);
  108.     static const char* FindURLSchemeEnd(const char *pszURL);
  109.     static BOOL IsURLRelative(const char *pszURL)
  110.     {
  111. return (FindURLSchemeEnd(pszURL) == NULL);
  112.     }
  113.     static void      TestCompressURL();
  114. private:
  115.     void ConstructURL(const char* pszURL);
  116.     static IHXCommonClassFactory* CreateCCF();
  117.     HX_RESULT m_LastError;
  118.     // URL options/values
  119.     char* m_pActualURL;
  120.     char*       m_pszURL;
  121.     char* m_pszEscapedURL;
  122.     char* m_pszOptions;
  123.     char* m_pszHost;
  124.     char* m_pszPort;
  125.     char* m_pszUsername;
  126.     char* m_pszPassword;
  127.     UINT16 m_unProtocol;
  128.     UINT16      m_unDefaultPort;
  129.     HX_BITFIELD m_bNetworkProtocol : 1;
  130.     char* m_pszResource;
  131.     IHXValues* m_pProperties;
  132.     IHXValues* m_pOptions;
  133.     IHXCommonClassFactory* m_pCCF;
  134.     // help functions
  135.     void TrimOffSpaces (char*& /* IN OUT */ pszString);
  136.     int StringNCompare (const char* /* IN */ pszStr1, 
  137.         const char* /* IN */ pszStr2,
  138. size_t     /* IN */ nChars);
  139.     
  140.     HX_RESULT ParseURL (char* /* IN */ pszURL);
  141.     HX_RESULT CollectOptions (char* /* IN */ pszOptions);
  142.     BOOL IsTimeValue (char* /* IN */ pszValue);
  143.     BOOL IsNumber (char* /* IN */    pszValue);
  144.     void ParseResource(void);
  145.     void Unescape(char* s);
  146.     int Unhex(char c);
  147. };
  148. #endif // _CHXURL_H_