od.py 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394
  1. from uuid import UUID
  2. from state.base import State
  3. from services.bottom.V0 import Bottom
  4. from services.primitives.integer_type import Integer
  5. from services.primitives.string_type import String
  6. from services.primitives.boolean_type import Boolean
  7. from services.primitives.actioncode_type import ActionCode
  8. from framework.conformance import Conformance
  9. from typing import Optional
  10. def get_slot_link_name(obj_name: str, attr_name: str):
  11. return f"{obj_name}_{attr_name}"
  12. # Object Diagrams service
  13. class OD:
  14. def __init__(self, type_model: UUID, model: UUID, state: State):
  15. """
  16. Implements services for the object diagrams LTM.
  17. Implementation is done in terms of services provided by LTM-bottom.
  18. Args:
  19. type_model: The SCD-conforming class diagram that contains the types of this object diagram
  20. model: UUID of the (OD) model to manipulate
  21. """
  22. self.scd_model = UUID(state.read_value(state.read_dict(state.read_root(), "SCD")))
  23. self.type_model = type_model
  24. self.model = model
  25. self.bottom = Bottom(state)
  26. def create_object(self, name: str, class_name: str):
  27. class_nodes = self.bottom.read_outgoing_elements(self.type_model, class_name)
  28. if len(class_nodes) == 0:
  29. raise Exception(f"Cannot create object: No such class '{class_name}'")
  30. class_node = class_nodes[0]
  31. abstract_nodes = self.bottom.read_outgoing_elements(self.type_model, f"{class_name}.abstract")
  32. return self._create_object(name, class_node)
  33. def _create_object(self, name: str, class_node: UUID):
  34. # Look at our `type_model` as if it's an object diagram:
  35. mm_od = OD(
  36. get_scd_mm(self.bottom), # the type model of our type model
  37. self.type_model,
  38. self.bottom.state)
  39. slot = mm_od.get_slot(class_node, "abstract")
  40. if slot != None:
  41. is_abstract, _ = read_primitive_value(self.bottom, slot, self.scd_model)
  42. if is_abstract:
  43. raise Exception("Cannot instantiate abstract class!")
  44. object_node = self.bottom.create_node()
  45. self.bottom.create_edge(self.model, object_node, name) # attach to model
  46. self.bottom.create_edge(object_node, class_node, "Morphism") # typed-by link
  47. return object_node
  48. def get_class_of_object(self, object_name: str):
  49. object_node, = self.bottom.read_outgoing_elements(self.model, object_name) # get the object
  50. return self._get_class_of_object(object_node)
  51. def _get_class_of_object(self, object_node: UUID):
  52. type_el, = self.bottom.read_outgoing_elements(object_node, "Morphism")
  53. for key in self.bottom.read_keys(self.type_model):
  54. type_el2, = self.bottom.read_outgoing_elements(self.type_model, key)
  55. if type_el == type_el2:
  56. return key
  57. def create_slot(self, attr_name: str, object_name: str, target_name: str):
  58. class_name = self.get_class_of_object(object_name)
  59. attr_link_name = self.get_attr_link_name(class_name, attr_name)
  60. if attr_link_name == None:
  61. raise Exception(f"Failed to get link name for attribute '{attr_name}' of object '{object_name}'")
  62. # An attribute-link is indistinguishable from an ordinary link:
  63. slot_link_name = get_slot_link_name(object_name, attr_name)
  64. slot_id = self.create_link(slot_link_name,
  65. attr_link_name, object_name, target_name)
  66. return slot_id
  67. def get_slot(self, object_node: UUID, attr_name: str):
  68. edge = self.get_slot_link(object_node, attr_name)
  69. slot_ref = self.bottom.read_edge_target(edge)
  70. return slot_ref
  71. def get_slot_link(self, object_node: UUID, attr_name: str):
  72. # I really don't like how complex and inefficient it is to read an attribute of an object...
  73. class_name = self._get_class_of_object(object_node)
  74. attr_link_name = self.get_attr_link_name(class_name, attr_name)
  75. if attr_link_name == None:
  76. raise Exception(f"Type '{class_name}' has no attribute '{attr_name}'")
  77. type_edge, = self.bottom.read_outgoing_elements(self.type_model, attr_link_name)
  78. for outgoing_edge in self.bottom.read_outgoing_edges(object_node):
  79. if type_edge in self.bottom.read_outgoing_elements(outgoing_edge, "Morphism"):
  80. return outgoing_edge
  81. def get_slots(self, object_node):
  82. attrlink_node = get_scd_mm_attributelink_node(self.bottom)
  83. slots = []
  84. outgoing_links = self.bottom.read_outgoing_edges(object_node)
  85. for l in outgoing_links:
  86. for type_of_link in self.bottom.read_outgoing_elements(l, "Morphism"):
  87. for type_of_type_of_link in self.bottom.read_outgoing_elements(type_of_link, "Morphism"):
  88. if type_of_type_of_link == attrlink_node:
  89. # hooray, we have a slot
  90. attr_name = get_attr_name(self.bottom, type_of_link)
  91. slots.append((attr_name, l))
  92. return slots
  93. def read_slot(self, slot_id):
  94. tgt = self.bottom.read_edge_target(slot_id)
  95. return read_primitive_value(self.bottom, tgt, self.type_model)
  96. def create_integer_value(self, name: str, value: int):
  97. from services.primitives.integer_type import Integer
  98. int_node = self.bottom.create_node()
  99. integer_t = Integer(int_node, self.bottom.state)
  100. integer_t.create(value)
  101. # name = 'int'+str(value) # name of the ref to the created integer
  102. # By convention, the type model must have a ModelRef named "Integer"
  103. return self.create_model_ref(name, "Integer", int_node)
  104. def create_boolean_value(self, name: str, value: bool):
  105. from services.primitives.boolean_type import Boolean
  106. bool_node = self.bottom.create_node()
  107. bool_service = Boolean(bool_node, self.bottom.state)
  108. bool_service.create(value)
  109. return self.create_model_ref(name, "Boolean", bool_node)
  110. def create_string_value(self, name: str, value: str):
  111. from services.primitives.string_type import String
  112. string_node = self.bottom.create_node()
  113. string_t = String(string_node, self.bottom.state)
  114. string_t.create(value)
  115. return self.create_model_ref(name, "String", string_node)
  116. def create_actioncode_value(self, name: str, value: str):
  117. from services.primitives.actioncode_type import ActionCode
  118. actioncode_node = self.bottom.create_node()
  119. actioncode_t = ActionCode(actioncode_node, self.bottom.state)
  120. actioncode_t.create(value)
  121. return self.create_model_ref(name, "ActionCode", actioncode_node)
  122. # Identical to the same SCD method:
  123. def create_model_ref(self, name: str, type_name: str, model: UUID):
  124. # create element + morphism links
  125. element_node = self.bottom.create_node(str(model)) # create element node
  126. self.bottom.create_edge(self.model, element_node, name) # attach to model
  127. type_node, = self.bottom.read_outgoing_elements(self.type_model, type_name) # retrieve type
  128. self.bottom.create_edge(element_node, type_node, "Morphism") # create morphism link
  129. # print('model ref:', name, type_name, element_node, model)
  130. return element_node
  131. # The edge connecting an object to the value of a slot must be named `{object_name}_{attr_name}`
  132. def get_attr_link_name(self, class_name, attr_name):
  133. assoc_name = f"{class_name}_{attr_name}"
  134. type_edges = self.bottom.read_outgoing_elements(self.type_model, assoc_name)
  135. if len(type_edges) == 1:
  136. return assoc_name
  137. else:
  138. # look for attribute in the super-types
  139. conf = Conformance(self.bottom.state, self.model, self.type_model)
  140. conf.precompute_sub_types() # only need to know about subtypes
  141. super_types = [s for s in conf.sub_types if class_name in conf.sub_types[s]]
  142. for s in super_types:
  143. assoc_name = f"{s}_{attr_name}"
  144. if len(self.bottom.read_outgoing_elements(self.type_model, assoc_name)) == 1:
  145. return assoc_name
  146. def create_link(self, link_name: Optional[str], assoc_name: str, src_obj_name: str, tgt_obj_name: str):
  147. src_obj_nodes = self.bottom.read_outgoing_elements(self.model, src_obj_name)
  148. if len(src_obj_nodes) == 0:
  149. raise Exception(f"Cannot create link '{link_name}' ({assoc_name}): source object '{src_obj_name}'' not found")
  150. src_obj_node = src_obj_nodes[0]
  151. tgt_obj_nodes = self.bottom.read_outgoing_elements(self.model, tgt_obj_name)
  152. if len(tgt_obj_nodes) == 0:
  153. raise Exception(f"Cannot create link '{link_name}' ({assoc_name}): target object '{tgt_obj_name}'' not found")
  154. tgt_obj_node = tgt_obj_nodes[0]
  155. # generate a unique name for the link
  156. if link_name == None:
  157. i = 0;
  158. while True:
  159. link_name = f"{assoc_name}{i}"
  160. if len(self.bottom.read_outgoing_elements(self.model, link_name)) == 0:
  161. break
  162. i += 1
  163. type_edges = self.bottom.read_outgoing_elements(self.type_model, assoc_name)
  164. if len(type_edges) == 0:
  165. raise Exception(f"No such attribute/association: {assoc_name}")
  166. type_edge = type_edges[0]
  167. link_id = self._create_link(link_name, type_edge, src_obj_node, tgt_obj_node)
  168. return link_id
  169. # used for attribute-links and association-links
  170. def _create_link(self, link_name: str, type_edge: UUID, src_obj_node: UUID, tgt_obj_node: UUID):
  171. # print('create_link', link_name, type_edge, src_obj_node, tgt_obj_node)
  172. # the link itself is unlabeled:
  173. link_edge = self.bottom.create_edge(src_obj_node, tgt_obj_node)
  174. # it is only in the context of the model, that the link has a name:
  175. self.bottom.create_edge(self.model, link_edge, link_name) # add to model
  176. self.bottom.create_edge(link_edge, type_edge, "Morphism")
  177. return link_edge
  178. def get_objects(self, class_node):
  179. return get_typed_by(self.bottom, self.model, class_node)
  180. def get_all_objects(self):
  181. scd_mm = get_scd_mm(self.bottom)
  182. class_node = get_scd_mm_class_node(self.bottom)
  183. all_classes = OD(scd_mm, self.type_model, self.bottom.state).get_objects(class_node)
  184. result = {}
  185. for class_name, class_node in all_classes.items():
  186. objects = self.get_objects(class_node)
  187. result[class_name] = objects
  188. return result
  189. def get_all_links(self):
  190. scd_mm = get_scd_mm(self.bottom)
  191. assoc_node = get_scd_mm_assoc_node(self.bottom)
  192. all_classes = OD(scd_mm, self.type_model, self.bottom.state).get_objects(assoc_node)
  193. result = {}
  194. for assoc_name, assoc_node in all_classes.items():
  195. links = self.get_objects(assoc_node)
  196. m = {}
  197. for link_name, link_edge in links.items():
  198. src_node = self.bottom.read_edge_source(link_edge)
  199. tgt_node = self.bottom.read_edge_target(link_edge)
  200. src_name = get_object_name(self.bottom, self.model, src_node)
  201. tgt_name = get_object_name(self.bottom, self.model, tgt_node)
  202. m[link_name] = (link_edge, src_name, tgt_name)
  203. result[assoc_name] = m
  204. return result
  205. def get_object_name(self, obj: UUID):
  206. for key in self.bottom.read_keys(self.model):
  207. for el in self.bottom.read_outgoing_elements(self.model, key):
  208. if el == obj:
  209. return key
  210. def get_types(bottom: Bottom, obj: UUID):
  211. return bottom.read_outgoing_elements(obj, "Morphism")
  212. def get_type(bottom: Bottom, obj: UUID):
  213. types = get_types(bottom, obj)
  214. if len(types) == 1:
  215. return types[0]
  216. elif len(types) > 1:
  217. raise Exception(f"Expected at most one type. Instead got {len(types)}.")
  218. def is_typed_by(bottom, el: UUID, typ: UUID):
  219. for typed_by in get_types(bottom, el):
  220. if typed_by == typ:
  221. return True
  222. return False
  223. def get_typed_by(bottom, model, type_node: UUID):
  224. name_to_instance = {}
  225. for key in bottom.read_keys(model):
  226. element, = bottom.read_outgoing_elements(model, key)
  227. element_types = bottom.read_outgoing_elements(element, "Morphism")
  228. if type_node in element_types:
  229. name_to_instance[key] = element
  230. # mapping from instance name to UUID
  231. return name_to_instance
  232. def get_scd_mm(bottom):
  233. scd_metamodel_id = bottom.state.read_dict(bottom.state.read_root(), "SCD")
  234. scd_metamodel = UUID(bottom.state.read_value(scd_metamodel_id))
  235. return scd_metamodel
  236. def get_scd_mm_class_node(bottom: Bottom):
  237. return get_scd_mm_node(bottom, "Class")
  238. def get_scd_mm_attributelink_node(bottom: Bottom):
  239. return get_scd_mm_node(bottom, "AttributeLink")
  240. def get_scd_mm_attributelink_name_node(bottom: Bottom):
  241. return get_scd_mm_node(bottom, "AttributeLink_name")
  242. def get_scd_mm_assoc_node(bottom: Bottom):
  243. return get_scd_mm_node(bottom, "Association")
  244. def get_scd_mm_modelref_node(bottom: Bottom):
  245. return get_scd_mm_node(bottom, "ModelRef")
  246. def get_scd_mm_actioncode_node(bottom: Bottom):
  247. return get_scd_mm_node(bottom, "ActionCode")
  248. def get_scd_mm_node(bottom: Bottom, node_name: str):
  249. scd_metamodel = get_scd_mm(bottom)
  250. node, = bottom.read_outgoing_elements(scd_metamodel, node_name)
  251. return node
  252. def get_scd_mm_class_uppercard_node(bottom: Bottom):
  253. return get_scd_mm_node(bottom, "Class_upper_cardinality")
  254. def get_scd_mm_class_lowercard_node(bottom: Bottom):
  255. return get_scd_mm_node(bottom, "Class_lower_cardinality")
  256. def get_scd_mm_assoc_src_uppercard_node(bottom: Bottom):
  257. return get_scd_mm_node(bottom, "Association_source_upper_cardinality")
  258. def get_scd_mm_assoc_src_lowercard_node(bottom: Bottom):
  259. return get_scd_mm_node(bottom, "Association_source_lower_cardinality")
  260. def get_scd_mm_assoc_tgt_uppercard_node(bottom: Bottom):
  261. return get_scd_mm_node(bottom, "Association_target_upper_cardinality")
  262. def get_scd_mm_assoc_tgt_lowercard_node(bottom: Bottom):
  263. return get_scd_mm_node(bottom, "Association_target_lower_cardinality")
  264. def get_object_name(bottom: Bottom, model: UUID, object_node: UUID):
  265. for key in bottom.read_keys(model):
  266. for el in bottom.read_outgoing_elements(model, key):
  267. if el == object_node:
  268. return key
  269. def get_type2(bottom: Bottom, mm: UUID, object_node: UUID):
  270. type_node, = bottom.read_outgoing_elements(object_node, "Morphism")
  271. return type_node, get_object_name(bottom, mm, type_node)
  272. def find_outgoing_typed_by(bottom, src: UUID, type_node: UUID):
  273. edges = []
  274. for outgoing_edge in bottom.read_outgoing_edges(src):
  275. for typedBy in bottom.read_outgoing_elements(outgoing_edge, "Morphism"):
  276. if typedBy == type_node:
  277. edges.append(outgoing_edge)
  278. break
  279. return edges
  280. def find_incoming_typed_by(bottom, tgt: UUID, type_node: UUID):
  281. edges = []
  282. for incoming_edge in bottom.read_incoming_edges(tgt):
  283. for typedBy in bottom.read_outgoing_elements(incoming_edge, "Morphism"):
  284. if typedBy == type_node:
  285. edges.append(incoming_edge)
  286. break
  287. return edges
  288. def navigate_modelref(bottom, node: UUID):
  289. uuid = bottom.read_value(node)
  290. return UUID(uuid)
  291. def find_cardinality(bottom, class_node: UUID, type_node: UUID):
  292. upper_card_edges = find_outgoing_typed_by(bottom, class_node, type_node)
  293. if len(upper_card_edges) == 1:
  294. ref = bottom.read_edge_target(upper_card_edges[0])
  295. integer, = bottom.read_outgoing_elements(
  296. navigate_modelref(bottom, ref),
  297. "integer")
  298. # finally, the value we're looking for:
  299. return bottom.read_value(integer)
  300. def get_attributes(bottom, class_node: UUID):
  301. attr_link_node = get_scd_mm_attributelink_node(bottom)
  302. attr_edges = find_outgoing_typed_by(bottom, class_node, attr_link_node)
  303. result = []
  304. for attr_edge in attr_edges:
  305. attr_name = get_attr_name(bottom, attr_edge)
  306. result.append((attr_name, attr_edge))
  307. return result
  308. def get_attr_name(bottom, attr_edge: UUID):
  309. attr_link_name_node = get_scd_mm_attributelink_name_node(bottom)
  310. name_edge, = find_outgoing_typed_by(bottom, attr_edge, attr_link_name_node)
  311. if name_edge == None:
  312. raise Exception("Expected attribute to have a name...")
  313. ref_name = bottom.read_edge_target(name_edge)
  314. string, = bottom.read_outgoing_elements(
  315. navigate_modelref(bottom, ref_name),
  316. "string")
  317. return bottom.read_value(string)
  318. # We need the meta-model (`mm`) to find out how to read the `modelref`
  319. def read_primitive_value(bottom, modelref: UUID, mm: UUID):
  320. typ = get_type(bottom, modelref)
  321. if not is_typed_by(bottom, typ, get_scd_mm_modelref_node(bottom)):
  322. raise Exception("Assertion failed: argument must be typed by ModelRef", typ)
  323. referred_model = UUID(bottom.read_value(modelref))
  324. typ_name = get_object_name(bottom, mm, typ)
  325. if typ_name == "Integer":
  326. return Integer(referred_model, bottom.state).read(), typ_name
  327. elif typ_name == "String":
  328. return String(referred_model, bottom.state).read(), typ_name
  329. elif typ_name == "Boolean":
  330. return Boolean(referred_model, bottom.state).read(), typ_name
  331. elif typ_name == "ActionCode":
  332. return ActionCode(referred_model, bottom.state).read(), typ_name
  333. else:
  334. raise Exception("Unimplemented type:", typ_name)