/*
 * Copyright (c) 2002-2003 IST-2004-2006-511731 ModelWare - ModelBus.
 * All rights reserved.
 *
 * This software is published under the terms of the ModelBus Software License
 * in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
 * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * A copy of ModelBus Software License is provided with this distribution in
 * doc/LICENSE.txt file.
 */

ModelBus Adapter V1
========================

1. Introduction
----------------

This distribution provides Adapter API as well as a set of functional tests.



2. System requirements
-----------------------

2.1. Standalone Java application
* JRE 1.4.x
All required third-party libraries are placed to the lib folder.

2.2. Eclipse plugin
* Eclipse 3.0
* EMF 2.0.1 (NEW!)

(Plugin was also tested for Eclipse 3.0.2, Eclipse 3.1 and EMF 2.0.2)

3. Installation
----------------

3.1. Standalone Java application
No particular installation is required

3.2. Eclipse plugin
Copy release/eclipse/plugins to your Eclipse plugins folder.

4. Test
--------

4.1. Standalone Java application
* Run registry on port 8082.
Distribution package contains test registry, which is purposed for tests only. 
Start test/run_testRegistry.but

* Run test Provider
Start test/run_testProvider.bat

* Run test Consumer
Sart test/run_testConsumer.bat

Normal console output is:

<?xml version="1.0" encoding="ASCII"?>
<ecore:EClass xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" xmlns:ecore="
http://www.eclipse.org/emf/2002/Ecore" name="class1"/>

ConsumerTestSample. output=
<?xml version="1.0" encoding="ASCII"?>
<xmi:XMI xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" xmlns:ecore="http:
//www.eclipse.org/emf/2002/Ecore">
  <ecore:EClass name="class1"/>
  <ecore:EClass name="class2"/>
</xmi:XMI>


4.1. Eclipse plugin
* Install adapter plugins
* Install adapter test plugins from test/eclipse

* Run Eclipse
* Run registry
Click menu ModelBusTest/1. Registry/Local Test registry Start
* Run test Provider
Click menu ModelBusTest/2. Perform Provider Test

* Run test Consumer
Click menu ModelBusTest/3. Performe Consumer Test

Normal console output is:
ConsumerTestSample. output=
<?xml version="1.0" encoding="ASCII"?>
<ecore:EClass xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" xmlns:ecore="http://www.eclipse.org/emf/2002/Ecore" name="class1"/>


ConsumerTestSample. output=
<?xml version="1.0" encoding="ASCII"?>
<xmi:XMI xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" xmlns:ecore="http://www.eclipse.org/emf/2002/Ecore">
  <ecore:EClass name="class2"/>
  <ecore:EClass name="class1"/>
</xmi:XMI>

...

4.2. Unit Tests
* Import src/org.eclipse.mddi.adapter.test.unit to your Eclipse evironement
* Execute tests as JUnit tests


5. More Information
--------------------
Please read 
	doc/ModelBusGuidelines-Adapter 
			for more information