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

= Tutorial do NetBeans E-commerce - Configurando o Ambiente de Desenvolvimento
:jbake-type: tutorial
:jbake-tags: tutorials 
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: Tutorial do NetBeans E-commerce - Configurando o Ambiente de Desenvolvimento - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, Tutorial do NetBeans E-commerce - Configurando o Ambiente de Desenvolvimento


1. link:intro.html[+Introdução+]
2. link:design.html[+Criando a Aplicação+]
3. *Configurando o Ambiente de Desenvolvimento*
4. link:data-model.html[+Criando o Modelo de Dados+]
5. link:page-views-controller.html[+Preparando as Views de Página e o Servlet do Controlador+]
6. link:connect-db.html[+Conectando a Aplicação ao Banco de Dados+]
7. link:entity-session.html[+Adicionando Classes de Entidades e Beans de Sessão+]
8. link:manage-sessions.html[+Gerenciando Sessões+]
9. link:transaction.html[+Integrando a Lógica de Negócios Transacional+]
10. link:language.html[+Adicionando o Suporte a Idioma+]
11. link:security.html[+Protegendo a Aplicação+]
12. link:test-profile.html[+Testando e Criando Perfis+]
13. link:conclusion.html[+Conclusão+]

image::../../../../images_www/articles/68/netbeans-stamp-68-69.png[title="O conteúdo desta página se aplica ao NetBeans IDE, versões e 6.8 e 6.9"]

As seguintes etapas descrevem como configurar seu ambiente de desenvolvimento. No processo, você aprenderá sobre algumas das janelas principais do IDE e compreenderá como o IDE usa o script de construção link:http://ant.apache.org/[+Ant+] para executar ações comuns em seu projeto. Ao final desta unidade do tutorial, você terá criado um projeto de aplicação web e confirmado que você pode compilar o projeto com sucesso, implantá-lo em seu servidor de desenvolvimento e executá-lo no IDE.

Você também aprenderá como conectar o IDE a um servidor de banco de dados MySQL, criar instâncias de bancos de dados e conectar-se a instâncias de bancos de dados a partir da janela Serviços do IDE. Nesta unidade, você criará um novo banco de dados chamado `affablebean`, que você usará durante todo o tutorial.

Você pode exibir uma demonstração ao vivo da aplicação construída neste tutorial: link:http://dot.netbeans.org:8080/AffableBean/[+Aplicação de Demonstração do Tutorial do NetBeans E-commerce+]


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

|link:https://netbeans.org/downloads/index.html[+NetBeans IDE+] |Pacote Java, 6.8 ou 6.9 

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

|<<glassFish,GlassFish Server>> |v3 ou Open Source Edition 3.0.1 

|link:http://dev.mysql.com/downloads/mysql/[+Servidor de banco de dados MySQL+] |versão 5.1 
|===

*Observações:*

* O NetBeans IDE requer o Java Development Kit (JDK) para ser executado adequadamente. Se você não tiver nenhum dos recursos listados acima, o JDK deverá ser o primeiro item a ser submetido a download e instalado.
* O Pacote Java do NetBeans IDE inclui o Java Web e tecnologias EE, que são necessárias para a aplicação construída neste tutorial.
* O pacote Java do NetBeans IDE também inclui o GlassFish Server, necessário para este tutorial. Você poderia link:https://glassfish.dev.java.net/public/downloadsindex.html[+fazer download do GlassFish Server independentemente+], mas a versão fornecida pelo NetBeans do qual fez download tem a vantagem adicional de ser registrada automaticamente no IDE.


[[create]]
== Criando um Projeto Web

1. Inicie o NetBeans IDE. Se estiver executando o IDE pela primeira vez, você verá a Página Inicial do IDE. 
image::images/ide-start-page.png[title="A Página Inicial do NetBeans IDE"]

[start=2]
. Clique no botão Novo Projeto (image::images/new-project-btn.png[]) (Ctrl-Shift-N; ⌘-Shift-N no Mac) para criar um novo projeto Java Web. O assistente Novo Projeto será aberto para guiá-lo pelo processo. Em Categorias, selecione Java Web, depois, em Projetos, selecione Aplicação Web. 
image::images/new-project-wzd.png[title="Criar um projeto usando o Assistente Novo Projeto"]

[start=3]
. Clique em Próximo.

[start=4]
. Na Etapa 2: Nome e Localização, dê o nome `AffableBean` ao projeto. Nesta etapa, você também pode designar a localização em seu computador onde o projeto residirá. Por default, o IDE cria a pasta `NetBeansProjects` no seu diretório home. Se você quiser alterar a localização, insira o caminho no campo de texto Localização do Projeto.

[start=5]
. Clique em Próximo.

[start=6]
. Na Etapa 3: Servidor e Definições, especifique o GlassFish v3 como o servidor no qual o projeto será implantado durante o desenvolvimento. Já que o GlassFish v3 foi incluído na sua instalação do NetBeans, você verá que o GlassFish v3 está listado no campo drop-down Servidor. 

Se você quisesse implantar em um servidor que ainda não estivesse registrado no IDE, você deveria clicar no botão Adicionar e percorrer o assistente Adicionar Instância do Servidor. Você pode exibir todos os servidores registrados no IDE na janela Servidores (Selecione Ferramentas > Servidores no menu principal).


[start=7]
. Para a versão do Java EE, selecione Java EE 6 Web. 

A aplicação que você criar usará várias funcionalidades do Java EE 6, principalmente anotações de servlet (novo na link:http://jcp.org/en/jsr/summary?id=315[+Especificação do Servlet 3.0+]) e EJBs usados diretamente nos contêineres de servlets (novo na link:http://jcp.org/en/jsr/summary?id=318[+Especificação do EJB 3.1+]). O Servlet 3.0 e o EJB 3.1 são parte da plataforma Java EE 6, portanto, é necessário um servidor compatível com EE-6 como o GlassFish v3 para usar neste tutorial. Para obter mais informações, consulte link:entity-session.html#specification[+Sobre Especificações e Implementações+].

[start=8]
. Certifique-se de que a opção "Ativar a Injeção de Dependência e Contextos" não está selecionada. Essa opção é específica para a tecnologia CDI (Injeção de Dependência e Contextos), especificada por link:http://jcp.org/en/jsr/detail?id=299[+JSR-299+] e não será usada neste tutorial. Para obter mais informações, consulte link:../cdi-intro.html[+Introdução à Injeção de Dependência e Contextos e ao JSF 2.0+]. 
image::images/new-project-wzd2.png[title="Especificar servidor de desenvolvimento, versão do EE e se deseja incluir suporte CDI"] 

Observe que, por default, o caminho do contexto da aplicação é o nome do projeto. Esse é o caminho no qual sua aplicação pode ser acessada após ser implantada no servidor. Por exemplo, o GlassFish usa 8080 como seu número de porta default, portanto, durante o desenvolvimento, você poderá acessar o projeto em uma janela do browser a partir de:

[source,java]
----

http://localhost:8080/AffableBean/
----

[start=9]
. Clique em Finalizar. O IDE gera um projeto de esqueleto chamado `AffableBean` que adota as link:http://java.sun.com/blueprints/code/projectconventions.html#99632[+convenções J2EE Blueprints para aplicações web+]. O IDE exibe as várias janelas em seu layout default. 
[.feature]
--
image::images/ide-default-layout.png[role="left", link="images/ide-default-layout.png"]
--

[start=10]
. Examine o layout default do IDE. Segue aqui uma breve visão geral da janelas e guias exibidas:
* *O Editor:* O editor (Ctrl-0; ⌘-0 no Mac) é o componente central do IDE e é onde você provavelmente gastará uma grande parte do seu tempo. O editor adapta-se, automaticamente, ao idioma no qual você está trabalhando, fornecendo suporte à documentação, autocompletar código, dicas e mensagens de erro específicas da tecnologia na qual você está codificando.
* *Janela Projetos:* A janela Projetos (Ctrl-1; ⌘-1 no Mac) é o ponto de entrada para os códigos-fonte do seu projeto. Fornece uma _view lógica_ do conteúdo importante do projeto e agrupa os arquivos com base em suas funções (por exemplo, `Configuration Files`). Ao clicar com o botão direito do mouse na janela Projetos, você pode chamar ações comuns às suas tarefas de desenvolvimento (ou seja, `Build`, `Clean`, `Deploy` e `Run`).
* *Janela Arquivos:* A janela Arquivos (Ctrl-2; ⌘-2 no Mac) oferece uma view com base em diretório do seu projeto. Ou seja, permite que você exiba a estrutura do projeto como ele existe no sistema de arquivos do computador. Nessa janela, é possível exibir todos os arquivos que pertencem ao seu projeto, incluindo o script de construção Ant, (`build.xml`), e os arquivos necessários pelo IDE para tratar o projeto (contidos na pasta `nbproject`). Se você tiver executado o projeto, poderá ver a localização dos arquivos Java compilados (pasta `build`). Se tiver explicitamente construído o seu projeto (escolhendo Construir ou Limpar e Construir no menu de contexto do nó do projeto da janela Projetos), você poderá ver o arquivo WAR distribuível do projeto (contido na pasta `dist`).
* *Navegador:* O Navegador (Ctrl-7; ⌘-7 no Mac) fornece uma visão geral estrutural do arquivo aberto no editor. Por exemplo, se uma página web HTML for exibida, o Navegador listará os nós de tags das listas, de maneira que correspondam ao Modelo de Objeto de Documento (DOM) da página. Se uma classe Java estiver aberta no editor, o Navegador exibirá as propriedades e os métodos pertencentes àquela classe. Você pode usar o Navegador para navegar até os itens no editor. Por exemplo, ao clicar duas vezes em um nó no Navegador, seu cursor será levado diretamente àquele elemento no editor.
* *Janela Tarefas:* A janela Tarefas (Ctrl-6; ⌘-6 no Mac) faz a varredura do código automaticamente e lista as linhas com erros de compilação, correções rápidas e advertências de estilo. Para classes Java, também lista as linhas comentadas que contêm palavras como “`TODO`” ou “`FIXME`”.
* *Janela Serviços:* A janela Serviços (Ctrl-5; ⌘-5 no Mac) fornece uma interface para gerenciar os servidores, os Web services, os bancos de dados e as conexões de bancos de dados, assim como outros serviços relacionados ao desenvolvimento de equipe.
* *Janela Saída:* _(Não exibida)_ A janela Saída (Ctrl-4; ⌘-4 no Mac) é exibida automaticamente quando você chama uma ação que invoca um serviço, geralmente de um recurso externo, como um servidor, e pode espelhar os arquivos de log do servidor. Em projetos Web, também permite exibir informações relacionadas às tarefas Ant (por exemplo, `Build`, `Clean and Build` e `Clean`).
* *Paleta:* _(Não exibido)_ A Paleta (Ctrl-Shift-8; ⌘-Shift-8 no Mac) fornece vários snippets de códigos úteis que você pode arrastar e soltar no editor. Muitos dos snippets incluídos na Paleta também são acessíveis chamando autocompletar código no editor, como será demonstrado posteriormente.

*Observação:* Todas as janelas do IDE podem ser acessadas no item de menu Janela.


[[run]]
== Executando o Projeto Web

1. Execute o novo projeto `AffableBean`. Na janela Projetos, você pode fazer isso clicando com o botão direito do mouse no nó do projeto e selecionando Executar. Caso contrário, clique no botão Executar Projeto (image::images/run-project-btn.png[]) (F6; fn-F6 no Mac) na barra de ferramentas principal do IDE. 

Uma janela do browser será aberta para exibir a página de boas-vindas do projeto. 
image::images/hello-world.png[title="O projeto será automaticamente implantado no servidor e será exibido no browser"] 
Então, o que acabou de acontecer? Quando você executa um projeto web, o IDE chama o destino Ant `run` no script de construção do seu projeto. Investigue abrindo o arquivo `build.xml` de seu projeto no editor.

[start=2]
. Alterne para a janela Arquivos (Ctrl-2; ⌘-2 no Mac), expanda o nó do projeto e clique duas vezes no arquivo `build.xml` contido em seu projeto. Quando o arquivo `build.xml` é aberto no editor, o Navegador lista todos os destinos Ant disponíveis para o script. 
image::images/navigator-ant-targets.png[title="O Navegador lista todos os destinos Ant disponíveis para o script build.xml"]

Destinos Ant normais são exibidos usando o ícone destino Geral (image::images/ant-normal-icon.png[]). O ícone do destino Ant (image::images/ant-emphasized-icon.png[]) _enfatizado_ simplesmente indica que o destino inclui uma descrição, que é exibida como uma dica de ferramenta (como mostrado na imagem acima). Para obter mais informações, consulte link:../../java/project-setup.html[+Criando, Importando e Configurando Projetos Java+].


[start=3]
. Clique duas vezes no destino `run`. O arquivo `build-impl.xml` será aberto no editor e exibe a definição do destino.

[source,java]
----

<target depends="run-deploy,run-display-browser" description="Deploy to server and show in browser." name="run"/>
----
Por que o arquivo `build-impl.xml` abre quando clicamos em um destino de `build.xml`? Se você alternar de volta para `build.xml` (Ctrl-Tab) e examinar o conteúdo do arquivo, você verá a seguinte linha:

[source,java]
----

<import file="nbproject/build-impl.xml"/>
----

O script de construção do projeto é basicamente um arquivo vazio que importa destinos definidos do NetBeans de `nbproject/build-impl.xml`.

Você pode editar livremente o script `build.xml` padrão do seu projeto adicionando novos destinos ou substituindo destinos definidos do NetBeans existentes. Entretanto, você não deve editar o arquivo `build-impl.xml`.

Você pode ver na definição do destino `run` que ele é dependente dos seguintes destinos:
* `run-deploy`
* `run-display-browser`
Esses dois destinos, por sua vez, dependem de outros destinos, que podem ser examinados em qualquer lugar no arquivo `build-impl.xml`. Mas, essencialmente, as seguintes ações ocorrem quando o destino `run` é chamado:
1. O projeto é compilado.
2. O arquivo WAR é criado.
3. O servidor é iniciado (caso já não esteja sendo executado).
4. O arquivo WAR é implantado no servidor designado.
5. O browser é aberto para exibir o URL do servidor e os caminhos de contexto da aplicação.

Consulte o link:http://ant.apache.org/manual/index.html[+Manual do Ant+] oficial para obter mais informações sobre como usar o Ant.


[start=4]
. Para gerar um arquivo WAR distribuível para seu projeto, selecione Limpar e Construir Projeto (ou Limpar e Construir Projeto Principal) no menu Executar do IDE.

[start=5]
. Na janela Arquivos (Ctrl-2; ⌘-2 no Mac), expanda o nó do projeto. A pasta `dist` contém arquivo WAR do projeto. A pasta `build` contém seu projeto compilado. 
image::images/files-window.png[title="A janela Arquivos fornece uma view baseada em diretório de seu projeto"]

*Observação:* se você _limpar_ o projeto (na janela Projetos, selecione Limpar no menu de contexto do nó do projeto), essas duas pastas serão removidas.


[start=6]
. Alterne para a janela Serviços (Ctrl-5; ⌘-5 no Mac) e expanda o nó Servidores > GlassFish Server 3 > Aplicações. 
image::images/services-win-deployed-app.png[title="A janela Serviços exibe o status do servidor, aplicações implantadas e recursos"]

*Observação:* O "GlassFish v3" é o nome default do servidor para os usuários do NetBeans 6.8.

O ícone da seta verde no nó do GlassFish Server (image::images/gf-server-running-node.png[]) indica que o servidor está sendo executado. A pasta Aplicações lista todas as aplicações implantadas e você pode ver que a aplicação `AffableBean` foi implantada com sucesso.

Nesta etapa, você já criou um projeto Java Web no IDE e confirmou que ele pode ser compilado e implantado com sucesso no seu servidor de desenvolvimento e aberto em um browser ao ser executado.


[[communicate]]
== Comunicando-se com o Servidor de Banco de Dados

Depois de ter feito download e instalado o servidor de banco de dados MySQL, você pode conectar-se a ele a partir do IDE. Uma instalação default usa “`root`” e '’ (uma string vazia) como a conta de usuário e senha para conectar-se ao servidor de banco de dados. No entanto, devido aos problemas de conectividade com o GlassFish, recomendamos que você use uma conta com uma senha que não seja vazia.^<<footnote1,[1]>>^ As seguintes instruções demonstram como executar o servidor de banco de dados e alterar a senha da conta `root` para “`nbuser`” na linha de comandos do MySQL. A combinação “`root`”/“`nbuser`” é usada por todo o Tutorial do NetBeans E-commerce. Com o servidor do banco de dados sendo executado e configurado adequadamente, você o registra no IDE e cria uma instância do banco de dados.

*Observação:* As instruções da linha de comandos abaixo presumem que você já adicionou o comando `mysql` à variável de ambiente `PATH`. (Se ainda não o tiver feito, você receberá um erro “`mysql: command not found`” ao inserir comandos `mysql` na linha de comandos.) 

Se você ainda não tiver adicionado `mysql` a `PATH`, você pode chamar o comando inserindo o caminho completo no diretório `bin` de instalação do MySQL. Por exemplo, se o comando `mysql` estiver localizado em seu computador em `/usr/local/mysql/bin`, você deverá digitar o seguinte:


[source,java]
----

shell> */usr/local/mysql/bin/*mysql -u root
----

Para obter mais informações, consulte o Manual de Referência oficial do MySQL:

* link:http://dev.mysql.com/doc/refman/5.1/en/general-installation-issues.html[+2.1. Orientações Gerais de Instalação+]
* link:http://dev.mysql.com/doc/refman/5.1/en/default-privileges.html[+2.13.2. Protegendo as Contas MySQL Iniciais+]
* link:http://dev.mysql.com/doc/refman/5.1/en/invoking-programs.html[+4.2.1. Chamando Programas MySQL+]
* link:http://dev.mysql.com/doc/refman/5.1/en/setting-environment-variables.html[+4.2.4. Configurando Variáveis de Ambiente+]


Execute as seguintes etapas.

* <<check,Verifique se o Servidor MySQL está sendo Executado>>
* <<start,Inicie o Servidor do Banco de Dados>>
* <<password,Altere a Senha>>
* <<register,Registre o Servidor no IDE>>
* <<database,Crie uma Instância de Banco de Dados>>


[[check]]
=== Verifique se o Servidor MySQL Server está sendo Executado

Antes de se conectar ao servidor MySQL pelo IDE, certifique-se de que o servidor está sendo executado. Uma maneira de fazer isso é usar o comando `ping` do cliente do link:http://dev.mysql.com/doc/refman/5.1/en/mysqladmin.html[+`mysqladmin`+].

1. Abra um prompt de linha de comandos e digite o seguinte:

[source,java]
----

shell> mysqladmin ping
----
Se o servidor estiver sendo executado, você verá uma saída semelhante a:

[source,java]
----

mysqld is alive
----
Se o servidor não estiver sendo executado, você verá uma saída semelhante a:

[source,java]
----

mysqladmin: connect to server at 'localhost' failed
error: 'Can't connect to local MySQL server through socket '/tmp/mysql.sock'
Check that mysqld is running and that the socket: '/tmp/mysql.sock' exists!
----


[[start]]
=== Inicie o Servidor do Banco de Dados

No caso de o servidor MySQL não estar sendo executado, você poderá iniciá-lo com a linha de comandos. Consulte link:http://dev.mysql.com/doc/refman/5.1/en/automatic-start.html[+2.13.1.2. Iniciando e Parando o MySQL Automaticamente+] para obter uma breve visão geral entre das várias plataformas. As etapas a seguir fornecem instruções gerais, dependendo do seu sistema operacional.


==== Sistemas tipo Unix:

Para sistemas tipo Unix, é recomendado iniciar o servidor MySQL chamando link:http://dev.mysql.com/doc/mysql-startstop-excerpt/5.1/en/mysqld-safe.html[+`mysqld_safe`+].

1. Abra um prompt de linha de comandos e execute o comando `mysqld_safe`:

[source,java]
----

shell> sudo ./mysqld_safe
----
Você verá uma saída semelhante à seguinte:

[source,java]
----

090906 02:14:37 mysqld_safe Starting mysqld daemon with databases from /usr/local/mysql/data
----


==== Windows:

O instalador MySQL do Windows permite a instalação do servidor do banco de dados como um serviço Windows, onde o MySQL é iniciado e interrompido automaticamente com o sistema operacional. Se você precisar iniciar o banco de dados manualmente, execute o comando link:http://dev.mysql.com/doc/mysql-startstop-excerpt/5.1/en/mysqld.html[+`mysqld`+] a partir da pasta `bin` do diretório de instalação.

1. Abra uma janela da console do Windows (no menu Iniciar, selecione Executar e digite `cmd` no campo de texto). A janela de linha de comandos será exibida.
2. Digite o seguinte comando (O caminho indicado presume que você tenha a versão 5.1 instalada na localização de instalação default):

[source,java]
----

C:\> "C:\Program Files\MySQL\MySQL Server 5.1\bin\mysqld"
----

Para obter mais informações, consulte o Manual de referência MySQL oficial: link:http://dev.mysql.com/doc/refman/5.1/en/windows-start-command-line.html[+2.4.5.5. Iniciando o MySQL a partir da linha de comandos do Windows+].


[[password]]
=== Alterar a Senha

Para definir a senha da conta `root` como “`nbuser`”, execute as seguintes etapas.

1. Abra um prompt de linha de comandos e digite o seguinte:

[source,java]
----

shell> mysql -u root
mysql> UPDATE mysql.user SET Password = PASSWORD('nbuser') WHERE User = 'root';
mysql> FLUSH PRIVILEGES;
----

Para obter mais informações, consulte o Manual de referência oficial do MySQL: link:http://dev.mysql.com/doc/refman/5.1/en/default-privileges.html[+2.13.2. Protegendo as Contas MySQL Iniciais+].


[[register]]
=== Registrar o Servidor no IDE

A janela Serviços do IDE permite que você se conecte ao servidor, inicie e pare o servidor, exiba as instâncias de bancos do dados e os dados nelas contidas e também execute uma ferramenta de administração externa no servidor.

1. Na janela Serviços, clique com o botão direito do mouse no nó Bancos de Dados e selecione Registrar Servidor MySQL. 
image::images/register-mysql-server.png[title="Registrar um servidor MySQL na janela Serviços do IDE"] 
Na caixa de diálogo Propriedades do Servidor MySQL, na guia Propriedades Básicas, é possível ver as definições default da instalação do servidor MySQL. São elas:
* *Nome do Host do Servidor:* `localhost`
* *Número da Porta do Servidor:* `3306`
* *Nome do Usuário Administrador:* `root`
* *Senha do Administrador:* `nbuser`

[start=2]
. Selecione a opção Salvar Senha. 
image::images/mysql-server-properties.png[title="Especificar definições do servidor MySQL"]

[start=3]
. Clique em OK. O IDE se conecta ao seu servidor de banco de dados MySQL e lista as instâncias do bancos de dados que são mantidas pelo servidor. Se expandir o nó Drivers, você também poderá ver que o IDE contém o link:http://dev.mysql.com/doc/refman/5.1/en/connector-j.html[+driver JDBC/Conector+] para MySQL. 
image::images/services-win-mysql.png[title="Conectar - se a um servidor MySQL na janela Serviços"] 
O servidor de aplicações (ou seja, GlassFish) requer o driver para ativar a comunicação entre o seu código Java e o banco de dados MySQL. Devido ao IDE já conter o driver J/Conector, você não precisará fazer download dele. Além disso, como será demonstrado posteriormente, você pode especificar nas definições do servidor a ativação da implantação automática do driver JDBC no GlassFish, caso ele esteja ausente no servidor. 

As etapas 4 a 7 abaixo são opcionais. Você pode configurar o IDE para iniciar e parar o servidor MySQL e também executar uma ferramenta de administração externa no servidor.

[start=4]
. Clique com o botão direito do mouse no nó do servidor MySQL e selecione Propriedades. Na caixa de diálogo Propriedades do Servidor MySQL, selecione a guia Propriedades de Admin.

[start=5]
. No campo “Caminho/URL para ferramenta admin”, digite o caminho no seu computador para o arquivo executável da ferramenta de administração do banco de dados, como, por exemplo, o link:http://dev.mysql.com/doc/administrator/en/mysql-administrator-introduction.html[+MySQL Administrator+]. O MySQL Administrator está incluído no pacote link:http://dev.mysql.com/downloads/gui-tools/[+MySQL GUI Tools+].

[start=6]
. No campo “Caminho para o comando iniciar”, digite o caminho para o comando iniciar do MySQL (ou seja, `mysqld` ou `mysqld_safe`), dependendo do seu sistema operacional. (Consulte <<start,Iniciar o Servidor do Banco de dados>> acima.) 

*Observação:* Para sistemas tipo Unix, você pode descobrir que só pode chamar o comando iniciar com privilégios administrativos ou como root. Para superar isso, você pode criar um script (usando link:http://www.nongnu.org/gksu/[+GKSu+] para Linux e Solaris e link:http://developer.apple.com/mac/library/documentation/Darwin/Reference/ManPages/man1/osascript.1.html[+osascript+] para Mac) que irá realizar a tarefa. Para obter mais informações, consulte link:http://davidvancouvering.blogspot.com/2008/09/starting-mysql-in-netbeans-as.html[+o post deste blog+].


[start=7]
. No campo “Caminho para o comando parar”, digite o caminho para o comando parar do MySQL (ou seja, `mysqladmin shutdown`). Devido a esse comando exigir uma conta de usuário com privilégios de shutdown, você precisa inserir as credenciais de nome de usuário/senha no campo Argumentos. Por exemplo:
* *Argumentos:* `-u root -pnbuser shutdown`

Depois de ter definido os campos listados na guia Propriedades Avançadas, você poderá:

* *Iniciar o servidor MySQL:* Clique com o botão direito do mouse no nó do servidor MySQL e selecione Iniciar.
* *Parar o servidor MySQL:* Clique com o botão direito do mouse no nó do servidor MySQL e selecione Parar.
* *Executar a ferramenta de administração externa:* Clique com o botão direito do mouse no nó do servidor MySQL e selecione Executar Ferramenta de Administração.


[[database]]
=== Criar uma Instância do Banco de Dados

1. Crie a instância do banco de dados que será usada neste tutorial. Para fazer isso, clique com o botão direito do mouse no nó do servidor MySQL e selecione Criar Banco de Dados.
2. Na caixa de diálogo que é exibida, digite `affablebean`. Selecione a opção “Conceder Acesso Total para” e, em seguida, selecione `root@localhost` no campo drop-down. Isso permite que a conta `root` no host `localhost` acesse o banco de dados. Posteriormente, ao criar um pool de conexões no servidor, você precisará fornecer a conta `root` e a senha `nbuser` como as credenciais de nome de usuário/senha para conceder ao servidor o acesso ao banco de dados. 
image::images/create-mysql-db-dialog.png[title="Clique com o botão direito do mouse no nó do servidor e selecione Criar Banco de Dados para criar uma nova instância do banco de dados"]

[start=3]
. Clique em OK. Quando você faz isso, o banco de dados chamado `affablebean` é criado, e a conexão ao banco de dados é estabelecida automaticamente. As conexões são exibidas na janela Serviços usando um nó de conexão (image::images/db-connection-node.png[]).

*Observação:* Os nós de conexão são mantidos na janela Serviços. Se você reiniciar o IDE, o nó de conexão será exibido com uma linha serrilhada (image::images/connection-broken.png[]), indicando que a conexão está interrompida. Para conectar-se novamente ao banco de dados, certifique-se de que o servidor do banco de dados está sendo executado e, em seguida, clique com o botão direito do mouse no nó e selecione Conectar.


[start=4]
. Expanda o nó de conexão do banco de dados `affablebean`. A conexão contém o esquema default do banco de dados (`affablebean`), e dentro dele existem nós para tabelas, views e procedimentos. Atualmente, eles estão vazios, pois ainda não criamos nada. 
image::images/db-conn-affable-bean.png[title="As conexões de banco de dados contêm o esquema default do banco de dados e os nós de tabelas, views e procedimentos"]

Neste estágio, você já criou a conexão ao servidor MySQL a partir do IDE e já criou um novo bando de dados chamado `affablebean`, que você usará durante todo o tutorial. Além disso, você criou o projeto Java Web no IDE e confirmou que ele pode ser compilado e implantado com sucesso no seu servidor de desenvolvimento e aberto em um browser ao ser executado. Agora que o ambiente de desenvolvimento está pronto, você pode começar a esboçar o modelo de dados da aplicação.

link:/about/contact_form.html?to=3&subject=Feedback: NetBeans E-commerce Tutorial - Setting up the Development Environment[+Envie-nos Seu Feedback+]


[[seeAlso]]
== Consulte Também


=== Recursos do NetBeans

* link:../../java/project-setup.html[+Criando, Importando e Configurando Projetos Java+]
* link:../../../articles/mysql.html[+MySQL e NetBeans IDE+]
* link:../../ide/mysql.html[+Conectando a um Banco de Dados MySQL+]
* link:../../web/mysql-webapp.html[+Criando uma Aplicação Web Simples Usando um Banco de Dados MySQL+]


=== Recursos Externos

* link:http://ant.apache.org/manual/index.html[+Manual do Usuário do Apache Ant+]
* link:http://ant.apache.org/manual/tutorial-HelloWorldWithAnt.html[+Hello World com Ant+]
* link:http://dev.mysql.com/doc/refman/5.1/en/[+Manual de Referência do MySQL 5.1+]
* link:http://dev.mysql.com/doc/administrator/en/index.html[+Manual de Referência do MySQL Administrator+]


=== Livros

* link:https://netbeans.org/kb/articles/books.html[+Livros do NetBeans+]
* link:http://www.apress.com/book/view/1590598954[+Pro NetBeans IDE 6 Rich Client Platform Edition+]
* link:http://apress.com/book/view/1430219548[+Iniciando a Plataforma Java EE 6 com o GlassFish 3: Do Novato ao Profissional+]


== Referências

1. <<1,^>> Usando o GlassFish v3, você pode criar um pool de conexões para um servidor de banco de dados MySQL usando uma senha vazia. O GlassFish Open Source Edition 3.0.1, incluído no NetBeans IDE 6.9, não ativa uma conexão usando uma senha vazia. Consulte link:https://glassfish.dev.java.net/issues/show_bug.cgi?id=12221[+GlassFish Edição 12221+].