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 VersionName implements ResourceName { 34 private static final PathTemplate PROJECT_VERSION = 35 PathTemplate.createWithoutUrlEncoding("projects/{project}/agent/versions/{version}"); 36 private static final PathTemplate PROJECT_LOCATION_VERSION = 37 PathTemplate.createWithoutUrlEncoding( 38 "projects/{project}/locations/{location}/agent/versions/{version}"); 39 private volatile Map<String, String> fieldValuesMap; 40 private PathTemplate pathTemplate; 41 private String fixedValue; 42 private final String project; 43 private final String version; 44 private final String location; 45 46 @Deprecated VersionName()47 protected VersionName() { 48 project = null; 49 version = null; 50 location = null; 51 } 52 VersionName(Builder builder)53 private VersionName(Builder builder) { 54 project = Preconditions.checkNotNull(builder.getProject()); 55 version = Preconditions.checkNotNull(builder.getVersion()); 56 location = null; 57 pathTemplate = PROJECT_VERSION; 58 } 59 VersionName(ProjectLocationVersionBuilder builder)60 private VersionName(ProjectLocationVersionBuilder builder) { 61 project = Preconditions.checkNotNull(builder.getProject()); 62 location = Preconditions.checkNotNull(builder.getLocation()); 63 version = Preconditions.checkNotNull(builder.getVersion()); 64 pathTemplate = PROJECT_LOCATION_VERSION; 65 } 66 getProject()67 public String getProject() { 68 return project; 69 } 70 getVersion()71 public String getVersion() { 72 return version; 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.") newProjectVersionBuilder()84 public static Builder newProjectVersionBuilder() { 85 return new Builder(); 86 } 87 88 @BetaApi("The per-pattern Builders are not stable yet and may be changed in the future.") newProjectLocationVersionBuilder()89 public static ProjectLocationVersionBuilder newProjectLocationVersionBuilder() { 90 return new ProjectLocationVersionBuilder(); 91 } 92 toBuilder()93 public Builder toBuilder() { 94 return new Builder(this); 95 } 96 of(String project, String version)97 public static VersionName of(String project, String version) { 98 return newBuilder().setProject(project).setVersion(version).build(); 99 } 100 101 @BetaApi("The static create methods are not stable yet and may be changed in the future.") ofProjectVersionName(String project, String version)102 public static VersionName ofProjectVersionName(String project, String version) { 103 return newBuilder().setProject(project).setVersion(version).build(); 104 } 105 106 @BetaApi("The static create methods are not stable yet and may be changed in the future.") ofProjectLocationVersionName( String project, String location, String version)107 public static VersionName ofProjectLocationVersionName( 108 String project, String location, String version) { 109 return newProjectLocationVersionBuilder() 110 .setProject(project) 111 .setLocation(location) 112 .setVersion(version) 113 .build(); 114 } 115 format(String project, String version)116 public static String format(String project, String version) { 117 return newBuilder().setProject(project).setVersion(version).build().toString(); 118 } 119 120 @BetaApi("The static format methods are not stable yet and may be changed in the future.") formatProjectVersionName(String project, String version)121 public static String formatProjectVersionName(String project, String version) { 122 return newBuilder().setProject(project).setVersion(version).build().toString(); 123 } 124 125 @BetaApi("The static format methods are not stable yet and may be changed in the future.") formatProjectLocationVersionName( String project, String location, String version)126 public static String formatProjectLocationVersionName( 127 String project, String location, String version) { 128 return newProjectLocationVersionBuilder() 129 .setProject(project) 130 .setLocation(location) 131 .setVersion(version) 132 .build() 133 .toString(); 134 } 135 parse(String formattedString)136 public static VersionName parse(String formattedString) { 137 if (formattedString.isEmpty()) { 138 return null; 139 } 140 if (PROJECT_VERSION.matches(formattedString)) { 141 Map<String, String> matchMap = PROJECT_VERSION.match(formattedString); 142 return ofProjectVersionName(matchMap.get("project"), matchMap.get("version")); 143 } else if (PROJECT_LOCATION_VERSION.matches(formattedString)) { 144 Map<String, String> matchMap = PROJECT_LOCATION_VERSION.match(formattedString); 145 return ofProjectLocationVersionName( 146 matchMap.get("project"), matchMap.get("location"), matchMap.get("version")); 147 } 148 throw new ValidationException("VersionName.parse: formattedString not in valid format"); 149 } 150 parseList(List<String> formattedStrings)151 public static List<VersionName> parseList(List<String> formattedStrings) { 152 List<VersionName> list = new ArrayList<>(formattedStrings.size()); 153 for (String formattedString : formattedStrings) { 154 list.add(parse(formattedString)); 155 } 156 return list; 157 } 158 toStringList(List<VersionName> values)159 public static List<String> toStringList(List<VersionName> values) { 160 List<String> list = new ArrayList<>(values.size()); 161 for (VersionName 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_VERSION.matches(formattedString) 173 || PROJECT_LOCATION_VERSION.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 (version != null) { 186 fieldMapBuilder.put("version", version); 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 VersionName that = ((VersionName) o); 214 return Objects.equals(this.project, that.project) 215 && Objects.equals(this.version, that.version) 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(version); 230 h *= 1000003; 231 h ^= Objects.hashCode(location); 232 return h; 233 } 234 235 /** Builder for projects/{project}/agent/versions/{version}. */ 236 public static class Builder { 237 private String project; 238 private String version; 239 Builder()240 protected Builder() {} 241 getProject()242 public String getProject() { 243 return project; 244 } 245 getVersion()246 public String getVersion() { 247 return version; 248 } 249 setProject(String project)250 public Builder setProject(String project) { 251 this.project = project; 252 return this; 253 } 254 setVersion(String version)255 public Builder setVersion(String version) { 256 this.version = version; 257 return this; 258 } 259 Builder(VersionName versionName)260 private Builder(VersionName versionName) { 261 Preconditions.checkArgument( 262 Objects.equals(versionName.pathTemplate, PROJECT_VERSION), 263 "toBuilder is only supported when VersionName has the pattern of projects/{project}/agent/versions/{version}"); 264 this.project = versionName.project; 265 this.version = versionName.version; 266 } 267 build()268 public VersionName build() { 269 return new VersionName(this); 270 } 271 } 272 273 /** Builder for projects/{project}/locations/{location}/agent/versions/{version}. */ 274 @BetaApi("The per-pattern Builders are not stable yet and may be changed in the future.") 275 public static class ProjectLocationVersionBuilder { 276 private String project; 277 private String location; 278 private String version; 279 ProjectLocationVersionBuilder()280 protected ProjectLocationVersionBuilder() {} 281 getProject()282 public String getProject() { 283 return project; 284 } 285 getLocation()286 public String getLocation() { 287 return location; 288 } 289 getVersion()290 public String getVersion() { 291 return version; 292 } 293 setProject(String project)294 public ProjectLocationVersionBuilder setProject(String project) { 295 this.project = project; 296 return this; 297 } 298 setLocation(String location)299 public ProjectLocationVersionBuilder setLocation(String location) { 300 this.location = location; 301 return this; 302 } 303 setVersion(String version)304 public ProjectLocationVersionBuilder setVersion(String version) { 305 this.version = version; 306 return this; 307 } 308 build()309 public VersionName build() { 310 return new VersionName(this); 311 } 312 } 313 } 314