Changes for page Your First Framework

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -7,45 +7,45 @@
7	7	When a framework is built (with Ant or Maven), the structure is like this:
8	8
9	9	MyStuff.framework
10		-~-~-> Resources
	10	+-> Resources
	11	+~-~--> Info.plist
	12	+~-~--> Java
	13	+~-~-~-~--> mystuff.jar
	14	+~-~-~-~--> some-third-party.jar
	15	+~-~--> MyEOModel.eomodeld
	16	+~-~--> Properties
	17	+-> WebServerResources
	18	+~-~--> someimage.png
	19	+~-~--> somestyling.css
11	11
12		-----
	21	+So why using frameworks? Simple: to be able to use them in more than one project. Putting your EOModel into a framework is a good idea since you can built many different projects for the same business logic.
13	13
14		-~> Info.plist
	23	+= Creating the framework =
15	15
16		-----
	25	+So let's make a new framework. In Eclipse, open the **File** menu, select **New** and select **Wonder Framework**. Name it **BlogCommon** and click **Finish**.
17	17
18		-~> Java
	27	+Now you have another project in your Eclipse workspace. Open it and you will see that the folder structure is the same as for an Wonder application. A framework and an application in Eclipse is almost the same, the difference is the nature of the project and when the project is built, the product will be a bit different.
19	19
20		-----
	29	+The next step is to copy the EOModel and its related Java code to the framework. Open the **BlogRest** project, open its **Resources** folder, and select **BlogModel.eogen** and **BlogModel.eomodel**. Right-click on one of the two files and select **Refactor** > **Move**.
21	21
22		-~> mystuff.jar
	31	+You will see the list of all opened projects in your Eclipse workspace, and we want to copy the two files into the **BlogCommon** project. Select the **Resources** folder of the **BlogCommon** project and click **OK**.
23	23
24		-----
	33	+We need to do similar steps for the Java code. Open the **Sources** folder of the **BlogRest** project. Select the **your.app.model** and **your.app.model.migrations** packages, right-click on one of the packages, and select **Refactor** > **Move**. For the destination, select the **Sources** folder, and click **OK**.
25	25
26		-~> some-third-party.jar
	35	+= Linking the application with the framework =
27	27
28		-----
	37	+If you go back to the **BlogRest** project, you will see compilation errors. We need to link the application project with the framework project. To do so, right-click on the **BlogRest** project, and select **Build Path** > **Configure Build Path**.
29	29
30		-~> MyEOModel.eomodeld
	39	+Click the **Libraries** tab, and you will see the list of Java archives (.jar) and Project Wonder frameworks.
31	31
32		-----
	41	+To add **BlogCommon** to the build path (aka the class path), click on **Add Library**.
33	33
34		-~> Properties
35		-~-~-> WebServerResources
	43	+Select **WebObjects Frameworks** and click **Next**.
36	36
37		-----
	45	+You will see a list of all frameworks that you can add to your project. Check **BlogCommon** in the list and click **Finish**. Click **OK** in the **Properties** window to go back to the main Eclipse window.
38	38
39		-~> someimage.png
	47	+You can see that all compilation errors are now gone. The next thing we need to do is to link the H2PlugIn with the **BlogCommon** framework. Why? Because since we moved the database model to the framework, the framework needs the JDBC plugin included in the H2PlugIn in its build path. To do so, right-click on the **BlogCommon** project, and select **Build Path** > **Configure Build Path**.
40	40
41		-----
	49	+Click the **Libraries** tab, and you will see the list of Java archives (.jar) and Project Wonder frameworks. Click on **Add Library**, select **WebObjects Frameworks** and click **Next**. Select **H2PlugIn**, click on **Add Library**. Close the **Properties** window to go back to the main Eclipse window.
42	42
43		-~> somestyling.css
44		-
45		-So why using frameworks? Simple: to be able to use them in more than one project. Putting your EOModel into a framework is a good idea since you can built many different projects for the same business logic.
46		-
47		-= Creating a framework =
48		-
49		-So let's make a new framework. In Eclipse, open the **File** menu, select **New** and select **Wonder Framework**. Name it **BlogCommon** and click **Finish**.
50		-
51		-Now you have another project in your Eclipse workspace. Open it and you will see that the folder structure is the same as for an Wonder application.
	51	+You can run the **BlogRest** application and everything will work. By moving the EOModel to the framework, you will be able to use the model in the next tutorial: [[building a DirectToWeb application to manage the blog>>Your First D2W Project]].