/* * Copyright 2010-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). * You may not use this file except in compliance with the License. * A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either * express or implied. See the License for the specific language governing * permissions and limitations under the License. */ package com.amazonaws.services.geo.model; import java.io.Serializable; import com.amazonaws.AmazonWebServiceRequest; /** * <p> * Stores a geofence geometry in a given geofence collection, or updates the * geometry of an existing geofence if a geofence ID is included in the request. * </p> */ public class PutGeofenceRequest extends AmazonWebServiceRequest implements Serializable { /** * <p> * The geofence collection to store the geofence in. * </p> * <p> * <b>Constraints:</b><br/> * <b>Length: </b>1 - 100<br/> * <b>Pattern: </b>^[-._\w]+$<br/> */ private String collectionName; /** * <p> * An identifier for the geofence. For example, * <code>ExampleGeofence-1</code>. * </p> * <p> * <b>Constraints:</b><br/> * <b>Length: </b>1 - 100<br/> * <b>Pattern: </b>^[-._\p{L}\p{N}]+$<br/> */ private String geofenceId; /** * <p> * Specifies additional user-defined properties to store with the Geofence. * An array of key-value pairs. * </p> */ private java.util.Map<String, String> geofenceProperties; /** * <p> * Contains the details to specify the position of the geofence. Can be * either a polygon or a circle. Including both will return a validation * error. * </p> * <note> * <p> * Each <a href= * "https://docs.aws.amazon.com/location-geofences/latest/APIReference/API_GeofenceGeometry.html" * > geofence polygon</a> can have a maximum of 1,000 vertices. * </p> * </note> */ private GeofenceGeometry geometry; /** * <p> * The geofence collection to store the geofence in. * </p> * <p> * <b>Constraints:</b><br/> * <b>Length: </b>1 - 100<br/> * <b>Pattern: </b>^[-._\w]+$<br/> * * @return <p> * The geofence collection to store the geofence in. * </p> */ public String getCollectionName() { return collectionName; } /** * <p> * The geofence collection to store the geofence in. * </p> * <p> * <b>Constraints:</b><br/> * <b>Length: </b>1 - 100<br/> * <b>Pattern: </b>^[-._\w]+$<br/> * * @param collectionName <p> * The geofence collection to store the geofence in. * </p> */ public void setCollectionName(String collectionName) { this.collectionName = collectionName; } /** * <p> * The geofence collection to store the geofence in. * </p> * <p> * Returns a reference to this object so that method calls can be chained * together. * <p> * <b>Constraints:</b><br/> * <b>Length: </b>1 - 100<br/> * <b>Pattern: </b>^[-._\w]+$<br/> * * @param collectionName <p> * The geofence collection to store the geofence in. * </p> * @return A reference to this updated object so that method calls can be * chained together. */ public PutGeofenceRequest withCollectionName(String collectionName) { this.collectionName = collectionName; return this; } /** * <p> * An identifier for the geofence. For example, * <code>ExampleGeofence-1</code>. * </p> * <p> * <b>Constraints:</b><br/> * <b>Length: </b>1 - 100<br/> * <b>Pattern: </b>^[-._\p{L}\p{N}]+$<br/> * * @return <p> * An identifier for the geofence. For example, * <code>ExampleGeofence-1</code>. * </p> */ public String getGeofenceId() { return geofenceId; } /** * <p> * An identifier for the geofence. For example, * <code>ExampleGeofence-1</code>. * </p> * <p> * <b>Constraints:</b><br/> * <b>Length: </b>1 - 100<br/> * <b>Pattern: </b>^[-._\p{L}\p{N}]+$<br/> * * @param geofenceId <p> * An identifier for the geofence. For example, * <code>ExampleGeofence-1</code>. * </p> */ public void setGeofenceId(String geofenceId) { this.geofenceId = geofenceId; } /** * <p> * An identifier for the geofence. For example, * <code>ExampleGeofence-1</code>. * </p> * <p> * Returns a reference to this object so that method calls can be chained * together. * <p> * <b>Constraints:</b><br/> * <b>Length: </b>1 - 100<br/> * <b>Pattern: </b>^[-._\p{L}\p{N}]+$<br/> * * @param geofenceId <p> * An identifier for the geofence. For example, * <code>ExampleGeofence-1</code>. * </p> * @return A reference to this updated object so that method calls can be * chained together. */ public PutGeofenceRequest withGeofenceId(String geofenceId) { this.geofenceId = geofenceId; return this; } /** * <p> * Specifies additional user-defined properties to store with the Geofence. * An array of key-value pairs. * </p> * * @return <p> * Specifies additional user-defined properties to store with the * Geofence. An array of key-value pairs. * </p> */ public java.util.Map<String, String> getGeofenceProperties() { return geofenceProperties; } /** * <p> * Specifies additional user-defined properties to store with the Geofence. * An array of key-value pairs. * </p> * * @param geofenceProperties <p> * Specifies additional user-defined properties to store with the * Geofence. An array of key-value pairs. * </p> */ public void setGeofenceProperties(java.util.Map<String, String> geofenceProperties) { this.geofenceProperties = geofenceProperties; } /** * <p> * Specifies additional user-defined properties to store with the Geofence. * An array of key-value pairs. * </p> * <p> * Returns a reference to this object so that method calls can be chained * together. * * @param geofenceProperties <p> * Specifies additional user-defined properties to store with the * Geofence. An array of key-value pairs. * </p> * @return A reference to this updated object so that method calls can be * chained together. */ public PutGeofenceRequest withGeofenceProperties( java.util.Map<String, String> geofenceProperties) { this.geofenceProperties = geofenceProperties; return this; } /** * <p> * Specifies additional user-defined properties to store with the Geofence. * An array of key-value pairs. * </p> * <p> * The method adds a new key-value pair into GeofenceProperties parameter, * and returns a reference to this object so that method calls can be * chained together. * * @param key The key of the entry to be added into GeofenceProperties. * @param value The corresponding value of the entry to be added into * GeofenceProperties. * @return A reference to this updated object so that method calls can be * chained together. */ public PutGeofenceRequest addGeofencePropertiesEntry(String key, String value) { if (null == this.geofenceProperties) { this.geofenceProperties = new java.util.HashMap<String, String>(); } if (this.geofenceProperties.containsKey(key)) throw new IllegalArgumentException("Duplicated keys (" + key.toString() + ") are provided."); this.geofenceProperties.put(key, value); return this; } /** * Removes all the entries added into GeofenceProperties. * <p> * Returns a reference to this object so that method calls can be chained * together. */ public PutGeofenceRequest clearGeofencePropertiesEntries() { this.geofenceProperties = null; return this; } /** * <p> * Contains the details to specify the position of the geofence. Can be * either a polygon or a circle. Including both will return a validation * error. * </p> * <note> * <p> * Each <a href= * "https://docs.aws.amazon.com/location-geofences/latest/APIReference/API_GeofenceGeometry.html" * > geofence polygon</a> can have a maximum of 1,000 vertices. * </p> * </note> * * @return <p> * Contains the details to specify the position of the geofence. Can * be either a polygon or a circle. Including both will return a * validation error. * </p> * <note> * <p> * Each <a href= * "https://docs.aws.amazon.com/location-geofences/latest/APIReference/API_GeofenceGeometry.html" * > geofence polygon</a> can have a maximum of 1,000 vertices. * </p> * </note> */ public GeofenceGeometry getGeometry() { return geometry; } /** * <p> * Contains the details to specify the position of the geofence. Can be * either a polygon or a circle. Including both will return a validation * error. * </p> * <note> * <p> * Each <a href= * "https://docs.aws.amazon.com/location-geofences/latest/APIReference/API_GeofenceGeometry.html" * > geofence polygon</a> can have a maximum of 1,000 vertices. * </p> * </note> * * @param geometry <p> * Contains the details to specify the position of the geofence. * Can be either a polygon or a circle. Including both will * return a validation error. * </p> * <note> * <p> * Each <a href= * "https://docs.aws.amazon.com/location-geofences/latest/APIReference/API_GeofenceGeometry.html" * > geofence polygon</a> can have a maximum of 1,000 vertices. * </p> * </note> */ public void setGeometry(GeofenceGeometry geometry) { this.geometry = geometry; } /** * <p> * Contains the details to specify the position of the geofence. Can be * either a polygon or a circle. Including both will return a validation * error. * </p> * <note> * <p> * Each <a href= * "https://docs.aws.amazon.com/location-geofences/latest/APIReference/API_GeofenceGeometry.html" * > geofence polygon</a> can have a maximum of 1,000 vertices. * </p> * </note> * <p> * Returns a reference to this object so that method calls can be chained * together. * * @param geometry <p> * Contains the details to specify the position of the geofence. * Can be either a polygon or a circle. Including both will * return a validation error. * </p> * <note> * <p> * Each <a href= * "https://docs.aws.amazon.com/location-geofences/latest/APIReference/API_GeofenceGeometry.html" * > geofence polygon</a> can have a maximum of 1,000 vertices. * </p> * </note> * @return A reference to this updated object so that method calls can be * chained together. */ public PutGeofenceRequest withGeometry(GeofenceGeometry geometry) { this.geometry = geometry; return this; } /** * Returns a string representation of this object; useful for testing and * debugging. * * @return A string representation of this object. * @see java.lang.Object#toString() */ @Override public String toString() { StringBuilder sb = new StringBuilder(); sb.append("{"); if (getCollectionName() != null) sb.append("CollectionName: " + getCollectionName() + ","); if (getGeofenceId() != null) sb.append("GeofenceId: " + getGeofenceId() + ","); if (getGeofenceProperties() != null) sb.append("GeofenceProperties: " + getGeofenceProperties() + ","); if (getGeometry() != null) sb.append("Geometry: " + getGeometry()); sb.append("}"); return sb.toString(); } @Override public int hashCode() { final int prime = 31; int hashCode = 1; hashCode = prime * hashCode + ((getCollectionName() == null) ? 0 : getCollectionName().hashCode()); hashCode = prime * hashCode + ((getGeofenceId() == null) ? 0 : getGeofenceId().hashCode()); hashCode = prime * hashCode + ((getGeofenceProperties() == null) ? 0 : getGeofenceProperties().hashCode()); hashCode = prime * hashCode + ((getGeometry() == null) ? 0 : getGeometry().hashCode()); return hashCode; } @Override public boolean equals(Object obj) { if (this == obj) return true; if (obj == null) return false; if (obj instanceof PutGeofenceRequest == false) return false; PutGeofenceRequest other = (PutGeofenceRequest) obj; if (other.getCollectionName() == null ^ this.getCollectionName() == null) return false; if (other.getCollectionName() != null && other.getCollectionName().equals(this.getCollectionName()) == false) return false; if (other.getGeofenceId() == null ^ this.getGeofenceId() == null) return false; if (other.getGeofenceId() != null && other.getGeofenceId().equals(this.getGeofenceId()) == false) return false; if (other.getGeofenceProperties() == null ^ this.getGeofenceProperties() == null) return false; if (other.getGeofenceProperties() != null && other.getGeofenceProperties().equals(this.getGeofenceProperties()) == false) return false; if (other.getGeometry() == null ^ this.getGeometry() == null) return false; if (other.getGeometry() != null && other.getGeometry().equals(this.getGeometry()) == false) return false; return true; } }