重新访问了访客模式

访客模式是面向对象设计中最被高估但又被低估的模式之一。高估了它，因为它常常被选择得太快（可能是由建筑宇航员选择的），然后以错误的方式添加时会膨胀本来非常简单的设计。如果您不遵循教科书示例，那么它可能会非常强大，因此被低估了。让我们详细看一下。

问题1：命名

它的最大缺陷（在我看来）是命名本身。 “访客”模式。当我们用google搜索它时，我们很可能会在相关的Wikipedia文章中找到自己，显示类似这样的有趣图像：

维基百科访客模式示例

对。对于我们98％的人在日常软件工程工作中对车轮，发动机和车身的思考而言，这很明显，因为我们知道，机修工向我们收取几千美元的汽车维修费用后，我们会首先访问车轮，然后是发动机，然后最终访问我们的钱包并接受我们的现金。如果我们很不幸，他也会在我们工作时拜访我们的妻子，但她永远不会接受那个忠实的灵魂。

但是，解决工作中其他问题的2％的人呢？就像我们为电子银行系统，证券交易所客户，Intranet门户等编写复杂的数据结构时一样。为什么不将访客模式应用于真正的分层数据结构？喜欢文件夹和文件？（好的，毕竟不是那么复杂）

好的，所以我们将“访问”文件夹，每个文件夹将让其文件“接受”为“访客”，然后我们也让访问者“访问”这些文件。什么？？汽车让其零件接纳访客，然后让访客自我访问吗？这些条款具有误导性。它们是通用的，适合设计模式。但是它们会杀死您的现实设计，因为没有人会考虑“接受”和“访问”，而实际上您是在读/写/删除/修改文件系统。

问题2：多态

当应用于错误的情况时，这比命名引起的头痛甚至更多。访客为什么在地球上认识其他所有人？为什么访问者需要针对层次结构中每个涉及元素的方法？多态性和封装要求将实现隐藏在API的后面。（我们数据结构的）API可能以某种方式实现了复合模式，即其部分继承自公共接口。好吧，当然，车轮不是汽车，我妻子也不是机械师。但是当我们采用文件夹/文件结构时，它们不是全部都是java.util.File对象吗？

了解问题

实际的问题不是访问代码的命名和可怕的API详细程度，而是对模式的误解。这不是最适合访问带有许多不同类型对象的大型复杂数据结构的模式。这种模式最适合于访问几种不同类型的简单数据结构，但要访问数百名访问者。取文件和文件夹。那是一个简单的数据结构。您有两种类型。一个可以包含另一个，两者共享一些属性。各种访客可能是：

CalculateSizeVisitor
FindOldestFileVisitor
DeleteAllVisitor
FindFilesByContentVisitor
ScanForVirusesVisitor
…你给它起名字

我仍然不喜欢命名，但是这种模式在这种范例中可以完美地工作。

那么，访客模式何时“错误”？

我想以jOOQ QueryPart结构为例。其中有很多，可以对各种SQL查询结构进行建模，从而使jOOQ可以构建和执行任意复杂度的SQL查询。让我们举几个例子：

健康）状况
- 组合条件
领域
- 表格栏位
字段清单

还有更多。它们中的每一个都必须能够执行两个操作：渲染SQL和绑定变量。那将使两个访问者每个人都知道……40-50种类型……？也许在遥远的将来，jOOQ查询将能够呈现JPQL或其他某种查询类型。那将使3位访客面对40-50种类型。显然，在这里，经典的访客模式是一个错误的选择。但是我仍然想“访问” QueryPart，将渲染和绑定委托给较低的抽象级别。

那么如何实现呢？

很简单：坚持使用复合模式！它允许您向每个人都必须实现的数据结构添加一些API元素。

因此，凭直觉，第一步就是

interface QueryPart {// Let the QueryPart return its SQLString getSQL();// Let the QueryPart bind variables to a prepared// statement, given the next bind index, returning// the last bind indexint bind(PreparedStatement statement, int nextIndex);
}

使用此API，我们可以轻松地抽象SQL查询并将职责委派给较低级别的工件。例如，一个BetweenCondition。它负责在[lower]和[upper]条件之间正确排序[field]的各部分，语法正确地呈现SQL，并将部分任务委派给其child-QueryParts：

class BetweenCondition {Field field;Field lower;Field upper;public String getSQL() {return field.getSQL() + ' between ' +lower.getSQL() + ' and ' +upper.getSQL();}public int bind(PreparedStatement statement, int nextIndex) {int result = nextIndex;result = field.bind(statement, result);result = lower.bind(statement, result);result = upper.bind(statement, result);return result;}
}

另一方面，BindValue主要负责变量绑定

class BindValue {Object value;public String getSQL() {return '?';}public int bind(PreparedStatement statement, int nextIndex) {statement.setObject(nextIndex, value);return nextIndex + 1;}
}

结合起来，我们现在可以轻松创建这种形式的条件：在之间？和？。当实现更多QueryPart时，我们还可以想象像MY_TABLE.MY_FIELD BETWEEN吗？如果可以使用适当的字段实现，则使用AND（选择？从双精度）。这就是使复合模式如此强大，通用的API和许多封装行为的组件，从而将行为的一部分委派给子组件的原因。

第2步负责API的演变

到目前为止，我们已经看到了复合模式，非常直观，但是功能非常强大。但是迟早，我们将需要更多的参数，因为我们发现要将状态从父级QueryPart传递给子级。例如，我们希望能够内联某些子句的某些绑定值。也许某些SQL方言不允许BETWEEN子句中的绑定值。如何使用当前的API处理该问题？扩展它，添加一个“布尔内联”参数？没有！这就是发明访客模式的原因之一。为了使复合结构元素的API保持简单（只需执行“接受”）。但是在这种情况下，用“上下文”替换参数比实现真正的访客模式好得多：

interface QueryPart {// The QueryPart now renders its SQL to the contextvoid toSQL(RenderContext context);// The QueryPart now binds its variables to the contextvoid bind(BindContext context);
}

上面的上下文包含这样的属性（setter和render方法返回上下文本身，以允许方法链接）：

interface RenderContext {// Whether we're inlining bind variablesboolean inline();RenderContext inline(boolean inline);// Whether fields should be rendered as a field declaration// (as opposed to a field reference). This is used for aliased fieldsboolean declareFields();RenderContext declareFields(boolean declare);// Whether tables should be rendered as a table declaration// (as opposed to a table reference). This is used for aliased tablesboolean declareTables();RenderContext declareTables(boolean declare);// Whether we should cast bind variablesboolean cast();// Render methodsRenderContext sql(String sql);RenderContext sql(char sql);RenderContext keyword(String keyword);RenderContext literal(String literal);// The context's 'visit' methodRenderContext sql(QueryPart sql);
}

BindContext也是如此。如您所见，该API相当可扩展，可以添加新属性，还可以添加其他常见的呈现SQL的方法。但是BetweenCondition不必放弃有关如何呈现其SQL以及是否允许绑定变量的封装知识。它会将这些知识保留给自己：

class BetweenCondition {Field field;Field lower;Field upper;// The QueryPart now renders its SQL to the contextpublic void toSQL(RenderContext context) {context.sql(field).keyword(' between ').sql(lower).keyword(' and ').sql(upper);}// The QueryPart now binds its variables to the contextpublic void bind(BindContext context) {context.bind(field).bind(lower).bind(upper);}
}

另一方面，BindValue主要负责变量绑定

class BindValue {Object value;public void toSQL(RenderContext context) {context.sql('?');}public void bind(BindContext context) {context.statement().setObject(context.nextIndex(), value);}
}

结论：将其命名为上下文模式，而不是访客模式

快速跳到访客模式时要小心。在许多情况下，您将使设计变得肿，从而使其完全不可读且难以调试。这里是要记住的规则，总结如下：