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