org.apache.geode.cache.ExpirationAttributes Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of geode-core Show documentation
Apache Geode provides a database-like consistency model, reliable transaction processing and a shared-nothing architecture to maintain very low latency performance with high concurrency processing
There is a newer version: 1.15.1
Show newest version
/*
 * Licensed to the Apache Software Foundation (ASF) under one or more contributor license
 * agreements. See the NOTICE file distributed with this work for additional information regarding
 * copyright ownership. The ASF licenses this file to You 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 org.apache.geode.cache;

import java.io.DataInput;
import java.io.DataOutput;
import java.io.IOException;

import org.apache.geode.DataSerializable;
import org.apache.geode.DataSerializer;
import org.apache.geode.internal.InternalDataSerializer;

/**
 * Immutable parameter object for accessing and setting the attributes associated with
 * timeToLive and idleTimeout. If the expiration action is not specified,
 * it defaults to ExpirationAction.INVALIDATE. If the timeout is not specified, it
 * defaults to zero (which means to never timeout).
 *
 *
 *
 * @see AttributesFactory
 * @see RegionAttributes
 * @see AttributesMutator
 * @since GemFire 3.0
 */
public class ExpirationAttributes implements DataSerializable {
  private static final long serialVersionUID = 5956885652945706394L;
  /** convenience constant for a default instance */
  public static final ExpirationAttributes DEFAULT = new ExpirationAttributes();

  /** The number of seconds since this value or region was created before it expires. */
  private int timeout;

  /**
   * The action that should take place when this object or region expires.
   */
  private ExpirationAction action;

  /**
   * Constructs a default ExpirationAttributes, which indicates no expiration will take
   * place.
   */
  public ExpirationAttributes() {
    this.timeout = 0;
    this.action = ExpirationAction.INVALIDATE;
  }

  /**
   * Constructs an ExpirationAttributes with the specified expiration time and the
   * default expiration action ExpirationAction.INVALIDATE.
   * 
   * @param expirationTime The number of seconds before expiration
   * @throws IllegalArgumentException if expirationTime is nonpositive
   */
  public ExpirationAttributes(int expirationTime) {
    this.timeout = expirationTime;
    this.action = ExpirationAction.INVALIDATE;
  }

  /**
   * Constructs an ExpirationAttributes with the specified expiration time and
   * expiration action.
   * 
   * @param expirationTime The number of seconds for a value to live before it expires
   * @param expirationAction the action to take when the value expires
   * @throws IllegalArgumentException if expirationTime is nonpositive
   */
  public ExpirationAttributes(int expirationTime, ExpirationAction expirationAction) {
    this.timeout = expirationTime;
    this.action = expirationAction;
  }


  /**
   * Returns the number of seconds before a region or value expires.
   *
   * @return the relative number of seconds before a region or value expires or zero if it will
   *         never expire
   */
  public int getTimeout() {
    return this.timeout;
  }

  /**
   * Returns the action that should take place when this value or region expires.
   * 
   * @return the action to take when expiring
   */
  public ExpirationAction getAction() {
    return this.action;
  }

  @Override
  public boolean equals(Object obj) {
    if (!(obj instanceof ExpirationAttributes)) {
      return false;
    }
    ExpirationAttributes ea = (ExpirationAttributes) obj;
    return this.timeout == ea.timeout && this.action == ea.action;
  }

  @Override
  public int hashCode() {
    return this.timeout ^ this.action.hashCode();
  }

  /**
   * Returns a string representation of this ExpirationAttributes. If the timeout is
   * zero, returns "NO EXPIRATION".
   * 
   * @return the String representation of this expiration attribute
   */
  @Override
  public String toString() {
    if (this.timeout == 0) {
      return "NO EXPIRATION";
    }
    return "timeout: " + this.timeout + ";action: " + this.action;
  }

  public static ExpirationAttributes createFromData(DataInput in)
      throws IOException, ClassNotFoundException {
    ExpirationAttributes result = new ExpirationAttributes();
    InternalDataSerializer.invokeFromData(result, in);
    return result;
  }


  public void fromData(DataInput in) throws IOException, ClassNotFoundException {
    this.timeout = in.readInt();
    this.action = (ExpirationAction) DataSerializer.readObject(in);

  }

  public void toData(DataOutput out) throws IOException {
    out.writeInt(this.timeout);
    DataSerializer.writeObject(this.action, out);
  }
}