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.policy
38 import gr.grnet.aquarium.{AquariumInternalError, Timespan}
39 import gr.grnet.aquarium.util.json.JsonSupport
40 import gr.grnet.aquarium.charging.ChargingBehavior
41 import gr.grnet.aquarium.converter.{JsonTextFormat, StdConverters}
44 * A policy is the fundamental business-related configuration of Aquarium.
45 * Policies change over the course of time. The underlying representation must be immutable.
47 * TODO: The following sentence will self-destruct at most after 200 commits.
48 * This model supersedes the original DSLPolicy, after changes in requirements and some thoughts on simplicity.
50 * @author Christos KK Loverdos <loverdos@gmail.com>
53 trait PolicyModel extends Ordered[PolicyModel] with JsonSupport {
54 final def compare(that: PolicyModel): Int = {
55 if(this.validFrom < that.validFrom) {
57 } else if(this.validFrom == that.validFrom) {
66 def parentID: Option[String]
68 def idInStore: Option[Any]
71 * The time period within which this policy is valid.
73 def validityTimespan: Timespan
75 final def validFrom: Long = validityTimespan.fromMillis
77 final def validTo: Long = validityTimespan.toMillis
80 * All known resource types for the policy's validity period.
82 def resourceTypes: Set[ResourceType]
85 * All known charging behaviors for the policy's validity period.<p/>
87 * Note than since a charging behavior is semantically attached to an implementation, a change in the set
88 * of known charging behaviors normally means a change in the implementation of Aquarium.
90 def chargingBehaviors: Set[String/*ImplementationClassName*/]
93 * Each role is mapped to a full price table.
95 def roleMapping: Map[String/*Role*/, FullPriceTable]
99 * All the known roles for the policy's validity period.
100 * These names must be common between all communicating parties, i.e. the IM component that sends
101 * [[gr.grnet.aquarium.event.model.im.IMEventModel]] events.
103 * This is a derived set, from the keys of `roleMapping`
105 def roles: Set[String] = roleMapping.keySet
107 def resourceTypesMap: Map[String, ResourceType] = Map(resourceTypes.map(rt ⇒ (rt.name, rt)).toSeq: _*)
109 def resourceTypeByName(resource: String): Option[ResourceType] = resourceTypes.find(_.name == resource)
117 final object Names extends NamesT
119 def fromJsonString(json: String): PolicyModel = {
120 StdConverters.AllConverters.convertEx[StdPolicy](JsonTextFormat(json))