Skip to content

Changes

Page history
michaela.bacikova created page: experiment 3 authored by Ing. Michaela Bačíková PhD.'s avatar Ing. Michaela Bačíková PhD.
Show whitespace changes
Inline Side-by-side
analyzing-java-applications.md
View page @ 3c8880ad
......@@ -2,32 +2,31 @@
## Project structure
Two main directories are important in DEAL:
* **src** - contains **source code** of DEAL. When creating any custom handlers, they should be created in this directory.
* **examples** - contains examples of **target applications** which can be analysed by DEAL.
The DEAL can be divided into two main parts:
* **DEAL source code** - all projects except DEALexamples.
* **Examples** - contains examples of **target applications** that can be analysed by DEAL.
## Introductory examples
In the DEAL prototype there are a few examples of target applications prepared in the examples directory. The target applications are open source Java applications downloaded from web (*.**jar** files).
In the DEAL prototype there are a few examples of target applications prepared in the DEALexamples project. The target applications are open source Java applications downloaded from web (*.**jar** files).
### Person form
**Person form** is a simple Java application example which was created for the purpose of testing. It is a simple form for inserting information about a person.
1. To **run** DEAL analysis on the Person form **select the DEALprototype project** in Eclipse.
2. Click with the right mouse button and select **Run As -> AspectJ/Java Application**.
![2.1runasaspjapp](/uploads/2ac80826c686fcf62ea7fda6a74af137/2.1runasaspjapp.png)
3. The important part of running DEAL analysis on existing applications is, that you have to know **the main class of the application, which you want to analyse**.
This you can get by **unzipping the jar of the target application** (rename it first to *.zip) and looking into the **manifest** file located in the unzipped directory. Don't forget to rename the zip file back to *.jar again.
4. In the **Select Java Application** dialog write **"Pers"** into the text field. Then select PersonForm_spinner from the list of matching items and click **OK**.
![2.2personform](/uploads/e2fe222dfd84837801e23f5e7f2adae8/2.2personform.png)
5. **Person Form** application (on the left) will start along with the DEAL analyser (on the right).
![2.3deal](/uploads/60a953318f69d50b59df894052458ab8/2.3deal.png)
6. Other examples can be launched exactly in the same way, but it is important to select the main class of the target application which you would like to launch. Please see the next section to know the main classes of the provided examples.
1. Create a **new run configuration** of type **AspectJ/Java application** in Eclipse with the following properties:
* Name: Person Form
* Project: DEALmain
* Main class: personform.PersonForm
![deal-run](/uploads/569d0b526cfa918568c56144d04196f8/deal-run.png)
2. Run the configuration
3. Other examples can be launched exactly in the same way, but it is important to select the main class of the target application which you would like to launch. Please see the next section to know the main classes of the provided examples.
> The important part of running DEAL analysis on existing applications is, that you have to know **the main class of the application, which you want to analyse**. This you can get by **unzipping the jar of the target application** (rename it first to *.zip) and looking into the **manifest** file located in the unzipped directory. Don't forget to rename the zip file back to *.jar again.
## Other Examples
Each of the examples packed in the **example** directory of the DEALprototype project can be started this way. The main task here is only to know the target application main class. Here we list all examples of open source Java applications packed in DEAL and their main classes for the purpose of trying any examples.
Each of the examples packed in the **DEALexamples** project of DEAL can be started this way. The main task here is only to know the target application main class. Here we list all examples of open source Java applications packed in DEAL and their main classes for the purpose of trying any examples.
| **Target application name** | **Application description** | **Main class** |
|----------------------------|-------------------------------------------------------------------------------------------------|--------------------------------------------|
......@@ -74,8 +73,8 @@ With DEAL, it is possible to generate an Ontology from the GUI of an existing ap
In case you would like to run DEAL on your own example, you have to have a ***.jar** file of such an application.
1. Copy the **jar** file of your application into the **examples** directory of the DEALproject (for example Total Commander or Windows Explorer).
2. In Eclipse right-click on the DEALproject and select **Refresh**. Your **jar** should appear in the examples folder of the DEALproject in Eclipse.
1. Copy the **jar** file of your application into the **examples** directory of the **DEALexamples** project.
2. In Eclipse, right-click on the DEALexamples and select **Refresh**. Your **jar** should appear in the examples folder of the DEALexamples project.
3. Right-click on your **jar** in Eclipse and select **AspectJ Tools -> Add to Inpath**.
4. To run DEAL with your application run it according to the tutorial but in the step (4.) select the main class of your **jar** application.
......