code.grnet.gr Git - aquarium/blob - src/main/scala/gr/grnet/aquarium/computation/data/ResourceInstanceSnapshot.scala

   1 /*
   2  * Copyright 2011-2012 GRNET S.A. All rights reserved.
   3  *
   4  * Redistribution and use in source and binary forms, with or
   5  * without modification, are permitted provided that the following
   6  * conditions are met:
   7  *
   8  *   1. Redistributions of source code must retain the above
   9  *      copyright notice, this list of conditions and the following
  10  *      disclaimer.
  11  *
  12  *   2. Redistributions in binary form must reproduce the above
  13  *      copyright notice, this list of conditions and the following
  14  *      disclaimer in the documentation and/or other materials
  15  *      provided with the distribution.
  16  *
  17  * THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
  18  * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  19  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  20  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
  21  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  22  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  23  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  24  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  25  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  27  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  28  * POSSIBILITY OF SUCH DAMAGE.
  29  *
  30  * The views and conclusions contained in the software and
  31  * documentation are those of the authors and should not be
  32  * interpreted as representing official policies, either expressed
  33  * or implied, of GRNET S.A.
  34  */
  35
  36 package gr.grnet.aquarium.computation.data
  37
  38 /**
  39  * Maintains the current state of a resource instance owned by the user.
  40  * The encoding is as follows:
  41  *
  42  * name: DSLResource.name
  43  * instanceId: instance-id (in the resource's descriminatorField)
  44  * data: current-resource-value
  45  * snapshotTime: last-update-timestamp
  46  *
  47  * In order to have a uniform representation of the resource state for all
  48  * resource types (complex or simple) the following convention applies:
  49  *
  50  *  - If the resource is complex, the (name, instanceId) is (DSLResource.name, instance-id)
  51  *  - If the resource is simple,  the (name, instanceId) is (DSLResource.name, "1")
  52  *
  53  * @param resource        Same as `resource` of [[gr.grnet.aquarium.event.resource.ResourceEventModel]]
  54  * @param instanceId      Same as `instanceId` of [[gr.grnet.aquarium.event.resource.ResourceEventModel]]
  55  * @param instanceAmount  This is the amount kept for the resource instance.
  56 *                         The general rule is that an amount saved in a [[gr.grnet.aquarium.computation.data. ResourceInstanceSnapshot]]
  57  *                        represents a total value, while a value appearing in a [[gr.grnet.aquarium.event.resource.ResourceEventModel]]
  58  *                        represents a difference. How these two values are combined to form the new amount is dictated
  59  *                        by the underlying [[gr.grnet.aquarium.logic.accounting.dsl.DSLCostPolicy]]
  60  *
  61  * @author Christos KK Loverdos <loverdos@gmail.com>
  62  */
  63 case class ResourceInstanceSnapshot(resource: String,
  64                                     instanceId: String,
  65                                     instanceAmount: Double) {
  66
  67   def isSameResourceInstance(resource: String, instanceId: String) = {
  68     this.resource == resource &&
  69     this.instanceId == instanceId
  70   }
  71 }