1 /* 2 * Copyright (c) 2014, 2019, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package jdk.jpackage.internal; 27 28 import java.util.Map; 29 import java.util.function.BiFunction; 30 import java.util.function.Function; 31 32 /** 33 * BundlerParamInfo<T> 34 * 35 * A BundlerParamInfo encapsulates an individual bundler parameter of type <T>. 36 */ 37 class BundlerParamInfo<T> { 38 /** 39 * The user friendly name of the parameter 40 */ 41 String name; 42 43 /** 44 * A more verbose description of the parameter 45 */ 46 String description; 47 48 /** 49 * The command line and hashmap name of the parameter 50 */ 51 String id; 52 53 /** 54 * Type of the parameter 55 */ 56 Class<T> valueType; 57 58 /** 59 * Indicates if value was set using default value function 60 */ 61 boolean isDefaultValue; 62 63 /** 64 * If the value is not set, and no fallback value is found, 65 * the parameter uses the value returned by the producer. 66 */ 67 Function<Map<String, ? super Object>, T> defaultValueFunction; 68 69 /** 70 * An optional string converter for command line arguments. 71 */ 72 BiFunction<String, Map<String, ? super Object>, T> stringConverter; 73 74 String getName() { 75 return name; 76 } 77 78 void setName(String name) { 79 this.name = name; 80 } 81 82 String getDescription() { 83 return description; 84 } 85 86 void setDescription(String description) { 87 this.description = description; 88 } 89 90 String getID() { 91 return id; 92 } 93 94 Class<T> getValueType() { 95 return valueType; 96 } 97 98 void setValueType(Class<T> valueType) { 99 this.valueType = valueType; 100 } 101 102 boolean getIsDefaultValue() { 103 return isDefaultValue; 104 } 105 106 Function<Map<String, ? super Object>, T> getDefaultValueFunction() { 107 return defaultValueFunction; 108 } 109 110 void setDefaultValueFunction( 111 Function<Map<String, ? super Object>, T> defaultValueFunction) { 112 this.defaultValueFunction = defaultValueFunction; 113 } 114 115 BiFunction<String, Map<String, ? super Object>,T> 116 getStringConverter() { 117 return stringConverter; 118 } 119 120 void setStringConverter(BiFunction<String, 121 Map<String, ? super Object>, T> stringConverter) { 122 this.stringConverter = stringConverter; 123 } 124 125 @SuppressWarnings("unchecked") 126 final T fetchFrom(Map<String, ? super Object> params) { 127 return fetchFrom(params, true); 128 } 129 130 @SuppressWarnings("unchecked") 131 final T fetchFrom(Map<String, ? super Object> params, 132 boolean invokeDefault) { 133 Object o = params.get(getID()); 134 if (o instanceof String && getStringConverter() != null) { 135 return getStringConverter().apply((String)o, params); 136 } 137 138 Class<T> klass = getValueType(); 139 if (klass.isInstance(o)) { 140 return (T) o; 141 } 142 if (o != null) { 143 throw new IllegalArgumentException("Param " + getID() 144 + " should be of type " + getValueType() 145 + " but is a " + o.getClass()); 146 } 147 if (params.containsKey(getID())) { 148 // explicit nulls are allowed 149 return null; 150 } 151 152 if (invokeDefault && (getDefaultValueFunction() != null)) { 153 T result = getDefaultValueFunction().apply(params); 154 if (result != null) { 155 params.put(getID(), result); 156 isDefaultValue = true; 157 } 158 return result; 159 } 160 161 // ultimate fallback 162 return null; 163 } 164 }