URI.h

//========================================================================================
// 
// $File$
// 
// Owner: Michael Easter
// 
// $Author$
// 
// $DateTime$
// 
// $Revision$
// 
// $Change$
// 
// Copyright 1997-2010 Adobe Systems Incorporated. All rights reserved.
// 
// NOTICE: Adobe permits you to use, modify, and distribute this file in accordance 
// with the terms of the Adobe license agreement accompanying it. If you have received
// this file from a source other than Adobe, then your use, modification, or 
// distribution of it requires the prior written permission of Adobe.
// 
// 
// Description:
// This class provides functionality to construct and parse a well formed Uniform
// Resource Identifier (URI).
// 
//========================================================================================

#ifndef __URI__
#define __URI__

// ----- Includes -----

class IPMStream;
class URIImpl;
class WideString;

static const WideString kCCLibraryAssetURIScheme("cclibraries");

static const WideString kFileAssetURIScheme("file");
static const WideString kHTTPAssetURIScheme("http");
static const WideString kHTTPSAssetURIScheme("https");

class URI
{
public: 
 typedef object_type data_type;

 URI();

 URI(const std::string& uri);

 URI(const WideString& uri);

 URI(const URI& uri);

 virtual ~URI();

 URI& operator=(const URI& rhs);

 bool operator==(const URI& rhs) const;

 bool operator!=(const URI& rhs) const;

 bool operator<(const URI& rhs) const;

 bool SetURI(const std::string& uri);

 std::string GetURI() const;

 bool SetURIW(const WideString& uri);

 WideString GetURIW() const;

 void ClearURI();

 enum Component {
 kScheme = 0,
 kAuthority,
 kPath,
 kQuery,
 kFragment
 };

 bool VerifyURI(Component* badComponent = nil) const;

 bool HasComponent(Component component) const;

 void SetComponent(Component component, const WideString& value);

 WideString GetComponent(Component component) const;

 void RemoveComponent(Component component);

 void ReadWrite(IPMStream* s);

private:
 URIImpl* fpImpl;

#ifdef DEBUG
#include <string>
 std::string fURIStr;
#endif
};

#endif // __URI__