设计模式-代理模式（Proxy）

代理模式（Proxy）

定义

代理是一种结构型设计模式，让你能够提供对象的替代品或其占位符。代理控制着对于原对象的访问，并允许在将请求提交给对象前后进行一些处理。

前言

1. 问题

举个例子：有这样一个消耗大量系统资源的巨型对象， 你只是偶尔需要使用它，并非总是需要。

你可以实现延迟初始化：在实际有需要时再创建该对象。对象的所有客户端都要执行延迟初始代码。不幸的是，这很可能会带来很多重复代码。 在理想情况下，我们希望将代码直接放入对象的类中，但这并非总是能实现：比如类可能是第三方封闭库的一部分。

2. 解决方案

代理模式建议新建一个与原服务对象接口相同的代理类，然后更新应用以将代理对象传递给所有原始对象客户端。代理类接收到客户端请求后会创建实际的服务对象，并将所有工作委派给它。

代理将自己伪装成数据库对象，可在客户端或实际数据库对象不知情的情况下处理延迟初始化和缓存查询结果的工作。

这有什么好处呢？如果需要在类的主要业务逻辑前后执行一些工作，你无需修改类就能完成这项工作。由于代理实现的接口与原类相同，因此你可将其传递给任何一个使用实际服务对象的客户端。

真实世界类比

信用卡是银行账户的代理， 银行账户则是一大捆现金的代理。 它们都实现了同样的接口， 均可用于进行支付。 消费者会非常满意， 因为不必随身携带大量现金； 商店老板同样会十分高兴， 因为交易收入能以电子化的方式进入商店的银行账户中， 无需担心存款时出现现金丢失或被抢劫的情况。

结构

1. 服务接口（Service Interface）声明了服务接口。代理必须遵循该接口才能伪装成服务对象。
2. 服务（Service）类提供了一些实用的业务逻辑。
3. 代理（Proxy）类包含一个指向服务对象的引用成员变量。代理完成其任务（例如延迟初始化、记录日志、访问控制和缓存等）后会将请求传递给服务对象。通常情况下，代理会对其服务对象的整个生命周期进行管理。
4. 客户端（Client） 能通过同一接口与服务或代理进行交互，所以你可在一切需要服务对象的代码中使用代理。

适用场景

• 延迟初始化（虚拟代理）。如果你有一个偶尔使用的重量级服务对象，一直保持该对象运行会消耗系统资源时，可使用代理模式。

你无需在程序启动时就创建该对象，可将对象的初始化延迟到真正有需要的时候。

• 访问控制（保护代理）。如果你只希望特定客户端使用服务对象，这里的对象可以是操作系统中非常重要的部分，而客户端则是各种已启动的程序（包括恶意程序），此时可使用代理模式。

代理可仅在客户端凭据满足要求时将请求传递给服务对象。

• 本地执行远程服务（远程代理）。适用于服务对象位于远程服务器上的情形。

在这种情形中，代理通过网络传递客户端请求，负责处理所有与网络相关的复杂细节。

• 记录日志请求（日志记录代理）。适用于当你需要保存对于服务对象的请求历史记录时。代理可以在向服务传递请求前进行记录。

• 缓存请求结果（缓存代理）。适用于需要缓存客户请求结果并对缓存生命周期进行管理时，特别是当返回结果的体积非常大时。

代理可对重复请求所需的相同结果进行缓存，还可使用请求参数作为索引缓存的键值。

• 智能引用。当一个对象被引用时提供一些额外的操作，比如将对象被调用的次数记录下来等。可在没有客户端使用某个重量级对象时立即销毁该对象。

代理会将所有获取了指向服务对象或其结果的客户端记录在案。代理会时不时地遍历各个客户端，检查它们是否仍在运行。如果相应的客户端列表为空，代理就会销毁该服务对象，释放底层系统资源。代理还可以记录客户端是否修改了服务对象。其他客户端还可以复用未修改的对象。

实现方式

1. 如果没有现成的服务接口，你就需要创建一个接口来实现代理和服务对象的可交换性。从服务类中抽取接口并非总是可行的，因为你需要对服务的所有客户端进行修改，让它们使用接口。备选计划是将代理作为服务类的子类，这样代理就能继承服务的所有接口了。
2. 创建代理类，其中必须包含一个存储指向服务的引用的成员变量。通常情况下，代理负责创建服务并对其整个生命周期进行管理。在一些特殊情况下，客户端会通过构造函数将服务传递给代理。
3. 根据需求实现代理方法。在大部分情况下，代理在完成一些任务后应将工作委派给服务对象。
4. 可以考虑新建一个构建方法来判断客户端可获取的是代理还是实际服务。 你可以在代理类中创建一个简单的静态方法，也可以创建一个完整的工厂方法。
5. 可以考虑为服务对象实现延迟初始化。

优点

• 你可以在客户端毫无察觉的情况下控制服务对象。
• 如果客户端对服务对象的生命周期没有特殊要求，你可以对生命周期进行管理。
• 即使服务对象还未准备好或不存在，代理也可以正常工作。
• 开闭原则。你可以在不对服务或客户端做出修改的情况下创 建新代理。

缺点

• 代码可能会变得复杂，因为需要新建许多类。
• 服务响应可能会延迟。

与其他模式的关系

• 适配器能为被封装对象提供不同的接口，代理能为对象提供相同的接口，装饰则能为对象提供加强的接口。
• 外观与代理的相似之处在于它们都缓存了一个复杂实体并自行对其进行初始化。代理与其服务对象遵循同一接口，使得自己和服务对象可以互换，在这一点上它与外观不同。
• 装饰和代理有着相似的结构，但是其意图却非常不同。这两个模式的构建都基于组合原则，也就是说一个对象应该将部分工作委派给另一个对象。两者之间的不同之处在于代理通常自行管理其服务对象的生命周期，而装饰的生成则总是由客户端进行控制。

实例

本例演示如何使用代理模式在第三方视频程序库中添加延迟初始化和缓存。

程序库提供了视频下载类。但是该类的效率非常低。如果客户端程序多次请求同一视频，程序库会反复下载该视频，而不会将首次下载的文件缓存下来复用。

代理类实现和原下载器相同的接口，并将所有工作委派给原下载器。不过，代理类会保存所有的文件下载记录，如果程序多次请求同一文件，它会返回缓存的文件。

ServiceInterface.h：

#ifndef SERVICE_INTERFACE_H_
#define SERVICE_INTERFACE_H_#include <string>// 远程服务接口
class ThirdPartyTVLib {public:virtual std::string listVideos() = 0;virtual std::string getVideoInfo(int id) = 0;
};#endif  // SERVICE_INTERFACE_H_

Service.h：

#ifndef SERVICE_H_
#define SERVICE_H_#include <string>
#include "ServiceInterface.h"// 视频下载类
// 该类的方法可以向远程视频后端服务请求信息, 请求速度取决于用户和服务器的网络状况
// 如果同时发送大量请求, 即使所请求的信息一模一样, 程序的速度依然会变慢
class ThirdPartyTVClass : public ThirdPartyTVLib {public:std::string listVideos() override {// 向远程视频后端服务发送一个API请求获取视频信息, 这里忽略实现return "video list";}std::string getVideoInfo(int id) override {// 向远程视频后端服务发送一个API请求获取某个视频的元数据, 这里忽略实现return "video info";}
};#endif  //  SERVICE_H_

Proxy.h：

#ifndef PROXY_H_
#define PROXY_H_#include <string>
#include "ServiceInterface.h"// 为了节省网络带宽, 我们可以将请求缓存下来并保存一段时间
// 当代理类接受到真实请求后才会将其委派给服务对象
class CachedTVClass : public ThirdPartyTVLib {public:explicit CachedTVClass(ThirdPartyTVLib* service) : service_(service), need_reset_(false), list_cache_(""), video_cache_("") {}void reset() {need_reset_ = true;}std::string listVideos() override {if (list_cache_ == "" || need_reset_) {list_cache_ = service_->listVideos();}return list_cache_;}std::string getVideoInfo(int id) override {if (video_cache_ == "" || need_reset_) {video_cache_ = service_->getVideoInfo(id);}return video_cache_;}private:ThirdPartyTVLib* service_;std::string list_cache_;std::string video_cache_;bool need_reset_;
};#endif  // PROXY_H_

Client.h：

#ifndef CLIENT_H_
#define CLIENT_H_#include <string>
#include <cstdio>
#include "Service.h"// 之前直接与服务对象交互的 GUI 类不需要改变, 前提是它仅通过接口与服务对象交互。
// 我们可以安全地传递一个代理对象来代替真实服务对象, 因为它们都实现了相同的接口。
class TVManager {public:explicit TVManager(ThirdPartyTVLib* s) : service_(s) {}void renderVideoPage(int id) {std::string video_info = service_->getVideoInfo(id);// 渲染视频页面, 这里忽略实现printf("渲染视频页面: %s\n", video_info.c_str());return;}void renderListPanel() {std::string videos = service_->listVideos();// 渲染视频缩略图列表, 这里忽略实现printf("渲染视频缩略图列表: %s\n", videos.c_str());return;}private:ThirdPartyTVLib* service_;
};#endif  // CLIENT_H_

main.cpp：

#include "Client.h"
#include "Service.h"
#include "Proxy.h"int main() {ThirdPartyTVClass* aTVService = new ThirdPartyTVClass();CachedTVClass* aTVProxy = new CachedTVClass(aTVService);TVManager* manager = new TVManager(aTVProxy);manager->renderVideoPage(1);manager->renderListPanel();delete aTVService;delete aTVProxy;delete manager;
}

编译运行：

$g++ -g main.cpp -std=c++11 -o proxy
$./proxy 
渲染视频页面: video info
渲染视频缩略图列表: video list