com.aerospike.client.policy.WritePolicy Maven / Gradle / Ivy
Show all versions of aerospike-client-jdk8 Show documentation
/*
* Copyright 2012-2024 Aerospike, Inc.
*
* Portions may be licensed to Aerospike, Inc. under one or more contributor
* license agreements WHICH ARE COMPATIBLE WITH THE APACHE LICENSE, VERSION 2.0.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License 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.aerospike.client.policy;
/**
* Container object for policy attributes used in write operations.
* This object is passed into methods where database writes can occur.
*/
public final class WritePolicy extends Policy {
/**
* Qualify how to handle writes where the record already exists.
*
* Default: RecordExistsAction.UPDATE
*/
public RecordExistsAction recordExistsAction = RecordExistsAction.UPDATE;
/**
* Qualify how to handle record writes based on record generation. The default (NONE)
* indicates that the generation is not used to restrict writes.
*
* The server does not support this field for UDF execute() calls. The read-modify-write
* usage model can still be enforced inside the UDF code itself.
*
* Default: GenerationPolicy.NONE
*/
public GenerationPolicy generationPolicy = GenerationPolicy.NONE;
/**
* Desired consistency guarantee when committing a command on the server. The default
* (COMMIT_ALL) indicates that the server should wait for master and all replica commits to
* be successful before returning success to the client.
*
* Default: CommitLevel.COMMIT_ALL
*/
public CommitLevel commitLevel = CommitLevel.COMMIT_ALL;
/**
* Expected generation. Generation is the number of times a record has been modified
* (including creation) on the server. If a write operation is creating a record,
* the expected generation would be 0. This field is only relevant when
* generationPolicy is not NONE.
*
* The server does not support this field for UDF execute() calls. The read-modify-write
* usage model can still be enforced inside the UDF code itself.
*
* Default: 0
*/
public int generation;
/**
* Record expiration. Also known as ttl (time to live).
* Seconds record will live before being removed by the server.
*
* Expiration values:
*
* - -2: Do not change ttl when record is updated.
* - -1: Never expire.
* - 0: Default to namespace configuration variable "default-ttl" on the server.
* - > 0: Actual ttl in seconds.
*
*
* Default: 0
*/
public int expiration;
/**
* For client operate(), return a result for every operation.
*
* Some operations do not return results by default (ListOperation.clear() for example).
* This can make it difficult to determine the desired result offset in the returned
* bin's result list.
*
* Setting respondAllOps to true makes it easier to identify the desired result offset
* (result offset equals bin's operate sequence). If there is a map operation in operate(),
* respondAllOps will be forced to true for that operate() call.
*
* Default: false
*/
public boolean respondAllOps;
/**
* If the command results in a record deletion, leave a tombstone for the record.
* This prevents deleted records from reappearing after node failures.
* Valid for Aerospike Server Enterprise Edition 3.10+ only.
*
* Default: false (do not tombstone deleted records).
*/
public boolean durableDelete;
/**
* Operate in XDR mode. Some external connectors may need to emulate an XDR client.
* If enabled, an XDR bit is set for writes in the wire protocol.
*
* Default: false.
*/
public boolean xdr;
/**
* Copy write policy from another write policy.
*/
public WritePolicy(WritePolicy other) {
super(other);
this.recordExistsAction = other.recordExistsAction;
this.generationPolicy = other.generationPolicy;
this.commitLevel = other.commitLevel;
this.generation = other.generation;
this.expiration = other.expiration;
this.respondAllOps = other.respondAllOps;
this.durableDelete = other.durableDelete;
this.xdr = other.xdr;
}
/**
* Copy write policy from another policy.
*/
public WritePolicy(Policy other) {
super(other);
}
/**
* Default constructor.
*/
public WritePolicy() {
// Writes are not retried by default.
super.maxRetries = 0;
}
@Override
public int hashCode() {
final int prime = 31;
int result = super.hashCode();
result = prime * result + ((commitLevel == null) ? 0 : commitLevel.hashCode());
result = prime * result + (durableDelete ? 1231 : 1237);
result = prime * result + expiration;
result = prime * result + generation;
result = prime * result + ((generationPolicy == null) ? 0 : generationPolicy.hashCode());
result = prime * result + ((recordExistsAction == null) ? 0 : recordExistsAction.hashCode());
result = prime * result + (respondAllOps ? 1231 : 1237);
result = prime * result + (xdr ? 1231 : 1237);
return result;
}
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (!super.equals(obj))
return false;
if (getClass() != obj.getClass())
return false;
WritePolicy other = (WritePolicy) obj;
if (commitLevel != other.commitLevel)
return false;
if (durableDelete != other.durableDelete)
return false;
if (expiration != other.expiration)
return false;
if (generation != other.generation)
return false;
if (generationPolicy != other.generationPolicy)
return false;
if (recordExistsAction != other.recordExistsAction)
return false;
if (respondAllOps != other.respondAllOps)
return false;
if (xdr != other.xdr)
return false;
return true;
}
// Include setters to facilitate Spring's ConfigurationProperties.
public void setRecordExistsAction(RecordExistsAction recordExistsAction) {
this.recordExistsAction = recordExistsAction;
}
public void setGenerationPolicy(GenerationPolicy generationPolicy) {
this.generationPolicy = generationPolicy;
}
public void setCommitLevel(CommitLevel commitLevel) {
this.commitLevel = commitLevel;
}
public void setGeneration(int generation) {
this.generation = generation;
}
public void setExpiration(int expiration) {
this.expiration = expiration;
}
public void setRespondAllOps(boolean respondAllOps) {
this.respondAllOps = respondAllOps;
}
public void setDurableDelete(boolean durableDelete) {
this.durableDelete = durableDelete;
}
public void setXdr(boolean xdr) {
this.xdr = xdr;
}
}