com.aerospike.client.policy.WritePolicy Maven / Gradle / Ivy
/*
* Copyright 2012-2019 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.
*
* Default: GenerationPolicy.NONE
*/
public GenerationPolicy generationPolicy = GenerationPolicy.NONE;
/**
* Desired consistency guarantee when committing a transaction 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.
*
* 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. Supported by Aerospike server versions >= 3.10.1.
* - -1: Never expire. Supported by Aerospike server versions >= 3.1.4.
* - 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 transaction 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;
/**
* 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;
}
/**
* 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;
}
}