Różnice między wybraną wersją a wersją aktualną.
| Both sides previous revision Poprzednia wersja Nowa wersja | Poprzednia wersja | ||
|
pl:miw:miw08_gefardxtt_1 [2008/06/14 21:11] miw |
pl:miw:miw08_gefardxtt_1 [2019/06/27 15:50] (aktualna) |
||
|---|---|---|---|
| Linia 1: | Linia 1: | ||
| ====== Opis ====== | ====== Opis ====== | ||
| + | __**Projekt zakończony**__ | ||
| + | |||
| Maciej Dudek (4AR) <md5@o2.pl> | Maciej Dudek (4AR) <md5@o2.pl> | ||
| Linia 12: | Linia 14: | ||
| Feasibility study, a description how to create such editors with GEF, a prototype editor | Feasibility study, a description how to create such editors with GEF, a prototype editor | ||
| MS Thesis regarding GEF: Interfejs graficzny do budowy aplikacji komponentowych zapewniający weryfikację semantyczną, ARD+ Editor [[miw:ard requirements|requirements]] | MS Thesis regarding GEF: Interfejs graficzny do budowy aplikacji komponentowych zapewniający weryfikację semantyczną, ARD+ Editor [[miw:ard requirements|requirements]] | ||
| + | |||
| ====== Spotkania ====== | ====== Spotkania ====== | ||
| - | ===== 080304 ===== | + | [[pl:miw:miw08_gefardxtt_1:spotkania|Archiwum spotkań]] |
| - | Wykonano: | ||
| - | * Zapoznanie się z częścią pracy magisterską Macieja Kwietnia i Jana Rachwalika dotyczącą GEF. | ||
| - | * Zainstalowanie plug-inu GEF na platformie Eclipse | ||
| - | * Uruchomienie przykładowego edytora, stworzenie przykładowego grafu w tym edytorze, przeglądnięcie kodu przykładowego edytora. | ||
| - | * Zapoznanie się ze specyfikacją ARD+ zawartą w https://ai.ia.agh.edu.pl/wiki/hekate:bib:hekate_bibliography#gjn2008flairs-ardformal | ||
| - | * Zapoznanie się z opisem systemu VARDA zawartego w https://ai.ia.agh.edu.pl/wiki/hekate:bib:hekate_bibliography#gjn2008flairs-ardprolog | ||
| - | * Pobieżne przestudiowanie przykładu UServ zawartego w https://ai.ia.agh.edu.pl/wiki/hekate:bib:hekate_bibliography#gjn2008flairs-userv | ||
| - | Powstałe wątpliwości: | ||
| - | * Finalizacja. | ||
| - | * Zbiór wszystkich możliwych operacji wykonywanych przez użytkownika. | ||
| - | * Język opisu powstałego grafu: <del>RGML?</del> ATTML [[hekatedev:hekate_markup_language]] | ||
| - | * Przestrzeń nazw. | ||
| - | * Czy również implementacja drzewa TPH? Na ile bezpieczne w sytuacji cykli, split/merge, manual refactoring. | ||
| - | * Liczba korzeni w drzewie, czy istnieje coś takiego jak korzeń? | ||
| - | * XSD z opisem ARD+. | ||
| - | * Co jak na końcu "liścia" jest Conceptual Attribute? Jaki wpływ na system? | ||
| - | * Physical Attribute a XTT. | ||
| - | * Attribute a Property. W prologu deklarowane oba. | ||
| - | ===== 080318 ===== | ||
| - | * [[hekate:varda]] - uruchomiono i przeanalizowano funkcjonalność. | ||
| - | * Zapoznano się ze specyfikacją ATTML | ||
| - | * Zapoznano się z UServ case study | ||
| - | ===== 080415 ===== | ||
| - | Planowano: | ||
| - | * prototyp | ||
| - | Zrealizowano: | ||
| - | * Przeanalizowanie [[http://www.eclipse.org/articles/Article-GEF-diagram-editor/shape.html|Diagram Editor]] | ||
| - | * Przeanalizowanie [[http://www.eclipse.org/articles/Article-GEF-editor/gef-schema-editor.html|Schema Editor]] | ||
| - | * Rozpoznanie struktury framework'u GEF | ||
| - | * Zainstalowanie EMF oraz GMF | ||
| - | * Wykonanie tutorialu [[http://wiki.eclipse.org/index.php/GMF_Tutorial|mindmodel]] na podstawie [[http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.gmf/examples/org.eclipse.gmf.examples.mindmap/model/mindmap.xsd?root=Modeling_Project&view=markup&content-type=text%2Fvnd.viewcvs-markup&revision=HEAD|mindmodel.xsd]] | ||
| - | ===== 080429 ===== | ||
| - | Planowano: | ||
| - | * model xsd, translacja do ecore | ||
| - | * automatyczny edytor | ||
| - | Zrealizowano: | ||
| - | <code xml> | ||
| - | <?xml version="1.0" encoding="UTF-8"?> | ||
| - | <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> | ||
| - | <xs:element name="hml"> | ||
| - | <xs:complexType> | ||
| - | <xs:sequence> | ||
| - | <xs:element ref="type_set"/> | ||
| - | <xs:element ref="attribute_set"/> | ||
| - | <xs:element minOccurs="0" ref="property_set"/> | ||
| - | <xs:element minOccurs="0" ref="tph"/> | ||
| - | <xs:element minOccurs="0" ref="ard"/> | ||
| - | </xs:sequence> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <xs:element name="type_set"> | ||
| - | <xs:complexType> | ||
| - | <xs:sequence> | ||
| - | <xs:element minOccurs="0" maxOccurs="unbounded" ref="type"/> | ||
| - | </xs:sequence> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <xs:element name="type"> | ||
| - | <xs:complexType> | ||
| - | <xs:sequence> | ||
| - | <xs:element minOccurs="0" ref="desc"/> | ||
| - | <xs:element ref="domain"/> | ||
| - | </xs:sequence> | ||
| - | <xs:attribute name="id" use="required" type="xs:ID"/> | ||
| - | <xs:attribute name="name" use="required"/> | ||
| - | <xs:attribute name="base" use="required"> | ||
| - | <xs:simpleType> | ||
| - | <xs:restriction base="xs:token"> | ||
| - | <xs:enumeration value="integer"/> | ||
| - | <xs:enumeration value="numeric"/> | ||
| - | <xs:enumeration value="string"/> | ||
| - | <xs:enumeration value="bool"/> | ||
| - | <xs:enumeration value="date"/> | ||
| - | <xs:enumeration value="time"/> | ||
| - | <xs:enumeration value="timestamp"/> | ||
| - | </xs:restriction> | ||
| - | </xs:simpleType> | ||
| - | </xs:attribute> | ||
| - | <xs:attribute name="length"/> | ||
| - | <xs:attribute name="scale"/> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <!-- id should begin with 'tpe_...' --> | ||
| - | <xs:element name="desc" type="xs:string"/> | ||
| - | <xs:element name="domain"> | ||
| - | <xs:complexType> | ||
| - | <xs:choice minOccurs="0" maxOccurs="unbounded"> | ||
| - | <xs:element ref="range"/> | ||
| - | <xs:element ref="value"/> | ||
| - | </xs:choice> | ||
| - | <xs:attribute name="type"> | ||
| - | <xs:simpleType> | ||
| - | <xs:restriction base="xs:token"> | ||
| - | <xs:enumeration value="ordered"/> | ||
| - | <xs:enumeration value="unordered"/> | ||
| - | </xs:restriction> | ||
| - | </xs:simpleType> | ||
| - | </xs:attribute> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <xs:element name="range"> | ||
| - | <xs:complexType> | ||
| - | <xs:attribute name="from" use="required"/> | ||
| - | <xs:attribute name="to" use="required"/> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <xs:element name="value" type="xs:string"/> | ||
| - | <xs:element name="attribute_set"> | ||
| - | <xs:complexType> | ||
| - | <xs:sequence> | ||
| - | <xs:element minOccurs="0" maxOccurs="unbounded" ref="att"/> | ||
| - | <xs:element minOccurs="0" maxOccurs="unbounded" ref="group"/> | ||
| - | </xs:sequence> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <xs:element name="att"> | ||
| - | <xs:complexType> | ||
| - | <xs:sequence> | ||
| - | <xs:element minOccurs="0" ref="desc"/> | ||
| - | </xs:sequence> | ||
| - | <xs:attribute name="id" use="required" type="xs:ID"/> | ||
| - | <xs:attribute name="type" type="xs:IDREF"/> | ||
| - | <xs:attribute name="name" use="required"/> | ||
| - | <xs:attribute name="abbrev"/> | ||
| - | <xs:attribute name="value" use="required"> | ||
| - | <xs:simpleType> | ||
| - | <xs:restriction base="xs:token"> | ||
| - | <xs:enumeration value="single"/> | ||
| - | <xs:enumeration value="multiple"/> | ||
| - | </xs:restriction> | ||
| - | </xs:simpleType> | ||
| - | </xs:attribute> | ||
| - | <xs:attribute name="class" use="required"> | ||
| - | <xs:simpleType> | ||
| - | <xs:restriction base="xs:token"> | ||
| - | <xs:enumeration value="ro"/> | ||
| - | <xs:enumeration value="rw"/> | ||
| - | <xs:enumeration value="wo"/> | ||
| - | <xs:enumeration value="state"/> | ||
| - | </xs:restriction> | ||
| - | </xs:simpleType> | ||
| - | </xs:attribute> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <!-- id should begin with 'att_...' --> | ||
| - | <xs:element name="group"> | ||
| - | <xs:complexType> | ||
| - | <xs:sequence> | ||
| - | <xs:element minOccurs="0" ref="desc"/> | ||
| - | <xs:element maxOccurs="unbounded" ref="attref"/> | ||
| - | </xs:sequence> | ||
| - | <xs:attribute name="id" use="required" type="xs:ID"/> | ||
| - | <xs:attribute name="name" use="required"/> | ||
| - | <xs:attribute name="abbrev"/> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <!-- id should begin with 'grp_...' --> | ||
| - | <xs:element name="attref"> | ||
| - | <xs:complexType> | ||
| - | <xs:attribute name="ref" use="required" type="xs:IDREF"/> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <xs:element name="property_set"> | ||
| - | <xs:complexType> | ||
| - | <xs:sequence> | ||
| - | <xs:element minOccurs="0" maxOccurs="unbounded" ref="property"/> | ||
| - | </xs:sequence> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <xs:element name="property"> | ||
| - | <xs:complexType> | ||
| - | <xs:sequence> | ||
| - | <xs:element maxOccurs="unbounded" ref="attref"/> | ||
| - | </xs:sequence> | ||
| - | <xs:attribute name="id" use="required" type="xs:ID"/> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <!-- id should begin with 'prp_...' --> | ||
| - | <xs:element name="tph"> | ||
| - | <xs:complexType> | ||
| - | <xs:sequence> | ||
| - | <xs:element minOccurs="0" maxOccurs="unbounded" ref="trans"/> | ||
| - | </xs:sequence> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <xs:element name="trans"> | ||
| - | <xs:complexType> | ||
| - | <xs:attribute name="src" use="required" type="xs:IDREF"/> | ||
| - | <xs:attribute name="dst" use="required" type="xs:IDREF"/> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <xs:element name="ard"> | ||
| - | <xs:complexType> | ||
| - | <xs:sequence> | ||
| - | <xs:element minOccurs="0" maxOccurs="unbounded" ref="dep"/> | ||
| - | </xs:sequence> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | <xs:element name="dep"> | ||
| - | <xs:complexType> | ||
| - | <xs:attribute name="independent" use="required" type="xs:IDREF"/> | ||
| - | <xs:attribute name="dependent" use="required" type="xs:IDREF"/> | ||
| - | </xs:complexType> | ||
| - | </xs:element> | ||
| - | </xs:schema> | ||
| - | </code> | ||
| - | Dokument [[https://ai.ia.agh.edu.pl/wiki/_media/hekate:hml-test.xml?id=hekate%3Ahekate_markup_language&cache=cache|hml-test.xml]] poprawnie przechodzi [[http://www.xmlforasp.net/SchemaValidator.aspx|walidację]] przy użyciu powyższej definicji. Konwersji dokonano przy użyciu programu [[http://www.thaiopensource.com/relaxng/trang-manual.html|Trang]]. | ||
| - | ===== 080527 ===== | ||
| - | Edytor ARD powinien umożliwić tworzenie i edytowanie następujących elementów języka HML: | ||
| - | * Property | ||
| - | * Attribute | ||
| - | * połączenia między elementami Property | ||
| - | Okazuję się jednak, iż framework GMF nie jest na tyle elastyczny, aby stworzyć edytor o powyższych założeniach na podstawie modelu hml.xsd. Framework GMF bazuje na modelach Ecore. Model Ecore można utworzyć samemu lub też otrzymać na drodze konwersji ze schematu XSD Schema. Dokładny opis konwersji opisany jest w [[http://www.eclipse.org/modeling/emf/docs/overviews/XMLSchemaToEcoreMapping.pdf|niniejszym dokumencie]]. Jedynym sposobem wpływania na mapowanie są tzw EAnnotation (str. 13) umieszczane w samym pliku xsd. W ten sposób można np zamienić atrybut IDREF na element, zmianę korzenia dokumentu albo zignorowanie danego elementu. Jednak adnotacje nie dają możliwości reorganizacji struktury elementów, zawierania się. Konwerter oprócz pliku Ecore zwraca także plik mapowania .xsd2ecore. Można w nim podglądnąć szczegóły mapowania. Sam konwerter nie daje się jednak skonfigurować. Konwersja jest jednoznaczna. Mówią o tym następująca odpowiedź programisty frameworku GMF. | ||
| - | <code> | ||
| - | Matthew Rawlings wrote: | ||
| - | > While reverse engineering a XSD to eCore I generate a .xsd2ecore file. | ||
| - | > Having changed the mapping in the .xsd2ecore file how I can a re-run it from | ||
| - | > inside Eclipse? | ||
| - | > | ||
| - | # From: Ed Merks <merks@xxxxxxxxxx> | ||
| - | # Date: Sat, 19 Aug 2006 18:01:31 -0400 | ||
| - | Matthew, | + | ====== Projekt ====== |
| - | That file is produced only to reflect what the XSDEcoreBuilder does, i.e., the relationship between the | + | |
| - | input schema and the output Ecore. It's not used as input to drive anything else. Short of writing a | + | |
| - | derived XSDEcoreBuilder, the best way to affect the mapping is to use the annotations in described in: | + | |
| - | http://www.eclipse.org/emf/docs/overviews/XMLSchemaToEcoreMapping.pdf | + | |
| - | Support for quite a few new annotations was added in 2.2 and are not yet documented. | + | |
| - | You'll note that the XML Schema information is recorded as EAnnotations and this annotation syntax can | + | |
| - | be used directly on any Ecore model to affect not only how instances of that model are serialized to XML | + | |
| - | but also to influence how that model itself is mapped to XML Schema when exported... | + | |
| - | _____ | + | |
| - | Ed Merks is a co-lead of the top-level Eclipse Modeling project as well as the lead of the Eclipse Modeling Framework project. He has many years of in-depth experience in the design and implementation of languages, frameworks and application development environments. He holds a Ph.D. in computing science and is a co-author of the authoritative "Eclipse Modeling Framework, A Developer's Guide" (Addison-Wesley 2003). He works for IBM Rational at the Toronto Lab. | + | |
| - | </code> | + | |
| - | Problem stanowią połączenia między elementami w modelu hml.xsd. W przypadku Ecore, aby element A posiadał element B i mógł być z nim połączony bezpośrednim linkiem, to element B musi być bezpośrednim składnikiem elementu A. Na przykład: | ||
| - | <code xml> | ||
| - | <xs:element name="A"> | ||
| - | <xs:complexType> | ||
| - | <xs:sequence> | ||
| - | <xs:element minOccurs="0" maxOccurs="unbounded" ref="B"/> | ||
| - | <xs:element minOccurs="0" maxOccurs="unbounded" ref="C"/> | ||
| - | </xs:sequence> | ||
| - | </xs:complexType> | ||
| - | </code> | ||
| - | Jeśli natomiast jeśli B nie jest składnikiem elementu A, to niemożliwe jest utworzenie bezpośredniego połączenia między nimi. Gdybyśmy chcieli mieć możliwość tworzenia i edytowania Property jak i Attribute musielibyśmy wybrać korzeń pliku element Hml jako korzeń modelu Ecore. Tylko ten element "zawiera w sobie" elementy zarówno Property jak i Attribute. Ale wtedy aby stworzyć pojedynczy element Property z jednym Atrribute'm musielibyśmy wykonać następujący szereg czynności: | ||
| - | - dodać z Palety element PropertySet | ||
| - | - dodać z Palety element Property i połączyć go linkiem z PropertySet (relacja posiadania) | ||
| - | - dodać z Palety AttributeSet | ||
| - | - dodać z Palety Attribute i połączyć go linkiem z AttributeSet | ||
| - | - dodać z Palety Attref i połączyć go z Property oraz z Attribute | ||
| - | Jest to sprzeczne z oczekiwaniami stawianymi edytorowi graficznemu. | ||
| - | ---- | ||
| - | Próby utworzenia edytorów: | + | ===== Source ===== |
| - | * Nie udało się utworzyć za pomocą standardowych narzędzi GMF edytora na podstawie hml.xsd. | + | - {{:pl:miw:miw08_gefardxtt_1:ardeditor_project.zip|Ard Editor Project}} |
| - | * Dokonano próby utworzenia edytora wszystkich elementów (bez żadnej customizacji) za pomocą pluginu do GMF o nazwie [[http://dynamicgmf.sourceforge.net/|dynamic gmf]]. Ten plugin ma w założeniu dać możliwość wygenerowania edytora jedynie przez wybranie pliku xsd. Pojawiał się jednak błąd wewnętrzny programu "Null pointer exception". Takiego błędu nie było gdy użyłem pliku [[http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.gmf/examples/org.eclipse.gmf.examples.mindmap/model/mindmap.xsd?root=Modeling_Project&view=markup&content-type=text%2Fvnd.viewcvs-markup&revision=HEAD|mindmap.xsd]]. Sądzę, iż obecność elementów IDREF mogła się do tego przyczynić. | + | - {{:pl:miw:miw08_gefardxtt_1:ardeditor_diagram.zip|Ard Editor Diagram}} |
| + | - {{:pl:miw:miw08_gefardxtt_1:ardeditor_edit.zip|Ard Editor Edit}} | ||
| - | ---- | ||
| - | Wnioski: | + | ==== Sposób uruchomienia ==== |
| - | * Model hml.xsd nie pasuje do frameworku GMF. | + | - Zaimportuj Ard Editor Diagram oraz Ard Editor Edit jako projekt w Eclipse |
| - | * Uważam, że prościej i przejrzyściej byłoby stworzenie nowego modelu Ecore uwzględniając przy tym tylko te elementy, które są potrzebne w diagramie ARD. | + | - Otwórz oba projekty |
| - | * Automatycznie generowany plik xml nowego edytora można by przy pomocy utworzonego pliku XSLT przekształcić do pliku kompatybilnego z hml.xsd. | + | - Kliknij prawym przyciskiem na Ard Editor Diagram: |
| + | - Run As... -> Eclipse Application | ||
| + | - W nowo otwartym oknie Eclipse utwórz nowy projekt (wystarczy nawet pusty katalog) | ||
| + | - Kliknij //New// -> Examples -> My Diagram | ||
| + | - Otworzy się edytor. Użytkownik musi podać 2 nazwy plików: | ||
| + | - Plik edytora o rozszerzeniu .hml_diagram (odpowiada za rozmieszczenie na ekranie itp) | ||
| + | - Plik modelu o rozszerzeniu .hml (w formacie XML) | ||
| - | ===== 080610 ===== | ||
| - | Moja propozycja ard.xsd (wersja 1.0) | ||
| - | <code xml> | ||
| - | <?xml version="1.0" encoding="UTF-8" standalone="no"?> | ||
| - | <xsd:schema xmlns:hml="hml" xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="hml"> | ||
| - | <xsd:element name="Ard" type="hml:Ard"/> | ||
| - | <xsd:element name="Property" type="hml:Property"/> | ||
| - | <xsd:element name="Atrybut" type="hml:Atrybut"/> | ||
| - | <xsd:complexType name="Ard"> | ||
| - | <xsd:sequence> | ||
| - | <xsd:element maxOccurs="unbounded" minOccurs="0" name="property" type="hml:Property"/> | ||
| - | </xsd:sequence> | ||
| - | </xsd:complexType> | ||
| - | <xsd:complexType name="Property"> | ||
| - | <xsd:sequence> | ||
| - | <xsd:element maxOccurs="unbounded" minOccurs="0" name="atrybut" type="hml:Atrybut"/> | ||
| - | </xsd:sequence> | ||
| - | <xsd:attribute name="dependant"> | ||
| - | <xsd:simpleType> | ||
| - | <xsd:list itemType="xsd:anyURI"/> | ||
| - | </xsd:simpleType> | ||
| - | </xsd:attribute> | ||
| - | </xsd:complexType> | ||
| - | <xsd:complexType name="Atrybut"> | ||
| - | <xsd:attribute name="nazwa"/> | ||
| - | </xsd:complexType> | ||
| - | </xsd:schema> | ||
| - | </code> | ||
| - | W powyższym modelu brakuje TPH oraz całego XTT. W przypadku TPH jestem na etapie szukania możliwości automatycznej generacji części xml'a odpowiadającej za TPH. Jednak z powodu dużego zautomatyzowania GMF'a nie wiem na ile to będzie możliwe lub kiedy uda mi się to zrobić. | ||
| - | Screen z prostego edytora ard oraz odpowiadający mu plik xml. | ||
| - | Przykład 1: | ||
| - | Diagram Ard | ||
| - | {{http://hyper.ia.agh.edu.pl/~dudekm/zdj/przykladowy_edytor_1.jpg}} | ||
| - | Wygenerowany XML | ||
| - | <code xml> | ||
| - | <?xml version="1.0" encoding="UTF-8"?> | ||
| - | <hml:Ard xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" xmlns:hml="hml"> | ||
| - | <property dependant="//@property.1 //@property.2"> | ||
| - | <atrybut nazwa="jeden"/> | ||
| - | <atrybut nazwa="dwa"/> | ||
| - | </property> | ||
| - | <property> | ||
| - | <atrybut nazwa="trzy"/> | ||
| - | <atrybut nazwa="cztery"/> | ||
| - | </property> | ||
| - | <property> | ||
| - | <atrybut nazwa="pięć"/> | ||
| - | <atrybut nazwa="sześć"/> | ||
| - | </property> | ||
| - | </hml:Ard> | ||
| - | </code> | ||
| - | Sprawdzono zgodność pliku xml ze schematem xsd. | ||
| - | ---- | ||
| - | Perspektywy | ||
| - | * XSLT? | ||
| - | * Automatyczne TPH | ||
| - | * Menu kontekstowe na operacje Finalizacji i Splitu? | ||
| - | ====== Projekt ====== | + | ====== Sprawozdanie ====== |
| + | ===== 1. Przygotowanie ===== | ||
| - | + | ==== 1.1 Lektury ==== | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | + | ||
| - | ====== Sprawozdanie ====== | + | |
| - | + | ||
| - | === Przygotowanie === | + | |
| Swoją pracę rozpocząłem od lektury następujących prac: | Swoją pracę rozpocząłem od lektury następujących prac: | ||
| * {{:pl:miw:mgr-gef.pdf|GEF MS Thesis}} - Część pracy magisterskiej Macieja Kwietnia i Jana Rachwalika dotycząca GEF. | * {{:pl:miw:mgr-gef.pdf|GEF MS Thesis}} - Część pracy magisterskiej Macieja Kwietnia i Jana Rachwalika dotycząca GEF. | ||
| Linia 404: | Linia 96: | ||
| * Uruchomienie przykładowych edytorów: Logic Diagram, Flow Diagram, Shapes Diagram. | * Uruchomienie przykładowych edytorów: Logic Diagram, Flow Diagram, Shapes Diagram. | ||
| + | ==== 1.2 Wyjaśnienie skrótów ==== | ||
| Ponieważ skróty EMF, GEF i GMF są do siebie podobne, po krótce wyjaśnię między różnice między tymi frameworkami: | Ponieważ skróty EMF, GEF i GMF są do siebie podobne, po krótce wyjaśnię między różnice między tymi frameworkami: | ||
| * [[http://www.eclipsecon.com/modeling/emf/|EMF]] - służy do tworzenia modeli, logiki biznesowej. Modele zapisywane są w plikach ecore. Jest możliwa konwersja między modelami w ecore oraz modelem opisanym przy pomocy [[http://www.w3.org/XML/Schema|XSD (XML Schema)]]. | * [[http://www.eclipsecon.com/modeling/emf/|EMF]] - służy do tworzenia modeli, logiki biznesowej. Modele zapisywane są w plikach ecore. Jest możliwa konwersja między modelami w ecore oraz modelem opisanym przy pomocy [[http://www.w3.org/XML/Schema|XSD (XML Schema)]]. | ||
| Linia 411: | Linia 104: | ||
| Zatem tworząc aplikację z pewnością użycie wszystkich z nich będzie nieodzowne a ich działanie będzie się przenikało. | Zatem tworząc aplikację z pewnością użycie wszystkich z nich będzie nieodzowne a ich działanie będzie się przenikało. | ||
| - | === Próba stworzenia edytora === | ||
| + | |||
| + | ===== 2. Pierwsza próba stworzenia edytora ===== | ||
| + | |||
| + | ==== 2.1 Użycie definicji DTD i translacja do XSD ==== | ||
| Aby skorzystać z możliwości EMF importując model XSD, przekształcono definicję [[https://ai.ia.agh.edu.pl/wiki/_media/hekate:hml.dtd?id=hekate%3Ahekate_markup_language&cache=cache|HML.dtd]] z postaci DTD do postaci XSD. Efekt został przedstawiony poniżej: | Aby skorzystać z możliwości EMF importując model XSD, przekształcono definicję [[https://ai.ia.agh.edu.pl/wiki/_media/hekate:hml.dtd?id=hekate%3Ahekate_markup_language&cache=cache|HML.dtd]] z postaci DTD do postaci XSD. Efekt został przedstawiony poniżej: | ||
| <code xml> | <code xml> | ||
| Linia 587: | Linia 283: | ||
| Dokument [[https://ai.ia.agh.edu.pl/wiki/_media/hekate:hml-test.xml?id=hekate%3Ahekate_markup_language&cache=cache|hml-test.xml]] poprawnie przechodzi [[http://www.xmlforasp.net/SchemaValidator.aspx|walidację]] przy użyciu powyższej definicji. Konwersji dokonano przy użyciu programu [[http://www.thaiopensource.com/relaxng/trang-manual.html|Trang]]. | Dokument [[https://ai.ia.agh.edu.pl/wiki/_media/hekate:hml-test.xml?id=hekate%3Ahekate_markup_language&cache=cache|hml-test.xml]] poprawnie przechodzi [[http://www.xmlforasp.net/SchemaValidator.aspx|walidację]] przy użyciu powyższej definicji. Konwersji dokonano przy użyciu programu [[http://www.thaiopensource.com/relaxng/trang-manual.html|Trang]]. | ||
| - | == Problem z użyciem powyższej definicji == | + | === Problem z użyciem powyższej definicji === |
| Powyższa definicja, choć poprawna, okazała się niekompatybilna z frameworkiem GMF. Podstawowe problemy to: | Powyższa definicja, choć poprawna, okazała się niekompatybilna z frameworkiem GMF. Podstawowe problemy to: | ||
| Linia 596: | Linia 292: | ||
| Dokonano próby utworzenia edytora wszystkich elementów (bez żadnej customizacji) za pomocą pluginu do GMF o nazwie [[http://dynamicgmf.sourceforge.net/|Dynamic GMF]]. Ten plugin ma w założeniu dać możliwość wygenerowania edytora jedynie przez wybranie pliku xsd. Pojawiał się jednak błąd wewnętrzny programu "Null pointer exception". Takiego błędu nie było gdy użyłem pliku [[http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.gmf/examples/org.eclipse.gmf.examples.mindmap/model/mindmap.xsd?root=Modeling_Project&view=markup&content-type=text%2Fvnd.viewcvs-markup&revision=HEAD|mindmap.xsd]]. Sądzę, iż obecność elementów IDREF mogła się do tego przyczynić. | Dokonano próby utworzenia edytora wszystkich elementów (bez żadnej customizacji) za pomocą pluginu do GMF o nazwie [[http://dynamicgmf.sourceforge.net/|Dynamic GMF]]. Ten plugin ma w założeniu dać możliwość wygenerowania edytora jedynie przez wybranie pliku xsd. Pojawiał się jednak błąd wewnętrzny programu "Null pointer exception". Takiego błędu nie było gdy użyłem pliku [[http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.gmf/examples/org.eclipse.gmf.examples.mindmap/model/mindmap.xsd?root=Modeling_Project&view=markup&content-type=text%2Fvnd.viewcvs-markup&revision=HEAD|mindmap.xsd]]. Sądzę, iż obecność elementów IDREF mogła się do tego przyczynić. | ||
| - | == Metodologia tworzenia modeli == | + | ==== 2.2 Inna metodologia tworzenia modeli ==== |
| Dużo bardziej naturalnym, prostszym i efektywniejszym sposobem jest tworzenie modelu ecore pasującego do GMF. I tak import z XSD następuje do pliku ECORE, na którym później się operuje. | Dużo bardziej naturalnym, prostszym i efektywniejszym sposobem jest tworzenie modelu ecore pasującego do GMF. I tak import z XSD następuje do pliku ECORE, na którym później się operuje. | ||
| Linia 602: | Linia 298: | ||
| Kolejnym krokiem mogłoby być eksportowanie tego modelu do XSD. W razie potrzeby można by dokonywać konwersji między róznymi definicjami XSD za pomocą szablonów XSLT. | Kolejnym krokiem mogłoby być eksportowanie tego modelu do XSD. W razie potrzeby można by dokonywać konwersji między róznymi definicjami XSD za pomocą szablonów XSLT. | ||
| - | === Własny model === | + | ==== 2.3 Własny model ==== |
| Stworzyłem zatem edytor opierając się o własny model. Model powstał przy pomocy EMF, który następnie wyeksportowałem do formatu XSD. | Stworzyłem zatem edytor opierając się o własny model. Model powstał przy pomocy EMF, który następnie wyeksportowałem do formatu XSD. | ||
| Linia 638: | Linia 334: | ||
| Poniżej zamieszczono screen z edytora oraz odpowiadający mu plik xml. | Poniżej zamieszczono screen z edytora oraz odpowiadający mu plik xml. | ||
| - | Przykład 1: | + | ==== 2.4 Edytor oparty na własnym modelu ==== |
| Diagram Ard | Diagram Ard | ||
| Linia 671: | Linia 368: | ||
| - | === Perspektywy === | + | |
| + | ===== 3. Perspektywy projektu ===== | ||
| Jest to wstępny zarys edytora. Docelowy edytor miałby posiadać bogatą funkcjonalność. Dalsze elementy, które należałoby zaimplementować to: | Jest to wstępny zarys edytora. Docelowy edytor miałby posiadać bogatą funkcjonalność. Dalsze elementy, które należałoby zaimplementować to: | ||
| Linia 682: | Linia 380: | ||
| - | === Wnioski === | + | |
| + | ===== 4. Wnioski ===== | ||
| * Model warto tworzyć od podstaw w EMF. | * Model warto tworzyć od podstaw w EMF. | ||
| Linia 690: | Linia 389: | ||
| - | === Linki === | + | |
| + | |||
| + | ===== 5. Linki ===== | ||
| Poniżej zamieszczam wartościowe linki związane z moim projektem: | Poniżej zamieszczam wartościowe linki związane z moim projektem: | ||
| - | == Instalacja == | + | === Instalacja GMF === |
| * [[http://wiki.eclipse.org/index.php/GMF_Tutorial|Instalacja + tutorial]] | * [[http://wiki.eclipse.org/index.php/GMF_Tutorial|Instalacja + tutorial]] | ||
| * [[http://www.brovig.org/blog/2007/05/17/installing-gmf-on-eclipse-33-m7-europa/|installing-gmf-on-eclipse-33-m7-europa]] | * [[http://www.brovig.org/blog/2007/05/17/installing-gmf-on-eclipse-33-m7-europa/|installing-gmf-on-eclipse-33-m7-europa]] | ||
| - | == Nauka == | + | === Nauka === |
| * [[http://www.eclipse.org/articles/Article-Introducing-GMF/article.html|Introducing GMF]] | * [[http://www.eclipse.org/articles/Article-Introducing-GMF/article.html|Introducing GMF]] | ||
| * [[http://www.eclipse.org/articles/Article-GEF-editor/gef-schema-editor.html|GEF Schema Editor]] | * [[http://www.eclipse.org/articles/Article-GEF-editor/gef-schema-editor.html|GEF Schema Editor]] | ||
| Linia 705: | Linia 406: | ||
| * [[http://wiki.eclipse.org/index.php/GMF_Tutorial_BPMN|Tutorial]] - edytora [[http://pl.wikipedia.org/wiki/BPMN|BPMN]]. Krok po kroku. | * [[http://wiki.eclipse.org/index.php/GMF_Tutorial_BPMN|Tutorial]] - edytora [[http://pl.wikipedia.org/wiki/BPMN|BPMN]]. Krok po kroku. | ||
| - | == Troubleshooting == | + | === Troubleshooting === |
| Problemy, które napotkałem oraz linki pomocne w ich rozwiązaniu: | Problemy, które napotkałem oraz linki pomocne w ich rozwiązaniu: | ||
| * [[http://dev.eclipse.org/newslists/news.eclipse.technology.gmf/msg03925.html|Containment Feature]] | * [[http://dev.eclipse.org/newslists/news.eclipse.technology.gmf/msg03925.html|Containment Feature]] | ||
| - | == Support == | + | === Support === |
| * [[http://www.nabble.com/Eclipse-GEF---Dev-f2208.html|GEF mailing list archive]] | * [[http://www.nabble.com/Eclipse-GEF---Dev-f2208.html|GEF mailing list archive]] | ||
| * [[http://eclipseforum.org.pl/|Polskie forum eclipse]] - zostało uruchomione pod koniec 2007 roku. | * [[http://eclipseforum.org.pl/|Polskie forum eclipse]] - zostało uruchomione pod koniec 2007 roku. | ||
| - | == Inne == | + | === Inne === |
| * [[http://wiki.eclipse.org/index.php/GMF_Documentation|GMF_Documentation]] - zawiera wiele dalszych linków. | * [[http://wiki.eclipse.org/index.php/GMF_Documentation|GMF_Documentation]] - zawiera wiele dalszych linków. | ||
| * [[http://help.eclipse.org/help33/index.jsp|Eclipse 3.3 API]] - zawiera również GMF, GEF. | * [[http://help.eclipse.org/help33/index.jsp|Eclipse 3.3 API]] - zawiera również GMF, GEF. | ||
| * [[http://eclipse-po-polsku.blogspot.com/|Eclipse po polsku]] | * [[http://eclipse-po-polsku.blogspot.com/|Eclipse po polsku]] | ||
| * [[http://www.redbooks.ibm.com/redbooks/pdfs/sg246302.pdf|IBM red book]], [[http://publib-b.boulder.ibm.com/Redbooks.nsf/RedpieceAbstracts/sg246302.html|code]] - bardzo przydatne, wiele elementów dobrze opisanych. | * [[http://www.redbooks.ibm.com/redbooks/pdfs/sg246302.pdf|IBM red book]], [[http://publib-b.boulder.ibm.com/Redbooks.nsf/RedpieceAbstracts/sg246302.html|code]] - bardzo przydatne, wiele elementów dobrze opisanych. | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| ====== Materiały ====== | ====== Materiały ====== | ||
| Linia 724: | Linia 433: | ||
| {{:pl:miw:mgr-gef.pdf|GEF MS Thesis}} | {{:pl:miw:mgr-gef.pdf|GEF MS Thesis}} | ||
| - | Patrz też na [[hekate:eclipse|osobne hasło]] | + | Patrz też na [[hekatedev:eclipse|osobne hasło]] |
