Apache HISE Developer Guide

1.0.0-SNAPSHOT


Table of Contents

Index
1. Compiling, Running & Testing
2. Compiling, Running & Testing under ServiceMix 4

Index

Chapter 1. Compiling, Running & Testing

A quick introduction to compiling and running:

  • Execute mvn install in hise directory

  • enter hise-web, run mvn jetty:run and enter http://localhost:8080/ - it will show published WS Services and operations.

    This will deploy hise-test-example project and start HISE on Jetty.

  • run soapui 3.5-beta1 and run tests from project hise-web/soapui-tests/hise-soapui-project.xml

    This will run integration tests for HISE.

Each time you do mvn jetty:run, a whole DB is erased. Additionally, for tests, there is exposed cleanup POJO Web Service, which cleans up DB Tables.

By default, HISE integration tests are run using H2 Database. This can be changed, for example to Oracle, by commenting out ojdbc deps in hise-web/pom.xml and Oracle datasource in hise-web/src/test/resources/hise-ds.xml.

HISE has two types of tests:

  • unit tests - those test a single module, for example DAO

  • integration tests - SoapUI test scenarios for a single use case

Chapter 2. Compiling, Running & Testing under ServiceMix 4

A quick introduction to compiling and running HISE under ServiceMix 4. During preparing this tutorial we use Apache Servicemix 4.2.0-fuse-01-00 and Ubuntu 10.04 LTS.

  • Execute mvn clean and mvn install in hise directory. If you want to omit unit tests instead 'mvn install' execute 'mvn install -Dmaven.test.skip'

  • After that in your local maven repository should be hise dorectory. For example for latest version :

    ~/.m2/repository/org/apache/hise/hise-karaf/1.0.0-SNAPSHOT/

    Run Servicemix and add url to HISE.

    karaf@root> features:addUrl mvn:org.apache.hise/hise-karaf/1.0.0-SNAPSHOT/xml/features

    Now check if url wass added properly

                karaf@root> features:listUrl | grep hise
                mvn:org.apache.hise/hise-karaf/1.0.0-SNAPSHOT/xml/feature
                

  • Check if HISE is available to install

                karaf@root> features:list | grep hise
                [uninstalled] [1.0.0-SNAPSHOT      ] hise                                 repo-0
                [uninstalled] [1.0.0-SNAPSHOT      ] hise-h2                              repo-0
                [uninstalled] [1.0.0-SNAPSHOT      ] hise-sqlserver                       repo-0
                [uninstalled] [1.0.0-SNAPSHOT      ] hise-oracle                          repo-0
                [uninstalled] [1.0.0-SNAPSHOT      ] hise-h2-test-example-osgi            repo-0
                [uninstalled] [1.0.0-SNAPSHOT      ] hise-sqlserver-test-example-osgi     repo-0
                

    Execute

    karaf@root> features:install hise-h2-test-example-osgi

    After instalation execute again features:list, you should see:

                    karaf@root> features:list | grep hise
                    [installed  ] [1.0.0-SNAPSHOT      ] hise                                 repo-0
                    [installed  ] [1.0.0-SNAPSHOT      ] hise-h2                              repo-0
                    [uninstalled] [1.0.0-SNAPSHOT      ] hise-sqlserver                       repo-0
                    [uninstalled] [1.0.0-SNAPSHOT      ] hise-oracle                          repo-0
                    [installed  ] [1.0.0-SNAPSHOT      ] hise-h2-test-example-osgi            repo-0
                    [uninstalled] [1.0.0-SNAPSHOT      ] hise-sqlserver-test-example-osgi     repo-0
                

  • Run web browser and open http://localhost:8181/cxf. There are listed services offered by HISE.

  • Run soapui 3.5-beta1 and run tests from project hise-web/soapui-tests/hise-soapui-project.xml

    This will run integration tests for HISE.