Download

20260330_Lomcoder.zip [Stand: 30.03.2026]

Wichtig: da es im Jahr 2021 eine Restrukturierung des Java-Sources bei HIT gab, wurden umbenannte und neue packages gebildet.
Die u.g. Sourcen sind somit in anderen Unterordnern abgelegt als im zuletzt angebotenen Download von 2018. Die Klassen per se sind
von den Methodenaufrufen her jedoch gleich geblieben.

Ä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 LomCoder 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 der Parameter 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 LomCoder 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 = LomCoder.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 LomCoder zurück:

String strFormatiert = LomCoder.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 fasst 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.

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.

Zum 04.08.2022 wurden niederländische (NL) Ohrmarkennummern um eine neue Serie (12- statt 9-stellig) erweitert (erst Anfang 2026 der HIT mitgeteilt worden).

Änderungen