BeanExplorer4 — различия между версиями
Asko  (обсуждение | вклад)  | 
				Asko  (обсуждение | вклад)   | 
				||
| Строка 1: | Строка 1: | ||
[[:Category:BeanExplorer4|Открыть категорию BeanExplorer4]]  | [[:Category:BeanExplorer4|Открыть категорию BeanExplorer4]]  | ||
----  | ----  | ||
| − | + | === Оглавление ===  | |
| − | + | ||
| − | + | ||
* Как начать работу с BeanExplorer 4  | * Как начать работу с BeanExplorer 4  | ||
* Описание по каждому редактору и view  | * Описание по каждому редактору и view  | ||
* Основная информация для понимания BeanExplorer 4  | * Основная информация для понимания BeanExplorer 4  | ||
* Работа с BeanExplorer 4 для аналитиков  | * Работа с BeanExplorer 4 для аналитиков  | ||
| − | * [  | + | * [[BeanExplorer4: Usecases|Usecases]] (сценарии использования - с картиночками)  | 
| − | *   | + | * Полезная информация, которая может помочь при работе с BeanExplorer 4  | 
| − | **   | + | ** Как устанавливать плагины/фитчи из архива.  | 
| − | **   | + | ** Где взять редактор YAML  | 
| − | **   | + | ** Где взять редактор FreeMarker  | 
| − | + | ** Как настроить Tomcat для возможности подгрузить изменения в class-файлах  | |
| − | **   | + | * Для разработчиков: [[Компиляция и запуск BeanExplorer4|компиляция и запуск BeanExplorer4]] (здесь инструкции для тех, кто запускает Eclipse BeanExplorer4 из под другого экземпляра Eclipse)  | 
| − | *   | + | * [[Структура проекта BeanExplorer 4|Структура]] проекта BeanExplorer 4  | 
| − | *   | + | * Процесс разработки  | 
| − | + | ** [[Использование ant в be4|Использование Ant]]  | |
| − | *   | + | ** Использование шаблонов [[Freemarker (BeanExplorer4)|Freemarker]]  | 
| − | **   | + | ** Текущее состояние [[BeanExplorer4 JavaScript Debugger|JavaScript Debugger]]  | 
| − | **   | + | ** Поддержка [[Поддержка СУБД в BeanExplorer4|различных СУБД]]  | 
| − | **   | + | |
| − | **   | + | === Как начать работу с BeanExplorer 4  | 
| − | + | Для установки: смотрите «[[Компиляция и запуск BeanExplorer4|компиляция и запуск]]»  | |
| − | + | Есть два способа начать работать с проектом BeanExplorer 4.  | |
| − | + | # Взять готовый проект. В таком случае просто откройте перспективу BeanExplorer, сделайте импорт проекта обычным способом, а затем кликните на проект или project.yaml правой кнопкой мыши (во view Project Explorer) и выберите "BeanExplorer -> Open BeanExplorer Project". Проект появится во view с названием Model.  | |
| − | Как начать работу с BeanExplorer 4  | + | # Преобразовать старый BeanExplorer-проект. Для этого выберите File->New->Project..., BeanExplorer->New BeanExplorer Project Using Database Connection (более короткий способ это сделать - это выбрать пункт меню BeanExplorer->Quick Load Using Database Connection, если уже есть профиль для подключения к базе данных). Если нет ни одного профиля для подключения к СУБД, его надо создать, нажав "Create a new connection profile" и введя всю необходимую информацию для подключения, а также выбрав JDBC драйвер. Пароль обязательно сохранить. После нажатия на кнопку "Finish" загруженный проект должен отобразиться во view "Model". Преобразование может быть неточным и придётся его доделывать вручную. Кроме того, не сохранятся никакие макросы.  | 
| − | + | ||
| − | + | === Описание по каждому редактору и view ===  | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | Описание по каждому редактору и view  | + | |
| − | + | ||
* <span style="font-family:arial,sans-serif"><font size="2"><span style="background-color:rgb(255,255,255)">Model (view). Дерево проекта.</span></font></span>  | * <span style="font-family:arial,sans-serif"><font size="2"><span style="background-color:rgb(255,255,255)">Model (view). Дерево проекта.</span></font></span>  | ||
* <span style="font-family:arial,sans-serif"><font size="2"><span style="background-color:rgb(255,255,255)">Properties (view). Свойства выделенного в дереве проекта элемента.</span></font></span>  | * <span style="font-family:arial,sans-serif"><font size="2"><span style="background-color:rgb(255,255,255)">Properties (view). Свойства выделенного в дереве проекта элемента.</span></font></span>  | ||
| Строка 145: | Строка 132: | ||
</font></span></div>  | </font></span></div>  | ||
<div>  | <div>  | ||
| − | + | ||
| − | + | == Полезная информация</font><font size="4">, которая может помочь при работе с BeanExplorer 4 ==  | |
| − | Полезная информация</font><font size="4">, которая может помочь при работе с BeanExplorer 4  | + | === Как устанавливать плагины/фитчи из архива ===  | 
| − | + | # Заходим в... Help->Install New Software. Add...->Archive... выбрать архив, OK.  | |
| − | + | # Снять галочку "Group items by category", если не видно пунктов для установки. Это может занять продолжительное время, т.к. с основного репозитория Eclipse будут скачиваться недостающие плагины.  | |
| − | + | ||
| − | + | === Где взять редактор YAML ===  | |
| − | + | Update site: <code>http://dadacoalition.org/yedit</code>  | |
| − | + | ||
| − | Это может занять продолжительное время, т.к.   | + | (Site: [https://code.google.com/p/yedit/ https://code.google.com/p/yedit/])  | 
| − | + | ||
| − | + | === Где взять редактор FreeMarker ===  | |
| − | + | Update site: <code>http://download.jboss.org/jbosstools/updates/stable/kepler/</code>  | |
| − | + | ||
| − | + | Или:  | |
| − | + | ||
| − | + | Help->Eclipse Marketplace... ищем "JBoss Tools", жмём Install у JBoss Tools (Kepler), снимаем галочку со всего и выбираем JBoss Tools (Kepler)->FreeMarker IDE.  | |
| − | + | ||
| − | + | === Как настроить Tomcat для возможности подгрузить изменения в class-файлах. ===  | |
| − | + | 1. Add the following lines into /conf/tomcat-users.xml (inside the root element <tomcat-users>):  | |
| − | + |  <role rolename="manager-script"/>  | |
| − | + |  <user username="tomcat" password="tomcat" roles="manager-script"/>  | |
| − | Или:  | + | |
| − | Help->Eclipse Marketplace... ищем "JBoss Tools", жмём Install у JBoss Tools (Kepler), снимаем галочку со всего и выбираем JBoss Tools (Kepler)->FreeMarker IDE.  | + | 2. Create /conf/Catalina/localhost/manager.xml with the following content:  | 
| − | + |  <Context privileged="true" antiResourceLocking="false"  | |
| − | Как настроить Tomcat для возможности подгрузить изменения в class-файлах.  | + |           docBase="${catalina.home}/webapps/manager">  | 
| − | + |   <Valve className="org.apache.catalina.valves.RemoteAddrValve"  | |
| − | + |          allow="127\.0\.0\.1" />  | |
| − | + |  </Context>  | |
| − | + | ||
| − | + | Подробнее [http://tomcat.apache.org/tomcat-7.0-doc/manager-howto.html здесь] и [http://www.mulesoft.com/tcat/tomcat-reload здесь].  | |
| − | + | ||
| − | + | === Компиляция и запуск Eclipse с плагином BeanExplorer4 ===  | |
| − | + | Здесь: [[Компиляция и запуск BeanExplorer4]]  | |
| − | + | ||
| − | + | === JavaScript Debugger ===  | |
| − | + | Здесь: [[BeanExplorer4 JavaScript Debugger|JavaScript Debugger]]  | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
Версия 12:05, 25 августа 2014
Открыть категорию BeanExplorer4
Содержание
Оглавление
- Как начать работу с BeanExplorer 4
 - Описание по каждому редактору и view
 - Основная информация для понимания BeanExplorer 4
 - Работа с BeanExplorer 4 для аналитиков
 - Usecases (сценарии использования - с картиночками)
 -  Полезная информация, которая может помочь при работе с BeanExplorer 4
- Как устанавливать плагины/фитчи из архива.
 - Где взять редактор YAML
 - Где взять редактор FreeMarker
 - Как настроить Tomcat для возможности подгрузить изменения в class-файлах
 
 - Для разработчиков: компиляция и запуск BeanExplorer4 (здесь инструкции для тех, кто запускает Eclipse BeanExplorer4 из под другого экземпляра Eclipse)
 - Структура проекта BeanExplorer 4
 -  Процесс разработки
- Использование Ant
 - Использование шаблонов Freemarker
 - Текущее состояние JavaScript Debugger
 - Поддержка различных СУБД
 
 
=== Как начать работу с BeanExplorer 4 Для установки: смотрите «компиляция и запуск» Есть два способа начать работать с проектом BeanExplorer 4.
- Взять готовый проект. В таком случае просто откройте перспективу BeanExplorer, сделайте импорт проекта обычным способом, а затем кликните на проект или project.yaml правой кнопкой мыши (во view Project Explorer) и выберите "BeanExplorer -> Open BeanExplorer Project". Проект появится во view с названием Model.
 - Преобразовать старый BeanExplorer-проект. Для этого выберите File->New->Project..., BeanExplorer->New BeanExplorer Project Using Database Connection (более короткий способ это сделать - это выбрать пункт меню BeanExplorer->Quick Load Using Database Connection, если уже есть профиль для подключения к базе данных). Если нет ни одного профиля для подключения к СУБД, его надо создать, нажав "Create a new connection profile" и введя всю необходимую информацию для подключения, а также выбрав JDBC драйвер. Пароль обязательно сохранить. После нажатия на кнопку "Finish" загруженный проект должен отобразиться во view "Model". Преобразование может быть неточным и придётся его доделывать вручную. Кроме того, не сохранятся никакие макросы.
 
Описание по каждому редактору и view
- Model (view). Дерево проекта.
 - Properties (view). Свойства выделенного в дереве проекта элемента.
 - Documentation (view). Документация к выделенному в дереве проекта элементу.
 - Tasks (view). Отображает все маркеры @todo и @check, найденные в документации ко всем элементам проекта.
 - Security (view). Таблица с правами ролей для каждого запроса и каждой операции. Реагирует на то, какой редактор открыт или какой элемент
 
в дереве проектов выбран, и в соответствии с последним выбранным
элементов фильтрует таблицу. Если в дереве проектов выбран модуль, то будут отображаться только операции и запросы из этого модуля, если entity, то отображаются только те операции и запросы, что относятся к данной entity. Фильтр по ролям позволяет выбрать все операции и запросы,
которые может выполнять выбранная роль.
- Diagram
 
(editor). Редактор ER. Может быть открыт посредством клика на модуль и
выбора "Create Diagram From This Module". Позволяет открывать .dml 
файлы.
- Diagram
 
Layout (view). Позволяет перераспределить элементы ER диаграмы. Всегда
относится к диаграмме из редактора ER, которым пользовались последним.
- SQL
 
Editor (editor). Позволяет редактировать SQL запросы - открывается при
клике на запросы в дереве проекта. Почти то же самое, что и SQL редактор
из Eclipse DTP. Позволяет запускать SQL запросы (правый щелчок
мышью->Execute All). Отличается от оригинального тем, что, во-первых,
не сохраняет изменения в файл (при попытке сохранить изменения окажутся в модели BeanExplorer 4), а, во-вторых, позволяет запускать SQL с
учётом макропроцессора FreeMarker и плейсхолдеров BeanExplorer (правый щелчок мышью->Run или "Run BeanExplorer SQL Query" на toolbar'е).
- Query
 
Parameters (view). Позволяет определить контекст выполнения SQL запроса - посредством выбора своих параметров запроса или сессии (при этом
запрос пока выполняется только под администратором).
- SQL Results (view). Автоматически активирует при SQL запросе. Позволяет
 
посмотреть результаты запроса как в виде простой таблицы, так и в виде
HTML после обработки в BeanExplorer, а также посмотреть обработанные представления запроса — после макропроцессора FreeMarker и в чистом SQL виде.
- JavaScript
 
Editor (editor). Позволяет редактировать JavaScript скрипты -
открывается при клике на JavaScript/server операции в дереве проекта. 
Почти то же самое, что и обычный JavaScript редактор из Eclipse JSDT. 
Отличается тем, что, во-первых, не сохраняет изменения в файл
 (при 
попытке сохранить изменения окажутся в модели BeanExplorer 4), а, 
во-вторых, позволяет запускать Rhino JavaScript ("Run JavaScript" на 
toolbar'е или "Execute" в Operation Parameters view). Результат вызова 
операции открывается в браузере.
- Operation
 
Parameters (view). Позволяет определить контекст выполнения
JavaScript/server операции посредством задания параметров и выбранных строчек. Также позволяет выбрать метод для запуска: getParameters(), invoke() или getRedirectURL() (последний пока не поддерживается).
- Localization
 
(view). Локализация, относящаяся к выделенному в дереве проектов
элементу. Отображается при выборе entity, operation или query.
Основная информация для понимания BeanExplorer 4
</div>
- проект,
 - модули (в т.ч. application),
 - сущности (entities - всё, что находится внутри модуля в папках Collections, Dictionaries, Tables, Generic Collections, Metadata),
 - операции,
 - запросы.
 
Документация отображается в Documentation view. Если в документации элемента есть маркер @todo или @check, то строка с этим маркером окажется и в другом view: Tasks. При клике на какую-либо строчку из Tasks будет выделен соответствующий ей элемент в Model view.
- Все роли перечислены в свойствах проекта. При клике на список ролей ("Project roles" в Properties view при выбранно проекте) появляется панель, позволяющая добавлять роли.
 - Для операций и запросов роли назначаются во view Security.
 
Usecases
Полезная информация</font>, которая может помочь при работе с BeanExplorer 4
Как устанавливать плагины/фитчи из архива
- Заходим в... Help->Install New Software. Add...->Archive... выбрать архив, OK.
 - Снять галочку "Group items by category", если не видно пунктов для установки. Это может занять продолжительное время, т.к. с основного репозитория Eclipse будут скачиваться недостающие плагины.
 
Где взять редактор YAML
Update site: http://dadacoalition.org/yedit
(Site: https://code.google.com/p/yedit/)
Где взять редактор FreeMarker
Update site: http://download.jboss.org/jbosstools/updates/stable/kepler/
Или:
Help->Eclipse Marketplace... ищем "JBoss Tools", жмём Install у JBoss Tools (Kepler), снимаем галочку со всего и выбираем JBoss Tools (Kepler)->FreeMarker IDE.
Как настроить Tomcat для возможности подгрузить изменения в class-файлах.
1. Add the following lines into /conf/tomcat-users.xml (inside the root element <tomcat-users>):
<role rolename="manager-script"/> <user username="tomcat" password="tomcat" roles="manager-script"/>
2. Create /conf/Catalina/localhost/manager.xml with the following content:
<Context privileged="true" antiResourceLocking="false"
         docBase="${catalina.home}/webapps/manager">
 <Valve className="org.apache.catalina.valves.RemoteAddrValve"
        allow="127\.0\.0\.1" />
</Context>
Компиляция и запуск Eclipse с плагином BeanExplorer4
Здесь: Компиляция и запуск BeanExplorer4
JavaScript Debugger
Здесь: JavaScript Debugger