1 /* 2 * Copyright 2022 Google LLC 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * https://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.google.cloud.dialogflow.v2; 18 19 import com.google.api.core.BetaApi; 20 import com.google.api.pathtemplate.PathTemplate; 21 import com.google.api.pathtemplate.ValidationException; 22 import com.google.api.resourcenames.ResourceName; 23 import com.google.common.base.Preconditions; 24 import com.google.common.collect.ImmutableMap; 25 import java.util.ArrayList; 26 import java.util.List; 27 import java.util.Map; 28 import java.util.Objects; 29 import javax.annotation.Generated; 30 31 // AUTO-GENERATED DOCUMENTATION AND CLASS. 32 @Generated("by gapic-generator-java") 33 public class IntentName implements ResourceName { 34 private static final PathTemplate PROJECT_INTENT = 35 PathTemplate.createWithoutUrlEncoding("projects/{project}/agent/intents/{intent}"); 36 private static final PathTemplate PROJECT_LOCATION_INTENT = 37 PathTemplate.createWithoutUrlEncoding( 38 "projects/{project}/locations/{location}/agent/intents/{intent}"); 39 private volatile Map<String, String> fieldValuesMap; 40 private PathTemplate pathTemplate; 41 private String fixedValue; 42 private final String project; 43 private final String intent; 44 private final String location; 45 46 @Deprecated IntentName()47 protected IntentName() { 48 project = null; 49 intent = null; 50 location = null; 51 } 52 IntentName(Builder builder)53 private IntentName(Builder builder) { 54 project = Preconditions.checkNotNull(builder.getProject()); 55 intent = Preconditions.checkNotNull(builder.getIntent()); 56 location = null; 57 pathTemplate = PROJECT_INTENT; 58 } 59 IntentName(ProjectLocationIntentBuilder builder)60 private IntentName(ProjectLocationIntentBuilder builder) { 61 project = Preconditions.checkNotNull(builder.getProject()); 62 location = Preconditions.checkNotNull(builder.getLocation()); 63 intent = Preconditions.checkNotNull(builder.getIntent()); 64 pathTemplate = PROJECT_LOCATION_INTENT; 65 } 66 getProject()67 public String getProject() { 68 return project; 69 } 70 getIntent()71 public String getIntent() { 72 return intent; 73 } 74 getLocation()75 public String getLocation() { 76 return location; 77 } 78 newBuilder()79 public static Builder newBuilder() { 80 return new Builder(); 81 } 82 83 @BetaApi("The per-pattern Builders are not stable yet and may be changed in the future.") newProjectIntentBuilder()84 public static Builder newProjectIntentBuilder() { 85 return new Builder(); 86 } 87 88 @BetaApi("The per-pattern Builders are not stable yet and may be changed in the future.") newProjectLocationIntentBuilder()89 public static ProjectLocationIntentBuilder newProjectLocationIntentBuilder() { 90 return new ProjectLocationIntentBuilder(); 91 } 92 toBuilder()93 public Builder toBuilder() { 94 return new Builder(this); 95 } 96 of(String project, String intent)97 public static IntentName of(String project, String intent) { 98 return newBuilder().setProject(project).setIntent(intent).build(); 99 } 100 101 @BetaApi("The static create methods are not stable yet and may be changed in the future.") ofProjectIntentName(String project, String intent)102 public static IntentName ofProjectIntentName(String project, String intent) { 103 return newBuilder().setProject(project).setIntent(intent).build(); 104 } 105 106 @BetaApi("The static create methods are not stable yet and may be changed in the future.") ofProjectLocationIntentName( String project, String location, String intent)107 public static IntentName ofProjectLocationIntentName( 108 String project, String location, String intent) { 109 return newProjectLocationIntentBuilder() 110 .setProject(project) 111 .setLocation(location) 112 .setIntent(intent) 113 .build(); 114 } 115 format(String project, String intent)116 public static String format(String project, String intent) { 117 return newBuilder().setProject(project).setIntent(intent).build().toString(); 118 } 119 120 @BetaApi("The static format methods are not stable yet and may be changed in the future.") formatProjectIntentName(String project, String intent)121 public static String formatProjectIntentName(String project, String intent) { 122 return newBuilder().setProject(project).setIntent(intent).build().toString(); 123 } 124 125 @BetaApi("The static format methods are not stable yet and may be changed in the future.") formatProjectLocationIntentName( String project, String location, String intent)126 public static String formatProjectLocationIntentName( 127 String project, String location, String intent) { 128 return newProjectLocationIntentBuilder() 129 .setProject(project) 130 .setLocation(location) 131 .setIntent(intent) 132 .build() 133 .toString(); 134 } 135 parse(String formattedString)136 public static IntentName parse(String formattedString) { 137 if (formattedString.isEmpty()) { 138 return null; 139 } 140 if (PROJECT_INTENT.matches(formattedString)) { 141 Map<String, String> matchMap = PROJECT_INTENT.match(formattedString); 142 return ofProjectIntentName(matchMap.get("project"), matchMap.get("intent")); 143 } else if (PROJECT_LOCATION_INTENT.matches(formattedString)) { 144 Map<String, String> matchMap = PROJECT_LOCATION_INTENT.match(formattedString); 145 return ofProjectLocationIntentName( 146 matchMap.get("project"), matchMap.get("location"), matchMap.get("intent")); 147 } 148 throw new ValidationException("IntentName.parse: formattedString not in valid format"); 149 } 150 parseList(List<String> formattedStrings)151 public static List<IntentName> parseList(List<String> formattedStrings) { 152 List<IntentName> list = new ArrayList<>(formattedStrings.size()); 153 for (String formattedString : formattedStrings) { 154 list.add(parse(formattedString)); 155 } 156 return list; 157 } 158 toStringList(List<IntentName> values)159 public static List<String> toStringList(List<IntentName> values) { 160 List<String> list = new ArrayList<>(values.size()); 161 for (IntentName value : values) { 162 if (value == null) { 163 list.add(""); 164 } else { 165 list.add(value.toString()); 166 } 167 } 168 return list; 169 } 170 isParsableFrom(String formattedString)171 public static boolean isParsableFrom(String formattedString) { 172 return PROJECT_INTENT.matches(formattedString) 173 || PROJECT_LOCATION_INTENT.matches(formattedString); 174 } 175 176 @Override getFieldValuesMap()177 public Map<String, String> getFieldValuesMap() { 178 if (fieldValuesMap == null) { 179 synchronized (this) { 180 if (fieldValuesMap == null) { 181 ImmutableMap.Builder<String, String> fieldMapBuilder = ImmutableMap.builder(); 182 if (project != null) { 183 fieldMapBuilder.put("project", project); 184 } 185 if (intent != null) { 186 fieldMapBuilder.put("intent", intent); 187 } 188 if (location != null) { 189 fieldMapBuilder.put("location", location); 190 } 191 fieldValuesMap = fieldMapBuilder.build(); 192 } 193 } 194 } 195 return fieldValuesMap; 196 } 197 getFieldValue(String fieldName)198 public String getFieldValue(String fieldName) { 199 return getFieldValuesMap().get(fieldName); 200 } 201 202 @Override toString()203 public String toString() { 204 return fixedValue != null ? fixedValue : pathTemplate.instantiate(getFieldValuesMap()); 205 } 206 207 @Override equals(Object o)208 public boolean equals(Object o) { 209 if (o == this) { 210 return true; 211 } 212 if (o != null || getClass() == o.getClass()) { 213 IntentName that = ((IntentName) o); 214 return Objects.equals(this.project, that.project) 215 && Objects.equals(this.intent, that.intent) 216 && Objects.equals(this.location, that.location); 217 } 218 return false; 219 } 220 221 @Override hashCode()222 public int hashCode() { 223 int h = 1; 224 h *= 1000003; 225 h ^= Objects.hashCode(fixedValue); 226 h *= 1000003; 227 h ^= Objects.hashCode(project); 228 h *= 1000003; 229 h ^= Objects.hashCode(intent); 230 h *= 1000003; 231 h ^= Objects.hashCode(location); 232 return h; 233 } 234 235 /** Builder for projects/{project}/agent/intents/{intent}. */ 236 public static class Builder { 237 private String project; 238 private String intent; 239 Builder()240 protected Builder() {} 241 getProject()242 public String getProject() { 243 return project; 244 } 245 getIntent()246 public String getIntent() { 247 return intent; 248 } 249 setProject(String project)250 public Builder setProject(String project) { 251 this.project = project; 252 return this; 253 } 254 setIntent(String intent)255 public Builder setIntent(String intent) { 256 this.intent = intent; 257 return this; 258 } 259 Builder(IntentName intentName)260 private Builder(IntentName intentName) { 261 Preconditions.checkArgument( 262 Objects.equals(intentName.pathTemplate, PROJECT_INTENT), 263 "toBuilder is only supported when IntentName has the pattern of projects/{project}/agent/intents/{intent}"); 264 this.project = intentName.project; 265 this.intent = intentName.intent; 266 } 267 build()268 public IntentName build() { 269 return new IntentName(this); 270 } 271 } 272 273 /** Builder for projects/{project}/locations/{location}/agent/intents/{intent}. */ 274 @BetaApi("The per-pattern Builders are not stable yet and may be changed in the future.") 275 public static class ProjectLocationIntentBuilder { 276 private String project; 277 private String location; 278 private String intent; 279 ProjectLocationIntentBuilder()280 protected ProjectLocationIntentBuilder() {} 281 getProject()282 public String getProject() { 283 return project; 284 } 285 getLocation()286 public String getLocation() { 287 return location; 288 } 289 getIntent()290 public String getIntent() { 291 return intent; 292 } 293 setProject(String project)294 public ProjectLocationIntentBuilder setProject(String project) { 295 this.project = project; 296 return this; 297 } 298 setLocation(String location)299 public ProjectLocationIntentBuilder setLocation(String location) { 300 this.location = location; 301 return this; 302 } 303 setIntent(String intent)304 public ProjectLocationIntentBuilder setIntent(String intent) { 305 this.intent = intent; 306 return this; 307 } 308 build()309 public IntentName build() { 310 return new IntentName(this); 311 } 312 } 313 } 314