Prerequisites - Installing 2.0.2-PRE-ALPHA-1 - Updated 15/01/2012

Here you can find instructions on how to start with JProvocateur in few simple steps. Basic knowledge of Maven is required (Maven 3.0.3 was used, click here to download it).

If you face any problems or you have any questions you can contact us through the Help Forum.

Maven setting.xml

In order to work with JProvocateur, you have to declare our maven repository in your setting.xml

In windows you can find this files under  <your user>\m2.

Edit the file and add

    <profiles>
        <profile>
            <id>default</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <repositories>
                <repository>
            <id>jprovocateur</id>
            <url>http://www.jprovocateur.org/nexus/content/repositories/releases/</url>
            <releases>
                <enabled>true</enabled>
                <checksumPolicy>ignore</checksumPolicy>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
            </repositories>
            <pluginRepositories>
                <pluginRepository>
                    <id>jprovocateur</id>
                    <name>Jprovocateur Repository</name>
                    <url>http://www.jprovocateur.org/nexus/content/repositories/releases/</url>
                    <snapshots>
                        <enabled>true</enabled>
                        <updatePolicy>always</updatePolicy>
                    </snapshots>
                    <releases>
                        <enabled>true</enabled>
                        <updatePolicy>always</updatePolicy>
                         <checksumPolicy>ignore</checksumPolicy>
                    </releases>
                </pluginRepository>
            </pluginRepositories>
        </profile>
    </profiles>
    <activeProfiles>
        <activeProfile>default</activeProfile>
    </activeProfiles>

 
 

Create Services Layer based on Archetype

In JProvocateur we split the business layer and presentation layer. Business layer is the place that you have your hibernate objects and your business classes.  You can either start from scratch or use thet Maven Archetype to generate the desired project.

Create a directory called mynewproject and inside the directory run

 mvn archetype:generate -DarchetypeGroupId=org.jprovocateur.archetype -DarchetypeArtifactId=jprovocateurService-archetype -DarchetypeVersion=2.0.2-Pre-Alpha-1  -DgroupId=<YOUR GROUP ID> -Dpackage=<YOUR DEFAULT PACKAGE> -DartifactId=<YOUR ARTIFACT ID> -Dversion=<YOUR VERSION>
 

e.g

 mvn archetype:generate -DarchetypeGroupId=org.jprovocateur.archetype -DarchetypeArtifactId=jprovocateurService-archetype -DarchetypeVersion=2.0.2-Pre-Alpha-1  -DgroupId=com.example -Dpackage=com.example -DartifactId=myservice -Dversion=1.0-SNAPSHOT

It will generate a maven project under mynewproject\myservice.

Go in my service, and run

1. mvn clean

2. mvn install  

Create the Web Layer based on Archetype

From inside mynewproject directory run

 mvn archetype:generate -DarchetypeGroupId=org.jprovocateur.archetype -DarchetypeArtifactId=sampleweb-archetype -DarchetypeVersion=2.0.2-Pre-Alpha-1  -DgroupId=<YOUR GROUP ID> -Dpackage=<YOUR DEFAULT PACKAGE> -DartifactId=<YOUR ARTIFACT ID> -Dversion=<YOUR VERSION> -DJAVASCRIPT_RELATED_LOCAL=<true/false (if false all javascript will be loaded from jprovocateur.org so no installation of ext j.s will be needed during your evaluation of jprovocateur)>  -Dservice_project_name=<THE PROJECT NAME OF YOUR SERVICES>

e.g.

 mvn archetype:generate -DarchetypeGroupId=org.jprovocateur.archetype -DarchetypeArtifactId=sampleweb-archetype -DarchetypeVersion=2.0.2-Pre-Alpha-1  -DgroupId=com.example -Dpackage=com.example -DartifactId=testweb -Dversion=1.0-SNAPSHOT -DJAVASCRIPT_RELATED_LOCAL=false -Dservice_project_name=myservice

 

Attention - Bug

Due to a bug, if you want to the JS/CSS related files to be served by www.jprovocateur  you have to replace manually in web.xml

    <context-param>
      <param-name>JAVASCRIPT_RELATED_LOCAL</param-name>
      <param-value>$(
JAVASCRIPT_RELATED_LOCAL)</param-value>
    </context-param>

with

    <context-param>
      <param-name>JAVASCRIPT_RELATED_LOCAL</param-name>
      <param-value>true
</param-value>
    </context-param>

It will be fixed in 2.0.2-Pre-Alpha-2.

 

Restrictions

1. YOUR GROUP ID = YOUR DEFAULT PACKAGE

2. YOUR GROUP ID is the same in both projects

3. YOUR VERSION is the same in both projects

Attention JAVASCRIPT_RELATED_LOCAL = false

This option is only for quick demo purposes, if you decide to use jprovocateur, download the related javascript files from their sources as described bellow.

 

Adding Ext J.S and other Javascript libraries to sampleweb

This step is required only if you set JAVASCRIPT_RELATED_LOCAL=true

Because of license reasons Ext J.S libraries and Sakis libraries are not included in the project. You have to download them and copy them to the right directory in sampleweb project.

 

Run sampleweb

Import both projects as maven projects in Eclipse and run.

Go to http://<your server>:<your port>/<YOUR ARTIFACT ID>/view/listCountries

and  login as

  • username:guest password:guest
  • username:admin password:admin

 
Design downloaded from free website templates.
 
Web Templates created with FlashMint. .