工厂模式:创建 bean 时验证输入 (Guice/Guava)
Factory pattern: Validating input when creating a bean (Guice/Guava)
我正在编写一个新应用程序,使用 Guice 进行依赖注入,并使用 Guava 的先决条件进行属性验证。
我正在使用工厂模式根据外部输入创建 bean。问题是,验证输入的首选方式是什么?(在可维护性、清晰度等方面)
让我们假设这些 类:
Bean.java
public interface Bean {
public Object getFoo();
}
BeanImpl.java
public class BeanImpl implements Bean {
private final Object foo;
public BeanImpl(Object param) {
foo = param;
}
@Override
public String getFoo() {
return foo;
}
}
我想检查 "param" 是否包含 "foo" 的有效值:
Preconditions.checkArgument(SomeValidator.isValid(param), "Bad param: %s!", param);
我应该在哪里做,为什么?
- 在 BeanImpl 的构造函数中? (我不确定为什么,但在构造函数中添加检查感觉是个坏主意。)
- 在调用 BeanFactory.create(param) 之前? (听起来像是可怕的代码重复。)
- 通过一些我不知道的 Guice 机制?
如果用特定的 foo
值构造 BeanImpl
是无效的,那么在构造函数中抛出一个 IllegalArgumentException
来详细说明错误。
public class BeanImpl {
...
public BeanImpl(Object param) {
if (param == null) {
throw new IllegalArgumentException("Param cannot be null");
}
foo = param;
}
...
}
根据对象的早期定义"state and behavior combined",这强制您不会用无效状态污染您的对象。
就工厂而言,在构造对象之前检查值是一种便利,但工厂的真正职责并不延伸到对象的职责中。工厂模式有助于确保对象以有意义的方式与其他对象相对应,但它不应该完成对象的工作以确保对象的内部状态正确。
让一个对象(工厂)确保另一个对象的状态正确是错误的行为。您将行为(验证状态)放在工厂中,但状态在对象中。因此,您现在拥有分散连接的代码,这些代码 应该 紧密耦合。这意味着现在你将必须有一个工厂来制作一个对象,而不是有一个工厂在有意义的时候制作一个对象,而在没有意义的时候直接制作对象。
这经常出现在单元测试中。如果你没有把验证码放在工厂里,你可以独立对Object进行单元测试;测试错误的参数。然而,如果你把验证码放在工厂里,你将无法构造 "valid" 没有工厂的对象,这是你得到的第一个提示,你不自然地耦合了两个不应该紧密的对象耦合在一起。
当然也有例外;但是当人们期望数据是正确的,但收集数据的方式没有提供验证时,它们往往会出现。例如,从网络套接字收集的结构化记录实际上可能包含概念上内部不一致的数据;但是,由于处理的性质,无效输入会被处理、记录和丢弃。
查看 Netflix 的 Guvernator 框架:
https://github.com/Netflix/governator/wiki/Field-Validation
它建立在 Google Guice 的基础上,并通过一些很酷的功能对其进行了扩展,例如
- 生命周期(构建、验证、预热、销毁)
- 验证
- 配置
在您的项目中包含 guvernator 的样板要多一些,但绝对值得一试。
我正在编写一个新应用程序,使用 Guice 进行依赖注入,并使用 Guava 的先决条件进行属性验证。
我正在使用工厂模式根据外部输入创建 bean。问题是,验证输入的首选方式是什么?(在可维护性、清晰度等方面)
让我们假设这些 类:
Bean.java
public interface Bean {
public Object getFoo();
}
BeanImpl.java
public class BeanImpl implements Bean {
private final Object foo;
public BeanImpl(Object param) {
foo = param;
}
@Override
public String getFoo() {
return foo;
}
}
我想检查 "param" 是否包含 "foo" 的有效值:
Preconditions.checkArgument(SomeValidator.isValid(param), "Bad param: %s!", param);
我应该在哪里做,为什么?
- 在 BeanImpl 的构造函数中? (我不确定为什么,但在构造函数中添加检查感觉是个坏主意。)
- 在调用 BeanFactory.create(param) 之前? (听起来像是可怕的代码重复。)
- 通过一些我不知道的 Guice 机制?
如果用特定的 foo
值构造 BeanImpl
是无效的,那么在构造函数中抛出一个 IllegalArgumentException
来详细说明错误。
public class BeanImpl {
...
public BeanImpl(Object param) {
if (param == null) {
throw new IllegalArgumentException("Param cannot be null");
}
foo = param;
}
...
}
根据对象的早期定义"state and behavior combined",这强制您不会用无效状态污染您的对象。
就工厂而言,在构造对象之前检查值是一种便利,但工厂的真正职责并不延伸到对象的职责中。工厂模式有助于确保对象以有意义的方式与其他对象相对应,但它不应该完成对象的工作以确保对象的内部状态正确。
让一个对象(工厂)确保另一个对象的状态正确是错误的行为。您将行为(验证状态)放在工厂中,但状态在对象中。因此,您现在拥有分散连接的代码,这些代码 应该 紧密耦合。这意味着现在你将必须有一个工厂来制作一个对象,而不是有一个工厂在有意义的时候制作一个对象,而在没有意义的时候直接制作对象。
这经常出现在单元测试中。如果你没有把验证码放在工厂里,你可以独立对Object进行单元测试;测试错误的参数。然而,如果你把验证码放在工厂里,你将无法构造 "valid" 没有工厂的对象,这是你得到的第一个提示,你不自然地耦合了两个不应该紧密的对象耦合在一起。
当然也有例外;但是当人们期望数据是正确的,但收集数据的方式没有提供验证时,它们往往会出现。例如,从网络套接字收集的结构化记录实际上可能包含概念上内部不一致的数据;但是,由于处理的性质,无效输入会被处理、记录和丢弃。
查看 Netflix 的 Guvernator 框架:
https://github.com/Netflix/governator/wiki/Field-Validation
它建立在 Google Guice 的基础上,并通过一些很酷的功能对其进行了扩展,例如
- 生命周期(构建、验证、预热、销毁)
- 验证
- 配置
在您的项目中包含 guvernator 的样板要多一些,但绝对值得一试。