Note: This page is also available in english.

Download

20180709_Lomcoder.zip [Stand: 09.07.2018]

Änderungshistorie siehe Ende der Seite

Inhalt

Anwendung

Nachfolgendes Beispiel gilt hauptsächlich für Java und ähnliche OO-Sprachen.

Um eine Ohrmarke zu prüfen, wird diese über den LomCoder2 und dessen Methode sintEncodeLom() aufgerufen. Da wir aber zwei Rückgabewerte erwarten (numerische Ohrmarke und Fehlercode), aber nur einen zurückerhalten können, unterstützt LomNumber die Rückgabe der geprüften und codierten Ohrmarke.

Zuerst wird also ein Objekt von LomNumber angelegt:

LomNumber objLom = new LomNumber();

Danach wird die generische Klasse LomCoder2 mit der statischen Methode sintEncodeLom() aufgerufen, welche zwei bzw drei Parameter erwartet (Ohrmarke als String, das LomNumber-Objekt und schließlich ggf. ein Datum, zu dem die Ohrmarke geprüft werden soll):

String strLom = "DE0196442853";
int intFehler = LomCoder2.sintEncodeLom(strLom,objLom);

Nach dem Aufruf erhält man eine Fehlernummer und im Objekt objLom eventuell die codierte (numerische) Ohrmarke. Zur Fehlerbehandlung ist in jedem Fall die Klasse LomCoderErrors zu Rate zu ziehen: sie liefert über die Methode sintGetFehlerSchwere() einen 'allgemeineren' Fehlercode zurück, der der Schwere des HIT-Systems entspricht (d.h. 0=Ok, 1=Hinweis, 2=Nachfrage, 3=Fehler, 4=Panik). Ist die Fehlerschwere 0 oder 1, dann steht in objLom die codierte Ohrmarke (in numerischer Form). Bei Fehlerschweren größer 1 wurde nichts codiert und man erhält über die Methode sstrGetError() die Fehlermeldung zur Fehlernummer.

int intSchwere = LomCoderErrors.sintGetFehlerSchwere(intFehler);

if (intSchwere > 1)  {
   String strFehler = LomCoderErrors.sstrGetError(intFehler);
   System.err.println("Fehler bei Lom "+strLom+": "+strFehler);
}
else  {
   System.out.println(strLom+" = "+objLom.getLom())
}

Um die Ohrmarke in formatierter Form auszugeben, greifen wir auf die Methode sstrToFormattedString() der Klasse LomCoder2 zurück:

String strFormatiert = LomCoder2.sstrToFormattedString(objLom);

Damit ließe sich obengenannte Beispielohrmarke als DE 01 964 42853 ausgeben.

Möchte man die 15stellige numerische Form einer EU-Ohrmarke haben, läßt man sich diese aus objLom über getLom() geben (vorausgesetzt, es gab keinen Fehler):

String strNumerisch = objLom.getLom();

Vereinfachung für externe Aufrufe

Um für eigene Zwecke die Anwendung zu vereinfachen (z.B. nach einer Umwandlung in ein COM bzw. Dot.NET-Objekt) gibt es die Klasse LomObject. Diese faßt das eben beschriebene Procedere in einfache Methoden zusammen:

LomObject objLomcoder = new LomObject();
String strFormatiert = objLomcoder.encodeLom(strLom);
if (objLomcoder.wasError())   {
   System.err.println("Fehler: "+objLomcoder.getError());
}
else  {
   System.out.println(strFormatiert);
}

Erst wird die Ohrmarke via encodeLom() (für die formatierte Ausgabe) oder decodeLom() (für die numerische Ausgabe) konvertiert, dann via wasError() geprüft, ob bei der zuletzt vorangegangenen Konvertierung ein Fehler auftrat. Wenn ja, kann man sich die Fehlermeldung via getError() holen, anderenfalls hat der Aufruf von encodeLom() bzw. decodeLom() eine Ohrmarke geliefert.

Man kann auch direkt getError() abholen, ohne wasError() abgefragt zu haben: bei einer korrekten Konvertierung liefert sie eine leere Zeichenkette. Möchte man auf die Fehlerbehandlung völlig verzichten (was nicht anzuraten ist), läßt sich über encodeLom() bzw. decodeLom() auch erkennen, ob eine Ohrmarke falsch war: sie liefern dann jeweils eine leere Zeichenkette.

Anmerkungen

Die Zip-Datei enthält nur die Sourcen für die Ohrmarkencodierung. Wollen Sie diese unverändert in Ihren Java-Programmen verwenden, sollten Sie sich das Applet-Archiv herunterladen. Dieses können Sie dann in eigenen Programmen aufrufen, wie oben unter Anwendung oder unter Vereinfachtung für externe Aufrufe beschrieben:

Ab dem 01.05.2004 sind 10 neue Länder (EU-Osterweiterung) dazugekommen (es liegen aber nicht für alle Länder eine Codiervorschrift vor, so daß für diese eine 15stellige LOM als Vorgabe erwartet wird). Für detailierte Ausführungen lese man bei den Alpha-Lom-Codierungen nach.

Ab dem 01.01.2007 sind zwei neue Länder (BG und RO) dazugekommen.

Zum 01.07.2013 ist Krotatien (HR) der EU beigetreten.

Änderungen