// 
//     Licensed to the Apache Software Foundation (ASF) under one
//     or more contributor license agreements.  See the NOTICE file
//     distributed with this work for additional information
//     regarding copyright ownership.  The ASF licenses this file
//     to you under the Apache License, Version 2.0 (the
//     "License"); you may not use this file except in compliance
//     with the License.  You may obtain a copy of the License at
// 
//       http://www.apache.org/licenses/LICENSE-2.0
// 
//     Unless required by applicable law or agreed to in writing,
//     software distributed under the License is distributed on an
//     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
//     KIND, either express or implied.  See the License for the
//     specific language governing permissions and limitations
//     under the License.
//

= Введение в веб-платформу Grails
:jbake-type: tutorial
:jbake-tags: tutorials 
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: Введение в веб-платформу Grails - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, Введение в веб-платформу Grails

Этот документ используется для начала работы с link:http://www.grails.org[+Grails+] в IDE NetBeans. Вот что сказано на веб-сайте Grails: "Grails привносит в Groovy парадигму "соглашение вместо настройки" ("кодирование по соглашению", "coding by convention"). Grails представляет собой платформу веб-приложений с открытым исходным кодом, дополняющую процесс веб-разработки на Java и использующую язык Groovy. Можно использовать Grails в качестве автономной среды разработки, в которой скрыты все дополнительные сведения о настройке, или интегрировать бизнес-логику Java. Grails позволяет максимально упростить процесс разработки, поэтому эта платформа должна привлечь широкий круг разработчиков, а не только членов сообщества Java".


image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой страницы применимо к IDE NetBeans 7.2, 7.3, 7.4 и 8.0"]


*Для работы с этим учебным курсом требуется следующее программное обеспечение и ресурсы.*

|===
|Программное обеспечение или материал |Требуемая версия 

|link:https://netbeans.org/downloads/index.html[+IDE NetBeans+] |версия Java 7.2 или более поздняя 

|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Комплект для разработчика на языке Java (JDK)+] |версия 7 

|link:http://www.grails.org/Installation[+Grails+] |текущая версия 
|===

*Примечания.*

* В качестве платформы Java необходимо использовать JDK 7. В настоящее время Grails не работает на платформе JDK 8.
* Для разработки приложений Grails в IDE необходимо активировать подключаемый модуль Groovy.
* Откройте окно "Параметры" в IDE и укажите расположение Grails на вкладке "Groovy" в категории "Разное".

При использовании Groovy укажите также папку Groovy.

* Прочтите на официальном веб-сайте link:http://grails.org/Quick%20Start[+Краткий учебный курс по работе с Grails+], в котором представлена ситуация, представленная в нижеследующих разделах.


== Создание приложения

В этом разделе команда "grails create-app" выполняется из среды IDE путем использования шаблона проекта "Grails Application" для создания нового приложения Grails.

1. Установите Grails на локальном компьютере и проверьте настройки.

Чтобы проверить, корректно ли работает Grails, запустите его из командной строки с помощью команды "grails".

2. Выберите команду "Файл" > "Создать проект" (CTRL+SHIFT+N), а затем – "Приложение Grails" из категории "Groovy". Нажмите кнопку "Далее".
3. В поле "Имя проекта" введите "BookDemo". В "Project Location" выберите папку, в которой будет создано приложение. Нажмите кнопку "Завершить".

Среда IDE выполняет команду "grails create-app", отображая результат выполнения в окне "Вывод". Окно "Проекты" должно выглядеть следующим образом:

image::images/grails-65-4.png[]

Разверните папки и просмотрите структуру исходных файлов, созданную средой IDE посредством сценариев Grails. Учтите, что во многих созданных файлах поля значений уже содержат значения по умолчанию.


== Создание класса домена

В этом разделе среда IDE будет использована для выполнения сценария "grails create-domain-class".

1. Щелкните правой кнопкой мыши узел "Классы домена" и команду "Создать" > "Класс домена Grails".
2. Назовите класс домена "Book" и нажмите кнопку "Готово". В узле "Классы домена" будет создан домен "Book.groovy".
3. Откройте класс Book и заполните строки "title" и "author". На экране появится следующее окно:
image::images/grails-65-8.png[]
4. Создайте несколько начальных значений в классе Bootstrap.groovy, находящемся в узле Configuration. Добавленный к классу код выделен жирным шрифтом:

[source,java]
----

class BootStrap {

     def init = { servletContext ->
         *new Book(author:"Stephen King",title:"The Shining").save()
         new Book(author:"James Patterson",title:"Along Came a Spider").save()*
     }
     
     def destroy = {
     }
     
}
----

*Примечание.* Если слева в редакторе исходного кода отображается предупреждение, добавьте импорт для  ``bookdemo.Book`` .


== Создание контроллера

В этом разделе сценарий "grails create-controller" используется для создания контроллера для класса домена:

1. Щелкните правой кнопкой мыши узел "Контроллеры" и выберите команду "Создать" > "Контроллер Grails".
2. В поле "Имя класса" введите "Book" и убедитесь в том, что создаваемый класс называется "BookController":
image::images/grails-65-11.png[]

Нажмите кнопку "Завершить". Создание контроллера выполнено.

3. Закомментируйте строку, созданную внутри скобок, и добавьте "def scaffold = Book". На экране появится следующее окно: 
image::images/grails-65-13.png[]


== Запуск приложения

Мы создали простое приложение Grails. В этом разделе будет выполнено его развертывание:

1. Щелкните приложение правой кнопкой мыши и выберите команду "Выполнить". Развертывание приложения выполняется в Jetty, как показано в окне "Службы": 
image::images/grails-65-19.png[]
2. Введите URL-адрес в окно "Вывод". Если страница браузера не открывается автоматически, вставьте URL-адрес в адресную строку браузера, после чего приложение откроется. Перейдите по ссылке "BookController". Появится следующее окно: 
image::images/grails-65-14.png[]
3. Щелкните "New Book" и создайте новую запись: 
image::images/grails-65-15.png[]
4. После нажатия кнопки "Создать" убедитесь в том, что запись может быть изменена или удалена: 
image::images/grails-65-17.png[]
5. ...а также в том, что эта запись отображается в списке записей: 
image::images/grails-65-18.png[]
link:/about/contact_form.html?to=3&subject=Feedback: NetBeans IDE 6.5 Grails Quick Start Guide[+Отправить отзыв по этому учебному курсу+]


== Дополнительные сведения

На этом завершается введение в Grails в IDE NetBeans. Теперь вы знаете, как создается простое приложение на платформе Grails с использованием среды IDE.

Дополнительные сведения о технологиях Grails и Groovy приведены на веб-сайте link:https://netbeans.org/[+netbeans.org+] в разделе link:../java/groovy-quickstart.html[+Введение в Groovy+].