// Copyright Yahoo. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root. package com.yahoo.config; import java.io.File; import java.util.ArrayList; import java.util.Collection; import java.util.LinkedHashMap; import java.util.List; import java.util.Map; import java.util.Objects; /** * An immutable file reference that can only be created from classes within the same package. * This is to prevent clients from creating arbitrary and invalid file references. * * @author Tony Vaagenes */ public final class FileReference { private final String value; public FileReference(String value) { this.value = Objects.requireNonNull(value); } public String value() { return value; } @Override public boolean equals(Object o) { if (this == o) return true; if (o == null || getClass() != o.getClass()) return false; FileReference that = (FileReference) o; return value.equals(that.value); } @Override public int hashCode() { return Objects.hash(value); } @Override public String toString() { return "file '" + value + "'"; } public static List toValues(Collection references) { List ret = new ArrayList<>(); for (FileReference r: references) { ret.add(r.value()); } return ret; } public static Map toValueMap(Map map) { Map ret = new LinkedHashMap<>(); for (Map.Entry e : map.entrySet()) { ret.put(e.getKey(), e.getValue().value()); } return ret; } public static FileReference mockFileReferenceForUnitTesting(File file) { if (! file.exists()) throw new IllegalArgumentException("File '" + file.getAbsolutePath() + "' does not exist."); return new FileReference(file.getPath()); } }