ontomde-uml2 1.0.4

data/History.txt

@@ -0,0 +1,8 @@
+
+== 1.0.3 /2007-11-30
+* Added ownedOperation for Actor (Objecteering 6 support)
+
+== 1.0.0 / 2007-10-27
+* First public release
+* rename from rdfma to ontoMDE
+

data/Manifest.txt

@@ -0,0 +1,39 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/ontomde-uml2.rb
+lib/ontomde-uml2/version.rb
+lib/ontomde-uml2/cardinality.rb
+lib/ontomde-uml2/check.rb
+lib/ontomde-uml2/uml2.rdfs.nt
+lib/ontomde-uml2/dotDiagram.rb
+lib/ontomde-uml2/nt_old_to_nt_new.sh
+lib/ontomde-uml2/createAndAdd.rb
+lib/ontomde-uml2/enumerated.rb
+lib/ontomde-uml2/select.rb
+lib/ontomde-uml2/salvageErrors.rb
+lib/ontomde-uml2/multipleInheritance.rb
+lib/ontomde-uml2/uml2.rb
+lib/ontomde-uml2/owner.rb
+lib/ontomde-uml2/versionSignature.rb
+lib/ontomde-uml2/depencies.rb
+lib/ontomde-uml2/extension.rb
+lib/ontomde-uml2/umlx.rb
+lib/ontomde-uml2/autoImplement.rb
+lib/ontomde-uml2.rb
+lib/ontomde-uml2/helper.rb
+lib/ontomde-uml2/shortcut.rb
+test/_test_perf.rb
+test/test_misc.rb
+test/test_base.rb
+test/test_ontomde-uml2.rb
+test/model/SID.emx
+test/model/SID.emx.nt
+test/model/simple2WithProfile.emx
+test/model/simple2.emx
+test/model/SID.uml2
+test/model/.project
+test/model/simple2.emx.nt
+test/test_clone.rb
+test/_test_dot.rb

data/README.txt

@@ -0,0 +1,77 @@
+ontomde-uml2
+    by stephane (Pierre) Carrie
+    http://ontomde.rubyforge.org
+
+== DESCRIPTION:
+
+ontoMDE-uml2 contains UML2 meta-model and helper files to manipulate a UML2 model.   
+ontoMDE-uml2 uses ontoMDA-core which provides core fonctionalities for loading a model in RDF/RDFS format. ontoMDE-UML2 is used by ontoMDE-java which contains rules for generating java Code.
+
+== FEATURES/PROBLEMS:
+  
+* UML2 meta-model definition in RDFS format
+* Ruby helper methods for handling a UML2 model.
+* UML Stereotype handling helpers.
+* UML predefined enumerations handling helper.
+* UML model manipulations helpers (add interface implementations, transform multiple inheritance into single inheritance, ...)
+
+
+== SYNOPSIS:
+
+  require 'ontomde-uml2'
+
+  # create a new empty model.
+  model=Crdf_Model.new
+
+  # loads UML2 meta-model
+  model.loadUML2
+  
+  # loads your UML2 model
+  model.loadModelFromFile("YourUML2ModelFile.emx.nt",true)
+
+  # display name of every UML element with a name 
+  module Muml_NamedElement
+     def disp
+	puts "Name=#{uml_name}"
+     end
+  end
+  # ignore every other model element 
+  module Crdf_Ressource
+    def disp
+       #do nothing
+    end
+  end
+
+  model.each { |k,c|
+	c.disp
+  }
+
+== REQUIREMENTS:
+
+* requires ontomde-core
+
+== INSTALL:
+
+* (UNIX) sudo gem install ontomde-uml2
+* (WIN)  gem install ontomde-uml2
+
+Additional information is available on ontoMDE web site :
+http://ontomde.rubyforge.org/website/download.html
+== LICENSE:
+
+Copyright (C) 2008 Orange-labs 
+38 rue General Leclerc
+92130 ISSY LES MOULINEAUX, France
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program 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 Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see http://www.gnu.org/licenses/.

data/Rakefile

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/ontomde-uml2/version.rb'
+
+Hoe.new('ontomde-uml2', Ontomde::Uml2::VERSION) do |p|
+  p.rubyforge_name = 'ontomde'
+  p.author = 'Stephane (Pierre) Carrie'
+  p.email = 'stephanepierre.carrie -nospam- @orange-ftgroup.com'
+  p.summary = 'OntoMDE UML2 handling cartridge'
+  p.description = p.paragraphs_of('README.txt', 2..5).join("\n\n")
+  p.url="http://ontomde.rubyforge.org"
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.spec_extras[:required_ruby_version] = '>= 1.8.4'
+  p.extra_deps=[ 
+	  ['ontomde-core',"= #{Ontomde::Uml2::VERSION}"]
+	  #,['rubygems-update', "> 0.9.5" ] # .cmd to .bat change
+  	]
+  p.spec_extras={ :required_ruby_version => '>=1.8.6',:required_rubygems_version => '>=1.0.0' }
+end
+
+# vim: syntax=Ruby

data/lib/ontomde-uml2.rb

@@ -0,0 +1,31 @@
+# This files includes requires for every ruby files of the ontomde-uml2 package.
+#
+# To use ontomde-uml2 just insert the following instruction in your file:
+#   require 'ontomde-uml2'
+#
+# Users wishing to write a Java Code generator should rather use ontomde-uml2_java and eventually redefine methods.
+
+here="#{File.dirname(__FILE__)}/ontomde-uml2"
+require "#{__FILE__[0..-4]}/version.rb"
+
+UML2_RDFS_NT_FILE="#{here}/uml2.rdfs.nt"
+require 'ontomde-core'
+require "#{here}/extension.rb"
+require "#{here}/enumerated.rb"
+require "#{here}/umlx.rb"
+require "#{here}/cardinality.rb"
+require "#{here}/uml2.rb"
+require "#{here}/dotDiagram.rb"
+require "#{here}/createAndAdd.rb"
+require "#{here}/autoImplement.rb"
+require "#{here}/owner.rb"
+require "#{here}/select.rb"
+require "#{here}/depencies.rb"
+require "#{here}/multipleInheritance.rb"
+require "#{here}/salvageErrors.rb"
+require "#{here}/check.rb"
+require "#{here}/versionSignature.rb"
+require "#{here}/helper.rb"
+require "#{here}/shortcut.rb"
+
+

data/lib/ontomde-uml2/autoImplement.rb

@@ -0,0 +1,196 @@
+# Provide auto-implement feature
+#
+# If a class implements an interface
+#
+
+module Mrdf_Model
+	def umlx_autoImplementProperty!
+		uml_Class_all.each {|c|
+			next unless c.kind_of?(Muml_Class)
+			c.umlx_autoImplementProperty!
+		}
+	end
+end
+module Muml_Class
+	rdf_safe_attr_reader_many :umlx_autoImplementComplete
+	def umlx_autoImplementProperty!
+		return if umlx_autoImplementComplete?
+		umlx_autoImplementComplete=RDF_TRUE
+
+		#Recurse begining at top of inheritance
+		uml_generalization.each { |gen|
+			gen.uml_general_one.umlx_autoImplementProperty!
+		}
+
+		#OK my ancesters have been processed
+		#Now if I don't implement an attribute, it is my duty.
+		impAttNames=umlx_ImplementedAttributesNames
+		umlx_ImplementedAttributes.each { |ia|
+			#log.debug { "umlx_autoImplementProperty #{ia} for #{self} #{ia.umlx_isAssociation?}" }
+			next if impAttNames.include?(ia.uml_name.to_s)
+			if(ia.umlx_isAttribute?)
+				att=self.umlx_createAndAddProperty(ia.uml_name.to_s)
+				att.uml_name=ia.uml_name
+				att.uml_type=ia.uml_type
+			else
+				#puts "create and add ..."
+				ms=ia.uml_association_one
+				ms1=ia
+				ms2=ia.umlx_otherEnd;
+				#puts "ms=#{ms}"
+				#puts "ms1=#{ms1} #{ms1.uml_type}"
+				#puts "ms2=#{ms2} #{ms2.uml_type}"
+				m,m1,m2=self.umlx_createAndAddAssociation(self.rdf_uri+ia.uml_name.to_s,ia.uml_type)
+				m1.uml_aggregation=ms1.uml_aggregation
+				m2.uml_aggregation=ms2.uml_aggregation
+				m1.uml_name=ms1.uml_name
+				m2.uml_name=ms2.uml_name
+
+				ms1.umlx_copyToAttributeProperty(m1)
+				ms2.umlx_copyToAttributeProperty(m2)
+
+				#puts "m=#{m}"
+				#puts "m1=#{m1} #{m1.uml_type}"
+				#puts "m2=#{m2} #{m2.uml_type}"
+			end
+		}
+	end
+	def umlx_ImplementedAttributesNames(ret=Set.new())
+		uml_generalization.each { |gen|
+			gen.uml_general_one.umlx_ImplementedAttributesNames(ret)
+		}
+		uml_ownedAttribute.each { |oa|
+			ret << oa.uml_name.to_s
+		}
+		return ret
+	end
+	def umlx_ImplementedAttributes(ret=Set.new())
+		uml_implementation.each { |g|
+			g.uml_supplier_one.umlx_ImplementedAttributes(ret)
+		}
+		return ret
+	end
+
+end
+module Muml_Interface
+	def umlx_ImplementedAttributes(ret)
+		uml_generalization.each{|gen|
+			gen.uml_general_one.umlx_ImplementedAttributes(ret)
+			}
+		uml_ownedAttribute.each { |oa|
+			ret << oa
+		}
+		return ret
+	end
+end
+
+
+#----------------
+#
+module Mrdf_Model
+	def umlx_autoImplementOperation!
+		uml_Class_all.each { |c|
+			next unless c.kind_of?(Muml_Class)
+			c.umlx_autoImplementOperation!
+		}
+	end
+end
+module Muml_Class
+	rdf_safe_attr_reader_many :umlx_autoImplementCompleteOperation
+	def umlx_autoImplementOperation!
+		return if umlx_autoImplementCompleteOperation?
+		return if uml_isAbstract?
+		umlx_autoImplementCompleteOperation=RDF_TRUE
+
+		#Recurse begining at top of inheritance
+		uml_generalization.each { |gen|
+			gen.uml_general_one.umlx_autoImplementOperation!
+		}
+
+		#OK my ancesters have been processed
+		#Now if I don't implement an operation, it is my duty.
+		impOper=umlx_ImplementedOperations
+		umlx_operationIShouldImplement.each { |sig,ia|
+			next if impOper.keys.include?(ia.umlx_signature)
+
+			c=umlx_createAndAddOperation(ia.rdf_uri+"_implem",ia.uml_name);
+			(ia.uml_ownedParameter+ia.uml_returnResult).each { |p|
+				cp=c.umlx_createAndAddParameter(p.rdf_uri+"_implem",p.uml_name_one)
+				p.umlx_copyToAttributeProperty(cp)
+				cp.uml_direction=p.uml_direction
+			}
+			# the new method is considered business Method if the original method is one
+			#NOTE: umlx_businessMethod? changed to umlx_businessMethod
+			c.umlx_businessMethod=ia.umlx_businessMethod
+			c.umlx_redefinesMethod=ia
+		}
+	end
+
+	def umlx_ImplementedOperations(ret=Hash.new())
+		uml_generalization.each { |gen|
+			gen.uml_general_one.umlx_ImplementedOperations(ret)
+		}
+		uml_ownedOperation.each { |oa|
+			next if oa.uml_isAbstract?
+			ret[oa.umlx_signature]=oa
+		}
+		return ret
+	end
+
+	def umlx_operationIShouldImplement(ret=Hash.new())
+
+		#SR16252
+		umlx_classifier_generalization_indirect.each { |i|
+			i.uml_ownedOperation.each { |oo|
+				next unless oo.uml_isAbstract?
+				ret[oo.umlx_signature]=oo
+				}
+		}
+		uml_implementation.each { |g|
+			g.uml_supplier_one.uml_ownedOperation.each { |oo|
+				ret[oo.umlx_signature]=oo
+			}
+			#interface implemented via an interface inheritance
+			g.uml_supplier_one.umlx_classifier_generalization_indirect.each { |i|
+				i.uml_ownedOperation.each { |oo|
+				ret[oo.umlx_signature]=oo
+			}}
+		}
+		return ret
+	end
+
+end
+module Muml_Interface
+	def umlx_ImplementedOperation(ret=Hash.new())
+		return ret
+	end
+end
+
+module Muml_Operation
+	#operation this operation redefines.
+	rdf_safe_attr_reader_many :umlx_redefinesMethod
+
+	def umlx_signature
+		#todo: take parameter into account
+		r="#{uml_name}("
+		sep=""
+		uml_ownedParameter.each { |p|
+			next if Cuml_ParameterDirectionKind::Return==p.uml_direction_one
+			r="#{r}#{sep}#{p.umlx_signature}"
+			sep=","
+		}
+		r="#{r})"
+		return r
+	end
+end
+
+module Muml_Parameter
+	# Returns parameter signature
+	# Examples: String[], int, ...
+	def umlx_signature
+		return self.uml_type
+	end
+end
+
+
+

data/lib/ontomde-uml2/cardinality.rb

@@ -0,0 +1,130 @@
+# Provides helpers to help map a UML model to a Relationnal database.
+module ::Muml_Parameter
+  # Is this property such an extremity of an SQL mapping ?
+  # (lowerValue<=1 && upperValue==1)
+  def umlx_oneSide?
+    #assoc = uml_association_one0
+    #return false if assoc.nil?
+    lowerValue = self.uml_lowerValue_one0
+    if !lowerValue.nil?
+      return false if lowerValue.umlx_to_i>1
+    end
+    upperValue = self.uml_upperValue_one0
+    if !upperValue.nil?
+      return false if upperValue.umlx_to_i!=1
+    end
+    return true
+  end
+end
+module ::Muml_Property
+
+  # Should this SQL mapping used for this association ?
+  def umlx_oneToOne?
+    return false if uml_association_one0.nil?
+    return false if !umlx_oneSide?
+    otherEnd = umlx_otherEnd
+    return false if otherEnd.nil?
+    return otherEnd.umlx_oneSide?
+  end
+
+  # Is this property such an extremity of an SQL mapping ?
+  # (lowerValue==1 && upperValue==1)
+  def umlx_exactlyOneSide?
+    assoc = uml_association_one0
+    return false if assoc.nil?
+    lowerValue = self.uml_lowerValue_one0
+    return false if lowerValue.nil?
+    return false if lowerValue.umlx_to_i != 1
+    upperValue = self.uml_upperValue_one0
+    if !upperValue.nil?
+      return false if upperValue.umlx_to_i!=1
+    end
+    return true
+  end
+
+  # Is this property such an extremity of an SQL mapping ?
+  # (lowerValue<=1 && upperValue==1)
+  def umlx_oneSide?
+    #assoc = uml_association_one
+    #return false if assoc.nil?
+    lowerValue = self.uml_lowerValue_one0
+    if !lowerValue.nil?
+      return false if lowerValue.umlx_to_i>1
+    end
+    upperValue = self.uml_upperValue_one0
+    if !upperValue.nil?
+      return false if upperValue.umlx_to_i!=1
+    end
+    return true
+  end
+
+  # Should this SQL mapping used for this association ?
+  def umlx_manyToMany?
+    assoc = uml_association_one0
+    return false if assoc.nil?
+    return false if !umlx_manySide?
+    otherEnd = umlx_otherEnd
+    return false if otherEnd.nil?
+    return otherEnd.umlx_manySide?
+  end
+
+  # Should this SQL mapping used for this association ?
+  def umlx_oneToMany?
+    assoc = uml_association_one0
+    return false if assoc.nil?
+    return false if !umlx_manySide?
+    otherEnd = umlx_otherEnd
+    return false if otherEnd.nil?
+    return otherEnd.umlx_oneSide?
+  end
+
+  # Should this SQL mapping used for this association ?
+  def umlx_manyToOne?
+    assoc = uml_association_one0
+    return false if assoc.nil?
+    otherEnd = umlx_otherEnd
+    return false if otherEnd.nil?
+    return otherEnd.umlx_oneToMany?
+  end
+
+  # Is this property such an extremity of an SQL mapping ?
+  def umlx_manySide?
+    #assoc = uml_association_one0
+    #return false if assoc.nil?
+    lowerValue = uml_lowerValue_one0
+    if !lowerValue.nil?
+      return true if lowerValue.umlx_to_i>1 || lowerValue.umlx_to_i==-1
+    end
+    upperValue = uml_upperValue_one0
+    if !upperValue.nil?
+      return true if upperValue.umlx_to_i>1 || upperValue.umlx_to_i==-1
+    end
+    return false
+  end
+  def umlx_unidirectionnel?
+    return umlx_otherEnd.nil?
+    #assoc = uml_association_one0
+    #return false if assoc.nil?
+    #return !assoc.uml_ownedEnd.empty?
+  end
+
+  # Is this property such an extremity of an SQL mapping ?
+  def umlx_masterEnd?
+    assoc = uml_association_one0
+    #return false if assoc.nil?
+    #return false if assoc.uml_memberEnd.empty? || assoc.uml_memberEnd.size==1
+    #return self==assoc.uml_memberEnd.first
+    oe=umlx_otherEnd
+    return true if oe.nil?
+    return true if umlx_isNavigable? && !oe.umlx_isNavigable?
+    return false if (!umlx_isNavigable?) && oe.umlx_isNavigable?
+
+
+    #Bidirectionnal association.
+    #First member is arbitrarily chosen as master.
+    return self==assoc.uml_memberEnd.first
+  end
+end
+
+
+