Różnice

Różnice między wybraną wersją a wersją aktualną.

Odnośnik do tego porównania

Both sides previous revision Poprzednia wersja
pl:miw:miw08_gefardxtt_2 [2008/09/18 12:15]
gjn koniec
pl:miw:miw08_gefardxtt_2 [2019/06/27 15:50] (aktualna)
Linia 1: Linia 1:
 +====== Opis ======
 +__**Projekt zakończony**__
 +
 +Szybura Bartek <​b.szybura@interia.pl>​
 +
 +GEFARDXTT\\ \\
 + GEF and Eclipse based editor for ARD and XTT. Evaluation, feasibility,​ prototype. XTTv2 Editor requirements \\
 +
 +input:\\ \\
 +Eclipse: EMF, GEF resources (GEF, http://​www.eclipse.org/​articles/​Article-GEF-editor/​gef-schema-editor.html),​ \\
 +ARD: Towards Formalization of ARD+ Conceptual Design and Refinement Method and An ARD+ Design and Visualization Toolchain Prototype in Prolog and UServ Case Study, Conceptual Design with ARD+ Method.\\ \\
 +output:\\ \\
 +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 requirements \\
 +
 +====== Projekt ======
 +[[pl:​miw:​miw08_gefardxtt_2:​spotkania]]
 +
 +====== Sprawozdanie ======
 +
 +Celem projektu było zapoznanie się z dostępnymi Frameworkami pozwalającymi na budowę edytora XTT. Na początku przeanalizowałem framewrok GEF (Graphical Editing Framework). Niestety w przypadku GEF zbudowanie odpowiedniego edytora było bardzo pracochłonne. Praca w GEF-ie zaczynała się o stworzenia odpowiednich tablic, połączeń,​ etykiet tablic lub połączeń. Korzystając tylko z GEF-a wszystkie właściwości takie jak miejsce narysowania strzałki, tablicy trzeba ręcznie ustawiać.\\ ​  
 +Dlatego też poszukałem inne rozwiązania,​ które są wykorzystywane w budowie edytorów. Znalazłem następny framework EMF (Eclipse Modeling Framework). Dzięki temu rozwiązaniu udało mi się stworzyć opis XTT w XML Schema.\\
 +
 +
 +{{:​pl:​miw:​xtt-xsd.xml|Poniżej przedstawiam opis XTT w .xsd:}}\\
 +
 +<code xml>
 +<?xml version="​1.0"​ encoding="​UTF-8"?>​
 +<​xsd:​schema targetNamespace="​http://​student.agh.edu.pl/​~szybura/​xtt"​
 +    xmlns:​ecore="​http://​www.eclipse.org/​emf/​2002/​Ecore"​
 +    xmlns:​xtt="​http://​student.agh.edu.pl/​~szybura/​xtt"​
 +    xmlns:​xsd="​http://​www.w3.org/​2001/​XMLSchema">​
 +
 + <​xsd:​complexType name="​Graph">​
 + <​xsd:​sequence>​
 + <​xsd:​element name="​TitleGraph"​ type="​xsd:​string"​ />
 + <​xsd:​element name="​DescribeGraph"​ type="​xsd:​string"​ />
 + <​xsd:​element maxOccurs="​unbounded"​ minOccurs="​1"​
 + name="​TableGarph"​ type="​xtt:​Tabel"​ />
 + </​xsd:​sequence>​
 + </​xsd:​complexType>​
 + <​xsd:​complexType name="​Tabel">​
 + <​xsd:​sequence>​
 + <​xsd:​element name="​TitleTabel"​ type="​xsd:​string"​ />
 + <​xsd:​element name="​DescribeTabel"​ type="​xsd:​string"​ />
 + <​xsd:​element maxOccurs="​unbounded"​ minOccurs="​1"​
 + name="​DataTabel"​ type="​xtt:​Row"​ />
 + </​xsd:​sequence>​
 + </​xsd:​complexType>​
 + <​xsd:​complexType name="​InsideRow">​
 + <​xsd:​sequence>​
 + <​xsd:​element name="​DescribeInsideRow"​ type="​xsd:​string"​ />
 + <​xsd:​element name="​DataInsideRow"​ type="​xsd:​string"​ />
 + </​xsd:​sequence>​
 + </​xsd:​complexType>​
 + <​xsd:​complexType name="​Row">​
 + <​xsd:​sequence>​
 + <​xsd:​element name="​TitleRow"​ type="​xsd:​string"​ />
 + <​xsd:​element name="​IdRow"​ type="​xsd:​int"​ />
 + <​xsd:​element maxOccurs="​unbounded"​ minOccurs="​1"​
 + name="​DataRow"​ type="​xtt:​InsideRow"​ />
 + <​xsd:​element maxOccurs="​1"​ minOccurs="​0"​ name="​ConectorRow"​
 +          type="​xsd:​anyURI"​ ecore:​reference="​xtt:​Row"​ ecore:​opposite="​IdRow"/>​
 + </​xsd:​sequence>​
 + </​xsd:​complexType>​
 +</​xsd:​schema>​
 +
 +</​code>​
 +
 +Dzięki danemu plikowi mogłem wygenerować pliki {{:​pl:​miw:​xtt-ecore.xml|xtt.ecore}} oraz {{:​pl:​miw:​xtt-genmodel.xml|xtt.genmodel}},​ które potrzebne mi były do stworzenia edytora XTT.\\
 +{{:​pl:​miw:​eclipse1.jpg|:​pl:​miw:​eclipse1.jpg}}\\
 +Rysunek 1.\\
 +
 +
 +{{:​pl:​miw:​miw08_gefardxtt_2_eclipse2.jpg|:​pl:​miw:​miw08_gefardxtt_2_eclipse2.jpg}}\\
 +Rysunek 2.\\
 +
 +Dzięki stworzonemu edytorowi XTT mogę wygenerować opis grafów XTT, np. (opis skrócony):
 +
 +<code xml>
 +<?xml version="​1.0"​ encoding="​UTF-8"?>​
 +<​xtt:​Graph xmlns:​xtt="​http://​student.agh.edu.pl/​~szybura/​xtt">​
 +  <​TitleGraph>​Termostat</​TitleGraph>​
 +  <​DescribeGraph>​Example. Termostat</​DescribeGraph>​
 +  <​TableGarph>​
 +    <​TitleTabel>​ms</​TitleTabel>​
 +    <​DescribeTabel>​Table id: 1 - ms</​DescribeTabel>​
 +    <​DataTabel>​
 +      <​TitleRow>​Describe row</​TitleRow>​
 +      <​DataRow>​
 +        <​DescribeInsideRow>​(?​) month</​DescribeInsideRow>​
 +        <​DataInsideRow>​(?​) month</​DataInsideRow>​
 +      </​DataRow>​
 +      <​DataRow>​
 +        <​DescribeInsideRow>​(?​) season</​DescribeInsideRow>​
 +        <​DataInsideRow>​(?​) season</​DataInsideRow>​
 +      </​DataRow>​
 +    </​DataTabel>​
 +  </​TableGarph>​
 +</​xtt:​Graph>​
 +</​code>​
 +
 +W każdym pliku mogę wygenerować odpowiednie tabele, w których mogę stworzyć wiersze, które są akurat potrzebne do przedstawienia danego modelu. Odpowiednie wiersze mogę ze sobą łączyć:​\\
 +
 +<code xml>
 +<​ConectorRow>#//​@tableGarph.0/​@dataTabel.0</​ConectorRow>​
 +</​code>​
 +
 +
 +
 +
 +====== Tutorial - Jak uruchomić edytor? ======
 +
 +W tutorialu wykorzystuję oprogramowanie:​
 +
 +[[ftp://​ftp.man.szczecin.pl/​pub/​eclipse/​technology/​epp/​downloads/​release/​ganymede/​R/​eclipse-jee-ganymede-win32.zip|Eclipse Platform Version: 3.4.0]] ​
 +
 +  * Uruchom eclipse.exe.
 +  * Następnie naciśnij File -> New -> Other.
 +  * Pojawi się okno, pokazane na Rysunku 3. Wybierz Eclipse Modeling Framework -> EMF Project.
 +
 +{{:​pl:​miw:​eclipse3.jpg|:​pl:​miw:​eclipse3.jpg}}\\
 +Rysunek 3.\\
 +  * Następnie wpisz naciśnij NEXT oraz wpisz w kolejnym oknie nazwę projektu i naciśnij NEXT (Rysunek 4).
 +
 +{{:​pl:​miw:​eclipse4.jpg|:​pl:​miw:​eclipse4.jpg}}\\
 +Rysunek 4.\\
 +  * Wybierz następnie Ecore model (modele importowane).
 +
 +{{:​pl:​miw:​eclipse5.jpg|:​pl:​miw:​eclipse5.jpg}}\\
 +Rysunek 5.\\
 +  * W kolejnym kroku trzeba wczytać istniejący model stworzony z pliku xsd. Należy pobrać plik {{:​pl:​miw:​xtt.xml|xtt.xml}} następnie zmienić rozszerzenie na xtt.ecore.
 +  * Wybieramy model xtt.ecore, automatycznie plik jest ładowany (Rysunek 6). Wciskamy FINISH.
 +
 +{{:​pl:​miw:​eclipse6.jpg|:​pl:​miw:​eclipse6.jpg}}\\
 +Rysunek 6.\\
 +  * Następnie gdy pojawi nam się okno z edytorem xtt.genmodel. Naciskamy prawym przyciskiem myszy i na xtt i wybieram GENERATE ALL (Rysunek 7).
 +
 +{{:​pl:​miw:​eclipse7.jpg|:​pl:​miw:​eclipse7.jpg}}\\
 +Rysunek 7.\\
 +  * Generują się odpowiednie pliki, które potrzebne są do stworzenia edytora XTT (Rysunek 8).
 +
 +{{:​pl:​miw:​eclipse8.jpg|:​pl:​miw:​eclipse8.jpg}}\\
 +Rysunek 8.\\
 +  * Gdy plik są wygenerowane,​ uruchamiamy myEditorXTT jako Eclipse Application (Rysunek 9).
 +
 +{{:​pl:​miw:​eclipse9.jpg|:​pl:​miw:​eclipse9.jpg}}\\
 +Rysunek 9.\\
 +  * Gdy zrobimy wszystkie kroki podane wyżej powinno się wyświetlić drugie okno Eclipse. W którym musi utworzyć nowy projekt (File -> New -> General -> Project), musimy wpisać nazwę projektu i nacisnąć FINISH.
 +  * W kolejnym kroku musimy stworzyć nowy model xtt (File -> New -> Other -> Example EMF Model Creatione Wizards -> Xtt Model, Rysunek 10).
 +
 +{{:​pl:​miw:​eclipse10.jpg|:​pl:​miw:​eclipse10.jpg}}\\
 +Rysunek 10.\\
 +  * Następnie należy wpisać nazwę pliku np. My.xtt. Wcisnąć NEXT. W polu Model Object wybieramy Graph (Rysunek 11). I wciskamy FINISH.
 +
 +{{:​pl:​miw:​eclipse11.jpg|:​pl:​miw:​eclipse11.jpg}}\\
 +Rysunek 11.\\
 +  * Gdy wszystko zostanie wykonane zgodnie z instrukcją możemy zacząć tworzyć nasz model xtt. Dodając poszczególne tabele, a w środku tabel wiersz, w wierszach zaś dodajemy poszczególne komórki (przyładowy wygląd tabel xtt). Oczywiście każdy graf, tabela, wiersz oraz wnętrze wiersza ma swoje właściwości,​ które możemy zmieniać w oknie Properties.
 +
 +{{:​pl:​miw:​eclipse12.jpg|:​pl:​miw:​eclipse12.jpg}}\\
 +Rysunek 12.\\
 +
 +  * Każdy wiersz można połączyć z innym istniejącym wierszem. Ustawia się to w oknie Properties -> Connector Row.
 + 
 + 
 +
 +
 +
 +
 +
 +====== Materiały ======
 +FIXME
 +  * http://​www.ibm.com/​developerworks/​
 +  * http://​www.ibm.com/​developerworks/​opensource/​library/​os-gef/​
 +  * http://​www.ibm.com/​developerworks/​opensource/​library/​os-eclipse-gef11/​
 +  * http://​www.apohllo.pl/​texts/​eclipse.pdf
 +  * http://​www.eclipse.org/​gef/​overview.html
 +  * http://​www.eclipse.org/​articles/​Article-GEF-Draw2d/​GEF-Draw2d.html
 +  * Praca magisterska "​Interfejs graficzny do budowy aplikacji kompnentowych zapewniający weryfikację semantyczną"​. Autorzy: Maciej Kwiecień, Jan Rachwalik
 +  * http://​www.eclipse.org/​articles/​Article-Introducing-GMF/​article.html
 +  * http://​www.eclipse.org/​articles/​Article-Using%20EMF/​using-emf.html
 +  * http://​dev.eclipse.org/​viewcvs/​index.cgi/​org.eclipse.emf/​org.eclipse.emf/​doc/​org.eclipse.emf.doc/​references/​overview/​EMF.html?​root=Modeling_Project&​view=co
 +  * http://​www.w3schools.com/​Schema/​default.asp
 +
  
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0