Step 4 - First steps with Z2 on SVN¶

Z2 can be used with Subversion just as well as with Git. In fact, the first implementation of Z2 was on Subversion only.

The overall approach is the same: The single parts of the z2-environment - such as the core, base, add-ons, application - are stored in separate repositories, and Z2 loads the source code and 3rd party libraries on-demand from SVN using SVNKit. In opposite to Git one will usually put the single z2-repositories (we call them component repositories, because they are the sources for the z2 components) into one SVN repository installation. Furthermore it is not uncommon that one SVN installation hosts multiple Z2 systems.

Prerequisites¶

You need a properly setup JDK 6 on Linux, Mac OS X or Windows - that's all.
A halfway modern system will do.

This how-to uses the SVN VCS (we're using SVN version 1.6 and 1.7). You can also run Z2 together with Git as described on Step 2 - Install and run in 5 minutes and Step 3 - First steps with Z2 on Git.

For Eclipse-SVN integration we are using Subclipse, which is also supported by the Z2 Eclipsoid plug-in. You can also use Subversive however there is no Eclipsoid-Subversive integration so far.

Creating a home for Z2¶

The folder layout is a bit simpler with SVN because SVN workspace and Eclipse workspace can overlap.

Create a folder called z2-base inside your favorite/home/development/what-ever directory and enter it. This will be the home for our Z2 installation and the Eclipse workspace:

mkdir z2-base
cd z2-base

Getting the Z2 core¶

Start Eclipse and choose z2-base as workspace. Go to the SVN repository perspective and add a new repository location http://www.z2-environment.net/svn/z2-environment/trunk/z2-base.core. Use user name "z2-environment" and the same password, when asked.

Right-click the new entry and choose "Checkout..." and simply click "finish" on the first "Checkout from SVN" wizard page. The core will be downloaded into your Eclipse workspace and opened as project "core".

Switch back to the Java perspective and dive into the core project. You will see two "z2_base*.launch" files - right-click the one that matches your OS and choose "Run As >" / "z2_base".
The Z2 server will be started inside a new window showing some log messages where the last one should be "... Completed worker process initialization".

Installation of the Eclipsoid plug-in¶

You can install the Eclipsoid plugin directly from the Eclipse Marketplace by searching "eclipsoid" or simply from here:

https://marketplace.eclipse.org/content/eclipsoid-z2-environment-eclipse-plugins

After installation you should now see a new menu entry labled "z2-Environment" and two new icons:

NOTE (important): When you use the plugin and you get authentication errors, please check for the user/password used at Window/Preferences/z2-Environment. By default use user z* (yes, "z" followed by an asterisk) with password z.

Changing source code and check the result¶

Once you've installed the Eclipsoid plug-in go to "z2-environment" in the Eclipse menu and choose "z2-Repositories View" - a new view should open inside the lower views-tab:

Right-click "com.zfabrik.boot.config/baseRepository" and choose "Add SVN repository" - this will only work if you installed the Subclipse plug-in. (For Subversive you can copy the SVN URL from the repository properties: look for the property called "svncr.url" inside the "z2-Repositories" view or inside the general Eclipse properties view when the entry "com.zfabrik.boot.config/baseRepository
" is selected. Now you can right-click the property and copy the value to the clipboard. Add this SVN URL to your Subversive repositories list).

Import the calculator project into your Eclipse workspace. When using Subclipse you can open the "z2-Projects" node inside the "z2-Repositories" view, right-click "com.zfabrik.samples.calculator" and choose "SVN checkout", when using Subversive you have to do this via the Subversive perspective.

From here on there is no Z2 specific difference any more between development with SVN or Git. As described at Step 3 - First steps with Z2 on Git you resolve the classpath for z2-projects via <Alt+R> and the error markers should be gone. You arm projects via "Arm z2-Projects" in the project's context menu, so that your local version in the workspace will be taken with preference over the calculator project in the SVN repository. Now you can perform the roundtrip: 1) change code, 2) sync server (by pressing Alt+Y> and 3) check results in your browser several times.

Continue with Z2_Modules_intro