********************************************************************************
*  Segment 2 -  SWE 2.BW-ISIS                                                                  *
********************************************************************************

Version: 1.5.2 (20100317-1105)


Übersicht
=========

Zur Ausführung der Softwareeinheit sind neben den Kernsoftware-Bibliotheken folgende 
zusätzliche Bibliotheken bzw. Softwareeinheiten erforderlich:
	de.bsvrz.sys.funclib.bitctrl
	de.bsvrz.iav.gllib
	de.bsvrz.sys.funclib.vewdynobj
	
Der Ereignistyp 'ereignisTyp.baustelle' muss existieren und sollte in der Menge der Ereignistypen
des KV, der der SWE übergeben wird, enthalten sein.


	

Versionsgeschichte

==================

Version 1.0.0
==================

erste Bereitstellung


Version 1.1.0
==================

- getestet mit SWE Ganglinienprognose und Baustellensimulation
- Methodensignaturen OrtsRefenerenzAsbStationierungInterface geändert:
  Referenzumrechnungsmethoden liefern jetzt Liste von Ergebnissen


Version 1.2.0
==================

- Exceptions korrigiert, es werden nur noch BisInterfaceExceptions und Runtime-
  Exceptions ("IllegalArgumentException") geworfen.
- Ortsreferenzumrechnung korrigiert
- Startskripte für die Testfälle integriert
- Zusatzprogramm zum Anlegen des Baustellen-Ereignistyps im Distributionspaket
- Ereignisse enthalten in der PID den Zeitstempel, damit mehrere Ereigniss pro
  Baustelle möglich sind
- Ganglinien liefern jetzt integrierten Stundenwert

 
Version 1.2.1
=============

- Fehler bei Referenzierungsumrechnung ASB->SegmentUndOffset bei mehreren 
  Segmenten korrigiert 

Version 1.2.2
=============

- PID, Name und Info bei erzeugeBaustelle dürfen 'null' sein, die Werte werden
  im Interface gebildet
- kompiliert mit Debug-Info zur besseren Stacktrace-Ausgabe
- benötigt Bibliothek de.bsvrz.sys.funclib.bitctrl_V20080710

  
Version 1.2.3
=============

- Verbot anlegen von Baustellen mit Beginn auf innerem Straßensegment entfernt 
  
  
Version 1.2.4
=============

- NullPointerException bei aendereInfo korrigiert

 
Version 1.3.0
=============

- Netzreferenzumrechnungen in funclib.bitctrl ausgelagert
- benötigt Bibliothek de.bsvrz.sys.funclib.bitctrl_V1.0.0


Version 1.3.1
=============

- Komplettlieferung VRZ3 


Version 1.3.2
=============

- Methode AbstractBis.disconnect() eingefügt


Version 1.4.0
==================

- Erzeugung der Baustellenobjekte unter Nutzung des Paketes: de.bsvrz.sys.funclib.vewdynobj
  Diese Bibliothek erfordert die Existenz einer Zuordnungsdatei 'zuordnung.csv' im gleichen 
  Verzeichnis wie die JAR-Datei der Bibliothek. Die Zuorndungsdatei kann auch leer sein.
  Bei nicht vorhandener oder fehlerhafter Zuordnungsdatei wird die Applikation durch die 
  Bibliothek mit einer entsprechenden Fehlermeldung beendet.

Version 1.5.0
==================

- Erzeugung der Baustellenobjekte unter Nutzung des Paketes: de.bsvrz.sys.funclib.dynobj
- die AbtractBIS.connect-Methode wurde modifiziert, um ein sicheres Beenden aller DAV-Threads
  sicherzustellen, wenn die Bibliothek innerhalb eines Tomcat-Servers benutzt wird
- Die Umrechnung der ABS-Stationierung in Strassensegment/Offset findet intern auch 
  ASB-Stationierungen zu den Nullpunkten der übergebenen Anfangs- bzw. Endknoten


Version 1.5.1
==================

- Re-Initialisierung der DAV-Verbindung nach Verbindungsverlust korrigiert


Version 1.5.2
==================

- Wenn eine ASB-Stationierung nicht in eine Referenz mit StrassenSegment und Offset abgebildet,
  aber eine Strasse zur ASB-Stationierung bestimmt werden kann, wird eine Betriebsmeldung 
  (Information) mit folgendem Meldungstext erzeugt:
   
  "Die ASB-Ortsreferenz (Anfangsknoten: XXXXXXXX, Endknoten: XXXXXXXX, Stationierung: XXX, 
  Stationierungsrichtung: XXX_STATIONIERUNGSRICHTUNG) auf Straße '<strassenname> (<strassepid>)' 
  konnte nicht auf eine OrtsReferenzStrassenSegmentUndOffset abgebildet werden (<interne Fehlermeldung>)"

  Beispiel:
  "Die ASB-Ortsreferenz (Anfangsknoten: 8211024, Endknoten: 8311021, Stationierung: 2000, 
  Stationierungsrichtung: GEGEN_STATIONIERUNGSRICHTUNG) auf Straße 'A5 von Basel nach Karlsruhe 
  (strasse.A.5.tmclc.07127)' konnte nicht auf eine OrtsReferenzStrassenSegmentUndOffset abgebildet werden
  (Keine Abbildung möglich: Es konnte kein Teilsegment mit passender ASB-Stationierung gefunden werden)"
  
  

Bemerkungen
===========

In der benutzten Datenverteiler-API werden einige Threads als Deamon gestartet. Um
eine Applikation, die diese Bibliothek benutzt, sauber zu beenden, ist daher der Aufruf 
von 'System.exit(<status>)' erforderlich. 

Disclaimer
==========

Segment 2 (KEx),  SWE 2.BW-ISIS
Copyright (C) 2007 BitCtrl Systems GmbH 

This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.

This program is distributed 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. See the GNU General Public License for more
details.

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 51
Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.


Kontakt
=======

BitCtrl Systems GmbH
Weißenfelser Straße 67
04229 Leipzig
Phone: +49 341-490670
mailto: info@bitctrl.de
