2 * Copyright 2011-2012 GRNET S.A. All rights reserved.
4 * Redistribution and use in source and binary forms, with or
5 * without modification, are permitted provided that the following
8 * 1. Redistributions of source code must retain the above
9 * copyright notice, this list of conditions and the following
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.
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.
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.
36 package gr.grnet.aquarium.charging
38 import gr.grnet.aquarium.policy.{ResourceType, EffectivePriceTable, FullPriceTable}
39 import gr.grnet.aquarium.event.model.resource.ResourceEventModel
40 import gr.grnet.aquarium.logic.accounting.dsl.Timeslot
41 import gr.grnet.aquarium.Aquarium
42 import gr.grnet.aquarium.computation.BillingMonthInfo
43 import gr.grnet.aquarium.charging.state.{WorkingResourceInstanceChargingState, AgreementHistoryModel, WorkingResourcesChargingState}
44 import gr.grnet.aquarium.charging.wallet.WalletEntry
45 import scala.collection.mutable
48 * A charging behavior indicates how charging for a resource will be done
49 * wrt the various states a resource instance can be in.
51 * @author Christos KK Loverdos <loverdos@gmail.com>
54 trait ChargingBehavior {
55 def selectorLabelsHierarchy: List[String]
58 * Provides some initial charging details that will be part of the mutable charging state
59 * ([[gr.grnet.aquarium.charging.state.WorkingResourcesChargingState]]).
61 def initialChargingDetails: Map[String, Any]
63 def computeSelectorPath(
64 workingChargingBehaviorDetails: mutable.Map[String, Any],
65 workingResourceInstanceChargingState: WorkingResourceInstanceChargingState,
66 currentResourceEvent: ResourceEventModel,
67 referenceTimeslot: Timeslot,
71 def selectEffectivePriceTable(
72 fullPriceTable: FullPriceTable,
73 workingChargingBehaviorDetails: mutable.Map[String, Any],
74 workingResourceInstanceChargingState: WorkingResourceInstanceChargingState,
75 currentResourceEvent: ResourceEventModel,
76 referenceTimeslot: Timeslot,
78 ): EffectivePriceTable
82 * @return The number of wallet entries recorded and the credit difference generated during processing (these are
83 * the credits to subtract from the total credits).
85 def processResourceEvent(
87 currentResourceEvent: ResourceEventModel,
88 resourceType: ResourceType,
89 billingMonthInfo: BillingMonthInfo,
90 workingResourcesChargingState: WorkingResourcesChargingState,
91 userAgreements: AgreementHistoryModel,
93 walletEntryRecorder: WalletEntry ⇒ Unit
96 def computeCreditsToSubtract(
97 workingResourceInstanceChargingState: WorkingResourceInstanceChargingState,
99 timeDeltaMillis: Long,
101 ): (Double /* credits */, String /* explanation */)
104 * Given the charging state of a resource instance and the details of the incoming message, compute the new
105 * accumulating amount.
107 def computeNewAccumulatingAmount(
108 workingResourceInstanceChargingState: WorkingResourceInstanceChargingState,
109 eventDetails: Map[String, String]