Trace:
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision Next revision Both sides next revision | ||
jvx:firstapp_step-by-step [2018/01/29 22:16] admin created |
jvx:firstapp_step-by-step [2018/01/29 22:25] admin |
||
---|---|---|---|
Line 15: | Line 15: | ||
This documentation covers the following areas: | This documentation covers the following areas: | ||
- | * [[#folders|JVx folder structure]] | + | * [[#folder_structure|JVx folder structure]] |
- | * [[#eclipse|Eclipse project configuration]] | + | * [[#project_configuration|Eclipse project configuration]] |
- | * [[#application|Application development]] | + | * [[#application_development|Application development]] |
* Client | * Client | ||
* Server | * Server | ||
Line 23: | Line 23: | ||
* [[#hypersql|Use of a HyperSQL database]] | * [[#hypersql|Use of a HyperSQL database]] | ||
- | ====== Folder structure ====== | + | == Folder structure == |
To develop an application with JVx, a special folder structure is recommended. This simplifies the Build process and separates any dependencies between Client and Server. This structure is to be created as follows: | To develop an application with JVx, a special folder structure is recommended. This simplifies the Build process and separates any dependencies between Client and Server. This structure is to be created as follows: | ||
+ | {{:jvx:folders.png?nolink|}} | ||
+ | |||
+ | A conventional structure: | ||
+ | |||
+ | {{:jvx:folders_common.png?nolink|}} | ||
+ | |||
+ | can also be used on request. However, the documentation refers to the recommended structure. | ||
+ | |||
+ | ^Folder^Description^ | ||
+ | |rad|Contains application- and server-specific files.| | ||
+ | |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.| | ||
+ | |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.| | ||
+ | |libs/server|Contains all libraries which are only necessary for the server.| | ||
+ | |src.client|Contains all the sources which are only necessary for the client.| | ||
+ | |src.server|Contains all the sources which are only necessary for the server.| | ||
+ | |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. | ||
+ | |||
+ | == Project configuration == | ||
+ | |||
+ | Once the configuration steps have been performed, a new project can be created with Eclipse: | ||
+ | |||
+ | * **File / New / Java Project** | ||
+ | * 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|}} | ||
+ | * The project can now be created | ||
+ | |||
+ | The project is shown in Eclipse as follows: | ||
+ | |||
+ | {{:jvx:project_eclipse.png?nolink|}} | ||
+ | |||
+ | == Application development == | ||
+ | |||
+ | On the server side, the application needs a configuration file for the settings that only concern the application. For the configuration of the server, an extra configuration file is needed. First we create the file for the application: |