org.simpleframework.util.lease.ContractLease Maven / Gradle / Ivy

Go to download
/*
 * ContractLease.java May 2004
 *
 * Copyright (C) 2004, Niall Gallagher 
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the 
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General 
 * Public License along with this library; if not, write to the 
 * Free Software Foundation, Inc., 59 Temple Place, Suite 330, 
 * Boston, MA  02111-1307  USA
 */

package org.simpleframework.util.lease;

import java.util.concurrent.TimeUnit;

/**
 * The ContractLease is used to maintain contracts by
 * using a controller object. This will invoke the controller with
 * the contract when a lease operation is performed. A lease is
 * renewed by changing the contract duration and passing that to
 * the controller which will reestablish the expiry time for it.
 *
 * @author Niall Gallagher 
 */
class ContractLease implements Lease {

   /**
    * This is the controller object used to handle contracts.
    */
   private final Controller handler;

   /**
    * This is the contract object representing the lease.
    */
   private final Contract contract;

   /**
    * Constructor for the ContractLease object. This is
    * used to create a lease which will maintain a contract using a
    * controller object. Lease renewals are performed by changing the
    * expiry duration on the contract and notifying the controller.     
    *  
    * @param handler this is used to manage the contract expiration
    * @param contract this is the contract representing the lease
    */
   public ContractLease(Controller handler, Contract contract) {
      this.handler = handler;
      this.contract = contract;      
   }   

   /**
    * Determines the duration remaining before the lease expires. 
    * The expiry is given as the number of TimeUnit
    * seconds remaining before the lease expires. If this value is 
    * negative it should be assumed that the lease has expired.
    *
    * @param unit this is the time unit used for the duration
    * 
    * @return the duration remaining within this lease instance
    *
    * @exception LeaseException if the lease expiry has passed
    */
   public long getExpiry(TimeUnit unit) throws Exception {
      return contract.getDelay(unit);           
   }

   /**
    * This ensures that the leased resource is maintained for the
    * specified number of TimeUnit seconds. Allowing
    * the duration unit to be specified enables the lease system 
    * to maintain a resource with a high degree of accuracy. The
    * accuracy of the leasing system is dependant on how long it
    * takes to clean the resource associated with the lease.
    * 
    * @param duration this is the length of time to renew for
    * @param unit this is the time unit used for the duration
    *
    * @exception LeaseException if the expiry has been passed
    */
   public void renew(long duration, TimeUnit unit) throws Exception {
      if(duration >= 0) {
         contract.setDelay(duration, unit);
      }
      handler.renew(contract);      
   }

   /**
    * This will cancel the lease and release the resource. This 
    * has the same effect as the renew method with
    * a zero length duration. Once this has been called the
    * Cleaner used should be notified immediately.
    * If the lease has already expired this throws an exception.
    *
    * @exception LeaseException if the expiry has been passed
    */
   public void cancel() throws Exception {      
      handler.cancel(contract);           
   }
   
   /**
    * Provides the key for the resource that this lease represents.
    * This can be used to identify the resource should the need
    * arise. Also, this provides a convenient means of identifying
    * leases when using or storing it as an Object.
    *
    * @return this returns the key for the resource represented
    */
   public T getKey() {
      return contract.getKey();
   }
}