Hinweis: Diese Seite gibt es auch auf deutsch.

 Download

20180709_Lomcoder.zip [latest version: 09-Jul-2018]

for Change history see end of page

Content

Usage

Following example is valid for Java and similar OO programming languages.

To check an eartag the method sintEncodeLom() of LomCoder2 is called. Since we expect two return values (numeric eartag and error code), but only can retrieve one, LomNumber supports the retrieval of the checked and coded eartag.

So an object of LomNumber is instantiated first:

LomNumber objLom = new LomNumber();

After that we call the generic class LomCoder2 by its static method sintEncodeLom() which expects two or three parameters respectively (eartag as String, the LomNumber object and finally if necessary the Date for checking the eartag at this date):

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

After the call we get an error number and the object objLom now may contain the encoded (numeric) eartag. For error tracking one has to use the class LomCoderErrors: using the method sintGetFehlerSchwere() it does return a 'more general' error code which is equivalent to the Schwere (=weight) of the HIT system (means 0=Ok, 1=Note, 2=Request, 3=Error, 4=Panic). If the error weight is 0 or 1, then objLom contains the encoded eartag (in numeric form). With error weights larger than 1 nothing has been encoded and the (unfortunately german) error message can be retrieved by the method sstrGetError().

int intErrWeight = LomCoderErrors.sintGetFehlerSchwere(intError);

if (intErrWeight > 1)  {
   String strErrMsg = LomCoderErrors.sstrGetError(intError);
   System.err.println("Error at eartag "+strLom+": "+strErrMsg);
}
else  {
   System.out.println(strLom+" = "+objLom.getLom())
}

To print out the eartag in formatted form, one has to use the method sstrToFormattedString() of the class LomCoder2:

String strFormatted = LomCoder2.sstrToFormattedString(objLom);

With this call the above eartag example will be printed as DE 01 964 42853 then.

If you want the 15 digit numerical form of an EU eartag, you can get it via getLom() of objLom (assuming that no error appeared):

String strNumerisch = objLom.getLom();

Simple usage for external calls

To simplify the usage for own purposes (e.g. after a conversion into a COM or Dot.NET object) there is a class called LomObject. This class combines the procedure described above and provides simple calls:

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

First the eartag will be converted by encodeLom() (for formatted output) or decodeLom() (for numeric output), then wasError() checks, if an error occured on the latest conversion. If so, the (german) error message can be retrieved by getError(); otherwise the encodeLom() or decodeLom() call respectively returned the eartag number.

It is possible to call getError() without calling wasError() before: if the eartag could be converted correctly, it returns an empty string. You also can ignore the error handling (not recommended), because in case of an error, the methods encodeLom() or decodeLom() return an empty string then.

Hints

The Zip archive above only contain the sources of the eartag coding. If you intend to use them precompiled, please download the applet archive. This one you can call in own application as decribed in the sections Usage or Simple usage for external calls above.

Starting with May 1st, 2004 10 new countries (EU eastern enlargement) were added (unfortunately we do not have the coding schemes for all new countries, so a 15 digit eartag number is required to be accepted). For more detailed schemes see Alpha-Lom-Codierungen (in german).

Starting with January 1st, 2007 two new countries (BG und RO) were added.

On July 1st, 2013 Croatia (HR) joined the EU.

Changes