优质广告供应商

广告是为了更好地支持作者创作

AutoValue_AutoValue with Builders

原文

AutoValue 的 构建者


AutoValue的介绍 (简单翻译)中已经包含了基本的使用,使用静态工厂作为你的公共API。但是在大部分情况(such as those laid out in Effective Java, 2nd Edition Item 2),你可能更倾向于让你的调用者使用一个构建者生成实例对象。

幸运的是,AutoValue可以也可以生成带有构建者的类。这一页介绍了怎么做。但是我们还是建议你先阅读并理解AutoValue的基本使用,AutoValue的介绍

怎么使用带有构建者的AutoValue


就像在介绍里面说的那样,AutoValue的概念就是写一个抽象的value class,AutoValue实现它。构建者的生成也是一样的方法:制造一个抽象的构造者类,并把它包含在抽象类里面,然后AutoValue就会生成他们的实现。

在<code>Animal.java</code>中

import com.google.auto.value.AutoValue;

@AutoValue
abstract class Animal {
    abstract String name();
    abstract int numberOfLegs();

    static Builder builder() {
        return new AutoValue_Animal.Builder();
    }

    @AutoValue.Builder
    abstract static class Builder {
        abstract Builder name(String value);
        abstract Builder numberOfLegs(int value);
        abstract Animal build();
    }
}

在实际应用中,一些类和方法可能是public的并且带有Javadoc,为了保证例子的简洁我们去掉了这些。

使用

public void testAnimal() {
    Animal dog = Animal.builder().name("dog").numberOfLegs(4).build();
    assertEquals("dog", dog.name());
    assertEquals(4, dog.numberOfLegs());

    //You probably don't need to write assertions like; just illustrating.
    assertTrue(Animal.builder().name("dog").numberogLegs(4).build().equals(dog));
    assertFalse(Animal.builder().name("cat").numberogLegs(4).build().equals(dog));
    assertFalse(Animal.builder().name("dog").numberogLegs(2).build().equals(dog));

    assertEquals("Animal{name=dog, numberOfLegs=4}", dog.toString());
}

AutoValue 生成的代码

警告


确保把这个静态<code>builder()</code>方法直接放在你的value class 内部(e.g.,<code>Animal</code>),而不是内部抽象<code>Builder</code>类。确保这个<code>Animal</code>类在<code>Builder</code>之前初始化。否则你可能遇到初始化顺序问题。

我怎么...   简单翻译/   原文


  • ...使用(或不使用)<code>set</code>前缀?
  • ...使用不同命名除了<code>builder()</code>/<code>Builder</code><code>build()</code>?
  • ...为一个属性制定默认值?
  • ...使用一个现有的 value 实例的值初始化一个构建者?
  • ...在value class内部包含<code>with-</code>方法,来生成一个略微修改的实例?
  • ...验证属性的值?
  • ...在构建时正常化(修改)属性的值?
  • ...同时暴露构造器和工厂方法?
  • ...处理<code>Optional</code>属性?
  • ...使用一个集合属性?
  • ...让构建者累积一个集合属性的值(而不是一次全部给出)?
  • ...在不打破链式调用的前提下累积集合的值?
  • ...对于同一个集合属性提供设置值的两种方式(一次性提供和累积提供)?

优质广告供应商

广告是为了更好地支持作者创作

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 131,289评论 18 138
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 30,482评论 18 399
  • 优质广告供应商

    广告是为了更好地支持作者创作

  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 44,334评论 6 344
  • 1 场景问题# 1.1 继续导出数据的应用框架## 在讨论工厂方法模式的时候,提到了一个导出数据的应用框架。 对于...
    七寸知架构阅读 4,076评论 1 59
  • 为期25天的高一衔接班至今天下午就要结束了,回顾过去的二十多天,我感慨万千。儿子自幼儿园至中考结束,什么特长班、学...
    雲行天下阅读 213评论 10 6
  • 今晚儿子放学回来后,让我看了他的衣服,比以前干净一点,希望继续保持,争取更好,手还是脏兮兮的,这个还是不好要...
    子瀚璐菡妈妈阅读 37评论 0 0
  • 优质广告供应商

    广告是为了更好地支持作者创作

  • 《执着》执着是一种沉淀,是以一种毅力,也是一种恒心,一种考验。明天早上继续10000步!有梦想的约起…
    cb9fa4682249阅读 157评论 0 0