Differences

This shows you the differences between two versions of the page.

--- jvx:firstapp_step-by-step [2018/01/30 08:12]
admin
+++ jvx:firstapp_step-by-step [2018/01/30 10:20]
admin
@@ Line 20: / Line 20: @@
       * Client
       * Server
-  * [[#workscreen|Creation of a work screen]]
+  * [[#create_a_work_screen|Creation of a work screen]]
-  * [[#hypersql|Use of a HyperSQL database]]
+  * [[#create_database|Use of a HyperSQL database]]
 == Folder structure ==
@@ Line 39: / Line 39: @@
 |apps|Contains all available applications. Only one application is contained in this concrete example.|
 |firstapp|Contains the application with project configuration, sources, libraries.|
-|help|Contains the client (GWT) for the online help and help pages.|
+|help|Contains the client for the online help and help pages.|
 |libs|Contains all libraries which are necessary both on the client and the server.|
 |libs/client|Contains all libraries which are only necessary for the client.|
@@ Line 47: / Line 47: @@
 |test|Contains unit tests for the client and server or the libraries.|
-Once the folder structure has been created, copy the library jvxclient.jar to the folder libs/client and the library jvx.jar to the folder libs/server. Both libraries are contained in the JVx binary package.
+Once the folder structure has been created, copy the library ''jvxclient.jar'' to the folder ''libs/client'' and the library ''jvx.jar'' to the folder ''libs/server''. Both libraries are contained in the JVx binary package.
 == Project configuration ==
@@ Line 54: / Line 54: @@
   * **File / New / Java Project**
-  * Note that the project has to be set up in the application folder firstapp. \\ {{:jvx:newproject.png?nolink|}}
+  * Note that the project has to be set up in the application folder firstapp \\ {{:jvx:newproject.png?nolink|}}
   * **Remove** the src folder from the **Source Folders** \\ **Set** the folders ''src.client'', ''src.server'' and ''test'' as **Source Folder** \\ {{:jvx:newproject_folders.png?nolink|}}
   * **Add** the ''jvx.jar'' library, from the project directory ''JVxFirstApp/libs/server'' \\ {{:jvx:newproject_libs.png?nolink|}}
@@ Line 331: / Line 331: @@
 We now create the client class for our work screen:
-  * **File** / **New** / **Class** \\ {{:jvx:dbedit_new.png?nolink|}}
+  * **File** / **New** / **Class** \\ ''src.client'', ''apps.firstapp.frames.DBEditFrame''\\ {{:jvx:dbedit_new.png?nolink|}}
 and use the following Source Code:
@@ Line 378: / Line 378: @@
   /**
    * Creates a new instance of DBEditFrame for a specific application.
- * <p/>
+   * <p/>
- * @param pApp the application
+   * @param pApp the application
- * @throws Throwable if the remote access fails
+   * @throws Throwable if the remote access fails
- */
+   */
- public DBEditFrame(Application pApp) throws Throwable
+  public DBEditFrame(Application pApp) throws Throwable
- {
+  {
- super(pApp.getDesktopPane());
+    super(pApp.getDesktopPane());
- application = pApp;
+    application = pApp;
- initializeModel();
+    initializeModel();
- initializeUI();
+    initializeUI();
- }
+  }
- /**
+  /**
- * Initializes the model.
+   * Initializes the model.
- * <p/>
+   * <p/>
- * @throws Throwable if the initialization throws an error
+   * @throws Throwable if the initialization throws an error
- */
+   */
- private void initializeModel() throws Throwable
+  private void initializeModel() throws Throwable
- {
+  {
- //we use a new "session" for the screen
+    //we use a new "session" for the screen
- connection = ((MasterConnection)application.getConnection()).
+    connection = ((MasterConnection)application.getConnection()).
- createSubConnection("apps.firstapp.frames.DBEdit");
+    createSubConnection("apps.firstapp.frames.DBEdit");
- connection.open();
+    connection.open();
- //data connection
+    //data connection
- dataSource.setConnection(connection);
+    dataSource.setConnection(connection);
- dataSource.open();
+    dataSource.open();
- //table
+    //table
- rdbContacts.setDataSource(dataSource);
+    rdbContacts.setDataSource(dataSource);
- rdbContacts.setName("contacts");
+    rdbContacts.setName("contacts");
- rdbContacts.open();
+    rdbContacts.open();
- }
+  }
- /**
+  /**
- * Initializes the UI.
+   * Initializes the UI.
- * <p/>
+   * <p/>
- * @throws Exception if the initialization throws an error
+   * @throws Exception if the initialization throws an error
- */
+   */
- private void initializeUI() throws Exception
+  private void initializeUI() throws Exception
- {
+  {
- UIGroupPanel group = new UIGroupPanel();
+    UIGroupPanel group = new UIGroupPanel();
- group.setText("Available Contacts");
+    group.setText("Available Contacts");
- UITable table = new UITable();
+    UITable table = new UITable();
- table.setDataBook(rdbContacts);
+    table.setDataBook(rdbContacts);
- group.setLayout(new UIBorderLayout());
+    group.setLayout(new UIBorderLayout());
- group.add(table);
+    group.add(table);
- //same behaviour as centered component in BorderLayout
+    //same behaviour as centered component in BorderLayout
- setLayout(new UIBorderLayout());
+    setLayout(new UIBorderLayout());
- add(group);
+    add(group);
- setTitle("Contacts");
+    setTitle("Contacts");
- setSize(new UIDimension(400, 500));
+    setSize(new UIDimension(400, 500));
- }
+  }
- //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+  //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- // Overwritten methods
+  // Overwritten methods
- //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+  //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- /**
+  /**
- * Closes the communication connection and disposes the frame.
+   * Closes the communication connection and disposes the frame.
- */
+   */
- @Override
+  @Override
- public void dispose()
+  public void dispose()
- {
+  {
- try
+    try
- {
+    {
- connection.close();
+      connection.close();
- }
+    }
- catch (Throwable th)
+    catch (Throwable th)
- {
+    {
- //nothing to be done
+      //nothing to be done
- }
+    }
- finally
+    finally
- {
+    {
- super.dispose();
+      super.dispose();
- }
+    }
- }
+  }
 } // DBEditFrame
@@ Line 509: / Line 509: @@
 The client implementation is now finished. Before we can use the application, we must create the missing server classes. We create the following classes:
-  * {{:jvx:lco_application.png?nolink|}}
+  * **File** / **New** / **Class** \\ ''src.server'', ''apps.firstapp.Application''\\ {{:jvx:lco_application.png?nolink|}}
 <file java Application.java>
@@ Line 530: / Line 530: @@
 |The class represents the lifecycle object for an application. There is exactly one instance of this class for each application, thereby enabling the use of session-wide objects.|
-  * {{:jvx:lco_session.png?nolink|}}
+  * **File** / **New** / **Class** \\ ''src.server'', ''apps.firstapp.Session'' \\ {{:jvx:lco_session.png?nolink|}}
 <file java Session.java>
@@ Line 583: / Line 583: @@
 |getDBAccess|Opens a new connection to a HyperSQL database, if this has not already happened. \\ \\ The Exception Handling is taken over by the server.|
-  * {{:jvx:lco_dbedit.png?nolink|}}
+  * **File** / **New** / **Class** \\ ''src.server'', ''apps.firstapp.frames.DBEdit'' \\ {{:jvx:lco_dbedit.png?nolink|}}
 <file java DBEdit.java>