Skip to content

Latest commit

 

History

History
95 lines (70 loc) · 3.4 KB

_OneDayTutorial.adoc

File metadata and controls

95 lines (70 loc) · 3.4 KB

A One Day Tutorial

In this chapter we will create the “Contacts” Scout application. The goal of this tutorial application is to learn about the most prominent features of the Eclipse Scout framework using a fully functional application.

The application is kept small enough to complete this tutorial within less than a day. An extended version of “Contacts” is available as a Scout sample application on Github.

As a prerequisite to this tutorial we assume that the reader has successfully completed the chapters "Hello World Tutorial" and "Import the Scout Demo Applications" as described in the Eclipse Scout user guide. To access the Scout user guide help hit F1 in the Eclipse IDE. This opens the Eclipse help view that includes the Eclipse Scout User Guide as shown in The Eclipse help view including the Eclipse Scout User Guide..

sdk f1
Figure 1. The Eclipse help view including the Eclipse Scout User Guide.

The “Contacts” tutorial is organized as follows. In the first section, the finished “Contacts” application is explained from the user perspective. The remaining sections focus on the individual steps to implement the “Contacts” tutorial application.

Setting up the Initial Project

Adding the Person and Organization Page

Creating and Accessing the Database

Adding a Form to Create/Edit Persons

Form Field Validation and Template Fields

Adding the Company Form

Additional Concepts and Features

Git configuration

If you want to add the created application to a Git repository there might some configurations be helpful. If there are no plans to use Git, this chapter can be skipped.

E.g. it is best practice to exclude some files from adding to a Git repository. These exclusions can be configured by creating a file named .gitignore in the root folder of the repository (see the Git Documentation for details). Here is a sample file that might be used as starting point:

# Git
*.orig

# Maven
target/
.surefire-*
.flattened-pom.xml

# Do not check in any log files
*.log