https://pascalabc.net/wiki/api.php?action=feedcontributions&feedformat=atom&user=AlexHitВики проекта PascalABC.NET - Вклад [ru]2026-04-18T12:32:49ZВкладMediaWiki 1.39.1https://pascalabc.net/wiki/index.php?title=%D0%A0%D0%BE%D0%BB%D0%B8_%D0%B2_%D0%BF%D1%80%D0%BE%D0%B5%D0%BA%D1%82%D0%B5_%D0%B8_%D0%B7%D0%B0%D0%B4%D0%B0%D0%BD%D0%B8%D1%8F_%D1%80%D0%B0%D0%B7%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%87%D0%B8%D0%BA%D0%B0%D0%BC_2011&diff=2251Роли в проекте и задания разработчикам 20112011-12-21T18:44:11Z<p>AlexHit: </p>
<hr />
<div>Темченко А. А. Соловьев Л. В.<br />
<br />
1) Передаточная функция в общем виде (композиция передаточных функций/оператор умножения для передаточных функций/).<br />
<br />
2) Функция создания множеств Gen, Kill по квадрике или базовому блоку.<br />
<br />
<br />
Венцко А.З. <br />
<br />
1) парсер языка Pascal и C (при участии А.Науменко)<br />
<br />
1.1)Помогал группе (А.Науменко, К.Пак) в реализации обработчиков узлов грамматики, совместно тестировали работу, отлавливали ошибки (как в грамматике, так и в обработчиках)<br />
<br />
2) множества IN[B], OUT[B], gen B, kill B, конструктор классов для достижимых определений (совместно - разработка интерфейса)<br />
<br />
3) Создание главного проекта, контроль версий, сборка, объединение всех подпроектов в единый проект, <br />
проверка работоспособности отдельных модулей. <br />
<br />
<br />
Владыкин К.В. <br />
<br />
1) алгоритм удаления мертвых переменных<br />
<br />
<br />
Баштанова Д.С., Найденов С.Г.<br />
<br />
1) первичное описание классов синтаксического дерева<br />
<br />
2) Инфраструктура visitor'ов<br />
<br />
3) абстрактный класс, передаточная функция, класс для достигающих определений<br />
<br />
<br />
<br />
<br />
Науменко А.Е., Пак К.Р.<br />
<br />
1) Обработчики грамматики <br />
<br />
2) Разбиение на блоки<br />
<br />
3) реализация итерационного алгоритма<br />
<br />
<br />
Пронин А., Бувайло О.<br />
<br />
1) Visitor для генерации трехадресного кода. Структура для трехадрессного кода.<br />
<br />
2) Квадрики - http://file.qip.ru/file/lbbaZEsQ/GenerateQuadruple.html</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%A0%D0%BE%D0%BB%D0%B8_%D0%B2_%D0%BF%D1%80%D0%BE%D0%B5%D0%BA%D1%82%D0%B5_%D0%B8_%D0%B7%D0%B0%D0%B4%D0%B0%D0%BD%D0%B8%D1%8F_%D1%80%D0%B0%D0%B7%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%87%D0%B8%D0%BA%D0%B0%D0%BC_2011&diff=2241Роли в проекте и задания разработчикам 20112011-12-01T11:03:25Z<p>AlexHit: </p>
<hr />
<div>Темченко А. А. Соловьев Л. В.<br />
<br />
1) парсер С<br />
<br />
2) Передаточная функция в общем виде (композиция передаточных функций/оператор умножения для передаточных функций/).<br />
<br />
3) Функция создания множеств Gen, Kill по квадрике или базовому блоку.<br />
<br />
<br />
Венцко А.З. <br />
<br />
1) парсер языка Pascal<br />
<br />
2) множества IN[B], OUT[B], gen B, kill B, конструктор классов для достижимых определений (совместно) <br />
<br />
<br />
Владыкин К.В. <br />
<br />
1) алгоритм удаления мертвых переменных<br />
<br />
<br />
Баштанова Д.С., Найденов С.Г.<br />
<br />
1) первичное описание классов синтаксического дерева<br />
<br />
2) Инфраструктура visitor'ов<br />
<br />
3) абстрактный класс, передаточная функция, класс для достигающих определений<br />
<br />
<br />
<br />
<br />
Науменко А.Е., Пак К.Р.<br />
<br />
1) Обработчики грамматики <br />
<br />
2) Разбиение на блоки<br />
<br />
3) реализация итерационного алгоритма<br />
<br />
<br />
Пронин А., Бувайло О.<br />
<br />
1) Visitor для генерации трехадресного кода. Структура для трехадрессного кода.<br />
<br />
2) Квадрики - http://file.qip.ru/file/lbbaZEsQ/GenerateQuadruple.html</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%98%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81_%D0%B0%D0%BD%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0_%D0%BF%D0%BE%D1%82%D0%BE%D0%BA%D0%B0_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85&diff=2240Интерфейс анализа потока данных2011-12-01T10:23:02Z<p>AlexHit: </p>
<hr />
<div>--[[Участник:AlexHit|Венцко Александр Зиновьевич]] 05:50, 29 ноября 2011 (UTC)<br />
<pre><br />
using System;<br />
using System.Collections.Generic;<br />
using System.Linq;<br />
using System.Text;<br />
using GenerateQuadruple;<br />
using System.Collections;<br />
namespace BaseBlocks<br />
{<br />
//структура описывает набор множеств для каждого блока<br />
struct DFA<br />
{<br />
public List<String> IN;<br />
public List<String> OUT;<br />
public List<String> GEN;<br />
public List<String> KILL;<br />
}<br />
//интерфейс анализа потока данных, по умолчанию все поля открытые, содержит словарь квадрик и список структур для базовых блоков<br />
interface IDataFlowAnalysis<br />
{<br />
//в комментариях представленна идея<br />
//public List<DFA> BaseBlockDFA;<br />
//public List<String> operatorNames;<br />
//Данный метод инициализирует словарь квадрик и список множеств, дл каждого базового блока<br />
void DataFlowAnalysisInit(List<BaseBlock> baseBlocks);<br />
}<br />
}<br />
</pre><br />
<br />
<br />
[http://webfile.ru/5698571 Класс в электронном виде]</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%98%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81_%D0%B0%D0%BD%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0_%D0%BF%D0%BE%D1%82%D0%BE%D0%BA%D0%B0_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85&diff=2239Интерфейс анализа потока данных2011-11-29T05:54:06Z<p>AlexHit: </p>
<hr />
<div>--[[Участник:AlexHit|Венцко Александр Зиновьевич]] 05:50, 29 ноября 2011 (UTC)<br />
<pre><br />
using System;<br />
using System.Collections.Generic;<br />
using System.Linq;<br />
using System.Text;<br />
using GenerateQuadruple;<br />
using System.Collections;<br />
namespace BaseBlocks<br />
{<br />
//структура описывает набор множеств для каждого блока<br />
struct DFA<br />
{<br />
public List<String> IN;<br />
public List<String> OUT;<br />
public List<String> GEN;<br />
public List<String> KILL;<br />
}<br />
//интерфейс анализа потока данных, по умолчанию все поля открытые, содержит словарь квадрик и список структур для базовых блоков<br />
interface IDataFlowAnalysis<br />
{<br />
List<DFA> BaseBlockDFA;<br />
Dictionary<string, Quadruple> QuadrDictionary;<br />
//Данный метод инициализирует словарь квадрик и список множеств, дл каждого базового блока<br />
void DataFlowAnalysisInit(List<BaseBlock> baseBlocks);<br />
}<br />
}<br />
</pre><br />
<br />
<br />
[http://webfile.ru/5698571 Класс в электронном виде]</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%98%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81_%D0%B0%D0%BD%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0_%D0%BF%D0%BE%D1%82%D0%BE%D0%BA%D0%B0_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85&diff=2238Интерфейс анализа потока данных2011-11-29T05:51:41Z<p>AlexHit: </p>
<hr />
<div>--[[Участник:AlexHit|Венцко Александр Зиновьевич]] 05:50, 29 ноября 2011 (UTC)<br />
<pre><br />
using System;<br />
using System.Collections.Generic;<br />
using System.Linq;<br />
using System.Text;<br />
using GenerateQuadruple;<br />
using System.Collections;<br />
namespace BaseBlocks<br />
{<br />
//структура описывает набор множеств для каждого блока<br />
struct DFA<br />
{<br />
public List<String> IN;<br />
public List<String> OUT;<br />
public List<String> GEN;<br />
public List<String> KILL;<br />
}<br />
//интерфейс анализа потока данных, по умолчанию все поля открытые, содержит словарь квадрик и список структур для базовых блоков<br />
interface IDataFlowAnalysis<br />
{<br />
List<DFA> BaseBlockDFA;<br />
Dictionary<string, Quadruple> QuadrDictionary;<br />
//Данный метод инициализирует словарь квадрик и список множеств, дл каждого базового блока<br />
void DataFlowAnalysisInit(List<BaseBlock> baseBlocks);<br />
}<br />
}<br />
</pre></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%98%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81_%D0%B0%D0%BD%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0_%D0%BF%D0%BE%D1%82%D0%BE%D0%BA%D0%B0_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85&diff=2237Интерфейс анализа потока данных2011-11-29T05:50:49Z<p>AlexHit: </p>
<hr />
<div>--[[Участник:AlexHit|Венцко Александр Зиновьевич]] 05:50, 29 ноября 2011 (UTC)<br />
<pre><br />
using System;<br />
using System.Collections.Generic;<br />
using System.Linq;<br />
using System.Text;<br />
using GenerateQuadruple;<br />
using System.Collections;<br />
namespace BaseBlocks<br />
{<br />
//структура описывает набор множеств для каждого блока<br />
struct DFA<br />
{<br />
public List<String> IN;<br />
public List<String> OUT;<br />
public List<String> GEN;<br />
public List<String> KILL;<br />
}<br />
//интерфейс андиза потока данных, по умолчанию все поля открытые, содержит словарь квадрик и список структур для базовых блоков<br />
interface IDataFlowAnalysis<br />
{<br />
List<DFA> BaseBlockDFA;<br />
Dictionary<string, Quadruple> QuadrDictionary;<br />
//Данный метод инициализирует словарь квадрик и список множеств, дл каждого базового блока<br />
void DataFlowAnalysisInit(List<BaseBlock> baseBlocks);<br />
}<br />
<br />
}<br />
</pre></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%98%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81_%D0%B0%D0%BD%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0_%D0%BF%D0%BE%D1%82%D0%BE%D0%BA%D0%B0_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85&diff=2236Интерфейс анализа потока данных2011-11-29T05:49:08Z<p>AlexHit: Новая: using System; using System.Collections.Generic; using System.Linq; using System.Text; using GenerateQuadruple; using System.Collections; namespace BaseBlocks { //структура ...</p>
<hr />
<div>using System;<br />
using System.Collections.Generic;<br />
using System.Linq;<br />
using System.Text;<br />
using GenerateQuadruple;<br />
using System.Collections;<br />
namespace BaseBlocks<br />
{<br />
//структура описывает набор множеств для каждого блока<br />
struct DFA<br />
{<br />
public List<String> IN;<br />
public List<String> OUT;<br />
public List<String> GEN;<br />
public List<String> KILL;<br />
}<br />
//интерфейс андиза потока данных, по умолчанию все поля открытые, содержит словарь квадрик и список структур для базовых блоков<br />
interface IDataFlowAnalysis<br />
{<br />
List<DFA> BaseBlockDFA;<br />
Dictionary<string, Quadruple> QuadrDictionary;<br />
//Данный метод инициализирует словарь квадрик и список множеств, дл каждого базового блока<br />
void DataFlowAnalysisInit(List<BaseBlock> baseBlocks);<br />
}<br />
<br />
}</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9C%D0%9F%D0%9E%D0%9A_2011&diff=2235МПОК 20112011-11-29T05:48:37Z<p>AlexHit: </p>
<hr />
<div>[[Роли в проекте и задания разработчикам 2011]]<br\><br />
[[Грамматика языка Pascal]]<br><br />
[[Грамматика языка С]]<br><br />
[[Диаграмма классов синтаксического дерева]]<br><br />
[[Грамматика Pascal + Код]]<br><br />
[[Грамматика C + Код]]<br><br />
[[Собранный проект с последними изменениями - всем скачать]]<br><br />
[http://files.mail.ru/KA9Z5M Изменения с пары 27.10.2011]<br><br />
[http://webfile.ru/5697190 Компилятор, который строит синтаксическое дерево программы (язык Pascal) 10.11.2011]<br><br />
[http://dl.dropbox.com/u/18182279/MSS/dvel.7z Удаление мертвых переменных внутри базового блока 17.11.2011]<br><br />
[[Разбиение списка квадрик на базовые блоки]]<br><br />
[[Интерфейс анализа потока данных]]<br></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9C%D0%9F%D0%9E%D0%9A_2011&diff=2234МПОК 20112011-11-28T11:32:09Z<p>AlexHit: </p>
<hr />
<div>[[Роли в проекте и задания разработчикам 2011]]<br\><br />
[[Грамматика языка Pascal]]<br><br />
[[Грамматика языка С]]<br><br />
[[Диаграмма классов синтаксического дерева]]<br><br />
[[Грамматика Pascal + Код]]<br><br />
[[Грамматика C + Код]]<br><br />
[[Собранный проект с последними изменениями - всем скачать]]<br><br />
[http://files.mail.ru/KA9Z5M Изменения с пары 27.10.2011]<br><br />
[http://webfile.ru/5697190 Компилятор, который строит синтаксическое дерево программы (язык Pascal) 10.11.2011]<br><br />
[http://dl.dropbox.com/u/18182279/MSS/dvel.7z Удаление мертвых переменных внутри базового блока 17.11.2011]<br><br />
[[Разбиение списка квадрик на базовые блоки]]<br></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9C%D0%9F%D0%9E%D0%9A_2011&diff=2225МПОК 20112011-11-10T16:05:22Z<p>AlexHit: </p>
<hr />
<div>[[Роли в проекте и задания разработчикам 2011]]<br><br />
[[Грамматика языка Pascal]]<br><br />
[[Грамматика языка С]]<br><br />
[[Диаграмма классов синтаксического дерева]]<br><br />
[[Грамматика Pascal + Код]]<br><br />
[[Грамматика C + Код]]<br><br />
[[Собранный проект с последними изменениями - всем скачать]]<br><br />
[[Разбиение списка квадрик на базовые блоки]]<br><br />
[http://files.mail.ru/KA9Z5M Изменения с пары 27.10.2011]<br><br />
[http://webfile.ru/5659541 Компилятор, который строит синтаксическое дерево программы (язык Pascal) 10.11.2011]</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9C%D0%9F%D0%9E%D0%9A_2011&diff=2224МПОК 20112011-11-10T16:05:00Z<p>AlexHit: </p>
<hr />
<div>[[Роли в проекте и задания разработчикам 2011]]<br><br />
[[Грамматика языка Pascal]]<br><br />
[[Грамматика языка С]]<br><br />
[[Диаграмма классов синтаксического дерева]]<br><br />
[[Грамматика Pascal + Код]]<br><br />
[[Грамматика C + Код]]<br><br />
[[Собранный проект с последними изменениями - всем скачать]]<br><br />
[[Разбиение списка квадрик на базовые блоки]]<br><br />
[http://files.mail.ru/KA9Z5M Изменения с пары 27.10.2011]<br />
[http://webfile.ru/5659541 Компилятор, который строит синтаксическое дерево программы (язык Pascal) 10.11.2011]</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%A1%D0%BE%D0%B1%D1%80%D0%B0%D0%BD%D0%BD%D1%8B%D0%B9_%D0%BF%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%D1%81_%D0%BF%D0%BE%D1%81%D0%BB%D0%B5%D0%B4%D0%BD%D0%B8%D0%BC%D0%B8_%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D1%8F%D0%BC%D0%B8_-_%D0%B2%D1%81%D0%B5%D0%BC_%D1%81%D0%BA%D0%B0%D1%87%D0%B0%D1%82%D1%8C&diff=2211Собранный проект с последними изменениями - всем скачать2011-10-15T08:05:24Z<p>AlexHit: </p>
<hr />
<div>[http://files.mail.ru/31NYVJ Ссылка на собранный проект yf на паре 13.10.2011] <br />
Дальше все модификации надо вносить в него...<br />
<br />
Пароль: IT<br />
[http://webfile.ru/5605435 исправленная версия того, что было сделано на паре 15.10.2011]</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%A1%D0%BE%D0%B1%D1%80%D0%B0%D0%BD%D0%BD%D1%8B%D0%B9_%D0%BF%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%D1%81_%D0%BF%D0%BE%D1%81%D0%BB%D0%B5%D0%B4%D0%BD%D0%B8%D0%BC%D0%B8_%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D0%B5%D0%BD%D0%B8%D1%8F%D0%BC%D0%B8_-_%D0%B2%D1%81%D0%B5%D0%BC_%D1%81%D0%BA%D0%B0%D1%87%D0%B0%D1%82%D1%8C&diff=2209Собранный проект с последними изменениями - всем скачать2011-10-13T06:38:07Z<p>AlexHit: Новая: [http://webfile.ru/5600793 Ссылка на собранный проект] Дальше все модификации надо вносить в него... Пароль: IT</p>
<hr />
<div>[http://webfile.ru/5600793 Ссылка на собранный проект] <br />
Дальше все модификации надо вносить в него...<br />
<br />
Пароль: IT</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9C%D0%9F%D0%9E%D0%9A_2011&diff=2208МПОК 20112011-10-13T06:35:45Z<p>AlexHit: </p>
<hr />
<div>[[Роли в проекте и задания разработчикам 2011]]<br><br />
[[Грамматика языка Pascal]]<br><br />
[[Грамматика языка С]]<br><br />
[[Диаграмма классов синтаксического дерева]]<br><br />
[[Первичное описание классов синтаксического дерева]]<br><br />
[[Грамматика Pascal + Код]]<br><br />
[[Грамматика C + Код]]<br><br />
[[Собранный проект с последними изменениями - всем скачать]]<br></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2203Грамматика языка Pascal2011-10-05T18:40:01Z<p>AlexHit: </p>
<hr />
<div>--[[Участник:AlexHit|Венцко Александр Зиновьевич]] 21:11, 21 сентября 2011 (UTC)<br />
<br />
'''Грамматика'''<br />
<pre><br />
%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
<br />
%output=Yacc.cs <br />
<br />
%union { <br />
public int iVal; <br />
public double dVal; <br />
public string sVal; <br />
public ExprNode eVal;<br />
public TreeNode tVal;<br />
public BlockNode lVal;<br />
public List<string> lsVal;<br />
public GreatType dtVal;<br />
}<br />
<br />
%using System.IO<br />
%using Syntax_node_tree<br />
%namespace LexScanner<br />
<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kDO kVAR kWRITE kWRITELN<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON POINT <br />
%token PLUS MINUS MULT DIVIDE <br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
%token <iVal> INTNUM <br />
%token <dVal> REALNUM <br />
%token <sVal> STRINGLITERAL<br />
%token <sVal> ID<br />
%token <dtVal> kREAL kINTEGER kBOOLEAN<br />
<br />
%type <eVal> expr<br />
%type <tVal> operator elsepart<br />
%type <lVal> listoperator progr <br />
%type <lsVal> ident <br />
%type <dtVal> ktype kSimpleType<br />
<br />
%left LT GT LE GE EQ NE<br />
%left MINUS PLUS OR<br />
%left MULT DIVIDE AND DIV MOD<br />
%left UMINUS NOT<br />
<br />
%%<br />
<br />
progr :<br />
{<br />
$$ = new Program(@$);<br />
}<br />
| defss kBEGIN listoperator kEND <br />
{<br />
$$ = $1;<br />
foreach (Operator oper in $3.list)<br />
$$.list.Add(oper);<br />
}<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD TEXT!!!");<br />
break;<br />
} <br />
;<br />
<br />
defss : defs <br />
{<br />
$$ = new BlockOperator(@$);<br />
$$.list.Add($1);<br />
}<br />
|defss defs {<br />
$1.list.Add($2);<br />
$$ = $1;<br />
}<br />
|<br />
;<br />
<br />
defs : kVAR ident COLON ktype SEMICOLUMN <br />
{<br />
TipType type;<br />
if ($4 == "int")<br />
type = TipType.IntType;<br />
else if ($4 == "double")<br />
type = TipType.DoubleType;<br />
else if ($4 == "bool")<br />
type = TipType.BoolType;<br />
else<br />
{<br />
// Error: unknown type<br />
}<br />
$$ = new VarDef(@$, $2, type);<br />
}<br />
; <br />
<br />
ident: ID <br />
{<br />
if (GlobalStructures.isNameExists($1))<br />
{<br />
// Error: this name is already used<br />
}<br />
Ident Id = new Ident($1, @1);<br />
listVars.Add(Id);<br />
$$ = new List<Ident>();<br />
$$.Add(Id);<br />
} <br />
|ident COLUMN ID <br />
{<br />
if (GlobalStructures.isNameExists($3))<br />
{<br />
// Error: this name is already used<br />
}<br />
Ident Id = new Ident($3, @3);<br />
listVars.Add(Id);<br />
$1.Add(Id);<br />
$$ = $1;<br />
}<br />
;<br />
<br />
listoperator : operator <br />
{<br />
$$ = new BlockOperator(@$);<br />
$$.list.Add($1);<br />
}<br />
| listoperator SEMICOLUMN operator {<br />
$1.list.Add($2);<br />
$$ = $1;<br />
}<br />
;<br />
<br />
ktype : kSimpleType<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD GREATE TYPE");<br />
break;<br />
}<br />
;<br />
<br />
kSimpleType : kREAL <br />
{<br />
$$ = "double";<br />
} <br />
| kINTEGER <br />
{<br />
$$ = "int";<br />
}<br />
| kBOOLEAN<br />
{<br />
$$ = "bool" <br />
}<br />
;<br />
<br />
operator: {}<br />
| ID ASSIGN expr <br />
{<br />
if (!GlobalStructures.isNameExists($1))<br />
{<br />
// Error: Undeclarated identifier<br />
}<br />
Ident Id = GlobalStructures.getIdentByName($1);<br />
$$ = new Assign(Id, $3, @3);<br />
}<br />
| kWHILE expr kDO operator <br />
{<br />
if ($2.getType()!=TypType.Boolean)<br />
{<br />
// Error: Óñëîâèå äîëæíî èìåòü ëîãè÷åñêèé òèï<br />
}<br />
$$ = new While($2, $4, @$);<br />
}<br />
| kIF expr kTHEN operator elsepart <br />
{<br />
if ($2.getType()!=TypType.Boolean)<br />
{<br />
// Error: Óñëîâèå äîëæíî èìåòü ëîãè÷åñêèé òèï<br />
}<br />
$$=new If($2,$4,$5,@$);<br />
}<br />
| kBEGIN listoperator kEND <br />
{<br />
$$ = $2;<br />
}<br />
| kWRITE LPAREN expr RPAREN <br />
{<br />
System.Console.Write($3);<br />
}<br />
| kWRITELN LPAREN expr RPAREN<br />
{<br />
System.Console.WriteLine($3);<br />
}<br />
;<br />
<br />
elsepart: <br />
{<br />
$$ = null;<br />
}<br />
| kELSE operator {<br />
$$ = $2;<br />
}<br />
;<br />
<br />
expr: INTNUM <br />
{<br />
int i = int.Parse($1);<br />
$$ = new IntConst(i, @1);<br />
}<br />
| REALNUM <br />
{<br />
double d = double.Parse($1);<br />
$$ = new DoubleConst(d, @1);<br />
}<br />
| STRINGLITERAL <br />
{<br />
// Íåò ó íàñ òàêèõ!!!<br />
}<br />
| ID <br />
{<br />
if (!GlobalStructures.isNameExists($1))<br />
{<br />
// Error: Undeclarated identifier<br />
}<br />
$$ = new Ident($1, @1);<br />
}<br />
| expr PLUS expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.Plus, @$);<br />
}<br />
| expr MINUS expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.Minus, @$);<br />
}<br />
| expr MULT expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.Mult, @$);<br />
}<br />
| expr DIVIDE expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.Divide, @$);<br />
}<br />
| expr DIV expr <br />
{<br />
// Íå ïîääåðæèâàåòñÿ!<br />
}<br />
| expr MOD expr <br />
{<br />
// Íå ïîääåðæèâàåòñÿ!<br />
}<br />
| expr AND expr <br />
{<br />
if ($1.getType() != TipType.BoolType || $2.getType() != TipType.BoolType)<br />
{<br />
// Error: only for bool types<br />
}<br />
$$ = new BinExpression($1, $3, Op.And, @$);<br />
}<br />
| expr OR expr <br />
{<br />
if ($1.getType() != TipType.BoolType || $2.getType() != TipType.BoolType)<br />
{<br />
// Error: only for bool types<br />
}<br />
$$ = new BinExpression($1, $3, Op.Or, @$);<br />
}<br />
| expr LT expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.Less, @$);<br />
}<br />
| expr GT expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.More, @$);<br />
}<br />
| expr LE expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.LessEqual, @$);<br />
}<br />
| expr GE expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.MoreEqual, @$); <br />
}<br />
| expr EQ expr<br />
{<br />
$$ = new BinExpression($1, $3, Op.Equal, @$); <br />
}<br />
| expr NE expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.NotEqual, @$); <br />
}<br />
| NOT expr <br />
{<br />
if ($2.getType() != TipType.BoolType)<br />
{<br />
// Error: type is wrong.<br />
}<br />
$$ = new UnarExpression($2, Op.Not, @2);<br />
}<br />
| MINUS expr %prec UMINUS <br />
{<br />
if ($2.getType() != TipType.IntType && $2.getType() != TipType.DoubleType)<br />
{<br />
// Error: type is wrong.<br />
}<br />
$$ = new UnarExpression($2, Op.Minus, @2);<br />
} <br />
| LPAREN expr RPAREN <br />
{<br />
$$ = $2;<br />
}<br />
;<br />
<br />
%%<br />
</pre><br />
<br />
'''Сканер'''<br />
<br />
<pre><br />
%namespace LexScanner<br />
%using Syntax_node_tree;<br />
<br />
Alpha [a-zA-Z_]<br />
INTNUM [0-9]+<br />
REALNUM {INTNUM}\.{INTNUM}<br />
ID [a-zA-Z_][a-zA-Z0-9_]* <br />
<br />
%x COMMENT<br />
%x COMMENT1<br />
<br />
%%<br />
<br />
"{" { BEGIN(COMMENT);}<br />
<COMMENT> "}" { BEGIN(INITIAL);}<br />
<COMMENT> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
"(*" { BEGIN(COMMENT1);}<br />
<COMMENT1> "*)" { BEGIN(INITIAL);}<br />
<COMMENT1> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
<br />
":=" { return (int)Tokens.ASSIGN; }<br />
";" { return (int)Tokens.SEMICOLUMN; }<br />
"-" { return (int)Tokens.MINUS; }<br />
"+" { return (int)Tokens.PLUS; }<br />
"*" { return (int)Tokens.MULT; }<br />
"/" { return (int)Tokens.DIVIDE; }<br />
"<" { return (int)Tokens.LT; }<br />
">" { return (int)Tokens.GT; }<br />
"<=" { return (int)Tokens.LE; }<br />
">=" { return (int)Tokens.GE; }<br />
"=" { return (int)Tokens.EQ; }<br />
"<>" { return (int)Tokens.NE; }<br />
"(" { return (int)Tokens.LPAREN; }<br />
")" { return (int)Tokens.RPAREN; }<br />
"," { return (int)Tokens.COLUMN; }<br />
":" { return (int)Tokens.COLON; }<br />
"." { return (int)Tokens.POINT; }<br />
<br />
<br />
\'[^']*\' {<br />
yylval.sVal = yytext.Substring(1,yytext.Length-2);<br />
return (int)Tokens.STRINGLITERAL;<br />
}<br />
<br />
{ID} { <br />
int res = ScannerHelper.GetIDToken(yytext);<br />
string s = yytext.ToLower();<br />
if (s=="integer")<br />
yylval.dtVal.DType=DataType.INTTYPE;<br />
if (s == "real")<br />
yylval.dtVal.DType =DataType.DOUBLETYPE;<br />
if (res == (int)Tokens.ID)<br />
yylval.sVal = yytext;<br />
return res;<br />
}<br />
<br />
{INTNUM} { <br />
yylval.iVal = int.Parse(yytext); <br />
return (int)Tokens.INTNUM; <br />
}<br />
<br />
{REALNUM} { <br />
yylval.dVal = double.Parse(yytext,new System.Globalization.CultureInfo("en-US")); <br />
return (int)Tokens.REALNUM; <br />
}<br />
<br />
%{<br />
yylloc = new LexLocation(tokLin, tokCol, tokELin, tokECol);<br />
%}<br />
<br />
%%<br />
<br />
class ScannerHelper <br />
{<br />
private static Dictionary<string,int> keywords;<br />
<br />
static ScannerHelper() <br />
{<br />
keywords = new Dictionary<string,int>();<br />
keywords.Add("var",(int)Tokens.kVAR);<br />
keywords.Add("real",(int)Tokens.kREAL);<br />
keywords.Add("integer",(int)Tokens.kINTEGER);<br />
keywords.Add("boolean",(int)Tokens.kBOOLEAN);<br />
keywords.Add("begin",(int)Tokens.kBEGIN);<br />
keywords.Add("end",(int)Tokens.kEND);<br />
keywords.Add("if",(int)Tokens.kIF);<br />
keywords.Add("then",(int)Tokens.kTHEN);<br />
keywords.Add("else",(int)Tokens.kELSE);<br />
keywords.Add("do",(int)Tokens.kDO);<br />
keywords.Add("while",(int)Tokens.kWHILE);<br />
keywords.Add("write",(int)Tokens.kWRITE);<br />
keywords.Add("writeln",(int)Tokens.kWRITELN);<br />
keywords.Add("div",(int)Tokens.DIV);<br />
keywords.Add("mod",(int)Tokens.MOD);<br />
keywords.Add("and",(int)Tokens.AND);<br />
keywords.Add("or",(int)Tokens.OR);<br />
keywords.Add("not",(int)Tokens.NOT); <br />
}<br />
public static int GetIDToken(string s)<br />
{<br />
s = s.ToLower();<br />
if (keywords.ContainsKey(s))<br />
{ <br />
return keywords[s];<br />
} <br />
else<br />
return (int)Tokens.ID;<br />
}<br />
<br />
}<br />
</pre></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2202Грамматика языка Pascal2011-10-05T18:37:54Z<p>AlexHit: </p>
<hr />
<div>--[[Участник:AlexHit|Венцко Александр Зиновьевич]] 21:11, 21 сентября 2011 (UTC)<br />
<br />
'''Грамматика'''<br />
<pre><br />
%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
<br />
%output=Yacc.cs <br />
<br />
%union { <br />
public int iVal; <br />
public double dVal; <br />
public string sVal; <br />
public ExprNode eVal;<br />
public TreeNode tVal;<br />
public BlockNode lVal;<br />
public List<string> lsVal;<br />
public GreatType dtVal;<br />
}<br />
<br />
%using System.IO<br />
%using Syntax_node_tree<br />
%namespace LexScanner<br />
<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kDO kVAR kWRITE kWRITELN<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON POINT <br />
%token PLUS MINUS MULT DIVIDE <br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
%token <iVal> INTNUM <br />
%token <dVal> REALNUM <br />
%token <sVal> STRINGLITERAL<br />
%token <sVal> ID<br />
%token <dtVal> kREAL kINTEGER kBOOLEAN<br />
<br />
%type <eVal> expr<br />
%type <tVal> operator elsepart<br />
%type <lVal> listoperator progr <br />
%type <lsVal> ident <br />
%type <dtVal> ktype kSimpleType<br />
<br />
%left LT GT LE GE EQ NE<br />
%left MINUS PLUS OR<br />
%left MULT DIVIDE AND DIV MOD<br />
%left UMINUS NOT<br />
<br />
%%<br />
<br />
progr :<br />
{<br />
$$ = new Program(@$);<br />
}<br />
| defss kBEGIN listoperator kEND <br />
{<br />
$$ = $1;<br />
foreach (Operator oper in $3.list)<br />
$$.list.Add(oper);<br />
}<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD TEXT!!!");<br />
break;<br />
} <br />
;<br />
<br />
defss : defs <br />
{<br />
$$ = new BlockOperator(@$);<br />
$$.list.Add($1);<br />
}<br />
|defss defs {<br />
$1.list.Add($2);<br />
$$ = $1;<br />
}<br />
|<br />
;<br />
<br />
defs : kVAR ident COLON ktype SEMICOLUMN <br />
{<br />
TipType type;<br />
if ($4 == "int")<br />
type = TipType.IntType;<br />
else if ($4 == "double")<br />
type = TipType.DoubleType;<br />
else if ($4 == "bool")<br />
type = TipType.BoolType;<br />
else<br />
{<br />
// Error: unknown type<br />
}<br />
$$ = new VarDef(@$, $2, type);<br />
}<br />
; <br />
<br />
ident: ID <br />
{<br />
if (GlobalStructures.isNameExists($1))<br />
{<br />
// Error: this name is already used<br />
}<br />
Ident Id = new Ident($1, @1);<br />
listVars.Add(Id);<br />
$$ = new List<Ident>();<br />
$$.Add(Id);<br />
} <br />
|ident COLUMN ID <br />
{<br />
if (GlobalStructures.isNameExists($3))<br />
{<br />
// Error: this name is already used<br />
}<br />
Ident Id = new Ident($3, @3);<br />
listVars.Add(Id);<br />
$1.Add(Id);<br />
$$ = $1;<br />
}<br />
;<br />
<br />
listoperator : operator <br />
{<br />
$$ = new BlockOperator(@$);<br />
$$.list.Add($1);<br />
}<br />
| listoperator SEMICOLUMN operator {<br />
$1.list.Add($2);<br />
$$ = $1;<br />
}<br />
;<br />
<br />
ktype : kSimpleType<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD GREATE TYPE");<br />
break;<br />
}<br />
;<br />
<br />
kSimpleType : kREAL <br />
{<br />
$$ = "double";<br />
} <br />
| kINTEGER <br />
{<br />
$$ = "int";<br />
}<br />
| kBOOLEAN<br />
{<br />
$$ = "bool" <br />
}<br />
;<br />
<br />
operator: {}<br />
| ID ASSIGN expr <br />
{<br />
if (!GlobalStructures.isNameExists($1))<br />
{<br />
// Error: Undeclarated identifier<br />
}<br />
Ident Id = GlobalStructures.getIdentByName($1);<br />
$$ = new Assign(Id, $3, @3);<br />
}<br />
| kWHILE expr kDO operator <br />
{<br />
if ($2.getType()!=TypType.Boolean)<br />
{<br />
// Error: Óñëîâèå äîëæíî èìåòü ëîãè÷åñêèé òèï<br />
}<br />
$$ = new While($2, $4, @$);<br />
}<br />
| kIF expr kTHEN operator elsepart <br />
{<br />
if ($2.getType()!=TypType.Boolean)<br />
{<br />
// Error: Óñëîâèå äîëæíî èìåòü ëîãè÷åñêèé òèï<br />
}<br />
$$=new If($2,$4,$5,@$);<br />
}<br />
| kBEGIN listoperator kEND <br />
{<br />
$$ = $2;<br />
}<br />
| kWRITE LPAREN expr RPAREN <br />
{<br />
System.Console.Write($3);<br />
}<br />
| kWRITELN LPAREN expr RPAREN<br />
{<br />
System.Console.WriteLine($3);<br />
}<br />
;<br />
<br />
elsepart: <br />
{<br />
$$ = null;<br />
}<br />
| kELSE operator {<br />
$$ = $2;<br />
}<br />
;<br />
<br />
expr: INTNUM <br />
{<br />
int i = int.Parse($1);<br />
$$ = new IntConst(i, @1);<br />
}<br />
| REALNUM <br />
{<br />
double d = double.Parse($1);<br />
$$ = new DoubleConst(d, @1);<br />
}<br />
| STRINGLITERAL <br />
{<br />
// Íåò ó íàñ òàêèõ!!!<br />
}<br />
| ID <br />
{<br />
if (!GlobalStructures.isNameExists($1))<br />
{<br />
// Error: Undeclarated identifier<br />
}<br />
$$ = new Ident($1, @1);<br />
}<br />
| expr PLUS expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.Plus, @$);<br />
}<br />
| expr MINUS expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.Minus, @$);<br />
}<br />
| expr MULT expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.Mult, @$);<br />
}<br />
| expr DIVIDE expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.Divide, @$);<br />
}<br />
| expr DIV expr <br />
{<br />
// Íå ïîääåðæèâàåòñÿ!<br />
}<br />
| expr MOD expr <br />
{<br />
// Íå ïîääåðæèâàåòñÿ!<br />
}<br />
| expr AND expr <br />
{<br />
if ($1.getType() != TipType.BoolType || $2.getType() != TipType.BoolType)<br />
{<br />
// Error: only for bool types<br />
}<br />
$$ = new BinExpression($1, $3, Op.And, @$);<br />
}<br />
| expr OR expr <br />
{<br />
if ($1.getType() != TipType.BoolType || $2.getType() != TipType.BoolType)<br />
{<br />
// Error: only for bool types<br />
}<br />
$$ = new BinExpression($1, $3, Op.Or, @$);<br />
}<br />
| expr LT expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.Less, @$);<br />
}<br />
| expr GT expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.More, @$);<br />
}<br />
| expr LE expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.LessEqual, @$);<br />
}<br />
| expr GE expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.MoreEqual, @$); <br />
}<br />
| expr EQ expr<br />
{<br />
$$ = new BinExpression($1, $3, Op.Equal, @$); <br />
}<br />
| expr NE expr <br />
{<br />
$$ = new BinExpression($1, $3, Op.NotEqual, @$); <br />
}<br />
| NOT expr <br />
{<br />
if ($2.getType() != TipType.BoolType)<br />
{<br />
// Error: type is wrong.<br />
}<br />
$$ = new UnarExpression($2, Op.Not, @2);<br />
}<br />
| MINUS expr %prec UMINUS <br />
{<br />
if ($2.getType() != TipType.IntType && $2.getType() != TipType.DoubleType)<br />
{<br />
// Error: type is wrong.<br />
}<br />
$$ = new UnarExpression($2, Op.Minus, @2);<br />
} <br />
| LPAREN expr RPAREN <br />
{<br />
$$ = $2;<br />
}<br />
;<br />
<br />
%%<br />
</pre><br />
<br />
'''Сканер'''<br />
<br />
<pre><br />
%namespace LexScanner<br />
%using Syntax_node_tree;<br />
<br />
Alpha [a-zA-Z_]<br />
INTNUM [0-9]+<br />
REALNUM {INTNUM}\.{INTNUM}<br />
ID [a-zA-Z_][a-zA-Z0-9_]* <br />
<br />
%x COMMENT<br />
%x COMMENT1<br />
<br />
%%<br />
<br />
"{" { BEGIN(COMMENT);}<br />
<COMMENT> "}" { BEGIN(INITIAL);}<br />
<COMMENT> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
"(*" { BEGIN(COMMENT1);}<br />
<COMMENT1> "*)" { BEGIN(INITIAL);}<br />
<COMMENT1> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
<br />
":=" { return (int)Tokens.ASSIGN; }<br />
";" { return (int)Tokens.SEMICOLUMN; }<br />
"-" { return (int)Tokens.MINUS; }<br />
"+" { return (int)Tokens.PLUS; }<br />
"*" { return (int)Tokens.MULT; }<br />
"/" { return (int)Tokens.DIVIDE; }<br />
"<" { return (int)Tokens.LT; }<br />
">" { return (int)Tokens.GT; }<br />
"<=" { return (int)Tokens.LE; }<br />
">=" { return (int)Tokens.GE; }<br />
"=" { return (int)Tokens.EQ; }<br />
"<>" { return (int)Tokens.NE; }<br />
"(" { return (int)Tokens.LPAREN; }<br />
")" { return (int)Tokens.RPAREN; }<br />
"," { return (int)Tokens.COLUMN; }<br />
":" { return (int)Tokens.COLON; }<br />
"." { return (int)Tokens.POINT; }<br />
<br />
<br />
\'[^']*\' {<br />
yylval.sVal = yytext.Substring(1,yytext.Length-2);<br />
return (int)Tokens.STRINGLITERAL;<br />
}<br />
<br />
{ID} { <br />
int res = ScannerHelper.GetIDToken(yytext);<br />
string s = yytext.ToLower();<br />
if (s=="integer")<br />
yylval.dtVal.DType=DataType.INTTYPE;<br />
if (s == "real")<br />
yylval.dtVal.DType =DataType.DOUBLETYPE;<br />
if (res == (int)Tokens.ID)<br />
yylval.sVal = yytext;<br />
return res;<br />
}<br />
<br />
{INTNUM} { <br />
yylval.iVal = int.Parse(yytext); <br />
return (int)Tokens.INTNUM; <br />
}<br />
<br />
{REALNUM} { <br />
yylval.dVal = double.Parse(yytext,new System.Globalization.CultureInfo("en-US")); <br />
return (int)Tokens.REALNUM; <br />
}<br />
<br />
%{<br />
yylloc = new LexLocation(tokLin, tokCol, tokELin, tokECol);<br />
%}<br />
<br />
%%<br />
<br />
class ScannerHelper <br />
{<br />
private static Dictionary<string,int> keywords;<br />
<br />
static ScannerHelper() <br />
{<br />
keywords = new Dictionary<string,int>();<br />
keywords.Add("var",(int)Tokens.kVAR);<br />
keywords.Add("real",(int)Tokens.kREAL);<br />
keywords.Add("integer",(int)Tokens.kINTEGER);<br />
keywords.Add("begin",(int)Tokens.kBEGIN);<br />
keywords.Add("end",(int)Tokens.kEND);<br />
keywords.Add("if",(int)Tokens.kIF);<br />
keywords.Add("then",(int)Tokens.kTHEN);<br />
keywords.Add("else",(int)Tokens.kELSE);<br />
keywords.Add("do",(int)Tokens.kDO);<br />
keywords.Add("while",(int)Tokens.kWHILE);<br />
keywords.Add("div",(int)Tokens.DIV);<br />
keywords.Add("mod",(int)Tokens.MOD);<br />
keywords.Add("and",(int)Tokens.AND);<br />
keywords.Add("or",(int)Tokens.OR);<br />
keywords.Add("not",(int)Tokens.NOT); <br />
}<br />
public static int GetIDToken(string s)<br />
{<br />
s = s.ToLower();<br />
if (keywords.ContainsKey(s))<br />
{ <br />
return keywords[s];<br />
} <br />
else<br />
return (int)Tokens.ID;<br />
}<br />
<br />
}<br />
</pre></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9C%D0%9F%D0%9E%D0%9A_2011&diff=2187МПОК 20112011-09-28T19:06:37Z<p>AlexHit: </p>
<hr />
<div>[[Роли в проекте и задания разработчикам 2011]]<br><br />
[[Грамматика языка Pascal]]<br><br />
[[Грамматика языка С]]<br><br />
[[Диаграмма классов синтаксического дерева]]<br><br />
Первичное описание классов синтаксического дерева 24.09.11 [http://files.mail.ru/47O3R5]<br><br />
[[Науменко]]<br></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9C%D0%9F%D0%9E%D0%9A_2011&diff=2186МПОК 20112011-09-28T19:05:46Z<p>AlexHit: </p>
<hr />
<div>[[Роли в проекте и задания разработчикам 2011]]<br><br />
[[Грамматика языка Pascal]]<br><br />
[[Грамматика языка С]]<br><br />
[[Диаграмма классов синтаксического дерева]]<br><br />
Первичное описание классов синтаксического дерева 24.09.11 [http://files.mail.ru/47O3R5]<br></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9C%D0%9F%D0%9E%D0%9A_2011&diff=2185МПОК 20112011-09-28T19:05:25Z<p>AlexHit: </p>
<hr />
<div>[[Роли в проекте и задания разработчикам 2011]]<br><br />
[[Грамматика языка Pascal]]<br><br />
[[Грамматика языка С]]<br><br />
[[Диаграмма классов синтаксического дерева]]<br><br />
Первичное описание классов синтаксического дерева 24.09.11 [http://files.mail.ru/47O3R5<br></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2179Грамматика языка Pascal2011-09-22T09:04:09Z<p>AlexHit: </p>
<hr />
<div>--[[Участник:AlexHit|Венцко Александр Зиновьевич]] 21:11, 21 сентября 2011 (UTC)<br />
<br />
'''Новый вариант'''<br />
<br />
И грамматика и сканер парсятся,готовые классы я выдам завтра на паре, возможны изменения, т.к. общей структуры, пока нет. <br />
<br />
Совет: рабочая группа (Найденов С. Баштанова Д.) сделайте библиотеку, а не консольный проект. Рекомендую посмотреть пост создания автоматической документации проекта на Visual Studio 2010 (в старых версиях, тоже есть) [http://msdn.microsoft.com/ru-ru/library/x4sa0ak0.aspx], чтобы не рисовать каждый раз диаграмму, куда проще делать это на автомате, да и быстрее!<br />
<br />
'''Грамматика'''<br />
<pre><br />
%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
%union { <br />
public int iVal; <br />
public double dVal; <br />
public string sVal; <br />
public ExprNode eVal;<br />
public List<ExprNode> elVal;<br />
public TreeNode tVal;<br />
public BlockNode lVal;<br />
public List<string> lsVal;<br />
public GreatType dtVal;<br />
}<br />
%output=PascalYacc.cs <br />
%using System.IO<br />
%using Syntax_node_tree<br />
%namespace LexScanner<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kDO kVAR<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON POINT <br />
%token PLUS MINUS MULT DIVIDE <br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
%token <iVal> INTNUM <br />
%token <dVal> REALNUM <br />
%token <sVal> STRINGLITERAL<br />
%token <sVal> ID<br />
%token <dtVal> kREAL kINTEGER <br />
<br />
%type <eVal> expr<br />
%type <tVal> operator elsepart<br />
%type <lVal> listoperator progr <br />
%type <lsVal> ident <br />
%type <elVal> exprlist <br />
%type <dtVal> ktype kSimpleType<br />
<br />
%left LT GT LE GE EQ NE<br />
%left MINUS PLUS OR<br />
%left MULT DIVIDE AND DIV MOD<br />
%left UMINUS NOT<br />
<br />
%%<br />
<br />
progr : {}<br />
| defss kBEGIN listoperator kEND {}<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD TEXT!!!");<br />
break;<br />
} <br />
;<br />
<br />
defss : defs <br />
|defss defs<br />
|<br />
;<br />
<br />
defs : kVAR ident COLON ktype SEMICOLUMN {}<br />
; <br />
<br />
ident : ID {} <br />
|ident COLUMN ID {}<br />
;<br />
<br />
listoperator : operator {}<br />
| listoperator SEMICOLUMN operator {}<br />
;<br />
<br />
ktype : kSimpleType<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD GREATE TYPE");<br />
break;<br />
}<br />
;<br />
<br />
kSimpleType : kREAL {} <br />
| kINTEGER {}<br />
;<br />
<br />
operator: {}<br />
| ID ASSIGN expr {}<br />
| kWHILE expr kDO operator {}<br />
operator {}<br />
| kIF expr kTHEN operator elsepart {}<br />
| kBEGIN listoperator kEND {}<br />
;<br />
<br />
elsepart: {}<br />
| kELSE operator {}<br />
;<br />
<br />
exprlist : expr {}<br />
| exprlist COLUMN expr {}<br />
;<br />
<br />
expr: INTNUM {}<br />
| REALNUM {}<br />
| STRINGLITERAL {}<br />
| ID {} <br />
| expr PLUS expr {}<br />
| expr MINUS expr {}<br />
| expr MULT expr {}<br />
| expr DIVIDE expr {}<br />
| expr DIV expr {}<br />
| expr MOD expr {}<br />
| expr AND expr {}<br />
| expr OR expr {}<br />
| expr LT expr {}<br />
| expr GT expr {}<br />
| expr LE expr {}<br />
| expr GE expr {}<br />
| expr EQ expr {}<br />
| expr NE expr {}<br />
| NOT expr {}<br />
| MINUS expr %prec UMINUS {} <br />
| LPAREN expr RPAREN {}<br />
;<br />
<br />
%%<br />
</pre><br />
<br />
'''Сканер'''<br />
<br />
<pre><br />
%namespace LexScanner<br />
%using Syntax_node_tree;<br />
<br />
Alpha [a-zA-Z_]<br />
INTNUM [0-9]+<br />
REALNUM {INTNUM}\.{INTNUM}<br />
ID [a-zA-Z_][a-zA-Z0-9_]* <br />
<br />
%x COMMENT<br />
%x COMMENT1<br />
<br />
%%<br />
<br />
"{" { BEGIN(COMMENT);}<br />
<COMMENT> "}" { BEGIN(INITIAL);}<br />
<COMMENT> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
"(*" { BEGIN(COMMENT1);}<br />
<COMMENT1> "*)" { BEGIN(INITIAL);}<br />
<COMMENT1> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
<br />
":=" { return (int)Tokens.ASSIGN; }<br />
";" { return (int)Tokens.SEMICOLUMN; }<br />
"-" { return (int)Tokens.MINUS; }<br />
"+" { return (int)Tokens.PLUS; }<br />
"*" { return (int)Tokens.MULT; }<br />
"/" { return (int)Tokens.DIVIDE; }<br />
"<" { return (int)Tokens.LT; }<br />
">" { return (int)Tokens.GT; }<br />
"<=" { return (int)Tokens.LE; }<br />
">=" { return (int)Tokens.GE; }<br />
"=" { return (int)Tokens.EQ; }<br />
"<>" { return (int)Tokens.NE; }<br />
"(" { return (int)Tokens.LPAREN; }<br />
")" { return (int)Tokens.RPAREN; }<br />
"," { return (int)Tokens.COLUMN; }<br />
":" { return (int)Tokens.COLON; }<br />
"." { return (int)Tokens.POINT; }<br />
<br />
<br />
\'[^']*\' {<br />
yylval.sVal = yytext.Substring(1,yytext.Length-2);<br />
return (int)Tokens.STRINGLITERAL;<br />
}<br />
<br />
{ID} { <br />
int res = ScannerHelper.GetIDToken(yytext);<br />
string s = yytext.ToLower();<br />
if (s=="integer")<br />
yylval.dtVal.DType=DataType.INTTYPE;<br />
if (s == "real")<br />
yylval.dtVal.DType =DataType.DOUBLETYPE;<br />
if (res == (int)Tokens.ID)<br />
yylval.sVal = yytext;<br />
return res;<br />
}<br />
<br />
{INTNUM} { <br />
yylval.iVal = int.Parse(yytext); <br />
return (int)Tokens.INTNUM; <br />
}<br />
<br />
{REALNUM} { <br />
yylval.dVal = double.Parse(yytext,new System.Globalization.CultureInfo("en-US")); <br />
return (int)Tokens.REALNUM; <br />
}<br />
<br />
%{<br />
yylloc = new LexLocation(tokLin, tokCol, tokELin, tokECol);<br />
%}<br />
<br />
%%<br />
<br />
class ScannerHelper <br />
{<br />
private static Dictionary<string,int> keywords;<br />
<br />
static ScannerHelper() <br />
{<br />
keywords = new Dictionary<string,int>();<br />
keywords.Add("var",(int)Tokens.kVAR);<br />
keywords.Add("real",(int)Tokens.kREAL);<br />
keywords.Add("integer",(int)Tokens.kINTEGER);<br />
keywords.Add("begin",(int)Tokens.kBEGIN);<br />
keywords.Add("end",(int)Tokens.kEND);<br />
keywords.Add("if",(int)Tokens.kIF);<br />
keywords.Add("then",(int)Tokens.kTHEN);<br />
keywords.Add("else",(int)Tokens.kELSE);<br />
keywords.Add("do",(int)Tokens.kDO);<br />
keywords.Add("while",(int)Tokens.kWHILE);<br />
keywords.Add("div",(int)Tokens.DIV);<br />
keywords.Add("mod",(int)Tokens.MOD);<br />
keywords.Add("and",(int)Tokens.AND);<br />
keywords.Add("or",(int)Tokens.OR);<br />
keywords.Add("not",(int)Tokens.NOT); <br />
}<br />
public static int GetIDToken(string s)<br />
{<br />
s = s.ToLower();<br />
if (keywords.ContainsKey(s))<br />
{ <br />
return keywords[s];<br />
} <br />
else<br />
return (int)Tokens.ID;<br />
}<br />
<br />
}<br />
</pre></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2178Грамматика языка Pascal2011-09-21T21:13:44Z<p>AlexHit: </p>
<hr />
<div>--[[Участник:AlexHit|Венцко Александр Зиновьевич]] 21:11, 21 сентября 2011 (UTC)<br />
<br />
'''Новый вариант'''<br />
<br />
И грамматика и сканер парсятся,готовые классы я выдам завтра на паре, возможны изменения, т.к. общей структуры, пока нет. <br />
<br />
Замечание: рабочая группа (Найденов С. Баштанова Д.) сделайте библиотеку, а не консольный проект (это не сложно - 5 минут), так же не смог закачать вашу диаграмму... Рекомендую посмотреть пост создания автоматической документации проекта на Visual Studio 2010 (в старых версиях, тоже есть) [http://msdn.microsoft.com/ru-ru/library/x4sa0ak0.aspx], чтобы не рисовать каждый раз диаграмму, куда проще делать это на автомате, да и быстрее!<br />
<br />
'''Грамматика'''<br />
<pre><br />
%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
%union { <br />
public int iVal; <br />
public double dVal; <br />
public string sVal; <br />
public ExprNode eVal;<br />
public List<ExprNode> elVal;<br />
public TreeNode tVal;<br />
public BlockNode lVal;<br />
public List<string> lsVal;<br />
public GreatType dtVal;<br />
}<br />
%output=PascalYacc.cs <br />
%using System.IO<br />
%using Syntax_node_tree<br />
%namespace LexScanner<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kDO kVAR<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON POINT <br />
%token PLUS MINUS MULT DIVIDE <br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
%token <iVal> INTNUM <br />
%token <dVal> REALNUM <br />
%token <sVal> STRINGLITERAL<br />
%token <sVal> ID<br />
%token <dtVal> kREAL kINTEGER <br />
<br />
%type <eVal> expr<br />
%type <tVal> operator elsepart<br />
%type <lVal> listoperator progr <br />
%type <lsVal> ident <br />
%type <elVal> exprlist <br />
%type <dtVal> ktype kSimpleType<br />
<br />
%left LT GT LE GE EQ NE<br />
%left MINUS PLUS OR<br />
%left MULT DIVIDE AND DIV MOD<br />
%left UMINUS NOT<br />
<br />
%%<br />
<br />
progr : {}<br />
| defss kBEGIN listoperator kEND {}<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD TEXT!!!");<br />
break;<br />
} <br />
;<br />
<br />
defss : defs <br />
|defss defs<br />
|<br />
;<br />
<br />
defs : kVAR ident COLON ktype SEMICOLUMN {}<br />
; <br />
<br />
ident : ID {} <br />
|ident COLUMN ID {}<br />
;<br />
<br />
listoperator : operator {}<br />
| listoperator SEMICOLUMN operator {}<br />
;<br />
<br />
ktype : kSimpleType<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD GREATE TYPE");<br />
break;<br />
}<br />
;<br />
<br />
kSimpleType : kREAL {} <br />
| kINTEGER {}<br />
;<br />
<br />
operator: {}<br />
| ID ASSIGN expr {}<br />
| kWHILE expr kDO operator {}<br />
operator {}<br />
| kIF expr kTHEN operator elsepart {}<br />
| kBEGIN listoperator kEND {}<br />
;<br />
<br />
elsepart: {}<br />
| kELSE operator {}<br />
;<br />
<br />
exprlist : expr {}<br />
| exprlist COLUMN expr {}<br />
;<br />
<br />
expr: INTNUM {}<br />
| REALNUM {}<br />
| STRINGLITERAL {}<br />
| ID {} <br />
| expr PLUS expr {}<br />
| expr MINUS expr {}<br />
| expr MULT expr {}<br />
| expr DIVIDE expr {}<br />
| expr DIV expr {}<br />
| expr MOD expr {}<br />
| expr AND expr {}<br />
| expr OR expr {}<br />
| expr LT expr {}<br />
| expr GT expr {}<br />
| expr LE expr {}<br />
| expr GE expr {}<br />
| expr EQ expr {}<br />
| expr NE expr {}<br />
| NOT expr {}<br />
| MINUS expr %prec UMINUS {} <br />
| LPAREN expr RPAREN {}<br />
;<br />
<br />
%%<br />
</pre><br />
<br />
'''Сканер'''<br />
<br />
<pre><br />
%namespace LexScanner<br />
%using Syntax_node_tree;<br />
<br />
Alpha [a-zA-Z_]<br />
INTNUM [0-9]+<br />
REALNUM {INTNUM}\.{INTNUM}<br />
ID [a-zA-Z_][a-zA-Z0-9_]* <br />
<br />
%x COMMENT<br />
%x COMMENT1<br />
<br />
%%<br />
<br />
"{" { BEGIN(COMMENT);}<br />
<COMMENT> "}" { BEGIN(INITIAL);}<br />
<COMMENT> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
"(*" { BEGIN(COMMENT1);}<br />
<COMMENT1> "*)" { BEGIN(INITIAL);}<br />
<COMMENT1> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
<br />
":=" { return (int)Tokens.ASSIGN; }<br />
";" { return (int)Tokens.SEMICOLUMN; }<br />
"-" { return (int)Tokens.MINUS; }<br />
"+" { return (int)Tokens.PLUS; }<br />
"*" { return (int)Tokens.MULT; }<br />
"/" { return (int)Tokens.DIVIDE; }<br />
"<" { return (int)Tokens.LT; }<br />
">" { return (int)Tokens.GT; }<br />
"<=" { return (int)Tokens.LE; }<br />
">=" { return (int)Tokens.GE; }<br />
"=" { return (int)Tokens.EQ; }<br />
"<>" { return (int)Tokens.NE; }<br />
"(" { return (int)Tokens.LPAREN; }<br />
")" { return (int)Tokens.RPAREN; }<br />
"," { return (int)Tokens.COLUMN; }<br />
":" { return (int)Tokens.COLON; }<br />
"." { return (int)Tokens.POINT; }<br />
<br />
<br />
\'[^']*\' {<br />
yylval.sVal = yytext.Substring(1,yytext.Length-2);<br />
return (int)Tokens.STRINGLITERAL;<br />
}<br />
<br />
{ID} { <br />
int res = ScannerHelper.GetIDToken(yytext);<br />
string s = yytext.ToLower();<br />
if (s=="integer")<br />
yylval.dtVal.DType=DataType.INTTYPE;<br />
if (s == "real")<br />
yylval.dtVal.DType =DataType.DOUBLETYPE;<br />
if (res == (int)Tokens.ID)<br />
yylval.sVal = yytext;<br />
return res;<br />
}<br />
<br />
{INTNUM} { <br />
yylval.iVal = int.Parse(yytext); <br />
return (int)Tokens.INTNUM; <br />
}<br />
<br />
{REALNUM} { <br />
yylval.dVal = double.Parse(yytext,new System.Globalization.CultureInfo("en-US")); <br />
return (int)Tokens.REALNUM; <br />
}<br />
<br />
%{<br />
yylloc = new LexLocation(tokLin, tokCol, tokELin, tokECol);<br />
%}<br />
<br />
%%<br />
<br />
class ScannerHelper <br />
{<br />
private static Dictionary<string,int> keywords;<br />
<br />
static ScannerHelper() <br />
{<br />
keywords = new Dictionary<string,int>();<br />
keywords.Add("var",(int)Tokens.kVAR);<br />
keywords.Add("real",(int)Tokens.kREAL);<br />
keywords.Add("integer",(int)Tokens.kINTEGER);<br />
keywords.Add("begin",(int)Tokens.kBEGIN);<br />
keywords.Add("end",(int)Tokens.kEND);<br />
keywords.Add("if",(int)Tokens.kIF);<br />
keywords.Add("then",(int)Tokens.kTHEN);<br />
keywords.Add("else",(int)Tokens.kELSE);<br />
keywords.Add("do",(int)Tokens.kDO);<br />
keywords.Add("while",(int)Tokens.kWHILE);<br />
keywords.Add("div",(int)Tokens.DIV);<br />
keywords.Add("mod",(int)Tokens.MOD);<br />
keywords.Add("and",(int)Tokens.AND);<br />
keywords.Add("or",(int)Tokens.OR);<br />
keywords.Add("not",(int)Tokens.NOT); <br />
}<br />
public static int GetIDToken(string s)<br />
{<br />
s = s.ToLower();<br />
if (keywords.ContainsKey(s))<br />
{ <br />
return keywords[s];<br />
} <br />
else<br />
return (int)Tokens.ID;<br />
}<br />
<br />
}<br />
</pre></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2177Грамматика языка Pascal2011-09-21T21:12:43Z<p>AlexHit: </p>
<hr />
<div>--[[Участник:AlexHit|Венцко Александр Зиновьевич]] 21:11, 21 сентября 2011 (UTC)<br />
<br />
'''Новый вариант'''<br />
<br />
И грамматика и сканер парсятся,готовые классы я выдам завтра на паре, возможны изменения, т.к. общей структуры, пока нет. <br />
<br />
Замечание: рабочая группа (Найденов С. Баштанова Д.) сделайте библиотеку, а не консольный проект (это не сложно - 5 минут), так же не смог закачать вашу диаграмму... Рекомендую посмотреть пост создания автоматической документации проекта на Visual Studio 2010 (в старых версия тоже есть) [http://msdn.microsoft.com/ru-ru/library/x4sa0ak0.aspx], чтобы не рисовать каждый раз диаграмму, куда проще делать это на автомате, да и быстрее!<br />
<br />
'''Грамматика'''<br />
<pre><br />
%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
%union { <br />
public int iVal; <br />
public double dVal; <br />
public string sVal; <br />
public ExprNode eVal;<br />
public List<ExprNode> elVal;<br />
public TreeNode tVal;<br />
public BlockNode lVal;<br />
public List<string> lsVal;<br />
public GreatType dtVal;<br />
}<br />
%output=PascalYacc.cs <br />
%using System.IO<br />
%using Syntax_node_tree<br />
%namespace LexScanner<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kDO kVAR<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON POINT <br />
%token PLUS MINUS MULT DIVIDE <br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
%token <iVal> INTNUM <br />
%token <dVal> REALNUM <br />
%token <sVal> STRINGLITERAL<br />
%token <sVal> ID<br />
%token <dtVal> kREAL kINTEGER <br />
<br />
%type <eVal> expr<br />
%type <tVal> operator elsepart<br />
%type <lVal> listoperator progr <br />
%type <lsVal> ident <br />
%type <elVal> exprlist <br />
%type <dtVal> ktype kSimpleType<br />
<br />
%left LT GT LE GE EQ NE<br />
%left MINUS PLUS OR<br />
%left MULT DIVIDE AND DIV MOD<br />
%left UMINUS NOT<br />
<br />
%%<br />
<br />
progr : {}<br />
| defss kBEGIN listoperator kEND {}<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD TEXT!!!");<br />
break;<br />
} <br />
;<br />
<br />
defss : defs <br />
|defss defs<br />
|<br />
;<br />
<br />
defs : kVAR ident COLON ktype SEMICOLUMN {}<br />
; <br />
<br />
ident : ID {} <br />
|ident COLUMN ID {}<br />
;<br />
<br />
listoperator : operator {}<br />
| listoperator SEMICOLUMN operator {}<br />
;<br />
<br />
ktype : kSimpleType<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD GREATE TYPE");<br />
break;<br />
}<br />
;<br />
<br />
kSimpleType : kREAL {} <br />
| kINTEGER {}<br />
;<br />
<br />
operator: {}<br />
| ID ASSIGN expr {}<br />
| kWHILE expr kDO operator {}<br />
operator {}<br />
| kIF expr kTHEN operator elsepart {}<br />
| kBEGIN listoperator kEND {}<br />
;<br />
<br />
elsepart: {}<br />
| kELSE operator {}<br />
;<br />
<br />
exprlist : expr {}<br />
| exprlist COLUMN expr {}<br />
;<br />
<br />
expr: INTNUM {}<br />
| REALNUM {}<br />
| STRINGLITERAL {}<br />
| ID {} <br />
| expr PLUS expr {}<br />
| expr MINUS expr {}<br />
| expr MULT expr {}<br />
| expr DIVIDE expr {}<br />
| expr DIV expr {}<br />
| expr MOD expr {}<br />
| expr AND expr {}<br />
| expr OR expr {}<br />
| expr LT expr {}<br />
| expr GT expr {}<br />
| expr LE expr {}<br />
| expr GE expr {}<br />
| expr EQ expr {}<br />
| expr NE expr {}<br />
| NOT expr {}<br />
| MINUS expr %prec UMINUS {} <br />
| LPAREN expr RPAREN {}<br />
;<br />
<br />
%%<br />
</pre><br />
<br />
'''Сканер'''<br />
<br />
<pre><br />
%namespace LexScanner<br />
%using Syntax_node_tree;<br />
<br />
Alpha [a-zA-Z_]<br />
INTNUM [0-9]+<br />
REALNUM {INTNUM}\.{INTNUM}<br />
ID [a-zA-Z_][a-zA-Z0-9_]* <br />
<br />
%x COMMENT<br />
%x COMMENT1<br />
<br />
%%<br />
<br />
"{" { BEGIN(COMMENT);}<br />
<COMMENT> "}" { BEGIN(INITIAL);}<br />
<COMMENT> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
"(*" { BEGIN(COMMENT1);}<br />
<COMMENT1> "*)" { BEGIN(INITIAL);}<br />
<COMMENT1> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
<br />
":=" { return (int)Tokens.ASSIGN; }<br />
";" { return (int)Tokens.SEMICOLUMN; }<br />
"-" { return (int)Tokens.MINUS; }<br />
"+" { return (int)Tokens.PLUS; }<br />
"*" { return (int)Tokens.MULT; }<br />
"/" { return (int)Tokens.DIVIDE; }<br />
"<" { return (int)Tokens.LT; }<br />
">" { return (int)Tokens.GT; }<br />
"<=" { return (int)Tokens.LE; }<br />
">=" { return (int)Tokens.GE; }<br />
"=" { return (int)Tokens.EQ; }<br />
"<>" { return (int)Tokens.NE; }<br />
"(" { return (int)Tokens.LPAREN; }<br />
")" { return (int)Tokens.RPAREN; }<br />
"," { return (int)Tokens.COLUMN; }<br />
":" { return (int)Tokens.COLON; }<br />
"." { return (int)Tokens.POINT; }<br />
<br />
<br />
\'[^']*\' {<br />
yylval.sVal = yytext.Substring(1,yytext.Length-2);<br />
return (int)Tokens.STRINGLITERAL;<br />
}<br />
<br />
{ID} { <br />
int res = ScannerHelper.GetIDToken(yytext);<br />
string s = yytext.ToLower();<br />
if (s=="integer")<br />
yylval.dtVal.DType=DataType.INTTYPE;<br />
if (s == "real")<br />
yylval.dtVal.DType =DataType.DOUBLETYPE;<br />
if (res == (int)Tokens.ID)<br />
yylval.sVal = yytext;<br />
return res;<br />
}<br />
<br />
{INTNUM} { <br />
yylval.iVal = int.Parse(yytext); <br />
return (int)Tokens.INTNUM; <br />
}<br />
<br />
{REALNUM} { <br />
yylval.dVal = double.Parse(yytext,new System.Globalization.CultureInfo("en-US")); <br />
return (int)Tokens.REALNUM; <br />
}<br />
<br />
%{<br />
yylloc = new LexLocation(tokLin, tokCol, tokELin, tokECol);<br />
%}<br />
<br />
%%<br />
<br />
class ScannerHelper <br />
{<br />
private static Dictionary<string,int> keywords;<br />
<br />
static ScannerHelper() <br />
{<br />
keywords = new Dictionary<string,int>();<br />
keywords.Add("var",(int)Tokens.kVAR);<br />
keywords.Add("real",(int)Tokens.kREAL);<br />
keywords.Add("integer",(int)Tokens.kINTEGER);<br />
keywords.Add("begin",(int)Tokens.kBEGIN);<br />
keywords.Add("end",(int)Tokens.kEND);<br />
keywords.Add("if",(int)Tokens.kIF);<br />
keywords.Add("then",(int)Tokens.kTHEN);<br />
keywords.Add("else",(int)Tokens.kELSE);<br />
keywords.Add("do",(int)Tokens.kDO);<br />
keywords.Add("while",(int)Tokens.kWHILE);<br />
keywords.Add("div",(int)Tokens.DIV);<br />
keywords.Add("mod",(int)Tokens.MOD);<br />
keywords.Add("and",(int)Tokens.AND);<br />
keywords.Add("or",(int)Tokens.OR);<br />
keywords.Add("not",(int)Tokens.NOT); <br />
}<br />
public static int GetIDToken(string s)<br />
{<br />
s = s.ToLower();<br />
if (keywords.ContainsKey(s))<br />
{ <br />
return keywords[s];<br />
} <br />
else<br />
return (int)Tokens.ID;<br />
}<br />
<br />
}<br />
</pre></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2176Грамматика языка Pascal2011-09-21T21:11:22Z<p>AlexHit: </p>
<hr />
<div>--[[Участник:AlexHit|Венцко Александр Зиновьевич]] 21:11, 21 сентября 2011 (UTC)<br />
<br />
'''Новый вариант'''<br />
<br />
И грамматика и сканер парсятся,готовые классы я выдам завтра на паре, возможны изменения, т.к. общей структуры, пока нет. <br />
<br />
Замечание: рабочая группа (Найденов С. Баштанова Д.) сделайте библиотеку, а не консольный проект (это не сложно - 5 минут), так же не смог закачать вашу диаграмму... Рекомендую посмотреть пост создания автоматической документации проекта на Visual Studio 2010 (в старых версия тоже есть) [http://msdn.microsoft.com/ru-ru/library/x4sa0ak0.aspx], чтобы не рисовать каждый раз диаграмму, куда проще делать это на автомате да и быстрее!<br />
<br />
'''Грамматика'''<br />
<pre><br />
%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
%union { <br />
public int iVal; <br />
public double dVal; <br />
public string sVal; <br />
public ExprNode eVal;<br />
public List<ExprNode> elVal;<br />
public TreeNode tVal;<br />
public BlockNode lVal;<br />
public List<string> lsVal;<br />
public GreatType dtVal;<br />
}<br />
%output=PascalYacc.cs <br />
%using System.IO<br />
%using Syntax_node_tree<br />
%namespace LexScanner<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kDO kVAR<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON POINT <br />
%token PLUS MINUS MULT DIVIDE <br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
%token <iVal> INTNUM <br />
%token <dVal> REALNUM <br />
%token <sVal> STRINGLITERAL<br />
%token <sVal> ID<br />
%token <dtVal> kREAL kINTEGER <br />
<br />
%type <eVal> expr<br />
%type <tVal> operator elsepart<br />
%type <lVal> listoperator progr <br />
%type <lsVal> ident <br />
%type <elVal> exprlist <br />
%type <dtVal> ktype kSimpleType<br />
<br />
%left LT GT LE GE EQ NE<br />
%left MINUS PLUS OR<br />
%left MULT DIVIDE AND DIV MOD<br />
%left UMINUS NOT<br />
<br />
%%<br />
<br />
progr : {}<br />
| defss kBEGIN listoperator kEND {}<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD TEXT!!!");<br />
break;<br />
} <br />
;<br />
<br />
defss : defs <br />
|defss defs<br />
|<br />
;<br />
<br />
defs : kVAR ident COLON ktype SEMICOLUMN {}<br />
; <br />
<br />
ident : ID {} <br />
|ident COLUMN ID {}<br />
;<br />
<br />
listoperator : operator {}<br />
| listoperator SEMICOLUMN operator {}<br />
;<br />
<br />
ktype : kSimpleType<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD GREATE TYPE");<br />
break;<br />
}<br />
;<br />
<br />
kSimpleType : kREAL {} <br />
| kINTEGER {}<br />
;<br />
<br />
operator: {}<br />
| ID ASSIGN expr {}<br />
| kWHILE expr kDO operator {}<br />
operator {}<br />
| kIF expr kTHEN operator elsepart {}<br />
| kBEGIN listoperator kEND {}<br />
;<br />
<br />
elsepart: {}<br />
| kELSE operator {}<br />
;<br />
<br />
exprlist : expr {}<br />
| exprlist COLUMN expr {}<br />
;<br />
<br />
expr: INTNUM {}<br />
| REALNUM {}<br />
| STRINGLITERAL {}<br />
| ID {} <br />
| expr PLUS expr {}<br />
| expr MINUS expr {}<br />
| expr MULT expr {}<br />
| expr DIVIDE expr {}<br />
| expr DIV expr {}<br />
| expr MOD expr {}<br />
| expr AND expr {}<br />
| expr OR expr {}<br />
| expr LT expr {}<br />
| expr GT expr {}<br />
| expr LE expr {}<br />
| expr GE expr {}<br />
| expr EQ expr {}<br />
| expr NE expr {}<br />
| NOT expr {}<br />
| MINUS expr %prec UMINUS {} <br />
| LPAREN expr RPAREN {}<br />
;<br />
<br />
%%<br />
</pre><br />
<br />
'''сканер'''<br />
<br />
<pre><br />
%namespace LexScanner<br />
%using Syntax_node_tree;<br />
<br />
Alpha [a-zA-Z_]<br />
INTNUM [0-9]+<br />
REALNUM {INTNUM}\.{INTNUM}<br />
ID [a-zA-Z_][a-zA-Z0-9_]* <br />
<br />
%x COMMENT<br />
%x COMMENT1<br />
<br />
%%<br />
<br />
"{" { BEGIN(COMMENT);}<br />
<COMMENT> "}" { BEGIN(INITIAL);}<br />
<COMMENT> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
"(*" { BEGIN(COMMENT1);}<br />
<COMMENT1> "*)" { BEGIN(INITIAL);}<br />
<COMMENT1> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
<br />
":=" { return (int)Tokens.ASSIGN; }<br />
";" { return (int)Tokens.SEMICOLUMN; }<br />
"-" { return (int)Tokens.MINUS; }<br />
"+" { return (int)Tokens.PLUS; }<br />
"*" { return (int)Tokens.MULT; }<br />
"/" { return (int)Tokens.DIVIDE; }<br />
"<" { return (int)Tokens.LT; }<br />
">" { return (int)Tokens.GT; }<br />
"<=" { return (int)Tokens.LE; }<br />
">=" { return (int)Tokens.GE; }<br />
"=" { return (int)Tokens.EQ; }<br />
"<>" { return (int)Tokens.NE; }<br />
"(" { return (int)Tokens.LPAREN; }<br />
")" { return (int)Tokens.RPAREN; }<br />
"," { return (int)Tokens.COLUMN; }<br />
":" { return (int)Tokens.COLON; }<br />
"." { return (int)Tokens.POINT; }<br />
<br />
<br />
\'[^']*\' {<br />
yylval.sVal = yytext.Substring(1,yytext.Length-2);<br />
return (int)Tokens.STRINGLITERAL;<br />
}<br />
<br />
{ID} { <br />
int res = ScannerHelper.GetIDToken(yytext);<br />
string s = yytext.ToLower();<br />
if (s=="integer")<br />
yylval.dtVal.DType=DataType.INTTYPE;<br />
if (s == "real")<br />
yylval.dtVal.DType =DataType.DOUBLETYPE;<br />
if (res == (int)Tokens.ID)<br />
yylval.sVal = yytext;<br />
return res;<br />
}<br />
<br />
{INTNUM} { <br />
yylval.iVal = int.Parse(yytext); <br />
return (int)Tokens.INTNUM; <br />
}<br />
<br />
{REALNUM} { <br />
yylval.dVal = double.Parse(yytext,new System.Globalization.CultureInfo("en-US")); <br />
return (int)Tokens.REALNUM; <br />
}<br />
<br />
%{<br />
yylloc = new LexLocation(tokLin, tokCol, tokELin, tokECol);<br />
%}<br />
<br />
%%<br />
<br />
class ScannerHelper <br />
{<br />
private static Dictionary<string,int> keywords;<br />
<br />
static ScannerHelper() <br />
{<br />
keywords = new Dictionary<string,int>();<br />
keywords.Add("var",(int)Tokens.kVAR);<br />
keywords.Add("real",(int)Tokens.kREAL);<br />
keywords.Add("integer",(int)Tokens.kINTEGER);<br />
keywords.Add("begin",(int)Tokens.kBEGIN);<br />
keywords.Add("end",(int)Tokens.kEND);<br />
keywords.Add("if",(int)Tokens.kIF);<br />
keywords.Add("then",(int)Tokens.kTHEN);<br />
keywords.Add("else",(int)Tokens.kELSE);<br />
keywords.Add("do",(int)Tokens.kDO);<br />
keywords.Add("while",(int)Tokens.kWHILE);<br />
keywords.Add("div",(int)Tokens.DIV);<br />
keywords.Add("mod",(int)Tokens.MOD);<br />
keywords.Add("and",(int)Tokens.AND);<br />
keywords.Add("or",(int)Tokens.OR);<br />
keywords.Add("not",(int)Tokens.NOT); <br />
}<br />
public static int GetIDToken(string s)<br />
{<br />
s = s.ToLower();<br />
if (keywords.ContainsKey(s))<br />
{ <br />
return keywords[s];<br />
} <br />
else<br />
return (int)Tokens.ID;<br />
}<br />
<br />
}<br />
</pre></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2175Грамматика языка Pascal2011-09-21T20:45:53Z<p>AlexHit: </p>
<hr />
<div>'''Новый вариант'''<br />
<br />
<pre><br />
%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
%union { <br />
public int iVal; <br />
public double dVal; <br />
public string sVal; <br />
public ExprNode eVal;<br />
public List<ExprNode> elVal;<br />
public TreeNode tVal;<br />
public BlockNode lVal;<br />
public List<string> lsVal;<br />
public GreatType dtVal;<br />
}<br />
%output=PascalYacc.cs <br />
%using System.IO<br />
%using Syntax_node_tree<br />
%namespace LexScanner<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kDO kVAR<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON POINT <br />
%token PLUS MINUS MULT DIVIDE <br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
%token <iVal> INTNUM <br />
%token <dVal> REALNUM <br />
%token <sVal> STRINGLITERAL<br />
%token <sVal> ID<br />
%token <dtVal> kREAL kINTEGER <br />
<br />
%type <eVal> expr<br />
%type <tVal> operator elsepart<br />
%type <lVal> listoperator progr <br />
%type <lsVal> ident <br />
%type <elVal> exprlist <br />
%type <dtVal> ktype kSimpleType<br />
<br />
%left LT GT LE GE EQ NE<br />
%left MINUS PLUS OR<br />
%left MULT DIVIDE AND DIV MOD<br />
%left UMINUS NOT<br />
<br />
%%<br />
<br />
progr : {}<br />
| defss kBEGIN listoperator kEND {}<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD TEXT!!!");<br />
break;<br />
} <br />
;<br />
<br />
defss : defs <br />
|defss defs<br />
|<br />
;<br />
<br />
defs : kVAR ident COLON ktype SEMICOLUMN {}<br />
; <br />
<br />
ident : ID {} <br />
|ident COLUMN ID {}<br />
;<br />
<br />
listoperator : operator {}<br />
| listoperator SEMICOLUMN operator {}<br />
;<br />
<br />
ktype : kSimpleType<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD GREATE TYPE");<br />
break;<br />
}<br />
;<br />
<br />
kSimpleType : kREAL {} <br />
| kINTEGER {}<br />
;<br />
<br />
operator: {}<br />
| ID ASSIGN expr {}<br />
| kWHILE expr kDO operator {}<br />
operator {}<br />
| kIF expr kTHEN operator elsepart {}<br />
| kBEGIN listoperator kEND {}<br />
;<br />
<br />
elsepart: {}<br />
| kELSE operator {}<br />
;<br />
<br />
exprlist : expr {}<br />
| exprlist COLUMN expr {}<br />
;<br />
<br />
expr: INTNUM {}<br />
| REALNUM {}<br />
| STRINGLITERAL {}<br />
| ID {} <br />
| expr PLUS expr {}<br />
| expr MINUS expr {}<br />
| expr MULT expr {}<br />
| expr DIVIDE expr {}<br />
| expr DIV expr {}<br />
| expr MOD expr {}<br />
| expr AND expr {}<br />
| expr OR expr {}<br />
| expr LT expr {}<br />
| expr GT expr {}<br />
| expr LE expr {}<br />
| expr GE expr {}<br />
| expr EQ expr {}<br />
| expr NE expr {}<br />
| NOT expr {}<br />
| MINUS expr %prec UMINUS {} <br />
| LPAREN expr RPAREN {}<br />
;<br />
<br />
%%<br />
</pre><br />
<br />
'''Предварительный сканер'''<br />
<br />
<pre><br />
%namespace LexScanner<br />
%using Syntax_node_tree;<br />
<br />
Alpha [a-zA-Z_]<br />
INTNUM [0-9]+<br />
REALNUM {INTNUM}\.{INTNUM}<br />
ID [a-zA-Z_][a-zA-Z0-9_]* <br />
<br />
%x COMMENT<br />
%x COMMENT1<br />
<br />
%%<br />
<br />
"{" { BEGIN(COMMENT);}<br />
<COMMENT> "}" { BEGIN(INITIAL);}<br />
<COMMENT> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
"(*" { BEGIN(COMMENT1);}<br />
<COMMENT1> "*)" { BEGIN(INITIAL);}<br />
<COMMENT1> <<EOF>> { Console.WriteLine("Комментарий не закрыт");}<br />
<br />
":=" { return (int)Tokens.ASSIGN; }<br />
";" { return (int)Tokens.SEMICOLUMN; }<br />
"-" { return (int)Tokens.MINUS; }<br />
"+" { return (int)Tokens.PLUS; }<br />
"*" { return (int)Tokens.MULT; }<br />
"/" { return (int)Tokens.DIVIDE; }<br />
"<" { return (int)Tokens.LT; }<br />
">" { return (int)Tokens.GT; }<br />
"<=" { return (int)Tokens.LE; }<br />
">=" { return (int)Tokens.GE; }<br />
"=" { return (int)Tokens.EQ; }<br />
"<>" { return (int)Tokens.NE; }<br />
"(" { return (int)Tokens.LPAREN; }<br />
")" { return (int)Tokens.RPAREN; }<br />
"," { return (int)Tokens.COLUMN; }<br />
":" { return (int)Tokens.COLON; }<br />
"." { return (int)Tokens.POINT; }<br />
<br />
<br />
\'[^']*\' {<br />
yylval.sVal = yytext.Substring(1,yytext.Length-2);<br />
return (int)Tokens.STRINGLITERAL;<br />
}<br />
<br />
{ID} { <br />
int res = ScannerHelper.GetIDToken(yytext);<br />
string s = yytext.ToLower();<br />
if (s=="integer")<br />
yylval.dtVal.DType=DataType.INTTYPE;<br />
if (s == "real")<br />
yylval.dtVal.DType =DataType.DOUBLETYPE;<br />
if (res == (int)Tokens.ID)<br />
yylval.sVal = yytext;<br />
return res;<br />
}<br />
<br />
{INTNUM} { <br />
yylval.iVal = int.Parse(yytext); <br />
return (int)Tokens.INTNUM; <br />
}<br />
<br />
{REALNUM} { <br />
yylval.dVal = double.Parse(yytext,new System.Globalization.CultureInfo("en-US")); <br />
return (int)Tokens.REALNUM; <br />
}<br />
<br />
%{<br />
yylloc = new LexLocation(tokLin, tokCol, tokELin, tokECol);<br />
%}<br />
<br />
%%<br />
<br />
class ScannerHelper <br />
{<br />
private static Dictionary<string,int> keywords;<br />
<br />
static ScannerHelper() <br />
{<br />
keywords = new Dictionary<string,int>();<br />
keywords.Add("var",(int)Tokens.kVAR);<br />
keywords.Add("real",(int)Tokens.kREAL);<br />
keywords.Add("integer",(int)Tokens.kINTEGER);<br />
keywords.Add("begin",(int)Tokens.kBEGIN);<br />
keywords.Add("end",(int)Tokens.kEND);<br />
keywords.Add("if",(int)Tokens.kIF);<br />
keywords.Add("then",(int)Tokens.kTHEN);<br />
keywords.Add("else",(int)Tokens.kELSE);<br />
keywords.Add("do",(int)Tokens.kDO);<br />
keywords.Add("while",(int)Tokens.kWHILE);<br />
keywords.Add("div",(int)Tokens.DIV);<br />
keywords.Add("mod",(int)Tokens.MOD);<br />
keywords.Add("and",(int)Tokens.AND);<br />
keywords.Add("or",(int)Tokens.OR);<br />
keywords.Add("not",(int)Tokens.NOT); <br />
}<br />
public static int GetIDToken(string s)<br />
{<br />
s = s.ToLower();<br />
if (keywords.ContainsKey(s))<br />
{ <br />
return keywords[s];<br />
} <br />
else<br />
return (int)Tokens.ID;<br />
}<br />
<br />
}<br />
</pre></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2174Грамматика языка Pascal2011-09-21T20:38:31Z<p>AlexHit: </p>
<hr />
<div>'''Новый вариант'''<br />
<br />
<pre><br />
%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
%union { <br />
public int iVal; <br />
public double dVal; <br />
public string sVal; <br />
public ExprNode eVal;<br />
public List<ExprNode> elVal;<br />
public TreeNode tVal;<br />
public BlockNode lVal;<br />
public List<string> lsVal;<br />
public GreatType dtVal;<br />
}<br />
%output=PascalYacc.cs <br />
%using System.IO<br />
%using Syntax_node_tree<br />
%namespace LexScanner<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kDO kVAR<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON POINT <br />
%token PLUS MINUS MULT DIVIDE <br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
%token <iVal> INTNUM <br />
%token <dVal> REALNUM <br />
%token <sVal> STRINGLITERAL<br />
%token <sVal> ID<br />
%token <dtVal> kREAL kINTEGER <br />
<br />
%type <eVal> expr<br />
%type <tVal> operator elsepart<br />
%type <lVal> listoperator progr <br />
%type <lsVal> ident <br />
%type <elVal> exprlist <br />
%type <dtVal> ktype kSimpleType<br />
<br />
%left LT GT LE GE EQ NE<br />
%left MINUS PLUS OR<br />
%left MULT DIVIDE AND DIV MOD<br />
%left UMINUS NOT<br />
<br />
%%<br />
<br />
progr : {}<br />
| defss kBEGIN listoperator kEND {}<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD TEXT!!!");<br />
break;<br />
} <br />
;<br />
<br />
defss : defs <br />
|defss defs<br />
|<br />
;<br />
<br />
defs : kVAR ident COLON ktype SEMICOLUMN {}<br />
; <br />
<br />
ident : ID {} <br />
|ident COLUMN ID {}<br />
;<br />
<br />
listoperator : operator {}<br />
| listoperator SEMICOLUMN operator {}<br />
;<br />
<br />
ktype : kSimpleType<br />
| error <br />
{ <br />
System.Console.WriteLine("BAD GREATE TYPE");<br />
break;<br />
}<br />
;<br />
<br />
kSimpleType : kREAL {} <br />
| kINTEGER {}<br />
;<br />
<br />
operator: {}<br />
| ID ASSIGN expr {}<br />
| kWHILE expr kDO operator {}<br />
operator {}<br />
| kIF expr kTHEN operator elsepart {}<br />
| kBEGIN listoperator kEND {}<br />
;<br />
<br />
elsepart: {}<br />
| kELSE operator {}<br />
;<br />
<br />
exprlist : expr {}<br />
| exprlist COLUMN expr {}<br />
;<br />
<br />
expr: INTNUM {}<br />
| REALNUM {}<br />
| STRINGLITERAL {}<br />
| ID {} <br />
| expr PLUS expr {}<br />
| expr MINUS expr {}<br />
| expr MULT expr {}<br />
| expr DIVIDE expr {}<br />
| expr DIV expr {}<br />
| expr MOD expr {}<br />
| expr AND expr {}<br />
| expr OR expr {}<br />
| expr LT expr {}<br />
| expr GT expr {}<br />
| expr LE expr {}<br />
| expr GE expr {}<br />
| expr EQ expr {}<br />
| expr NE expr {}<br />
| NOT expr {}<br />
| MINUS expr %prec UMINUS {} <br />
| LPAREN expr RPAREN {}<br />
;<br />
<br />
%%<br />
</pre></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2162Грамматика языка Pascal2011-09-15T11:33:26Z<p>AlexHit: </p>
<hr />
<div><pre><br />
%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
<br />
<br />
%output=myyacc.cs <br />
<br />
<br />
%union <br />
{ <br />
public double dVal; <br />
public string sVal; <br />
public int iVal; <br />
public ExprNode eVal;<br />
public List<ExprNode> elVal; <br />
public TreeNode tVal;<br />
public BlockNode lVal; <br />
public GreatType dtVal; <br />
public List<string> lsVal;<br />
}<br />
<br />
<br />
%using System.IO<br />
%using SimpleCompiler<br />
%namespace LexScanner<br />
<br />
<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kREPEAT kUNTIL kFOR kTO kDO kVAR kOF kARRAY<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON LQPAREN RQPAREN MPOINT POINT <br />
%token PLUS MINUS MULT DIVIDE <br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
%token <iVal> INTNUM <br />
%token <dVal> REALNUM <br />
%token <sVal> STRINGLITERAL<br />
%token <sVal> ID<br />
%token <dtVal> kREAL kINTEGER <br />
%type <iVal> funcid<br />
%type <eVal> expr funccall<br />
%type <tVal> stat elsepart<br />
%type <lVal> liststat progr<br />
%type <lsVal> listid <br />
%type <elVal> exprlist <br />
%type <dtVal> ktype kSimpleType<br />
<br />
<br />
%left LT GT LE GE EQ NE<br />
%left MINUS PLUS OR<br />
%left MULT DIVIDE AND DIV MOD<br />
%left UMINUS NOT<br />
<br />
%%<br />
<br />
progr : defss kBEGIN liststat kEND <br />
| error <br />
;<br />
<br />
defss : defs <br />
|defss defs<br />
|<br />
;<br />
<br />
defs : kVAR listid COLON ktype SEMICOLUMN <br />
; <br />
<br />
listid : ID <br />
|listid COLUMN ID <br />
;<br />
<br />
liststat : stat <br />
| liststat SEMICOLUMN stat <br />
;<br />
<br />
ktype : kSimpleType <br />
| error <br />
;<br />
<br />
kSimpleType : kREAL <br />
| kINTEGER <br />
;<br />
<br />
stat: { $$ = new Node(@$);}<br />
| ID ASSIGN expr <br />
| ID LQPAREN expr RQPAREN ASSIGN expr<br />
| kWHILE expr kDO stat<br />
| kIF expr kTHEN stat elsepart<br />
{<br />
$$ = new IfNode($2,$4,$5,@$);<br />
}<br />
| kBEGIN liststat kEND { $$ = $2;}<br />
;<br />
<br />
elsepart: {$$ = null;}<br />
| kELSE stat<br />
;<br />
<br />
exprlist : expr <br />
| exprlist COLUMN expr<br />
;<br />
<br />
expr: INTNUM<br />
| REALNUM <br />
| ID<br />
| ID LQPAREN expr RQPAREN <br />
| expr PLUS expr<br />
| expr MINUS expr <br />
| expr MULT expr <br />
| expr DIVIDE expr <br />
| expr DIV expr<br />
| expr MOD expr <br />
| expr AND expr<br />
| expr OR expr <br />
| expr LT expr<br />
| expr GT expr <br />
| expr LE expr <br />
| expr GE expr <br />
| expr EQ expr <br />
| expr NE expr <br />
| NOT expr <br />
| MINUS expr %prec UMINUS<br />
| LPAREN expr RPAREN<br />
;<br />
<br />
%%<br />
</pre></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2158Грамматика языка Pascal2011-09-15T11:29:46Z<p>AlexHit: </p>
<hr />
<div><pre><br />
%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
<br />
<br />
%output=myyacc.cs <br />
<br />
<br />
%union { <br />
<br />
public double dVal; <br />
<br />
public string sVal; <br />
<br />
public int iVal; <br />
<br />
public ExprNode eVal;<br />
<br />
public List<ExprNode> elVal;<br />
<br />
public TreeNode tVal;<br />
<br />
public BlockNode lVal;<br />
<br />
public GreatType dtVal;<br />
<br />
public List<string> lsVal;<br />
<br />
}<br />
<br />
<br />
%using System.IO<br />
<br />
%using SimpleCompiler<br />
<br />
%namespace LexScanner<br />
<br />
<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kREPEAT kUNTIL kFOR kTO kDO kVAR kOF kARRAY<br />
<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON LQPAREN RQPAREN MPOINT POINT <br />
<br />
%token PLUS MINUS MULT DIVIDE <br />
<br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
<br />
%token <iVal> INTNUM <br />
<br />
%token <dVal> REALNUM <br />
<br />
%token <sVal> STRINGLITERAL<br />
<br />
%token <sVal> ID<br />
<br />
%token <dtVal> kREAL kINTEGER <br />
<br />
%type <iVal> funcid<br />
<br />
%type <eVal> expr funccall<br />
<br />
%type <tVal> stat elsepart<br />
<br />
%type <lVal> liststat progr<br />
<br />
%type <lsVal> listid <br />
<br />
%type <elVal> exprlist <br />
<br />
%type <dtVal> ktype kSimpleType<br />
<br />
<br />
<br />
%left LT GT LE GE EQ NE<br />
<br />
%left MINUS PLUS OR<br />
<br />
%left MULT DIVIDE AND DIV MOD<br />
<br />
%left UMINUS NOT<br />
<br />
<br />
%%<br />
<br />
progr : defss kBEGIN liststat kEND <br />
<br />
| error <br />
<br />
;<br />
<br />
defss : defs <br />
<br />
|defss defs<br />
<br />
|<br />
<br />
;<br />
<br />
defs : kVAR listid COLON ktype SEMICOLUMN <br />
<br />
; <br />
<br />
listid : ID <br />
<br />
|listid COLUMN ID <br />
<br />
;<br />
<br />
liststat : stat <br />
<br />
| liststat SEMICOLUMN stat <br />
<br />
;<br />
<br />
ktype : kSimpleType<br />
<br />
| error <br />
<br />
;<br />
<br />
kSimpleType : kREAL <br />
<br />
| kINTEGER <br />
<br />
;<br />
<br />
stat: { $$ = new Node(@$);}<br />
<br />
| ID ASSIGN expr <br />
<br />
| ID LQPAREN expr RQPAREN ASSIGN expr<br />
<br />
| kWHILE expr kDO stat<br />
<br />
| kIF expr kTHEN stat elsepart<br />
<br />
{<br />
<br />
$$ = new IfNode($2,$4,$5,@$);<br />
<br />
}<br />
<br />
| kBEGIN liststat kEND { $$ = $2;}<br />
<br />
;<br />
<br />
elsepart: {$$ = null;}<br />
<br />
| kELSE stat<br />
<br />
;<br />
<br />
exprlist : expr <br />
<br />
| exprlist COLUMN expr<br />
<br />
;<br />
<br />
expr: INTNUM<br />
<br />
| REALNUM <br />
<br />
| ID<br />
<br />
| ID LQPAREN expr RQPAREN <br />
<br />
| expr PLUS expr<br />
<br />
| expr MINUS expr <br />
<br />
| expr MULT expr <br />
<br />
| expr DIVIDE expr <br />
<br />
| expr DIV expr<br />
<br />
| expr MOD expr <br />
<br />
| expr AND expr<br />
<br />
| expr OR expr <br />
<br />
| expr LT expr<br />
<br />
| expr GT expr <br />
<br />
| expr LE expr <br />
<br />
| expr GE expr <br />
<br />
| expr EQ expr <br />
<br />
| expr NE expr <br />
<br />
| NOT expr <br />
<br />
| MINUS expr %prec UMINUS<br />
<br />
| LPAREN expr RPAREN<br />
<br />
;<br />
<br />
%%<br />
</pre></div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2157Грамматика языка Pascal2011-09-15T11:28:11Z<p>AlexHit: </p>
<hr />
<div>%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
<br />
<br />
%output=myyacc.cs <br />
<br />
<br />
%union { <br />
<br />
public double dVal; <br />
<br />
public string sVal; <br />
<br />
public int iVal; <br />
<br />
public ExprNode eVal;<br />
<br />
public List<ExprNode> elVal;<br />
<br />
public TreeNode tVal;<br />
<br />
public BlockNode lVal;<br />
<br />
public GreatType dtVal;<br />
<br />
public List<string> lsVal;<br />
<br />
}<br />
<br />
<br />
%using System.IO<br />
<br />
%using SimpleCompiler<br />
<br />
%namespace LexScanner<br />
<br />
<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kREPEAT kUNTIL kFOR kTO kDO kVAR kOF kARRAY<br />
<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON LQPAREN RQPAREN MPOINT POINT <br />
<br />
%token PLUS MINUS MULT DIVIDE <br />
<br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
<br />
%token <iVal> INTNUM <br />
<br />
%token <dVal> REALNUM <br />
<br />
%token <sVal> STRINGLITERAL<br />
<br />
%token <sVal> ID<br />
<br />
%token <dtVal> kREAL kINTEGER <br />
<br />
%type <iVal> funcid<br />
<br />
%type <eVal> expr funccall<br />
<br />
%type <tVal> stat elsepart<br />
<br />
%type <lVal> liststat progr<br />
<br />
%type <lsVal> listid <br />
<br />
%type <elVal> exprlist <br />
<br />
%type <dtVal> ktype kSimpleType<br />
<br />
<br />
<br />
%left LT GT LE GE EQ NE<br />
<br />
%left MINUS PLUS OR<br />
<br />
%left MULT DIVIDE AND DIV MOD<br />
<br />
%left UMINUS NOT<br />
<br />
<br />
%%<br />
<br />
progr : defss kBEGIN liststat kEND <br />
<br />
| error <br />
<br />
;<br />
<br />
defss : defs <br />
<br />
|defss defs<br />
<br />
|<br />
<br />
;<br />
<br />
defs : kVAR listid COLON ktype SEMICOLUMN <br />
<br />
; <br />
<br />
listid : ID <br />
<br />
|listid COLUMN ID <br />
<br />
;<br />
<br />
liststat : stat <br />
<br />
| liststat SEMICOLUMN stat <br />
<br />
;<br />
<br />
ktype : kSimpleType<br />
<br />
| error <br />
<br />
;<br />
<br />
kSimpleType : kREAL <br />
<br />
| kINTEGER <br />
<br />
;<br />
<br />
stat: { $$ = new Node(@$);}<br />
<br />
| ID ASSIGN expr <br />
<br />
| ID LQPAREN expr RQPAREN ASSIGN expr<br />
<br />
| kWHILE expr kDO stat<br />
<br />
| kIF expr kTHEN stat elsepart<br />
<br />
{<br />
<br />
$$ = new IfNode($2,$4,$5,@$);<br />
<br />
}<br />
<br />
| kBEGIN liststat kEND { $$ = $2;}<br />
<br />
;<br />
<br />
elsepart: {$$ = null;}<br />
<br />
| kELSE stat<br />
<br />
;<br />
<br />
exprlist : expr <br />
<br />
| exprlist COLUMN expr<br />
<br />
;<br />
<br />
expr: INTNUM<br />
<br />
| REALNUM <br />
<br />
| ID<br />
<br />
| ID LQPAREN expr RQPAREN <br />
<br />
| expr PLUS expr<br />
<br />
| expr MINUS expr <br />
<br />
| expr MULT expr <br />
<br />
| expr DIVIDE expr <br />
<br />
| expr DIV expr<br />
<br />
| expr MOD expr <br />
<br />
| expr AND expr<br />
<br />
| expr OR expr <br />
<br />
| expr LT expr<br />
<br />
| expr GT expr <br />
<br />
| expr LE expr <br />
<br />
| expr GE expr <br />
<br />
| expr EQ expr <br />
<br />
| expr NE expr <br />
<br />
| NOT expr <br />
<br />
| MINUS expr %prec UMINUS<br />
<br />
| LPAREN expr RPAREN<br />
<br />
;<br />
<br />
%%</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2152Грамматика языка Pascal2011-09-15T11:20:33Z<p>AlexHit: </p>
<hr />
<div>%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
<br />
<br />
%output=myyacc.cs <br />
<br />
<br />
%union { <br />
<br />
public double dVal; <br />
<br />
public string sVal; <br />
<br />
public int iVal; <br />
<br />
public ExprNode eVal;<br />
<br />
public List<ExprNode> elVal;<br />
<br />
public TreeNode tVal;<br />
<br />
public BlockNode lVal;<br />
<br />
public GreatType dtVal;<br />
<br />
public List<string> lsVal;<br />
<br />
}<br />
<br />
<br />
%using System.IO<br />
<br />
%using SimpleCompiler<br />
<br />
%namespace LexScanner<br />
<br />
<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kREPEAT kUNTIL kFOR kTO kDO kVAR kOF kARRAY<br />
<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON LQPAREN RQPAREN MPOINT POINT <br />
<br />
%token PLUS MINUS MULT DIVIDE <br />
<br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
<br />
%token <iVal> INTNUM <br />
<br />
%token <dVal> REALNUM <br />
<br />
%token <sVal> STRINGLITERAL<br />
<br />
%token <sVal> ID<br />
<br />
%token <dtVal> kREAL kINTEGER <br />
<br />
%type <iVal> funcid<br />
<br />
%type <eVal> expr funccall<br />
<br />
%type <tVal> stat elsepart<br />
<br />
%type <lVal> liststat progr<br />
<br />
%type <lsVal> listid <br />
<br />
%type <elVal> exprlist <br />
<br />
%type <dtVal> ktype kSimpleType<br />
<br />
<br />
<br />
%left LT GT LE GE EQ NE<br />
<br />
%left MINUS PLUS OR<br />
<br />
%left MULT DIVIDE AND DIV MOD<br />
<br />
%left UMINUS NOT<br />
<br />
<br />
%%<br />
<br />
progr : defss kBEGIN liststat kEND <br />
| error <br />
;<br />
<br />
defss : defs <br />
|defss defs<br />
|<br />
;<br />
<br />
defs : kVAR listid COLON ktype SEMICOLUMN <br />
; <br />
<br />
listid : ID <br />
|listid COLUMN ID <br />
;<br />
<br />
liststat : stat <br />
| liststat SEMICOLUMN stat <br />
;<br />
<br />
ktype : kSimpleType <br />
| error <br />
;<br />
<br />
kSimpleType : kREAL <br />
| kINTEGER <br />
;<br />
<br />
stat: { $$ = new Node(@$);}<br />
| ID ASSIGN expr <br />
| ID LQPAREN expr RQPAREN ASSIGN expr<br />
| kWHILE expr kDO stat<br />
| kIF expr kTHEN stat elsepart<br />
{<br />
$$ = new IfNode($2,$4,$5,@$);<br />
}<br />
| kBEGIN liststat kEND { $$ = $2;}<br />
;<br />
<br />
elsepart: {$$ = null;}<br />
| kELSE stat<br />
;<br />
<br />
exprlist : expr <br />
| exprlist COLUMN expr<br />
;<br />
<br />
expr: INTNUM<br />
| REALNUM <br />
| ID<br />
| ID LQPAREN expr RQPAREN <br />
| expr PLUS expr<br />
| expr MINUS expr <br />
| expr MULT expr <br />
| expr DIVIDE expr <br />
| expr DIV expr<br />
| expr MOD expr <br />
| expr AND expr<br />
| expr OR expr <br />
| expr LT expr<br />
| expr GT expr <br />
| expr LE expr <br />
| expr GE expr <br />
| expr EQ expr <br />
| expr NE expr <br />
| NOT expr <br />
| MINUS expr %prec UMINUS<br />
| LPAREN expr RPAREN<br />
;<br />
<br />
%%</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2151Грамматика языка Pascal2011-09-15T11:19:47Z<p>AlexHit: </p>
<hr />
<div>%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
<br />
<br />
%output=myyacc.cs <br />
<br />
<br />
%union { public double dVal; <br />
public string sVal; <br />
public int iVal; <br />
public ExprNode eVal;<br />
public List<ExprNode> elVal;<br />
public TreeNode tVal;<br />
public BlockNode lVal;<br />
public GreatType dtVal;<br />
public List<string> lsVal;}<br />
<br />
<br />
%using System.IO<br />
<br />
%using SimpleCompiler<br />
<br />
%namespace LexScanner<br />
<br />
<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kREPEAT kUNTIL kFOR kTO kDO kVAR kOF kARRAY<br />
<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON LQPAREN RQPAREN MPOINT POINT <br />
<br />
%token PLUS MINUS MULT DIVIDE <br />
<br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
<br />
%token <iVal> INTNUM <br />
<br />
%token <dVal> REALNUM <br />
<br />
%token <sVal> STRINGLITERAL<br />
<br />
%token <sVal> ID<br />
<br />
%token <dtVal> kREAL kINTEGER <br />
<br />
%type <iVal> funcid<br />
<br />
%type <eVal> expr funccall<br />
<br />
%type <tVal> stat elsepart<br />
<br />
%type <lVal> liststat progr<br />
<br />
%type <lsVal> listid <br />
<br />
%type <elVal> exprlist <br />
<br />
%type <dtVal> ktype kSimpleType<br />
<br />
<br />
<br />
%left LT GT LE GE EQ NE<br />
<br />
%left MINUS PLUS OR<br />
<br />
%left MULT DIVIDE AND DIV MOD<br />
<br />
%left UMINUS NOT<br />
<br />
<br />
%%<br />
<br />
progr : defss kBEGIN liststat kEND <br />
| error <br />
;<br />
<br />
defss : defs <br />
|defss defs<br />
|<br />
;<br />
<br />
defs : kVAR listid COLON ktype SEMICOLUMN <br />
; <br />
<br />
listid : ID <br />
|listid COLUMN ID <br />
;<br />
<br />
liststat : stat <br />
| liststat SEMICOLUMN stat <br />
;<br />
<br />
ktype : kSimpleType <br />
| error <br />
;<br />
<br />
kSimpleType : kREAL <br />
| kINTEGER <br />
;<br />
<br />
stat: { $$ = new Node(@$);}<br />
| ID ASSIGN expr <br />
| ID LQPAREN expr RQPAREN ASSIGN expr<br />
| kWHILE expr kDO stat<br />
| kIF expr kTHEN stat elsepart<br />
{<br />
$$ = new IfNode($2,$4,$5,@$);<br />
}<br />
| kBEGIN liststat kEND { $$ = $2;}<br />
;<br />
<br />
elsepart: {$$ = null;}<br />
| kELSE stat<br />
;<br />
<br />
exprlist : expr <br />
| exprlist COLUMN expr<br />
;<br />
<br />
expr: INTNUM<br />
| REALNUM <br />
| ID<br />
| ID LQPAREN expr RQPAREN <br />
| expr PLUS expr<br />
| expr MINUS expr <br />
| expr MULT expr <br />
| expr DIVIDE expr <br />
| expr DIV expr<br />
| expr MOD expr <br />
| expr AND expr<br />
| expr OR expr <br />
| expr LT expr<br />
| expr GT expr <br />
| expr LE expr <br />
| expr GE expr <br />
| expr EQ expr <br />
| expr NE expr <br />
| NOT expr <br />
| MINUS expr %prec UMINUS<br />
| LPAREN expr RPAREN<br />
;<br />
<br />
%%</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2150Грамматика языка Pascal2011-09-15T11:19:03Z<p>AlexHit: </p>
<hr />
<div>%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
<br />
<br />
%output=myyacc.cs <br />
<br />
<br />
%union { public double dVal; <br />
public string sVal; <br />
public int iVal; <br />
public ExprNode eVal;<br />
public List<ExprNode> elVal;<br />
public TreeNode tVal;<br />
public BlockNode lVal;<br />
public List<string> lsVal;<br />
public GreatType dtVal;<br />
}<br />
<br />
<br />
%using System.IO<br />
<br />
%using SimpleCompiler<br />
<br />
%namespace LexScanner<br />
<br />
<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kREPEAT kUNTIL kFOR kTO kDO kVAR kOF kARRAY<br />
<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON LQPAREN RQPAREN MPOINT POINT <br />
<br />
%token PLUS MINUS MULT DIVIDE <br />
<br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
<br />
%token <iVal> INTNUM <br />
<br />
%token <dVal> REALNUM <br />
<br />
%token <sVal> STRINGLITERAL<br />
<br />
%token <sVal> ID<br />
<br />
%token <dtVal> kREAL kINTEGER <br />
<br />
%type <iVal> funcid<br />
<br />
%type <eVal> expr funccall<br />
<br />
%type <tVal> stat elsepart<br />
<br />
%type <lVal> liststat progr<br />
<br />
%type <lsVal> listid <br />
<br />
%type <elVal> exprlist <br />
<br />
%type <dtVal> ktype kSimpleType<br />
<br />
<br />
<br />
%left LT GT LE GE EQ NE<br />
<br />
%left MINUS PLUS OR<br />
<br />
%left MULT DIVIDE AND DIV MOD<br />
<br />
%left UMINUS NOT<br />
<br />
<br />
%%<br />
<br />
progr : defss kBEGIN liststat kEND <br />
| error <br />
;<br />
<br />
defss : defs <br />
|defss defs<br />
|<br />
;<br />
<br />
defs : kVAR listid COLON ktype SEMICOLUMN <br />
; <br />
<br />
listid : ID <br />
|listid COLUMN ID <br />
;<br />
<br />
liststat : stat <br />
| liststat SEMICOLUMN stat <br />
;<br />
<br />
ktype : kSimpleType <br />
| error <br />
;<br />
<br />
kSimpleType : kREAL <br />
| kINTEGER <br />
;<br />
<br />
stat: { $$ = new Node(@$);}<br />
| ID ASSIGN expr <br />
| ID LQPAREN expr RQPAREN ASSIGN expr<br />
| kWHILE expr kDO stat<br />
| kIF expr kTHEN stat elsepart<br />
{<br />
$$ = new IfNode($2,$4,$5,@$);<br />
}<br />
| kBEGIN liststat kEND { $$ = $2;}<br />
;<br />
<br />
elsepart: {$$ = null;}<br />
| kELSE stat<br />
;<br />
<br />
exprlist : expr <br />
| exprlist COLUMN expr<br />
;<br />
<br />
expr: INTNUM<br />
| REALNUM <br />
| ID<br />
| ID LQPAREN expr RQPAREN <br />
| expr PLUS expr<br />
| expr MINUS expr <br />
| expr MULT expr <br />
| expr DIVIDE expr <br />
| expr DIV expr<br />
| expr MOD expr <br />
| expr AND expr<br />
| expr OR expr <br />
| expr LT expr<br />
| expr GT expr <br />
| expr LE expr <br />
| expr GE expr <br />
| expr EQ expr <br />
| expr NE expr <br />
| NOT expr <br />
| MINUS expr %prec UMINUS<br />
| LPAREN expr RPAREN<br />
;<br />
<br />
%%</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%93%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%D1%82%D0%B8%D0%BA%D0%B0_%D1%8F%D0%B7%D1%8B%D0%BA%D0%B0_Pascal&diff=2149Грамматика языка Pascal2011-09-15T11:18:19Z<p>AlexHit: Выложил грамматику языка Pascal</p>
<hr />
<div>%{<br />
Dictionary<string,double> vars = new Dictionary<string,double>();<br />
%}<br />
<br />
<br />
%output=myyacc.cs <br />
<br />
<br />
%union { public double dVal; <br />
public string sVal; <br />
public int iVal; <br />
public ExprNode eVal;<br />
public List<ExprNode> elVal;<br />
public TreeNode tVal;<br />
public BlockNode lVal;<br />
public List<string> lsVal;<br />
//public DataType dtVal.DType;<br />
public GreatType dtVal;<br />
}<br />
<br />
<br />
%using System.IO<br />
<br />
%using SimpleCompiler<br />
<br />
%namespace LexScanner<br />
<br />
<br />
%start progr<br />
<br />
%token kBEGIN kEND kIF kTHEN kELSE kWHILE kREPEAT kUNTIL kFOR kTO kDO kVAR kOF kARRAY<br />
<br />
%token ASSIGN SEMICOLUMN LPAREN RPAREN COLUMN COLON LQPAREN RQPAREN MPOINT POINT <br />
<br />
%token PLUS MINUS MULT DIVIDE <br />
<br />
%token AND OR NOT LT GT EQ NE LE GE DIV MOD<br />
<br />
%token <iVal> INTNUM <br />
<br />
%token <dVal> REALNUM <br />
<br />
%token <sVal> STRINGLITERAL<br />
<br />
%token <sVal> ID<br />
<br />
%token <dtVal> kREAL kINTEGER <br />
<br />
%type <iVal> funcid<br />
<br />
%type <eVal> expr funccall<br />
<br />
%type <tVal> stat elsepart<br />
<br />
%type <lVal> liststat progr<br />
<br />
%type <lsVal> listid <br />
<br />
%type <elVal> exprlist <br />
<br />
%type <dtVal> ktype kSimpleType<br />
<br />
<br />
<br />
%left LT GT LE GE EQ NE<br />
<br />
%left MINUS PLUS OR<br />
<br />
%left MULT DIVIDE AND DIV MOD<br />
<br />
%left UMINUS NOT<br />
<br />
<br />
%%<br />
<br />
progr : defss kBEGIN liststat kEND <br />
| error <br />
;<br />
<br />
defss : defs <br />
|defss defs<br />
|<br />
;<br />
<br />
defs : kVAR listid COLON ktype SEMICOLUMN <br />
; <br />
<br />
listid : ID <br />
|listid COLUMN ID <br />
;<br />
<br />
liststat : stat <br />
| liststat SEMICOLUMN stat <br />
;<br />
<br />
ktype : kSimpleType <br />
| error <br />
;<br />
<br />
kSimpleType : kREAL <br />
| kINTEGER <br />
;<br />
<br />
stat: { $$ = new Node(@$);}<br />
| ID ASSIGN expr <br />
| ID LQPAREN expr RQPAREN ASSIGN expr<br />
| kWHILE expr kDO stat<br />
| kIF expr kTHEN stat elsepart<br />
{<br />
$$ = new IfNode($2,$4,$5,@$);<br />
}<br />
| kBEGIN liststat kEND { $$ = $2;}<br />
;<br />
<br />
elsepart: {$$ = null;}<br />
| kELSE stat<br />
;<br />
<br />
exprlist : expr <br />
| exprlist COLUMN expr<br />
;<br />
<br />
expr: INTNUM<br />
| REALNUM <br />
| ID<br />
| ID LQPAREN expr RQPAREN <br />
| expr PLUS expr<br />
| expr MINUS expr <br />
| expr MULT expr <br />
| expr DIVIDE expr <br />
| expr DIV expr<br />
| expr MOD expr <br />
| expr AND expr<br />
| expr OR expr <br />
| expr LT expr<br />
| expr GT expr <br />
| expr LE expr <br />
| expr GE expr <br />
| expr EQ expr <br />
| expr NE expr <br />
| NOT expr <br />
| MINUS expr %prec UMINUS<br />
| LPAREN expr RPAREN<br />
;<br />
<br />
%%</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9C%D0%9F%D0%9E%D0%9A_2011&diff=2148МПОК 20112011-09-15T11:02:25Z<p>AlexHit: </p>
<hr />
<div>[[Роли в проекте и задания разработчикам 2011]]<br><br />
[[Грамматика языка Pascal]]</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9C%D0%9F%D0%9E%D0%9A_2011&diff=2147МПОК 20112011-09-15T11:02:12Z<p>AlexHit: </p>
<hr />
<div>[[Роли в проекте и задания разработчикам 2011]]<br />
[[Грамматика языка Pascal]]</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=1088Проект "MonoDevelop Add-in для PascalABC.NET"2009-12-08T13:38:19Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути.<br />
<br />
'''Архитектура приложения расширения.'''<br />
<br />
Приложение расширения, состоит как минимум из одной сборки выполнения и одной библиотеки. Mono.Addins основывается на так называемой сильно типизированной модели. Эта модель нуждается в точном объявлени всех точек расширения и иныормации их согласования. Вся эта информация составляет '''add-in root''' (корневой add-in).<br />
<br />
'''Add-in roots'''<br />
<br />
Приложения расширения доложны объявлять один, как минимум add-in root, но при необходимости могут объявлять и больше.Определив нсколько add-in roots для приложения состоящего из нескольких модулей. Это один из возможных путей, использования инструмента add-ins , основанный на специфике модулей приложения.например мощь инструмента приложении в логике, в одной сборке и GUI в другой. <br />
<br />
В порядке разрешения этих типов архитектуры, add-in roots должен иметь уникальный идентификатор.Add-ins должен ссылаться на этот ID(идентификатор add-in root).Add-in roots так же имеет номер версии, который используется для поддержания логичности между точками расширения, им используемыми, и расширения представляемых add-ins.<br />
<br />
Add-in roots могут связывать одну или несколько сборок, которые могут быть выполняемыми или библиотеками. Сложные приложения состоят обычно из нескольких сборок,поэтому важно тщательно определять, что является add-in root, а что нет.<br />
<br />
[картика]<br />
<br />
В данном примере приложение состоит из 2-х файлов: консольного и графического приложения.Приложение определяет 2 add-in roots:<br />
<br />
-Логический корень add-in содержит 2 сборки:Logic.dll and LogicHelper.dll.<br />
- GUI add-in root содержит только GUI библиотеку. <br />
<br />
Есть 2 основные причины включать сборку в add-in root:<br />
<br />
-Сборка определяет несколько классов или интерфейсов для применения add-ins.<br />
-Сборке необходимо загрузить остальные сборки add-in root.<br />
<br />
Mono.Addins обеспечивает несколько путей декларирования add-in roots и сборок, связывающих их. Это объясняет деталь описания Add-ins и Add-in Hosts секцию, но в кратце, существуют 3 способа: <br />
<br />
- Создание файла add-in manifest (XML файл с расширением .addin).<br />
- Создание файла add-in manifest и вставка сборок в ресурс.<br />
-Использование [assembly:AddinRoot] атрибутов для сборок.<br />
<br />
В первом и во втором случае, секция Runtime в manifest может использовать ссылку на сборки, включенных в add-in root.<br />
Во втором и третьем случае, различные сборки могут ссылаться на используемые атрибуты [assembly:AddinAssemblyInclude].<br />
<br />
Add-in roots обычно имеют главный файл. Когда используется одиночный манифест, главным файлом является манифест. Когда же используется манифест включенный в сборку, или использует атрибут [AddinRoot], главный файл сборки. Только главный файл может включать другие файлы в add-in root.<br />
<br />
<br />
'''Add-ins'''<br />
<br />
Add-ins во многом схожи с add-in roots, потому что add-in могут так же себя вести как add-in hosts для разных add-ins. Таким образом, add-ins могут содержать несколько сборок и других файлов,и они могут определить использование отдельных манифестов, и встроенных манифестов или применить атрибуты [assembly:Addin] для данных сборок.<br />
<br />
Данная диагрмма отображает add-in сборки и определенный другими add-in:<br />
<br />
Add-in roots и add-ins описывают использование разных Add-in моделей описания, но они обходятся разными инструментами.<br />
Add-in root assemblies загружают applications hosts использу "регулярные" сборки, пока add-ins are динамично обнаруженные и загруженные add-in инструментом.<br />
<br />
'''Extensible libraries'''<br />
Когда add-in root помещается в библиотеку, в результате мы получаем библиотеку расширения. Правильно в этом случае правильно инкапсулировать подход точек расширенпия к библиотеке.<br />
<br />
Таким образом, библиотека будет выглядеть как любая другая библиотека,и любое приложение будет иметь возможность использовать ее как любую другую библиотеку.<br />
<br />
Mono.Addins поддерживает несколько одинковых копий add-in root в разных местах. Когда загружается add-in root, the add-in engine будет заботитья о загрузке надстройки для данной версии и включит ее в нее..<br />
<br />
Например, допустим, кто-то реализующей общую библиотеку для разбора файлы с исходным кодом называется NParser. NParser обеспечит:<br />
<br />
- Общий API для разбора файлов.<br />
- Точка расширения для использования надстроек для добавления поддержки новых языков.<br />
<br />
Any application might be able to use NParser by just linking to it and distributing it as a private assembly, or using it from the GAC. In this case, add-ins for the library would be loaded from the global registry, unless the application specified a different add-in registry.<br />
<br />
<br />
Description of Add-ins and Add-in Roots<br />
<br />
Every add-in and add-in root has to provide a description of the extensibility elements it provides. There are two ways of doing this:<br />
<br />
* Using custom attributes: Mono.Addins provides several attributes which can be used to mark classes as extensions or extension points. Attributes can also be used to declare add-in information and dependencies.<br />
* Using an add-in manifest: a manifest is an XML description of an add-in. Attributes are very easy to use, but not all extensibility features that Mono.Addins provides can be expressed using attributes. Any declaration that can be done using custom attributes can also be done in a manifest, but not everything that can be declared in a manifest can also be expressed using custom attributes. Manifests can be deployed as standalone files, or they can be embedded as a resource in assemblies. Manifest files are identified by their extension, which must be ".addin" or ".addin.xml". <br />
<br />
It is allowed to use a mix of both approaches to describe an add-in. That is, an add-in could declare simple extensions using attributes, and more complex extensions in a manifest embedded as a resource.<br />
<br />
As you can see from the previous examples, the description of an add-in root looks similar to the description of an add-in. In fact, from the point of view of the add-in engine, add-ins and add-in roots are almost the same, so they use the same description model.<br />
<br />
The following sections describe in detail all information that can be included in an add-in or add-in root description. The term add-in is used generically in this chapter to refer to add-ins and add-in roots, unless specifically differenced.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=1087Проект "MonoDevelop Add-in для PascalABC.NET"2009-12-07T22:00:59Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути.<br />
<br />
'''Архитектура приложения расширения.'''<br />
<br />
Приложение расширения, состоит как минимум из одной сборки выполнения и одной библиотеки. Mono.Addins основывается на так называемой сильно типизированной модели. Эта модель нуждается в точном объявлени всех точек расширения и иныормации их согласования. Вся эта информация составляет '''add-in root''' (корневой add-in).<br />
<br />
'''Add-in roots'''<br />
<br />
Приложения расширения доложны объявлять один, как минимум add-in root, но при необходимости могут объявлять и больше.Определив нсколько add-in roots для приложения состоящего из нескольких модулей. Это один из возможных путей, использования инструмента add-ins , основанный на специфике модулей приложения.например мощь инструмента приложении в логике, в одной сборке и GUI в другой. <br />
<br />
В порядке разрешения этих типов архитектуры, add-in roots должен иметь уникальный идентификатор.Add-ins должен ссылаться на этот ID(идентификатор add-in root).Add-in roots так же имеет номер версии, который используется для поддержания логичности между точками расширения, им используемыми, и расширения представляемых add-ins.<br />
<br />
Add-in roots могут связывать одну или несколько сборок, которые могут быть выполняемыми или библиотеками. Сложные приложения состоят обычно из нескольких сборок,поэтому важно тщательно определять, что является add-in root, а что нет.<br />
<br />
[картика]<br />
<br />
В данном примере приложение состоит из 2-х файлов: консольного и графического приложения.Приложение определяет 2 add-in roots:<br />
<br />
-Логический корень add-in содержит 2 сборки:Logic.dll and LogicHelper.dll.<br />
- GUI add-in root содержит только GUI библиотеку. <br />
<br />
Есть 2 основные причины включать сболрку в add-in root:<br />
<br />
-Сборка определяет несколько классов или интерфейсов для применения add-ins.<br />
-Сборке необходимо загрузить остальные сборки add-in root.<br />
<br />
Mono.Addins обеспечивает несколько путей декларирования add-in roots и сборок, связывающих их. Это объясняет деталь описания Add-ins и Add-in Hosts секцию, но в кратце, существуют 3 способа: <br />
<br />
- Создание файла add-in manifest (XML файл с расширением .addin).<br />
- Создание файла add-in manifest и вставка сборок в ресурс.<br />
-Использование [assembly:AddinRoot] атрибутов для сборок.<br />
<br />
В первом и во втором случае, секция Runtime в manifest может использовать ссылку на сборки, включенных в add-in root.<br />
Во втором и третьем случае, различные сборки могут ссылаться на используемые атрибуты [assembly:AddinAssemblyInclude].<br />
<br />
Add-in roots обычно имеют главный файл. Когда используется одиночный манифест, главным файлом является манифест. Когда же используется манифест включенный в сборку, или использует атрибут [AddinRoot], главный файл сборки. Только главный файл может включать другие файлы в add-in root.<br />
<br />
<br />
'''Add-ins'''<br />
<br />
Add-ins во многом схожи с add-in roots, потому что add-in могут так же себя вести как add-in hosts для разных add-ins. Таким образом, add-ins могут содержать несколько сборок и других файлов,и они могут определить использование отдельных манифестов, и встроенных манифестов или применить атрибуты [assembly:Addin] для данных сборок.<br />
<br />
Данная диагрмма отображает add-in сборки и определенный другими add-in:<br />
<br />
Add-in roots и add-ins описывают использование разных Add-in моделей описания, но они обходятся разными инструментами.<br />
Add-in root assemblies загружают applications hosts использу "регулярные" сборки, пока add-ins are динамично обнаруженные и загруженные add-in инструментом.<br />
<br />
'''Extensible libraries'''<br />
<br />
When an add-in root is entirely composed by libraries, what we have in fact is an extensible library. It is important in this case to properly encapsulate the access to extension points in the library. In this way the library will look like any other regular library, and any application will be able to use it like any other library.<br />
<br />
Mono.Addins supports having several copies of the same add-in root in different locations. When loading an add-in root, the add-in engine will take care of loading the add-ins that extend that specific add-in root version.<br />
<br />
For example, let's say somebody implements a generic library for parsing source code files called NParser. NParser would provide:<br />
<br />
* A common API for parsing files.<br />
* An extension point to be used by add-ins to add support for new languages. <br />
<br />
Any application might be able to use NParser by just linking to it and distributing it as a private assembly, or using it from the GAC. In this case, add-ins for the library would be loaded from the global registry, unless the application specified a different add-in registry.<br />
<br />
<br />
Description of Add-ins and Add-in Roots<br />
<br />
Every add-in and add-in root has to provide a description of the extensibility elements it provides. There are two ways of doing this:<br />
<br />
* Using custom attributes: Mono.Addins provides several attributes which can be used to mark classes as extensions or extension points. Attributes can also be used to declare add-in information and dependencies.<br />
* Using an add-in manifest: a manifest is an XML description of an add-in. Attributes are very easy to use, but not all extensibility features that Mono.Addins provides can be expressed using attributes. Any declaration that can be done using custom attributes can also be done in a manifest, but not everything that can be declared in a manifest can also be expressed using custom attributes. Manifests can be deployed as standalone files, or they can be embedded as a resource in assemblies. Manifest files are identified by their extension, which must be ".addin" or ".addin.xml". <br />
<br />
It is allowed to use a mix of both approaches to describe an add-in. That is, an add-in could declare simple extensions using attributes, and more complex extensions in a manifest embedded as a resource.<br />
<br />
As you can see from the previous examples, the description of an add-in root looks similar to the description of an add-in. In fact, from the point of view of the add-in engine, add-ins and add-in roots are almost the same, so they use the same description model.<br />
<br />
The following sections describe in detail all information that can be included in an add-in or add-in root description. The term add-in is used generically in this chapter to refer to add-ins and add-in roots, unless specifically differenced.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=1086Проект "MonoDevelop Add-in для PascalABC.NET"2009-12-07T21:24:07Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути.<br />
<br />
'''Архитектура приложения расширения.'''<br />
<br />
Приложение расширения, состоит как минимум из одной сборки выполнения и одной библиотеки. Mono.Addins основывается на так называемой сильно типизированной модели. Эта модель нуждается в точном объявлени всех точек расширения и иныормации их согласования. Вся эта информация составляет '''add-in root''' (корневой add-in).<br />
<br />
'''Add-in roots'''<br />
<br />
Приложения расширения доложны объявлять один, как минимум add-in root, но при необходимости могут объявлять и больше.Определив нсколько add-in roots для приложения состоящего из нескольких модулей. Это один из возможных путей, использования инструмента add-ins , основанный на специфике модулей приложения.например мощь инструмента приложении в логике, в одной сборке и GUI в другой. <br />
<br />
В порядке разрешения этих типов архитектуры, add-in roots должен иметь уникальный идентификатор.Add-ins должен ссылаться на этот ID(идентификатор add-in root).Add-in roots так же имеет номер версии, который используется для поддержания логичности между точками расширения, им используемыми, и расширения представляемых add-ins.<br />
<br />
Add-in roots могут связывать одну или несколько сборок, которые могут быть выполняемыми или библиотеками. Сложные приложения состоят обычно из нескольких сборок,поэтому важно тщательно определять, что является add-in root, а что нет.<br />
<br />
[картика]<br />
<br />
В данном примере приложение состоит из 2-х файлов: консольного и графического приложения.Приложение определяет 2 add-in roots:<br />
<br />
-Логический корень add-in содержит 2 сборки:Logic.dll and LogicHelper.dll.<br />
- GUI add-in root содержит только GUI библиотеку. <br />
<br />
Есть 2 основные причины включать сболрку в add-in root:<br />
<br />
-Сборка определяет несколько классов или интерфейсов для применения add-ins.<br />
-Сборке необходимо загрузить остальные сборки add-in root.<br />
<br />
Mono.Addins обеспечивает несколько путей декларирования add-in roots и сборок, связывающих их. Это объясняет деталь описания Add-ins и Add-in Hosts секцию, но в кратце, существуют 3 способа: <br />
<br />
- Создание файла add-in manifest (XML файл с расширением .addin).<br />
- Создание файла add-in manifest и вставка сборок в ресурс.<br />
-Использование [assembly:AddinRoot] атрибутов для сборок.<br />
<br />
В первом и во втором случае, секция Runtime в manifest может использовать ссылку на сборки, включенных в add-in root.<br />
Во втором и третьем случае, различные сборки могут ссылаться на используемые атрибуты [assembly:AddinAssemblyInclude].<br />
<br />
Add-in roots обычно имеют главный файл. Когда используется одиночный манифест, главным файлом является манифест. Когда же используется манифест включенный в сборку, или использует атрибут [AddinRoot], главный файл сборки. Только главный файл может включать другие файлы в add-in root.<br />
<br />
<br />
'''Add-ins'''<br />
<br />
Add-ins have many similarities to add-in roots, because add-ins can also behave as add-in hosts for other add-ins. So, add-ins can be composed by several assemblies and other files, and they can be described using a standalone manifest, and embedded manifest or by applying the [assembly:Addin] attribute to an assembly.<br />
<br />
The following diagram shows an add-in composed by two assemblies, and extended by another add-in:<br />
<br />
Add-in roots and add-ins are described using the same Add-in Description Model, but they are handled differently by the add-in engine. Add-in root assemblies are loaded by applications hosts like regular assemblies, while add-ins are dynamically discovered and loaded by the add-in engine.<br />
Extensible libraries<br />
<br />
When an add-in root is entirely composed by libraries, what we have in fact is an extensible library. It is important in this case to properly encapsulate the access to extension points in the library. In this way the library will look like any other regular library, and any application will be able to use it like any other library.<br />
<br />
Mono.Addins supports having several copies of the same add-in root in different locations. When loading an add-in root, the add-in engine will take care of loading the add-ins that extend that specific add-in root version.<br />
<br />
For example, let's say somebody implements a generic library for parsing source code files called NParser. NParser would provide:<br />
<br />
* A common API for parsing files.<br />
* An extension point to be used by add-ins to add support for new languages. <br />
<br />
Any application might be able to use NParser by just linking to it and distributing it as a private assembly, or using it from the GAC. In this case, add-ins for the library would be loaded from the global registry, unless the application specified a different add-in registry.<br />
<br />
<br />
Description of Add-ins and Add-in Roots<br />
<br />
Every add-in and add-in root has to provide a description of the extensibility elements it provides. There are two ways of doing this:<br />
<br />
* Using custom attributes: Mono.Addins provides several attributes which can be used to mark classes as extensions or extension points. Attributes can also be used to declare add-in information and dependencies.<br />
* Using an add-in manifest: a manifest is an XML description of an add-in. Attributes are very easy to use, but not all extensibility features that Mono.Addins provides can be expressed using attributes. Any declaration that can be done using custom attributes can also be done in a manifest, but not everything that can be declared in a manifest can also be expressed using custom attributes. Manifests can be deployed as standalone files, or they can be embedded as a resource in assemblies. Manifest files are identified by their extension, which must be ".addin" or ".addin.xml". <br />
<br />
It is allowed to use a mix of both approaches to describe an add-in. That is, an add-in could declare simple extensions using attributes, and more complex extensions in a manifest embedded as a resource.<br />
<br />
As you can see from the previous examples, the description of an add-in root looks similar to the description of an add-in. In fact, from the point of view of the add-in engine, add-ins and add-in roots are almost the same, so they use the same description model.<br />
<br />
The following sections describe in detail all information that can be included in an add-in or add-in root description. The term add-in is used generically in this chapter to refer to add-ins and add-in roots, unless specifically differenced.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=1085Проект "MonoDevelop Add-in для PascalABC.NET"2009-12-07T21:16:49Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути.<br />
<br />
'''Архитектура приложения расширения.'''<br />
<br />
Приложение расширения, состоит как минимум из одной сборки выполнения и одной библиотеки. Mono.Addins основывается на так называемой сильно типизированной модели. Эта модель нуждается в точном объявлени всех точек расширения и иныормации их согласования. Вся эта информация составляет '''add-in root''' (корневой add-in).<br />
<br />
'''Add-in roots'''<br />
<br />
Приложения расширения доложны объявлять один, как минимум add-in root, но при необходимости могут объявлять и больше.Определив нсколько add-in roots для приложения состоящего из нескольких модулей. Это один из возможных путей, использования инструмента add-ins , основанный на специфике модулей приложения.например мощь инструмента приложении в логике, в одной сборке и GUI в другой. <br />
<br />
В порядке разрешения этих типов архитектуры, add-in roots должен иметь уникальный идентификатор.Add-ins должен ссылаться на этот ID(идентификатор add-in root).Add-in roots так же имеет номер версии, который используется для поддержания логичности между точками расширения, им используемыми, и расширения представляемых add-ins.<br />
<br />
Add-in roots могут связывать одну или несколько сборок, которые могут быть выполняемыми или библиотеками. Сложные приложения состоят обычно из нескольких сборок,поэтому важно тщательно определять, что является add-in root, а что нет.<br />
<br />
[картика]<br />
<br />
В данном примере приложение состоит из 2-х файлов: консольного и графического приложения.Приложение определяет 2 add-in roots:<br />
<br />
-Логический корень add-in содержит 2 сборки:Logic.dll and LogicHelper.dll.<br />
- GUI add-in root содержит только GUI библиотеку. <br />
<br />
Есть 2 основные причины включать сболрку в add-in root:<br />
<br />
-Сборка определяет несколько классов или интерфейсов для применения add-ins.<br />
-Сборке необходимо загрузить остальные сборки add-in root.<br />
<br />
Mono.Addins обеспечивает несколько путей декларирования add-in roots и сборок, связывающих их. Это объясняет деталь описания Add-ins и Add-in Hosts секцию, но в кратце, существуют 3 способа: <br />
<br />
- Создание файла add-in manifest (XML файл с расширением .addin).<br />
- Создание файла add-in manifest и вставка сборок в ресурс.<br />
-Использование [assembly:AddinRoot] атрибутов для сборок.<br />
<br />
В первом и во втором случае, секция Runtime в manifest может использовать ссылку на сборки, включенных в add-in root.<br />
Во втором и третьем случае, различные сборки могут ссылаться на используемые атрибуты [assembly:AddinAssemblyInclude].<br />
<br />
Add-in roots обычно имеют главный файл. Когда используется одиночный манифест, главным файлом является манифест. Когда же используется манифест включенный в сборку, или использует атрибут [AddinRoot], главный файл сборки. Только главный файл может включать другие файлы в add-in root.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=1084Проект "MonoDevelop Add-in для PascalABC.NET"2009-12-07T20:59:21Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути.<br />
<br />
'''Архитектура приложения расширения.'''<br />
<br />
Приложение расширения, состоит как минимум из одной сборки выполнения и одной библиотеки. Mono.Addins основывается на так называемой сильно типизированной модели. Эта модель нуждается в точном объявлени всех точек расширения и иныормации их согласования. Вся эта информация составляет '''add-in root''' (корневой add-in).<br />
<br />
'''Add-in roots'''<br />
<br />
Приложения расширения доложны объявлять один, как минимум add-in root, но при необходимости могут объявлять и больше.Определив нсколько add-in roots для приложения состоящего из нескольких модулей. Это один из возможных путей, использования инструмента add-ins , основанный на специфике модулей приложения.например мощь инструмента приложении в логике, в одной сборке и GUI в другой. <br />
<br />
В порядке разрешения этих типов архитектуры, add-in roots должен иметь уникальный идентификатор.Add-ins должен ссылаться на этот ID(идентификатор add-in root).Add-in roots так же имеет номер версии, который используется для поддержания логичности между точками расширения, им используемыми, и расширения представляемых add-ins.<br />
<br />
Add-in roots могут связывать одну или несколько сборок, которые могут быть выполняемыми или библиотеками. Сложные приложения состоят обычно из нескольких сборок,поэтому важно тщательно определять, что является add-in root, а что нет.<br />
<br />
[картика]<br />
<br />
В данном примере приложение состоит из 2-х файлов: консольного и графического приложения.Приложение определяет 2 add-in roots:<br />
<br />
-Логический корень add-in содержит 2 сборки:Logic.dll and LogicHelper.dll.<br />
- GUI add-in root содержит только GUI библиотеку. <br />
<br />
Есть 2 основные причины включать сболрку в add-in root:<br />
<br />
-Сборка определяет несколько классов или интерфейсов для применения add-ins.<br />
-Сборке необходимо загрузить остальные сборки add-in root.<br />
<br />
Mono.Addins обеспечивает несколько путей декларирования add-in roots и сборок, связывающих их. Это объясняет деталь описания Add-ins и Add-in Hosts секцию, но в кратце, существуют 3 способа: <br />
<br />
- Создание файла add-in manifest (XML файл с расширением .addin).<br />
- Создание файла add-in manifest и вставка сборок в ресурс.<br />
-Использование [assembly:AddinRoot] атрибутов для сборок.<br />
<br />
In the first and second case, a Runtime section in the manifest can be used to reference other assemblies to be included in the add-in root. In the second and third case, other assemblies can be referenced using the attribute [assembly:AddinAssemblyInclude].<br />
<br />
Add-in roots always have a main file. When using an standalone manifest, the main file is the manifest file. When using a manifest embedded in an assembly, or when using the [AddinRoot] attribute, the main file is the assembly. Only the main file can include other files in the add-in root.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=1083Проект "MonoDevelop Add-in для PascalABC.NET"2009-12-07T20:52:56Z<p>AlexHit: -</p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути.<br />
<br />
'''Архитектура приложения расширения.'''<br />
<br />
Приложение расширения, состоит как минимум из одной сборки выполнения и одной библиотеки. Mono.Addins основывается на так называемой сильно типизированной модели. Эта модель нуждается в точном объявлени всех точек расширения и иныормации их согласования. Вся эта информация составляет '''add-in root''' (корневой add-in).<br />
<br />
'''Add-in roots'''<br />
<br />
Приложения расширения доложны объявлять один, как минимум add-in root, но при необходимости могут объявлять и больше.Определив нсколько add-in roots для приложения состоящего из нескольких модулей. Это один из возможных путей, использования инструмента add-ins , основанный на специфике модулей приложения.например мощь инструмента приложении в логике, в одной сборке и GUI в другой. <br />
<br />
В порядке разрешения этих типов архитектуры, add-in roots должен иметь уникальный идентификатор.Add-ins должен ссылаться на этот ID(идентификатор add-in root).Add-in roots так же имеет номер версии, который используется для поддержания логичности между точками расширения, им используемыми, и расширения представляемых add-ins.<br />
<br />
Add-in roots могут связывать одну или несколько сборок, которые могут быть выполняемыми или библиотеками. Сложные приложения состоят обычно из нескольких сборок,поэтому важно тщательно определять, что является add-in root, а что нет.<br />
<br />
[картика]<br />
<br />
В данном примере приложение состоит из 2-х файлов: консольного и графического приложения.Приложение определяет 2 add-in roots:<br />
<br />
-Логический корень add-in содержит 2 сборки:Logic.dll and LogicHelper.dll.<br />
- GUI add-in root содержит только GUI библиотеку. <br />
<br />
Есть 2 основные причины включать сболрку в add-in root:<br />
<br />
-Сборка определяет несколько классов или интерфейсов для применения add-ins.<br />
-Сборке необходимо загрузить остальные сборки add-in root.<br />
<br />
Mono.Addins обеспечивает несколько путей декларирования add-in roots и сборок, связывающих их. Это объясняет деталь описания Add-ins и Add-in Hosts секцию, но в кратце, существуют 3 способа: <br />
<br />
-<br />
* By creating an add-in manifest file (an XML file with a .addin extension).<br />
* By creating an add-in manifest file and embedding it in an assembly as a resource.<br />
* By applying the [assembly:AddinRoot] attribute to an assembly. <br />
<br />
In the first and second case, a Runtime section in the manifest can be used to reference other assemblies to be included in the add-in root. In the second and third case, other assemblies can be referenced using the attribute [assembly:AddinAssemblyInclude].<br />
<br />
Add-in roots always have a main file. When using an standalone manifest, the main file is the manifest file. When using a manifest embedded in an assembly, or when using the [AddinRoot] attribute, the main file is the assembly. Only the main file can include other files in the add-in root.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=1082Проект "MonoDevelop Add-in для PascalABC.NET"2009-12-07T20:35:39Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути.<br />
<br />
'''Архитектура приложения расширения.'''<br />
<br />
Приложение расширения, состоит как минимум из одной сборки выполнения и одной библиотеки. Mono.Addins основывается на так называемой сильно типизированной модели. Эта модель нуждается в точном объявлени всех точек расширения и иныормации их согласования. Вся эта информация составляет '''add-in root''' (корневой add-in).<br />
<br />
'''Add-in roots'''<br />
<br />
Приложения расширения доложны объявлять один, как минимум add-in root, но при необходимости могут объявлять и больше.Определив нсколько add-in roots для приложения состоящего из нескольких модулей. Это один из возможных путей, использования инструмента add-ins , основанный на специфике модулей приложения.например мощь инструмента приложении в логике, в одной сборке и GUI в другой. <br />
<br />
В порядке разрешения этих типов архитектуры, add-in roots должен иметь уникальный идентификатор.Add-ins должен ссылаться на этот ID(идентификатор add-in root).Add-in roots так же имеет номер версии, который используется для поддержания логичности между точками расширения, им используемыми, и расширения представляемых add-ins.<br />
<br />
Add-in roots могут связывать одну или несколько сборок, которые могут быть выполняемыми или библиотеками. Сложные приложения состоят обычно из нескольких сборок,поэтому важно тщательно определять, что является add-in root, а что нет.<br />
<br />
[картика]<br />
<br />
В данном примере приложение состоит из 2-х файлов: консольного и графического приложения.Приложение определяет 2 add-in roots:<br />
<br />
<br />
* The Logic add-in root is composed by two assemblies: Logic.dll and LogicHelper.dll. Since both assemblies are libraries, they can be reused from the console and the gui exes.<br />
* The GUI add-in root is composed only by the GUI library. <br />
<br />
There are basically two reasons for including an assembly in an add-in root:<br />
<br />
* The assembly defines some classes or interfaces to be implemented by add-ins.<br />
* The assembly is required to load other add-in root assemblies. <br />
<br />
Mono.Addins provides several ways of declaring add-in roots and the assemblies they are bound to. This is explained in detail in the Description of Add-ins and Add-in Hosts section, but summarizing, there are three ways:<br />
<br />
* By creating an add-in manifest file (an XML file with a .addin extension).<br />
* By creating an add-in manifest file and embedding it in an assembly as a resource.<br />
* By applying the [assembly:AddinRoot] attribute to an assembly. <br />
<br />
In the first and second case, a Runtime section in the manifest can be used to reference other assemblies to be included in the add-in root. In the second and third case, other assemblies can be referenced using the attribute [assembly:AddinAssemblyInclude].<br />
<br />
Add-in roots always have a main file. When using an standalone manifest, the main file is the manifest file. When using a manifest embedded in an assembly, or when using the [AddinRoot] attribute, the main file is the assembly. Only the main file can include other files in the add-in root.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=1081Проект "MonoDevelop Add-in для PascalABC.NET"2009-12-07T20:18:48Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути.<br />
<br />
'''Архитектура приложения расширения.'''<br />
<br />
Приложение расширения, состоит как минимум из одной сборки выполнения и одной библиотеки. Mono.Addins основывается на так называемой сильно типизированной модели. Эта модель нуждается в точном объявлени всех точек расширения и иныормации их согласования. Вся эта информация составляет '''add-in root''' (корневой add-in).<br />
<br />
'''Add-in roots'''<br />
<br />
Приложения расширения доложны объявлять один, как минимум add-in root, но при необходимости могут объявлять и больше.Определив нсколько add-in roots для приложения состоящего из нескольких модулей. Это один из возможных путей, использования инструмента add-ins , основанный на специфике модулей приложения.например мощь инструмента приложении в логике, в одной сборке и GUI в другой. <br />
<br />
В порядке разрешения этих типов архитектуры, add-in roots должен иметь уникальный идентификатор.Add-ins должен ссылаться на этот ID(идентификатор add-in root).Add-in roots так же имеет номер версии, который используется для поддержания логичности между точками расширения, им используемыми, и расширения представляемых add-ins.<br />
<br />
Add-in roots могут связывать одну или несколько сборок, которые могут быть выполняемыми или библиотеками. Сложные приложения состоят обычно из нескольких сборок,поэтому важно тщательно определять, что является add-in root, а что нет.<br />
<br />
<br />
In this example, an application is composed by two executables: a console app and a graphical app. Both executables share the same logic libraries, and the GUI app has a GUI library and a components library. The application defines two add-in roots:<br />
<br />
* The Logic add-in root is composed by two assemblies: Logic.dll and LogicHelper.dll. Since both assemblies are libraries, they can be reused from the console and the gui exes.<br />
* The GUI add-in root is composed only by the GUI library. <br />
<br />
There are basically two reasons for including an assembly in an add-in root:<br />
<br />
* The assembly defines some classes or interfaces to be implemented by add-ins.<br />
* The assembly is required to load other add-in root assemblies. <br />
<br />
Mono.Addins provides several ways of declaring add-in roots and the assemblies they are bound to. This is explained in detail in the Description of Add-ins and Add-in Hosts section, but summarizing, there are three ways:<br />
<br />
* By creating an add-in manifest file (an XML file with a .addin extension).<br />
* By creating an add-in manifest file and embedding it in an assembly as a resource.<br />
* By applying the [assembly:AddinRoot] attribute to an assembly. <br />
<br />
In the first and second case, a Runtime section in the manifest can be used to reference other assemblies to be included in the add-in root. In the second and third case, other assemblies can be referenced using the attribute [assembly:AddinAssemblyInclude].<br />
<br />
Add-in roots always have a main file. When using an standalone manifest, the main file is the manifest file. When using a manifest embedded in an assembly, or when using the [AddinRoot] attribute, the main file is the assembly. Only the main file can include other files in the add-in root.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=1080Проект "MonoDevelop Add-in для PascalABC.NET"2009-12-07T20:15:01Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути.<br />
<br />
'''Архитектура приложения расширения.'''<br />
<br />
Приложение расширения, состоит как минимум из одной сборки выполнения и одной библиотеки. Mono.Addins основывается на так называемой сильно типизированной модели. Эта модель нуждается в точном объявлени всех точек расширения и иныормации их согласования. Вся эта информация составляет '''add-in root''' (корневой add-in).<br />
<br />
'''Add-in roots'''<br />
<br />
Приложения расширения доложны объявлять один, как минимум add-in root, но при необходимости могут объявлять и больше.Определив нсколько add-in roots для приложения состоящего из нескольких модулей. Это один из возможных путей, использования инструмента add-ins , основанный на специфике модулей приложения.например мощь инструмента приложении в логике, в одной сборке и GUI в другой. <br />
<br />
В порядке разрешения этих типов архитектуры, add-in roots должен иметь уникальный идентификатор.Add-ins должен ссылаться на этот ID(идентификатор add-in root).Add-in roots так же имеет номер версии, который используется для поддержания логичности между точками расширения, им используемыми, и расширения представляемых add-ins.<br />
<br />
<br />
Add-in roots can be bound to one or more assemblies, which can be executables or libraries. Complex applications are usually composed by several assemblies, so it is important to carefully decide what constitutes an add-in root and what not. <br />
<br />
In this example, an application is composed by two executables: a console app and a graphical app. Both executables share the same logic libraries, and the GUI app has a GUI library and a components library. The application defines two add-in roots:<br />
<br />
* The Logic add-in root is composed by two assemblies: Logic.dll and LogicHelper.dll. Since both assemblies are libraries, they can be reused from the console and the gui exes.<br />
* The GUI add-in root is composed only by the GUI library. <br />
<br />
There are basically two reasons for including an assembly in an add-in root:<br />
<br />
* The assembly defines some classes or interfaces to be implemented by add-ins.<br />
* The assembly is required to load other add-in root assemblies. <br />
<br />
Mono.Addins provides several ways of declaring add-in roots and the assemblies they are bound to. This is explained in detail in the Description of Add-ins and Add-in Hosts section, but summarizing, there are three ways:<br />
<br />
* By creating an add-in manifest file (an XML file with a .addin extension).<br />
* By creating an add-in manifest file and embedding it in an assembly as a resource.<br />
* By applying the [assembly:AddinRoot] attribute to an assembly. <br />
<br />
In the first and second case, a Runtime section in the manifest can be used to reference other assemblies to be included in the add-in root. In the second and third case, other assemblies can be referenced using the attribute [assembly:AddinAssemblyInclude].<br />
<br />
Add-in roots always have a main file. When using an standalone manifest, the main file is the manifest file. When using a manifest embedded in an assembly, or when using the [AddinRoot] attribute, the main file is the assembly. Only the main file can include other files in the add-in root.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=1079Проект "MonoDevelop Add-in для PascalABC.NET"2009-12-07T19:54:06Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути.<br />
<br />
'''Архитектура приложения расширения.'''<br />
<br />
Приложение расширения, состоит как минимум из одной сборки выполнения и одной библиотеки. Mono.Addins основывается на так называемой сильно типизированной модели. Эта модель нуждается в точном объявлени всех точек расширения и иныормации их согласования. Вся эта информация составляет '''add-in root''' (корневой add-in).<br />
<br />
'''Add-in roots'''<br />
<br />
Приложения расширения доложны объявлять один, как минимум add-in root, но при необходимости могут объявлять и больше.Определив нсколько add-in roots для приложения состоящего из нескольких модулей. Это один из возможных путей, использования инструмента add-ins , основанный на специфике модулей приложения.например мощь инструмента приложении в логике, в одной сборке и GUI в другой. <br />
<br />
<br />
<br />
In order to allow this kind of architectures, add-in roots must have an unique identifier. Add-ins must then specify the add-in root(s) they extend by referencing this ID. Add-in roots also have a version number, which is used to ensure consistency between the extension points they provide, and the extensions provided by add-ins.<br />
<br />
Add-in roots can be bound to one or more assemblies, which can be executables or libraries. Complex applications are usually composed by several assemblies, so it is important to carefully decide what constitutes an add-in root and what not. <br />
<br />
In this example, an application is composed by two executables: a console app and a graphical app. Both executables share the same logic libraries, and the GUI app has a GUI library and a components library. The application defines two add-in roots:<br />
<br />
* The Logic add-in root is composed by two assemblies: Logic.dll and LogicHelper.dll. Since both assemblies are libraries, they can be reused from the console and the gui exes.<br />
* The GUI add-in root is composed only by the GUI library. <br />
<br />
There are basically two reasons for including an assembly in an add-in root:<br />
<br />
* The assembly defines some classes or interfaces to be implemented by add-ins.<br />
* The assembly is required to load other add-in root assemblies. <br />
<br />
Mono.Addins provides several ways of declaring add-in roots and the assemblies they are bound to. This is explained in detail in the Description of Add-ins and Add-in Hosts section, but summarizing, there are three ways:<br />
<br />
* By creating an add-in manifest file (an XML file with a .addin extension).<br />
* By creating an add-in manifest file and embedding it in an assembly as a resource.<br />
* By applying the [assembly:AddinRoot] attribute to an assembly. <br />
<br />
In the first and second case, a Runtime section in the manifest can be used to reference other assemblies to be included in the add-in root. In the second and third case, other assemblies can be referenced using the attribute [assembly:AddinAssemblyInclude].<br />
<br />
Add-in roots always have a main file. When using an standalone manifest, the main file is the manifest file. When using a manifest embedded in an assembly, or when using the [AddinRoot] attribute, the main file is the assembly. Only the main file can include other files in the add-in root.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=1078Проект "MonoDevelop Add-in для PascalABC.NET"2009-12-07T19:38:29Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути.<br />
<br />
'''Архитектура приложения расширения.'''<br />
<br />
Приложение расширения, состоит как минимум из одной сборки выполнения и одной библиотеки. Mono.Addins основывается на так называемой сильно типизированной модели. Эта модель нуждается в точном объявлени всех точек расширения и иныормации их согласования. Вся эта информация составляет '''add-in root''' (корневой add-in).<br />
<br />
'''Add-in roots'''<br />
<br />
Extensible applications must declare one add-in root, but they can also declare more than one. Defining several add-in roots is useful for applications composed by several modules. In this way it is possible to implement add-ins which target specific modules of the application. For example, an application might implement some logic in one assembly and the GUI in another assembly. In this way it would be possible to build add-ins for extending the logic (with no GUI dependencies), and add-ins for extending the GUI, or add-ins extending both: <br />
<br />
n order to allow this kind of architectures, add-in roots must have an unique identifier. Add-ins must then specify the add-in root(s) they extend by referencing this ID. Add-in roots also have a version number, which is used to ensure consistency between the extension points they provide, and the extensions provided by add-ins.<br />
<br />
Add-in roots can be bound to one or more assemblies, which can be executables or libraries. Complex applications are usually composed by several assemblies, so it is important to carefully decide what constitutes an add-in root and what not. <br />
<br />
In this example, an application is composed by two executables: a console app and a graphical app. Both executables share the same logic libraries, and the GUI app has a GUI library and a components library. The application defines two add-in roots:<br />
<br />
* The Logic add-in root is composed by two assemblies: Logic.dll and LogicHelper.dll. Since both assemblies are libraries, they can be reused from the console and the gui exes.<br />
* The GUI add-in root is composed only by the GUI library. <br />
<br />
There are basically two reasons for including an assembly in an add-in root:<br />
<br />
* The assembly defines some classes or interfaces to be implemented by add-ins.<br />
* The assembly is required to load other add-in root assemblies. <br />
<br />
Mono.Addins provides several ways of declaring add-in roots and the assemblies they are bound to. This is explained in detail in the Description of Add-ins and Add-in Hosts section, but summarizing, there are three ways:<br />
<br />
* By creating an add-in manifest file (an XML file with a .addin extension).<br />
* By creating an add-in manifest file and embedding it in an assembly as a resource.<br />
* By applying the [assembly:AddinRoot] attribute to an assembly. <br />
<br />
In the first and second case, a Runtime section in the manifest can be used to reference other assemblies to be included in the add-in root. In the second and third case, other assemblies can be referenced using the attribute [assembly:AddinAssemblyInclude].<br />
<br />
Add-in roots always have a main file. When using an standalone manifest, the main file is the manifest file. When using a manifest embedded in an assembly, or when using the [AddinRoot] attribute, the main file is the assembly. Only the main file can include other files in the add-in root.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=1077Проект "MonoDevelop Add-in для PascalABC.NET"2009-12-07T19:36:26Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути.<br />
<br />
'''Архитектура приложения расширения.'''<br />
<br />
Приложение расширения, состоит как минимум из одной сборки выполнения и одной библиотеки. Mono.Addins основывается на так называемой сильно типизированной модели. Эта модель нуждается в точном объявлени всех точек расширения и иныормации их согласования. Вся эта информация составляет '''add-in root''' (корневой add-in).</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=972Проект "MonoDevelop Add-in для PascalABC.NET"2009-11-16T10:21:38Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=971Проект "MonoDevelop Add-in для PascalABC.NET"2009-11-16T10:19:59Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Атрибут AddinRoot может быть использован для отметки сборки настройки add-in host. TypeExtensionPoint этот атрибут описывает новую точку расширения с определенным путем для конструктора, и требует узлы типа TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Addin этот атрибут указывает на сборку add-in. Для этого может использоваться идентификатор или версия при необходимости.<br />
AddinDependency- атрибут описывающий зависимости TextEditor от add-in host.<br />
Extensio- атрибут указывающий class extension.<br />
Для этого регистрируем узел расширения с типом TypeExtensionNode с указанием пути. <br />
<br />
The host application can be the same app shown in the manifest example.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=970Проект "MonoDevelop Add-in для PascalABC.NET"2009-11-16T10:04:25Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
&nbsp;Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
&nbsp;Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
&nbsp;Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
&nbsp;Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
&nbsp;Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
&nbsp;В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
&nbsp;Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
AddinRoot attribute can be used to mark an assembly as being an add-in host. The TypeExtensionPoint attribute declares a new extension point in path the specified in the constructor, and requiring nodes of type TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
''[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
The Addin attribute indicates that an assembly is an add-in. It can also be used to specify the add-in Id and Version if needed. The AddinDependency attribute declares the dependency on the TextEditor add-in host. The Extension attribute marks a class as being an extension. It will register an extension node of type TypeExtensionNode in the provided path. <br />
<br />
The host application can be the same app shown in the manifest example.</div>AlexHithttps://pascalabc.net/wiki/index.php?title=%D0%9F%D1%80%D0%BE%D0%B5%D0%BA%D1%82_%22MonoDevelop_Add-in_%D0%B4%D0%BB%D1%8F_PascalABC.NET%22&diff=969Проект "MonoDevelop Add-in для PascalABC.NET"2009-11-16T10:00:10Z<p>AlexHit: </p>
<hr />
<div>'''Mono.Addins Reference Manual'''<br />
<br />
'''Введение'''<br />
<br />
'''Mono.Addins''' является основой для создания расширяемых приложений, а также для создания библиотек, расширяющих эти приложения(аналог "плагинов").<br />
<br />
Эта структура вытекает из использования MonoDevelop, путем добавления в MonoDevelop расширяемых приложений (extensible applications), хотя MonoDevelop был полностью переписан и усовершенствован, существует множество способов сделать его более общим и простым в использовании. Добавление в программу MonoDevelop "плагинов" (Mono.Addins) реализованно намного удобней, чем по сравнению с инструментом SharpDevelop, который реализован на основе идей от Eclipse add-in engine (добавления "плагинов" в системе Eclipse). <br />
<br />
Mono.Addins был разработан, чтобы быть полезным для широкого спектра приложений: от простых приложений с малыми потребностями расширения(дополнения к коду) до сложных приложений (таких как сам MonoDevelop), которые нуждаются в поддержке: в больших дополнениях в структурах программы. <br />
<br />
Этот документ включает в себя подробное описание всех функций, которые предоставляет Mono.Addins. Если у Вас есть вопросы или предложения о Mono.Addins, подпишитесь на рассылку разработчиков Mono.Addins (http://groups.google.com/group/mono-addins).<br />
<br />
'''Основы Mono.Addins'''<br />
<br />
Модель расширения Mono.Addins базируется на четырех концепциях:<br />
<br />
'''Add-in host:''' приложение или библиотека, которые могут быть расширены с помощью add-ins. Расширение возможностей определяется посредством точек расширения(extension points). <br />
<br />
'''Extension point:''' пространство, гед add-ins могут регистрировать '''extension nodes'''(узлы расширекния) для расширения функциональности. Extension points определяются путем использования '''extension paths'''(путей расширения). <br />
<br />
'''Extension node:''' Атрибут оформления элемента, описывающий расширения. Extension nodes(узлы расширения) типизированные. extension points могут объявить, какие типы extension nodes они принимают. <br />
<br />
'''Add-in:''' Набор файлов, которые регистрируют новые узлы в одной или нескольких точек расширения, определяются add-in hosts. Add-in может дополнять add-in host, и может реализовываться разными add-ins. <br />
<br />
Mono.Addins определяется оделью описания Add-in, с использованием add-ins and add-in hosts для описания индормации расширения. Add-in может быть представлен с использованием XML манифеста(объявления), или с применением атрибутов и типов. <br />
<br />
В результатте Mono.Addins записывается в виде API (выполняя Mono.Addins.dll) который встраивается при выполнении.<br />
<br />
Для примера рассотрим базовое приложение Mono.Addins. <br />
<br />
'''Простейший пример'''<br />
<br />
Реализуем текстовый редактор к которому будем подключать наши add-ins. Рассмотрим диаграмму, на колторой отображена схема работы программы.<br />
<br />
[[Изображение:Example.jpg]]<br />
<br />
Далее рассмотрим, как расширить возможности текстового редактора, используя возможности Mono.Addins.<br />
<br />
Мы хотим разрешить add-ins выполнять последние изменения при запуске приложения. <br />
<br />
Приложение текстового редактора состоит из 2-х сборок: <br />
<br />
1)TextEditor.exe это само приложение. <br />
<br />
2)TextEditorLib.dll определяет насколько дополнительных интерфейсов для приложения<br />
<br />
<br />
Далее мы видим базовую структуру. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''public interface ICommand<br />
<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
Это очень просто пример с одним методом: run. Редактор выполяет этот метод в вконце.<br />
<br />
'''Add-in host manifest (TextEditor.addin)'''<br />
<br />
''<Addin id="TextEditor" version="1.0" isroot="true"><br />
<br />
<br />
<Runtime><br />
<br />
<Import assembly="TextEditor.exe"/><br />
<br />
<Import assembly="TextEditorLib.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<ExtensionPoint path = "/TextEditor/StartupCommands"><br />
<br />
<ExtensionNode name="Command" type="Mono.Addins.TypeExtensionNode"/><br />
<br />
</ExtensionPoint><br />
<br />
</Addin>''<br />
<br />
Основной манифест включает следующую информацию: <br />
<br />
1)Элемент Addin объявляет главный идентификатор и версию. Корневой атрибут определяет что необходимо добавить в манифест.<br />
<br />
2)Элемент времени выполнения определяет файлы принадлежащие хосту. <br />
<br />
3)Элемент точки расширения определяет новую точку расширения. Атрибут определяет местоположение точки расширения в дереве расширения. <br />
<br />
4)Элемент узла расширения определяет тип узла, который принимает точку расширения. В этом случае, точка расширения позволяет только узлам типа TypeExtensionNode, которые будут определены в расширениях, используя имя Command.<br />
<br />
'''The host application (TextEditor.exe)'''<br />
<br />
''public class TextEditorApplication<br />
<br />
{<br />
<br />
public static void Main ()<br />
<br />
{<br />
<br />
// Initialize the add-in engine<br />
<br />
AddinManager.Initialize ();<br />
<br />
<br />
// Get the extension nodes in the extension point<br />
<br />
foreach (TypeExtensionNode node in AddinManager.GetExtensionNodes ("/TextEditor/StartupCommands")) }<br />
<br />
ICommand command = (ICommand) node.CreateInstance ();<br />
<br />
command.Run ();<br />
<br />
}<br />
<br />
}<br />
}''<br />
<br />
Приложение хоста использует Mono.Addins API, чтобы получить узлы зарегистрированных в точке расширения. Для этого: <br />
<br />
1)Инициализировать add-in engine, называемый AddinManager.Initialize() <br />
<br />
2)Вызываем метод AddinManager.GetExtensionNodes(), чтобы вернуть все зарегистрированные узлы add-ins в точке расширения StartupCommands. Вызов возвращает узлы типа TypeExtensionNode, с точки расширения определенной для такого рода узлов. <br />
<br />
3)TypeExtensionNode это особый тип узла, который позволяет указать тип. Он предоставляет методы для создания экземпляров из описанных типов. Принимающий вызов метода CreateInstance на каждом узле, чтобы получить реализацию ICommand, а затем вызывает Запустить на каждом из них. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
class HelloWorldExtension: ICommand<br />
''<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}''<br />
<br />
Этот add-in представляет собой простую реализацию интерфейса ICommand. <br />
<br />
'''Add-in manifest (SampleAddin.addin)'''<br />
''<br />
<Addin><br />
<br />
<Runtime><br />
<br />
<Import assembly="SampleAddin.dll"/><br />
<br />
</Runtime><br />
<br />
<br />
<Dependencies><br />
<br />
<Addin id="TextEditor" version="1.0" /><br />
<br />
</Dependencies><br />
<br />
<br />
<Extension path = "/TextEditor/StartupCommands"><br />
<br />
<Command type="HelloWorldExtension" /><br />
<br />
</Extension><br />
<br />
<br />
</Addin>''<br />
Add-in манифест схож с главным манифестом(хоста): <br />
<br />
1)Здесь Addin корневой элемент, не предоставляет информацию об идентификационном номере или версии. Ид и версии не требуются add-ins, если они объявят новые точки расширения они смогут усовершенствовать add-ins. <br />
<br />
2)Зависимый элемент определяет зависимость от других add-ins или add-in hosts.<br />
<br />
3)Зависимые элементы могуь использовать описание новых расширений. Свойство определяет точку расширения и расширяется выполнением.<br />
<br />
4)Управляющий элемент расширяет узел. Т.к. узлы этой точки расширения имеют тип TypeExtensionNode, мы должна описывать типы атрибутов для описания имени класса. Этот класс будет создан при вызове CreateInstance данного узла.<br />
<br />
Элемент является продолжением узла. С узлах этой точки расширения имеют тип TypeExtensionNode, удлинители должны предоставить печатать атрибут, который определяет имя класса, представленного этим узлом. Это класс, который будет создан при вызове CreateInstance узла.<br />
<br />
'''Простой пример использования атрибутов сборки'''<br />
<br />
Данный пример может быть раелизован, использхуя атрибуты сборки вместо xml манифеста. Правда не всеобъявления,которые делаются в манифесте, можно сделать с помощью атрибутов. Но атрибуты активно используются, т.к. они очень удобны, особенно для простых примеров. <br />
<br />
'''ICommand library (TextEditorLib.dll)'''<br />
<br />
''[assembly:AddinRoot ("TextEditor", "1.0")]<br />
<br />
[TypeExtensionPoint ("/TextEditor/StartupCommands")]<br />
<br />
public interface ICommand<br />
{<br />
<br />
string Run ();<br />
<br />
}''<br />
<br />
AddinRoot attribute can be used to mark an assembly as being an add-in host. The TypeExtensionPoint attribute declares a new extension point in path the specified in the constructor, and requiring nodes of type TypeExtensionNode. <br />
<br />
'''An add-in (SampleAddin.dll)'''<br />
<br />
[assembly:Addin]<br />
<br />
[assembly:AddinDependency ("TextEditor", "1.0")]<br />
<br />
[Extension ("/TextEditor/StartupCommands")]<br />
<br />
class HelloWorldExtension: ICommand<br />
<br />
{<br />
<br />
public string Run ()<br />
<br />
{<br />
<br />
Console.WriteLine ("Hello World");<br />
<br />
}<br />
<br />
}<br />
<br />
The Addin attribute indicates that an assembly is an add-in. It can also be used to specify the add-in Id and Version if needed. The AddinDependency attribute declares the dependency on the TextEditor add-in host. The Extension attribute marks a class as being an extension. It will register an extension node of type TypeExtensionNode in the provided path. <br />
<br />
The host application can be the same app shown in the manifest example.</div>AlexHit