hxurl.h
上传用户:dangjiwu
上传日期:2013-07-19
资源大小:42019k
文件大小:6k
源码类别:

Symbian

开发平台:

Visual C++

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