RxMember.h

Go to the documentation of this file.

// Copyright (C) 2002-2018, Open Design Alliance (the "Alliance"). 
// All rights reserved. 
// 
// This software and its documentation and related materials are owned by 
// the Alliance. The software may only be incorporated into application 
// programs owned by members of the Alliance, subject to a signed 
// Membership Agreement and Supplemental Software License Agreement with the
// Alliance. The structure and organization of this software are the valuable  
// trade secrets of the Alliance and its suppliers. The software is also 
// protected by copyright law and international treaty provisions. Application  
// programs incorporating this software must include the following statement 
// with their copyright notices:
//   
//   This application incorporates Teigha(R) software pursuant to a license 
//   agreement with Open Design Alliance.
//   Teigha(R) Copyright (C) 2002-2018 by Open Design Alliance. 
//   All rights reserved.
//
// By use of this software, its documentation or related materials, you 
// acknowledge and accept the above terms.
 
#ifndef _ODRXMEMBER_INCLUDED_
#define _ODRXMEMBER_INCLUDED_
 
#include "OdString.h"
#include "OdArray.h"
#include "RxOverrule.h"
#include "SharedPtr.h"
 
class OdRxValue;
class OdRxValueType;
class OdRxAttributeCollection;
class OdRxPromotingQueryContext;
 
class OdRxMemberIteratorImpl;
class OdRxMemberQueryContextImpl;
class OdRxMemberQueryEngineImpl;
class OdRxMemberImpl;
class OdRxMemberCollectionImpl;
 
class OdRxMember;
typedef OdSmartPtr<OdRxMember> OdRxMemberPtr;
 
class ODRX_ABSTRACT FIRSTDLL_EXPORT OdRxMember : public OdRxObject
{
public:
  ODRX_DECLARE_MEMBERS(OdRxMember);
  
  const OdString& name() const throw();
  
  OdString localName() const throw();
  
  const OdRxValueType& type()const throw();
 
  const OdRxAttributeCollection& attributes() const throw();
  OdRxAttributeCollection& attributes() throw();
 
  const OdRxObject* owner() const throw();
 
  const OdArray<OdRxMemberPtr>* children() const throw();
 
  static void deleteMember(const OdRxMember* pMember) throw();
protected:
  friend class OdRxMemberImpl;
  virtual ~OdRxMember();
  OdRxMember(OdRxMemberImpl*);
  
  virtual OdString subLocalName() const;
  
  virtual OdResult subChildren(OdArray<OdRxMemberPtr>& children) const;
 
  virtual OdResult subChildrenEx(OdArray<OdRxMemberPtr>*& pChildren) const;
  
  void init(const OdString& name, const OdRxValueType* type, const OdRxObject* owner = 0);
  OdRxMemberImpl* m_pImpl;
};
 
 
class OdRxEnumTag;
typedef OdSmartPtr<OdRxEnumTag> OdRxEnumTagPtr;
class OdRxEnumTagImpl;
 
class FIRSTDLL_EXPORT OdRxEnumTag : public OdRxMember
{
public:
  ODRX_DECLARE_MEMBERS(OdRxEnumTag);
  static OdRxEnumTagPtr createObject(const OdChar* name, const OdRxValue& value, const OdRxObject* owner);
  
  const OdRxValue& value() const;
 
  OdString alternateLocalName() const;
protected:
  OdRxEnumTag(OdRxMemberImpl*);
  virtual OdString subAlternateLocalName() const;
};
 
class ODRX_ABSTRACT FIRSTDLL_EXPORT OdRxMemberCollection
{
public:
  virtual ~OdRxMemberCollection();
  virtual int count() const = 0;
  virtual OdRxMember* getAt(int index) const = 0;
};
 
class FIRSTDLL_EXPORT OdRxMemberCollectionBuilder
{
public:
  void add(OdRxMember* member);
  
  const OdRxClass* owner() const { return m_owner; }
private:
  friend class OdRxMemberCollectionImpl;
  OdRxMemberCollectionBuilder(OdRxMemberCollectionImpl* imp, const OdRxClass* owner) : m_pImpl(imp), m_owner(owner) {}
  const OdRxClass* m_owner;
  OdRxMemberCollectionImpl* m_pImpl;
};
 
class FIRSTDLL_EXPORT OdRxMemberIterator
{
public:
  virtual ~OdRxMemberIterator();
  virtual bool done();
  virtual bool next();
  virtual OdRxMember* current() const;
  virtual OdRxMember* find(const OdChar* name) const;
protected:
  OdRxMemberIterator();
private:
  friend class OdRxMemberIteratorImpl;
  OdRxMemberIteratorImpl* m_pImpl;
};
 
typedef OdSharedPtr<OdRxMemberIterator> OdRxMemberIteratorPtr;
 
 
class ODRX_ABSTRACT FIRSTDLL_EXPORT OdRxMemberQueryContext : public OdRxObject
{
public:
  ODRX_DECLARE_MEMBERS(OdRxMemberQueryContext);
  OdRxMemberIteratorPtr newMemberIterator(const OdArray<OdRxClassPtr>& facets) const;
protected:
  friend class OdRxMemberQueryContextImpl;
  OdRxMemberQueryContextImpl* m_pImpl;
  OdRxMemberQueryContext();
  virtual ~OdRxMemberQueryContext();
  virtual OdRxMemberIteratorPtr subNewMemberIterator(const OdArray<OdRxClassPtr>& facets) const = 0;
};
 
 
struct ODRX_ABSTRACT FIRSTDLL_EXPORT OdRxFacetProvider : OdRxObject
{
  ODRX_DECLARE_MEMBERS(OdRxFacetProvider);
 
  virtual void getFacets(const OdRxObject* pO, const OdRxMemberQueryContext* pContext, OdArray<OdRxClassPtr>& facets) = 0;
};
 
typedef OdSmartPtr<OdRxFacetProvider> OdRxFacetProviderPtr;
 
class FIRSTDLL_EXPORT OdRxMemberReactor
{
public:
  virtual ~OdRxMemberReactor() {}
  virtual void goodbye(const OdRxMember* ) {}
};
 
 
class FIRSTDLL_EXPORT OdRxMemberQueryEngine
{
public:
  static OdRxMemberQueryEngine* theEngine();
  
  OdRxMember* find(const OdRxObject* pO, const OdChar* name, const OdRxMemberQueryContext* pContext = NULL) const;
 
  OdRxMemberIteratorPtr newMemberIterator(const OdRxObject* pO, const OdRxMemberQueryContext* pContext = NULL) const;
 
  const OdRxMemberQueryContext* defaultContext() const;
 
  const OdRxPromotingQueryContext* promotingContext() const;
 
  void addFacetProvider(OdRxFacetProvider* pProvider);
 
  void removeFacetProvider(OdRxFacetProvider* pProvider);
 
  void addReactor(OdRxMemberReactor* pReactor);
  
  void removeReactor(OdRxMemberReactor* pReactor);
private:
  friend class OdRxMemberQueryEngineImpl;
  OdRxMemberQueryEngineImpl* m_pImpl;
  OdRxMemberQueryEngine(OdRxMemberQueryEngineImpl*);
};
 
 
class FIRSTDLL_EXPORT OdRxMemberOverrule : public OdRxObject
{
public:
  ODRX_DECLARE_MEMBERS(OdRxMemberOverrule);
  static OdResult addOverrule(OdRxMember* pOverruledSubject, OdRxMemberOverrule* pOverrule, bool bAddAtLast = false);
  static OdResult removeOverrule(OdRxMember* pOverruledSubject, OdRxMemberOverrule* pOverrule);
};
 
#endif