Effective Java 在工作中的应用总结

import lombok.Builder;
/** 请求类 */@Builderpublic class SampleRequest {    private String paramOne;    private int paramTwo;    private boolean paramThree;}
/** 响应类 */@Builderpublic class SampleResponse {    private boolean success;}
/** 服务接口 */public interface SampleFacade {    Result<SampleResponse> rpcOne(RequestParam<SampleRequest>);}
/** 调用 */public void testRpcOne() {    SampleRequest request =          SampleRequest.builder().paramOne("one").paramTwo(2).paramThree(true).build();    Result<SampleResponse> response = sampleFacade.rpcOne(request);}

public class SampleUtility {
    public static String getXXX() {        return "test";    }  
    /** 私有化构造器 */    private SampleUtility() {}}
/** 直接调用方法 */public static void main(String[] args) {    System.out.println(SampleUtility.getXXX());}

import com.google.common.annotations.VisibleForTesting;
@VisibleForTesting(otherwise = VisibleForTesting.PRIVATE)String getXXX() {    return "test";}

public class Utility {
    private static boolean isGreaterThan(int a, int b) {        return a > b;    }
    private Utility() {}}
/** 测试类 */import org.junit.Test;import org.junit.jupiter.api.Assertions;import org.junit.runner.RunWith;import org.powermock.core.classloader.annotations.PrepareForTest;import org.powermock.modules.junit4.PowerMockRunner;import org.powermock.reflect.Whitebox;
@RunWith(PowerMockRunner.class)@PrepareForTest({Utility.class})public class UtilityTest {
    @Test    public void test_privateIsGreaterThan_success() throws Exception {        /** 测试私有的 isGreaterThan 方法 */        boolean result = Whitebox.invokeMethod(Utility.class, "isGreaterThan", 3, 2);
        Assertions.assertTrue(result);    }}

import static com.google.common.collect.ImmutableList.toImmutableList;import com.google.common.collect.ImmutableList;import com.google.common.collect.ImmutableMap;
/** 推荐 */private static final ImmutableMap<String, Integer> SAMPLE_MAP =    ImmutableMap.of("One", 1, "Two", 2);
/** 推荐：确保原input列表不会变化 */public ImmutableList<TestObj> updateXXX(ImmutableList<TestObj> input) {    return input.stream()            .map(obj -> obj.setXXX(true))            .collect(toImmutableList());}
/** 不推荐：改变input的信息 */public void filterXXX(List<TestObj> input) {    input.forEach(obj -> obj.setXXX(true));}

public class SampleListener {
    public ConsumeConcurrentlyStatus consumeMessage(String input) {          SampleResult result = generateResult(input);        ...    } 
    private static SampleResult generateResult(String input) {        ...    }
    /** 辅助类 */    private static class SampleResult {        private boolean success;        private List<String> xxxList;        private int count;    }}

/** 推荐：提示返回值可能为空。*/public Optional<Foo> findFoo(String id);
/**  * 中立：稍显笨重  * 可考虑 doSomething("bar", null);  * 或者重载 doSomething("bar"); 和 doSomething("bar", "baz");  **/public Foo doSomething(String id, Optional<Bar> barOptional);
/**   * 不推荐：违背 Optional 设计的目的。  * 当 Optional 值缺省时，一般有3种处理方法：1）提供代替的值；2）调用方法提供代替的值；3）抛出异常  * 这些处理方法可以在字段初始或赋值的时候处理。   **/public class Book {    private List<Pages> pages;    private Optional<Index> index;}
/**   * 不推荐：违背 Optional 设计的目的。  * 若为缺省值，可直接不放入列表中。   **/List<Optional<Foo>>

/** 推荐 */public int sum(int a, int b) {    return a + b;}
/** 不推荐：不必要的装箱 */public Integer sum(Integer a, Integer b) {    return a + b;}