1 chuck 1.2 
  2           //%2003////////////////////////////////////////////////////////////////////////
  3           //
  4           // Copyright (c) 2000, 2001, 2002  BMC Software, Hewlett-Packard Development
  5           // Company, L. P., IBM Corp., The Open Group, Tivoli Systems.
  6           // Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L. P.;
  7           // IBM Corp.; EMC Corporation, The Open Group.
  8           //
  9           // Permission is hereby granted, free of charge, to any person obtaining a copy
 10           // of this software and associated documentation files (the "Software"), to
 11           // deal in the Software without restriction, including without limitation the
 12           // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
 13           // sell copies of the Software, and to permit persons to whom the Software is
 14           // furnished to do so, subject to the following conditions:
 15           // 
 16           // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
 17           // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
 18           // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
 19           // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
 20           // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
 21           // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
 22 chuck 1.2 // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 23           // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 24           //
 25           //==============================================================================
 26           //
 27           // Authors: David Rosckes (rosckes@us.ibm.com)
 28           //          Bert Rivero (hurivero@us.ibm.com)
 29           //          Chuck Carmack (carmack@us.ibm.com)
 30           //          Brian Lucier (lucier@us.ibm.com)
 31           //
 32           // Modified By: 
 33           //
 34           //%/////////////////////////////////////////////////////////////////////////////
 35           
 36           #ifndef Pegasus_CQLChainedIdentifier_h
 37           #define Pegasus_CQLChainedIdentifier_h
 38           
 39           #include <Pegasus/Common/Config.h>
 40           #include <Pegasus/CQL/Linkage.h>
 41           //#include <Pegasus/Common/Array.h>
 42           #include <Pegasus/Common/ArrayInternal.h>
 43 chuck 1.2 #include <Pegasus/Common/String.h>
 44           #include <Pegasus/Query/QueryCommon/QueryChainedIdentifier.h>
 45           #include <Pegasus/CQL/CQLIdentifier.h>
 46           
 47           #ifdef PEGASUS_USE_EXPERIMENTAL_INTERFACES
 48           
 49           PEGASUS_NAMESPACE_BEGIN 
 50           class PEGASUS_CQL_LINKAGE CQLFactory;
 51           class PEGASUS_CQL_LINKAGE CQLChainedIdentifierRep;
 52           
 53           /**  
 54           CQLChainedIdentifier class is used for parsing (not resolving)
 55           the identifier portion of a CQL select statement.  
 56           A couple examples of a CQLIdentifier:
 57           
 58             Class.EmbeddedObject.Property[3]
 59             Class.Property#'OK'
 60           
 61           
 62           The CQLChainedIdentifier class can parse and return each
 63            section of a CQL identifier.  The possible sections are:
 64 chuck 1.2 
 65                class (optional)
 66                zero or more embedded objects
 67                property
 68           
 69           Note:  this must handle wildcard("*"), embedded objects, arrays, symbolic
 70           constants, etc.
 71              */
 72           class PEGASUS_CQL_LINKAGE CQLChainedIdentifier : public QueryChainedIdentifier
 73           {
 74             public:
 75           
 76               CQLChainedIdentifier();
 77               /**  constructor 
 78                     Parses the string into the various components of a CQL identifier.
 79                     Throws parsing errors.
 80                 */
 81               CQLChainedIdentifier(String inString);
 82           
 83               CQLChainedIdentifier(const CQLIdentifier & id);
 84            
 85 chuck 1.2     CQLChainedIdentifier(const CQLChainedIdentifier& cid);
 86           
 87               ~CQLChainedIdentifier();
 88           
 89               CQLChainedIdentifier& operator=(const CQLChainedIdentifier& rhs);
 90           
 91               CQLIdentifier operator[](Uint32 index)const;
 92           
 93               Array<CQLIdentifier> getSubIdentifiers()const;
 94           
 95               CQLIdentifier getLastIdentifier()const;
 96           	
 97               friend class CQLFactory;
 98           
 99             private:
100           
101           };
102           
103           /*
104           #ifndef PEGASUS_ARRAY_T
105           #define PEGASUS_ARRAY_T CQLChainedIdentifier
106 chuck 1.2 #include <Pegasus/Common/ArrayInter.h>
107           #undef PEGASUS_ARRAY_T
108           #endif
109           */
110           
111           PEGASUS_NAMESPACE_END
112           #endif
113           #endif /* Pegasus_CQLChainedIdentifier_h */