baseassemblyspec.h

// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// ============================================================
//
// BaseAssemblySpec.h
//


//
// Declares the BaseAssemblySpec class
//
// ============================================================

#ifndef __BASE_ASSEMBLY_SPEC_H__
#define __BASE_ASSEMBLY_SPEC_H__

class StackingAllocator;

// a class representing assembly name in Loader
class BaseAssemblySpec
{
protected:
    AssemblyMetaDataInternal    m_context;
    LPCSTR                      m_pAssemblyName;
    PBYTE                       m_pbPublicKeyOrToken;
    DWORD                       m_cbPublicKeyOrToken;
    DWORD                       m_dwFlags;             // CorAssemblyFlags
    int                         m_ownedFlags;
    AssemblyBinder             *m_pBinder;

public:
    enum
    {
        NAME_OWNED                  = 0x01,
        PUBLIC_KEY_OR_TOKEN_OWNED   = 0x02,
        LOCALE_OWNED                = 0x08,
        // unused                   = 0x20,
        // Set if ParseName() returned illegal textual identity.
        // Cannot process the string any further.
        BAD_NAME_OWNED              = 0x40,
    };

    BaseAssemblySpec();
    ~BaseAssemblySpec();

    void Init(LPCSTR pAssemblyName,
              const AssemblyMetaDataInternal* pContext,
              const BYTE * pbPublicKeyOrToken, DWORD cbPublicKeyOrToken,
              DWORD dwFlags);

    HRESULT Init(mdToken tkAssemblyRef, IMDInternalImport *pImport);
    HRESULT Init(mdAssembly tkAssemblyRef, IMetaDataAssemblyImport* pImport);

    void Init(SString& assemblyDisplayName);
    HRESULT InitNoThrow(SString& assemblyDisplayName);

    // Note that this method does not clone the fields!
    VOID CopyFrom(const BaseAssemblySpec *pSpec);

    VOID    CloneFields();
    VOID    CloneFieldsToLoaderHeap(LoaderHeap *pHeap, AllocMemTracker *pamTracker);

    inline void SetBinder(AssemblyBinder *pBinder)
    {
        LIMITED_METHOD_CONTRACT;

        m_pBinder = pBinder;
    }

    inline AssemblyBinder* GetBinder()
    {
        LIMITED_METHOD_CONTRACT;

        return m_pBinder;
    }

    DWORD Hash();

    LPCSTR GetName() const;
    inline void GetName(SString & ssName) const { WRAPPER_NO_CONTRACT; ssName.SetUTF8(GetName()); }

    void SetName(LPCSTR szName);

    VOID SetCulture(LPCSTR szCulture);

    VOID ConvertPublicKeyToToken();

    void  SetContext(ASSEMBLYMETADATA* assemblyData);

    inline AssemblyMetaDataInternal *GetContext() { LIMITED_METHOD_CONTRACT; return &m_context; }
    inline AssemblyMetaDataInternal const *GetContext() const { LIMITED_METHOD_CONTRACT; return &m_context; }

    BOOL IsStrongNamed() const;
    BOOL HasPublicKey() const;
    BOOL HasPublicKeyToken() const;
    BOOL IsCoreLibSatellite() const;
    BOOL IsCoreLib();

    enum CompareExFlags
    {
        ASC_Default                 = 0x00, // Default comparison policy.
        ASC_DefinitionEquality      = 0x01, // Will not treat non-bindable content types as equivalent.
    };

    BOOL CompareEx(BaseAssemblySpec *pSpec, DWORD dwCompareFlags = ASC_Default);
    static int CompareStrings(LPCUTF8 string1, LPCUTF8 string2);
    static BOOL RefMatchesDef(const BaseAssemblySpec* pRef, const BaseAssemblySpec* pDef);

    void GetDisplayName(DWORD flags, SString &result) const;

protected: // static
    static BOOL CompareRefToDef(const BaseAssemblySpec *pRef, const BaseAssemblySpec *pDef);

protected:
    void InitializeWithAssemblyIdentity(BINDER_SPACE::AssemblyIdentity *identity);
    void PopulateAssemblyNameData(AssemblyNameData &data) const;
};

#endif // __BASE_ASSEMBLY_SPEC_H__