VC++导入导出类

一、导出类

VC++中导出类很简单，下面列出了两个等价的方法：

方法1：

class __declspec(dllexport) CTest

{

public:

int        m_nValue;

CObj    m_obj;

};

方法2：

class __declspec(dllexport) CTest;        //类声明，说明是一个导出类

class CTest

{

public:

int        m_nValue;

CObj    m_obj;

};

注意：方法2的类声明必须放在 class CTest 的前面，最好放在预编译头文件 StdAfx.h 里。

使用方法1比较麻烦，要导出一个类还得修改类定义；方法2就比较方便了，可以将要导出的类声明集中放在 StdAfx.h 里，方便维护。

需要注意以下几个问题：

1、成员对象所属类也需要被导出

m_obj是CTest的成员对象，它所属的类CObj也需要被导出。否则编译的时候会产生警告，客户程序可能无法正常构造CTest类（Debug版正常，Release版分配内存但不调用构造函数）。如果导出CObj比较困难，如它是一个模板类，则应该将CObj m_obj更改为CObj*m_obj;

2、内联成员函数

内联函数相当于宏，编译的时候用来替换源代码，用以提高效率。一般它是不会被编译成目标代码的，但是一旦使用了__declspec(dllexport)，编译程序将会为其生成一份目标代码，客户程序调用内联成员函数时，可能直接调用目标代码，此时函数将不再是内联的了。当然，导入类时也可以控制客户程序，使其使用内联的成员函数。

3、友元函数

需要注意的是，上述两个方法均不能导出类的友元函数。要导出友元函数，必须专门声明。方法1、2的改进方案为：

方法1：

class __declspec(dllexport) CTest

{

public:

int m_nValue;

public:

//导出友元函数要专门声明

friend __declspec(dllexport) CTest operator+(const CTest&a,const CTest&b);

};

方法2：

class __declspec(dllexport) CTest;

//导出友元函数要专门声明

__declspec(dllexport) CTest operator+(const CTest&a,const CTest&b);

class CTest

{

public:

int m_nValue;

public:

friend CTest operator+(const CTest&a,const CTest&b);

};

4、嵌套类

要导出嵌套类，方法1的改进方案为：

class __declspec(dllexport) CTest

{

public:

class __declspec(dllexport) CNest    //前面也要使用__declspec(dllexport)

{

}

};

方法2无法导出嵌套类，因为不能按下面的语法进行嵌套类声明：

class __declspec(dllexport) CTest::CNest;    //这样声明是错误的

此时，解决方案可能只有使用DEF文件了。

二、使用DEF文件导出类

按下图设置，使得编译时生成map文件。

编译如下代码

class __declspec(dllexport) CTest

{

public:

void        SetValue(int v)        {m_Value = v;}

int            GetValue();

private:

int            m_Value;

public:

static int    s_nValue;

};

int CTest::s_nValue = 1;

int CTest::GetValue()                {return m_Value;}

查看 map 文件，提取包含 CTest 的函数或变量：

Address	Publics by Value	Rva+Base	Lib:Object
0001:00000030	?SetValue@CTest@@QAEXH@Z	10001030 f i	tDLL.obj
0001:00000070	??4CTest@@QAEAAV0@ABV0@@Z	10001070 f i	tDLL.obj
0001:000000b0	?GetValue@CTest@@QAEHXZ	100010b0 f	tDLL.obj
0003:00000a30	?s_nValue@CTest@@2HA	1002ba30	tDLL.obj

注意上表的第三列，f表示函数，i表示内联。如果将 class __declspec(dllexport) CTest 中的 __declspec(dllexport) 去掉，重新编译，则上表第三列包含 f i 的在map文件中不会再出现。

内联函数没有目标代码，所以无法通过 DEF 导出。只能通过DEF文件导出非内联的成员函数，如：下面的DEF文件内容导出了CTest::GetValue函数。

EXPORTS

?GetValue@CTest@@QAEHXZ

?s_nValue@CTest@@2HA对应着CTest::s_nValue，它应该被导出，但是使用DEF导出变量需要注意：客户程序导入该变量时，只能导入该变量的地址。

三、导入类

导出类到动态链接库的同时，就生成了库文件(*.lib)。VC++很智能，客户程序包含这个库文件即可完成类的导入。要特别注意这种导入的内联成员函数。下面的代码中，客户程序调用内联成员函数GetValue时，将不会使用导出类的GetValue目标代码，而是使用类声明中的代码。此时，GetValue还是内联函数。

class CTest

{

public:

int m_nValue;

public:

int GetValue()

{

return m_nValue;

}

};

如果不想客户程序使用类声明中的代码，有两种方法：

1、删除内联函数GetValue的实现代码，仅仅保留函数声明；

2、使用__declspec(dllimport)，如下所示：

class __declspec(dllimport) CTest

{

public:

int m_nValue;

public:

int GetValue()

{

return m_nValue;

}

};

或在 StdAfx.h 中，增加class __declspec(dllimport) CTest;这句类声明。使用__declspec(dllimport)声明类之后，友元函数就不再需要__declspec(dllimport)声明了。

四、总结

1、导出类有两种方法，一种是使用 __declspec(dllexport)；另一种方法是使用DEF文件，该方法不能导出内联函数，导出类的静态成员变量也较为不便；

2、友元函数不属于类，要导出的话必须使用 __declspec(dllexport) 声明，或在 DEF 文件中导出；

3、导入类可以使用 __declspec(dllimport)，也可以不使用。前者将取消内联成员函数的内联性质，后者不会；

应用实例：

下面是类CTest的定义部分，在 Test.h 里

class CTest

{

public:

class CNest

{

public:

void SetValue(int v);

int GetValue();

friend CNest operator+(const CNest&a,const CNest&b);

private:

int m_nValue;

};

public:

void SetValue(int v);

int GetValue();

friend CTest operator+(const CTest&a,const CTest&b);

private:

int m_nValue;

public:

static int s_nValue;

};

下面是类CTest的实现部分，在Test.cpp里

//CTest-------------------------------------------------------------------------

int CTest::s_nValue = 1;

void CTest::SetValue(int v)

{

m_nValue = v;

}

int CTest::GetValue()

{

return m_nValue;

}

CTest operator+(const CTest&a,const CTest&b)

{

CTest c;

c.m_nValue = a.m_nValue + b.m_nValue;

return c;

}

//CTest::CNest------------------------------------------------------------------

void CTest::CNest::SetValue(int v)

{

m_nValue = v;

}

int CTest::CNest::GetValue()

{

return m_nValue;

}

CTest::CNest operator+(const CTest::CNest&a,const CTest::CNest&b)

{

CTest::CNest c;

c.m_nValue = a.m_nValue + b.m_nValue;

return c;

}

导出 CTest 类及其友元函数，只需在 StdAfx.h 里增加如下代码：

class __declspec(dllexport) CTest;

__declspec(dllexport) CTest operator+(const CTest&a,const CTest&b);

导出CTest::CNest的成员函数稍微麻烦些，需要在DEF文件中导出：

EXPORTS

?SetValue@CNest@CTest@@QAEXH@Z

?GetValue@CNest@CTest@@QAEHXZ

??H@YA?AVCNest@CTest@@ABV01@0@Z

客户程序导入CTest类，只需在 StdAfx.h 里增加如下代码：

class __declspec(dllimport) CTest;

//有了上面的声明，CTest的友元函数就不再需要特别声明了

//下面这句话反而会引起警告

__declspec(dllimport) CTest operator+(const CTest&a,const CTest&b);

客户程序对 CTest::CNest 的导入无需特别声明，VC++编译器能够自动完成。但是，它对CNest是有限制的，即不能有静态成员变量。如果有，最好的办法就是不要使用嵌套了。