// 
//     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.
//

= Introdução ao Groovy
:jbake-type: tutorial
:jbake-tags: tutorials 
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: Introdução ao Groovy - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, Introdução ao Groovy

Este documento lhe apresenta o link:http://groovy.codehaus.org/[+Groovy+] no NetBeans IDE. Você criará uma aplicação Java, adicionará um JFrame e recuperará uma mensagem simples de um arquivo Groovy.


image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.2, 7.3, 7.4 e 8.0"]


*Para seguir este tutorial, são necessários os recursos e o software a seguir.*

|===
|Software ou Recurso |Versão Necessária 

|link:https://netbeans.org/downloads/index.html[+NetBeans IDE+] |Pacote Java 7.2, 7.3, 7.4, 8.0 

|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+JDK (Java Development Kit)+] |versão 7 ou 8 

|Plug-in do Groovy |- 
|===


== Ativar o Plug-in do Groovy

O suporte para Groovy é desativado por padrão quando você instala a versão Java do IDE. Para trabalhar com o Groovy no IDE, ative primeiramente o plug-in do Groovy no gerenciador de Plug-ins.

1. Escolha *Ferramentas* > *Plug-ins* no menu principal para abrir o gerenciador de Plug-ins.
2. Clique na guia *Instalado* no gerenciador de Plug-ins.
3. Selecione Mostrar Detalhes e localize o plug-in *Groovy e Grails* na lista de plug-ins.

Se preferir, digite `groovy` no campo Pesquisar para filtrar a lista de plug-ins.


[start=4]
. Marque a caixa de seleção do plug-in Groovy e Grails e clique em Ativar.
image::images/groovy-plugin.png[title="Plug-in do Groovy selecionado no gerenciador de Plug-ins"]

[start=5]
. Clique em Ativar na janela do Instalador do NetBeans IDE para ativar o plug-in do Groovy.

[start=6]
. Clique em Finalizar na janela do Instalador do NetBeans IDE após a instalação ser concluída e, em seguida, clique em Fechar no gerenciador de Plug-ins.


== Criando a Aplicação

Nesta seção, você criará uma nova aplicação Java.

1. Selecione Arquivo > Novo Projeto (Ctrl-Shift-N; ⌘-Shift-N no Mac) no menu principal para abrir o assistente Novo Projeto.
2. Selecione Aplicação Java na categoria Java. Clique em Próximo.
3. Digite *GroovyJavaDemo* como o Nome do Projeto e especifique a pasta na qual você deseja criar a aplicação no campo Localização do Projeto.
4. Cancele a seleção da caixa de seleção Criar Classe Principal. Clique em Finalizar.

Quando você clica em Finalizar, o IDE cria o projeto e exibe um nó do projeto na janela Projetos.


== Criando a Classe Java e o Arquivo Groovy

Nesta seção, você criará um JFrame e uma classe Groovy.

1. Clique com o botão direito do mouse no nó do projeto na janela Projetos e escolha Novo > Outro para abrir a caixa de diálogo Novo Arquivo.
2. Selecione o Form JFrame na categoria Forms de GUI Swing. Clique em Próximo.
image::images/groovy-newjframe.png[title="Modelo de Form JFrame no assistente Novo Arquivo"]

[start=3]
. Digite *DisplayJFrame* como o Nome da Classe.

[start=4]
. Digite *org.demo* como o Pacote. Clique em Finalizar.
image::images/groovy-newjframe2.png[title="Painel Nome e Localização no assistente Novo Form JFrame"]

Quando você clica em Finalizar, o IDE cria o form JFrame e abre o arquivo no editor.


[start=5]
. Clique com o botão direito do mouse no nó do projeto na janela Projetos e escolha Novo > Outro para abrir a caixa de diálogo Novo Arquivo.

[start=6]
. Selecione a Classe Groovy na categoria Groovy. Clique em Próximo.
image::images/groovy-newgroovyclass.png[title="Modelo de Classe Groovy no assistente Novo Arquivo"]

[start=7]
. Digite *GreetingProvider* como o Nome da Classe.

[start=8]
. Selecione o pacote  ``org.demo``  na lista drop-down Pacote. Clique em Finalizar.

Quando você clica em Finalizar, o IDE cria o arquivo Groovy e abre-o no editor.

Se você expandir o nó do projeto na janela Projetos poderá ver que os dois arquivos criados estão no nó Pacotes de Origem.


== Chamando o Groovy a partir do Java

Nesta seção, você codificará a interação entre o arquivo Groovy e a classe Java.

1. Abra  ``GreetingProvider.groovy``  no editor (se ainda não estiver aberto).
2. Defina uma variável greeting na definição de classe adicionando o seguinte código (em negrito). Salve as alterações.

[source,java]
----

class GreetingProvider {

    *def greeting = "Hello from Groovy"*

}
----

[start=3]
. Abra  ``DisplayJFrame.java``  no editor (se ainda não estiver aberto) e clique na guia Design.

[start=4]
. Abra a Paleta (Janela > Paleta do menu principal) e arraste e solte um elemento Campo de Texto ( ``jTextField`` ) da Paleta e para o JFrame.
image::images/groovy-jtextfield.png[title="JTextfield no DesignJFrame será aberto na view de Design do editor"]

[start=5]
. Clique na guia Código-fonte do editor e adicione o seguinte código à parte superior do corpo da classe para instanciar a classe Groovy e no construtor para chamar o método  ``getGreeting()``  na classe Groovy.

[source,java]
----

public class DisplayJFrameForm extends javax.swing.JFrame {*

    GreetingProvider provider = new GreetingProvider();*

    public DisplayJFrame() {
        initComponents();
        *String greeting = provider.getGreeting().toString();
        jTextField1.setText(greeting);*
    }
----

É possível utilizar a funcionalidade autocompletar código na classe Java para encontrar os métodos necessários na classe Groovy.

image::images/groovy-codecompletion.png[title="Autocompletar código no editor"]

[start=6]
. Clique com o botão direito do mouse no nó na janela Projetos e selecione Executar.

Quando escolher Executar o IDE compila e aciona a aplicação.

image::images/groovy-runproject.png[title="Janela da aplicação exibindo o texto da classe Groovy no campo de texto"]

Na janela da aplicação, você pode ver que o texto da classe Groovy é exibido no campo de texto.

Agora você sabe como criar uma aplicação Java básica que interaja com o Groovy.

link:/about/contact_form.html?to=3&subject=Feedback:%20NetBeans%20IDE%20Groovy%20Quick%20Start[+Enviar Feedback neste Tutorial+]


== Consulte Também

O NetBeans IDE também suporta o framework do Grails na Web, que usa a linguagem Groovy no desenvolvimento Java Web. Para aprender a usar o framework do Grails com o NetBeans IDE, consulte link:../web/grails-quickstart.html[+Introdução ao Framework do Grails+].