diff options
Diffstat (limited to 'documentation/getting-started/getting-started-netbeans.asciidoc')
-rw-r--r-- | documentation/getting-started/getting-started-netbeans.asciidoc | 61 |
1 files changed, 61 insertions, 0 deletions
diff --git a/documentation/getting-started/getting-started-netbeans.asciidoc b/documentation/getting-started/getting-started-netbeans.asciidoc new file mode 100644 index 0000000000..6e2fa660de --- /dev/null +++ b/documentation/getting-started/getting-started-netbeans.asciidoc @@ -0,0 +1,61 @@ +--- +title: Creating a Project with NetBeans IDE +order: 7 +layout: page +--- + +[[getting-started.netbeans]] += Creating a Project with NetBeans IDE + +The easiest way to develop Vaadin application with the NetBeans IDE is to use +the Vaadin Plugin for NetBeans. It allows you to create new Vaadin projects +easily and provides many features for working on a project. You can download the +plugin at http://plugins.netbeans.org/plugin/50531/vaadin-plug-in-for-netbeans. +The download page contains a link to a plugin features overview in NetBeans +Wiki. + +Without the plugin, you can most easily create a Vaadin project as a Maven +project using a Vaadin archetype. You can also create a Vaadin project as a +regular web application project, but it requires many manual steps to install +all the Vaadin libraries, create the UI class, configure the servlet, create +theme, and so on. + +[[getting-started.netbeans.maven]] +== Maven Project from a Vaadin Archetype + +Creating a Maven project with a Vaadin archetype creates an application skeleton +with a UI class and project theme, defines the [filename]#web.xml# deployment +descriptor, and also retrieves the latest Vaadin library automatically. + +. Select "File > New Project". + +. Select "Maven > Project from Archetype" and click [guibutton]#Next#. + +. Find [literal]#++vaadin-archetype-application++#, select it, and click +[guilabel]#Next#. + +. In the [guilabel]#Name and Location# step, enter [guilabel]#Project Name#, which +is recommended to be only lower-case alphabetics, as it is used also as a +suggestion for the Java package name of the project. Modify the other parameters +for your project and click [guibutton]#Finish#. + ++ +[[figure.getting-started.netbeans.maven.new-project]] +.Adding a New Maven Project in NetBeans +image::img/netbeans-maven-newproject-name.png[] + + +Creating the project can take a while as Maven loads all the needed +dependencies. Once created, you can run it by right-clicking on the project in +the [guilabel]#Projects# view and selecting [guilabel]#Run#. In the +[guilabel]#Select deployment server# window that opens, select +[guilabel]#Glassfish# or [guilabel]#Apache Tomcat#, and click [guibutton]#OK#. +If all goes well, NetBeans starts the server in port 8080 and, depending on your +system configuration, launches the default browser to display the web +application. If not, you can open it manually, for example, at +http://localhost:8080/myproject. The project name is used by default as the +context path of the application. + + + + |