Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Scout/Concepts"

(Replaced content with "The Scout documentation has been moved to https://eclipsescout.github.io/.")
 
(9 intermediate revisions by 7 users not shown)
Line 1: Line 1:
[[Category:Scout]]
+
The Scout documentation has been moved to https://eclipsescout.github.io/.
{{ScoutPage|cat=Concepts}}
+
 
+
The Concepts pages define concepts and elements used in the Eclipse Scout Framework.
+
 
+
== Big Picture - Main Architecture of Scout ==
+
[[Image:Scout_main_architecture.png|thumb|right|200px|Scout Main Architecture]]
+
 
+
Scout is a framework for creating modern business applications. Such applications are typically separated into multiple tiers where each tier is responsible for a specific part of the application like presenting information to the user or processing business logic and persisting data.
+
 
+
Scout solves these requirements by providing a separation of such tiers out of the box. The two main tiers of Scout are the client part and the server part.
+
 
+
Scout is also a framework, which is simple to use but yet flexible. This is achieved, amongst other things, by using a stable platform as base, namely Eclipse / Equinox. By using this base on both the client and the server side, it becomes possible to use the same technologies and tools for creating the server and the client part. Even though these tiers are separated, there is no need to use different Eclipse workspaces or even different developers for each tier. One developer is able to create a multi tier application in one Eclipse workspace and still has a strict separation of client and server thanks to OSGI/Equinox.
+
 
+
Another thing that makes it so simple is the communication between these tiers. There is no need to explicitly define webservice and exchange WSDLs in the same application, only to show some information on a dialog (not implying that it would not possible to do so, it actually is!). Instead OSGi services are used where only an interface is sufficient. That interface for a service including the data transfer objects (DTO) is known on client and server side. This is achieved by having these interfaces in a shared part. With that mechanism it is possible to provide a service tunnel, which actually is one webservice tunneling every OSGi service call from client to server.
+
 
+
=== Plugin-Set ===
+
[[Image:Scout Client Shared Server.png|thumb|right|200px|Plugin-Set of a Scout Application]]
+
 
+
A Scout project is composed of different Eclipse plug-ins (each plug-in is an Eclipse Project).
+
* Client Plug-In (eg <code>your.application.client</code>)
+
* Shared Plug-In (eg <code>your.application.shared</code>)
+
* Server Plug-In (eg <code>your.application.server</code>)
+
 
+
Since the Scout runtime relies on a strict separation of business code and presentation code additional plugins are provided where GUI specific code is placed. Depending on the GUI implementation these plugins can be one of the following:
+
* SWT UI Plug-In for native desktop applications (eg <code>your.application.ui.swt</code>)
+
* Swing UI Plug-In for individual desktop applications (eg <code>your.application.ui.swing</code>)
+
* Rap UI Plugin for web (2.0) applications (eg <code>your.application.ui.rap</code>)
+
 
+
The image "Plugin-Set of a Scout Application" shows how the plug-ins are organized. In the above part of the image you can see the plug-ins of a typical scout application: client, shared, server and the ui-plugin. In to bottom part there are the equivalent plug-ins of the Scout Runtime Framework. All these plug-ins follow strict dependency rules which are represented by the arrows. The application's server plug-in for example does not know anything about the client it only knows the shared plug-ins and the server plugin of scout.
+
 
+
The Scout SDK relies on the following principles to recognize and display the structure of a Scout project:
+
 
+
* Each plug-in project is marked to be of "Scout Nature" in its .project file. This is handled by the Scout SDK for you if you create a new Scout project. You can also add an existing plug-in project to a Scout project  via the "Import Plugin..." menu in the Scout SDK. However, you then still need to handle the bundle dependencies and naming convention manually (see below).
+
* Bundle dependencies: A plug-in project is represented as a client component (orange box) if it depends on the org.eclipse.scout.rt.client bundle. Similarly, a shared or server component depends on the corresponding Scout RT bundle. Also, both the client and server bundles should depend on the shared bundle.
+
* Naming convention: A Scout project has a project name (e.g. my.project.name) and an optional project postfix (e.g. core). The plug-in projects then follow the naming pattern projectName.[client|shared|server].postfix. The full name of the client bundle then would be my.project.name.client.core.
+
 
+
== Overview of the concept pages ==
+
* {{ScoutLink|Concepts|Communication|Client/Server Communication}}
+
** Service Tunnel
+
** Session Handling
+
* {{ScoutLink|Concepts|Client Plug-In|Client part}}
+
** Separation of UI and GUI
+
** Threading and Jobs
+
** Layouting
+
** Component Model
+
* {{ScoutLink|Concepts|Server Plug-In|Server part}}
+
** Providing data for the client
+
** Accessing persistent data
+
** Webservice (JAX-WS) support
+
** Server Side Equinox
+
** Transaction Handling
+
* {{ScoutLink|Concepts|Shared Plug-In|Shared part}}
+
** {{ScoutLink|Concepts|NLS-Support|NLS-Support}}
+
** {{ScoutLink|Concepts|Logging|Logging}}
+
** {{ScoutLink|Concepts|Scheduler|Scheduler}}
+
** {{ScoutLink|Concepts|Client Notification|Client Notification}}
+
* {{ScoutLink|Concepts|Security|Security}}
+
** Security Principles of Scout
+
** Authentication
+
** Authorization
+
* {{ScoutLink|SDK|name=Scout SDK}}
+
 
+
== See also ==
+
*[[:Category:Scout_Concepts|All Eclipse Scout Concepts]]
+

Latest revision as of 05:43, 14 March 2024

The Scout documentation has been moved to https://eclipsescout.github.io/.

Back to the top