Подготовка рабочего места для работы с Celesta

Материал из Course Orchestra
Перейти к: навигация, поиск
Внимание! Вы просматриваете документацию к Celesta 6.x. Документация по Celesta 7.x доступна на courseorchestra.github.io/celesta.

1. Справочник Celesta

1.1 Введение и основные понятия
1.2 Запуск и авто-обновление
1.3 Базовая настройка
1.4 Системные таблицы
1.5 CelestaSQL
1.6 CelestaDoc
1.7 Контексты сессии и вызова
1.8 Курсоры
1.9 BLOB-поля
1.10 Option-поля
1.11 Защита от потерянных обновлений
1.12 Метаданные Celesta
1.13 CelestaUnit

2. Celesta и базы данных

2.1 Особенности работы Celesta с поддерживаемыми типами СУБД
2.2 Проектирование базы данных Celesta в DBSchema

3. Создание решений с использованием Celesta для ShowCase

3.1 Программа обучения Celesta
3.2 Подготовка рабочего места для работы с Celesta
3.2.1 Для разработчиков платформы
3.2.2 Для разработчиков решений
3.3 Системные гранулы Celesta
3.3.1 common
3.3.1.1 Экспорт/импорт данных
3.3.1.2 Навигатор
3.3.1.3 Серии номеров
3.3.1.4 Иерархия Дьюи
3.3.1.5 Системные функции
3.3.1.6 Реестр настроек
3.3.1.7 Mailsender
3.3.1.8 Common.filter
3.3.2 common.api
3.3.4 security
3.3.3 lyra
3.4 Стандартные гранулы Celesta
3.4.1 dirusing
3.4.2 workflow
3.4.3 File repository
3.5 Отрисовка элементов Showcase при помощи Celesta
3.5.1 Конвертер XML-JSON
3.5.2 Навигатор (Navigator)
3.5.3 Информационная панель (Datapanel)
3.5.4 Серверное действие (Server activity)
3.5.5 Вебтекст (WebText)
3.5.6 Грид (Grid)
3.5.6.1 Панель инструментов (ToolBar)
3.5.7 XForms
3.5.7.1 Селекторы
3.5.7.2 Submission
3.5.7.3 Загрузка/Выгрузка файлов (Upload/Download)

5. Решение проблем

5.1 Проблемы с кодировкой jython-файлов

Необходимое ПО

Для того, чтобы Вы могли создавать проекты на платформе Курс с использованием Showcase и Celesta, Вам понадобятся следующие компоненты:

  1. Настроенный Eclipse. Если Вы не можете скачать Eclipse по ссылке, скачайте его с официального сайта и установите плагины (см. таблицу ниже, плагины отмеченные желтым цветом обязательны для установки)
  2. Tomcat 7
  3. JDK 1.7 для любой версии Tomcat (portable или service) либо JRE 1.7 для service-версии Tomcat
  4. Клиент Subversion TortoiseSVN (в случае если проект находится в SVN-репозитории)
  5. Одна из поддерживаемых баз.
  6. Сервер аутентификации Mellophone, для локальных пользователей используйте ссылку
  7. Если вы разрабатываете решение под Showcase, то Showcase , для локальных пользователей используйте ссылку. Версия Showcase-ext отличается от Showcase наличием библиотек ApachePOI и JasperReports. Данные библиотеки могут быть использованы в Python-скриптах. Основной код Showcase их не вызывает.
  8. Если вы разрабатываете решение под Flute, то Flute, для локальных пользователей используйте ссылку
Загрузить дистрибутив платформы Course Orchestra
Download.png
Стабильные сборки


Необходимые плагины Eclipse

Замечание: После каждой инсталляции плагина рекомендуется перегружать Eclipse.

Плагин Репозиторий или место для загрузки
SVN - используем плагин от Subclipse Subclipse - http://subclipse.tigris.org/update_1.8.x

выбирать можно все

Для Eclipse Juno 4.2 (можно попробовать поставить Subclipse, правда версии для Juno пока еще нет. Если Subclipse не пойдет то ставим это): Выбираем http://download.eclipse.org/releases/juno и в выпадающем списке выбираем Collaboration и отмечаем Subversion Team Provider


Дополнительно Subclipse можно найти тут: http://marketplace.eclipse.org/content/subclipse

или этот http://marketplace.eclipse.org/content/subclipse?mpc=true&mpc_state=

Но для установки надо выбрать в Eclipse: Help->Eclipse MarketPlace..., ввести "Subclipse" в поле Find нажать Enter. В появившейся выдаче нажать Install рядом с Suclipse

CheckStyle http://eclipse-cs.sourceforge.net/update

выбрать только Checkstyle 5

Можно установить через marketplace, написав “Checkstyle”

GWT http://dl.google.com/eclipse/plugin/3.7

выбирать Google Plugin, Google Web Toolkit, а на всякий случай Designer и AppEngine SDK

Для Eclipse 4.2 (Juno) использовать http://dl.google.com/eclipse/plugin/4.2

GreenUML (опционально: как простое UML средство) http://www.cse.buffalo.edu/faculty/alphonce/green

выбрать все

Hibernate http://download.jboss.org/jbosstools/updates/development/indigo/

далее JBoss Application Development и выбрать Hibernate Tools

Для Juno: http://download.jboss.org/jbosstools/updates/development/juno/

Spring STS - http://dist.springsource.com/milestone/TOOLS/update/e3.7

ставить Core/ Spring IDe и Core/STS. Остальное - только если знаешь для чего.

Для Eclipse Juno 4.2: http://dist.springsource.com/milestone/TOOLS/update/e4.2

Либо для установки надо выбрать в Eclipse: Help->Eclipse MarketPlace..., ввести "Spring" в поле Find нажать Enter. В появившейся выдаче нажать Install рядом с “Spring Tool Suite (STS) for Eclipse Juno (3.8 4.2) ”

Либо, скачать spring toolkit http://www.springsource.org/download/community, распаковать и перенести jar из папки lib в проект, но там надо не все и вообще так не рекомендуется.

Tomcat поддержка в Eclipse встроена по умолчанию
Ant поддержка в Eclipse встроена по умолчанию
JUnit поддержка в Eclipse встроена по умолчанию
JAutodoc http://jautodoc.sourceforge.net/update/

Включена в JComponentDVD. Можно также скачать на сайте разработчика.

Либо через marketplace

Eclemma Eclipse plugin http://update.eclemma.org/
AspectJ http://download.eclipse.org/tools/ajdt/37/update

Инсталлировать AspectJ Development Tools (Required) и Other AJDT Tools (Optional)

Для Eclipse Juno 4.2: http://download.eclipse.org/tools/ajdt/42/update

PyDev (разработка Python\Jython) http://pydev.org/updates/

Ставить только PyDev

Sonar http://dist.sonar-ide.codehaus.org/eclipse/

Ставить все. Требует для работы компонент Mylyn, который входит в Eclipse IDE for Java EE Developers.


Кроме этого Вам необходимо иметь доступ к следующим репозиториям SVN (получить разрешения можно в отделе программистов):

  1. Celesta (доступ на чтение) (можно использовать reader/reader в качестве логина и пароля)
  2. Grains (доступ на чтение)
  3. SVN Вашего решения (доступ на изменение)

Установка необходимого ПО

Установка JDK

Скачайте файл установки JDK (см.выше), запустите его. Далее следуйте инструкциям инсталятора. После того как вы установили JDK, необходимо прописать путь к Java в переменную среды JAVA_HOME. Необходимо указывать путь именно к папке с JDK, например C:\Program Files\Java\jdk1.7.0_04. Последовательность действий продемонстрирована на рисунке.

JAVA HOME.png

Установка Jython и TortoiseSVN

Для установки Jython и TortoiseSVN запустите скачанные файлы инсталяторов и следуйте инструкциям.

Установка Tomcat

В случае, если Вы скачали service-версию Tomcat (запускаемый файл .exe или .msi), запустите скопированный файл и cледуйте указаниям инсталятора, если Вы загрузили portable-версию Tomcat (архивный файл), разархивируйте папку с Tomcat в удобное для Вас место.

После установки Tomcat необходимо его настроить. Для этого перейдите в папку с Tomcat далее откройте файл server.xml в папке conf. Укажите порт на котором будет располагаться Tomcat

 <!-- A "Connector" represents an endpoint by which requests are received
         and responses are returned. Documentation at :
         Java HTTP Connector: /docs/config/http.html (blocking & non-blocking)
         Java AJP  Connector: /docs/config/ajp.html
         APR (HTTP/AJP) Connector: /docs/apr.html
         Define a non-SSL HTTP/1.1 Connector on port 8080
    -->
    <Connector port="8088" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />

Для запуска Tomcat перейдите в папку bin и запустите файл startup.bat (в случае терминально весрии) или tomcat7w.exe (в случае service-версии).

Установка и настройка Eclipse

Разархивируйте скачанный Вами Eclipse в удобную для Вас папку, например E:\Eclipse. Запустите файл eclipse.exe. При первом запуске Вам необходимо выбрать место, где будут храниться ваши проекты, например E:\Projects. В случае если Вы скачали Eclipse с официального сайта, установите в него плагины, указанные выше. После запуска Вам необходимо настроить Eclipse. Настройте Eclipse, чтобы он ссылался на установленный jython для этого выберите в панели инструментов пункт Window, далее следуйте инструкции на картинке ниже. При выборе пути к Jython выберите файл Jython.jar

Jython Eclipse.png

Jython-Eclipse-2.png

Теперь неоходимо подключить к Eclipse стилевой файл curs_strict.zip. Скопируйте и разархивируйте его. Настоятельно рекомендуется положить данный файл в надежную папку, которую вы вряд ли будете удалять, например в папку к Eclipse. После этого следуйте инструкции на картинке

Checkstyle.png

Настройка проекта Celesta

Перейдем к настройке проекта Celesta. Скачайте проект Celesta из svn в Eclipse, как показано на картинке.

NewProject.png

Далее откройте в проводнике папку, где лежит проект Celesta и создайте новую папку с названием вашего проекта (например myProject), эта папка будет сожеражть весь набор настроек (userdata) вашего проекта. После этого зайдите в папку myProject, нажмите правой кнопкой мыши в пустое место и выберите пункт SVN Checkout.... Далее подключитесь к SVN вашего решения и выберите в нем все необходимые Вам.userdata (в случае наличия гранул в папке tags необходимо брать гранулы оттуда, иначе использовать trunk). Аналогичные действия проделайте с папкой userScore, взяв необходимые гранулы из репозитория вашего решения.

Важная информация


В случае если в своем проекте вы используете дополнительные библиотеки поместите их в папку lib проекта Celesta.


После этого снова перейдите в Eclipse выберите проект Celesta и нажмите кнопку F5 и "разверните" папку проекта. Теперь необходимо произвести настройку проекта. При работе с Celesta разработчик решений должен уметь использовать отладку при помощи java и jython, для каждого из этих способов необходим свой файл настроек.

Настройка Showcase

После установки Showcase его необходимо настроить.


CelestaPlan.png