* The applet from eID middleware 2.5.9 / 2.6 provided the methods getFirstName1, getFirstName2 and getFirstName3. * The applet from eID middleware 3.5 has only one method, getFirstName, which returns the first, second and third first names. * The third first name on the eID card is only the first letter of the third name. * Some people have a first name consisting of two words. For example Pieter Jan or Jean Marie. * So it is impossible to determine the second first name. * Still the EIDCard object has the firstName2 property in order to be backwards compatible * with the applet from eID middleware 2.5.9 / 2.6. But the firstName2 property is always an empty string. * Maybe in a future middleware, the applet will return the first names correctly. *
* Formats of identity data on an eID card are described in the following documents:
* @see belgian_electronic_identity_card_content_v2.8.a.pdf
* @see formaat_van_de_datums_04042006.pdf
* @extends be.belgium.eid.Card
* @constructor
*/
be.belgium.eid.EIDCard = function() {
this.chipNumber = new String("");
this.issuingMunicipality = new String("");
this.nationalNumber = new Number(0);
this.surname = new String("");
this.firstName1 = new String("");
this.firstName2 = new String("");
this.firstName3 = new String("");
this.nationality = new String("");
this.birthLocation = new String("");
this.birthDate = new Date(0);
this.sex = be.belgium.eid.sex.FEMALE;
this.nobleCondition = new String("");
this.documentType = be.belgium.eid.documentType.BELGIAN_CITIZEN;
this.specialStatus = be.belgium.eid.specialStatus.NO_STATUS;
this.whiteCane = new Boolean(false);
this.yellowCane = new Boolean(false);
this.extendedMinority = new Boolean(false);
this.street = new String("");
this.streetNumber = new String(""); // Usually digits, but street numbers like for example 32A do exist
this.boxNumber = new String("");
this.zipCode = new Number(0);
this.municipality = new String("");
this.country = new String("");
this.picture = null; // byte array (type object, instanceof Array)
};
be.belgium.eid.EIDCard.prototype = new be.belgium.eid.Card; // extends Card
/**
* Returns a string representation of public readable identity data of an eID card.
* @public
* @method toString
* @return a string representation of public readable identity data of an eID card.
* @type primitive string
*/
be.belgium.eid.EIDCard.prototype.toString = function() {
var dateFormatter = new be.belgium.eid.DateFormatter(be.belgium.eid.dateFormat.DD_MM_YYYY);
var newline = "\r\n";
var str = "eID card" + newline;
str += be.belgium.eid.Card.prototype.toString.call(this) + newline;
str += "chipNumber: " + this.chipNumber + newline;
str += "issuingMunicipality: " + this.issuingMunicipality + newline;
str += "nationalNumber: " + this.nationalNumber.toString() + newline;
str += "surname: " + this.surname + newline;
str += "firstName1: " + this.firstName1 + newline;
str += "firstName2: " + this.firstName2 + newline;
str += "firstName3: " + this.firstName3 + newline;
str += "nationality: " + this.nationality + newline;
str += "birthLocation: " + this.birthLocation + newline;
str += "birthDate: " + dateFormatter.format(this.birthDate) + newline;
str += "sex: " + this.sex + newline;
str += "nobleCondition: " + this.nobleCondition + newline;
str += "documentType: " + this.documentType + newline;
str += "specialStatus: " + this.specialStatus + newline;
str += "whiteCane: " + this.whiteCane.toString() + newline;
str += "yellowCane: " + this.yellowCane.toString() + newline;
str += "extendedMinority: " + this.extendedMinority.toString() + newline;
str += "street: " + this.street + newline;
str += "streetNumber: " + this.streetNumber + newline;
str += "boxNumber: " + this.boxNumber + newline;
str += "zipCode: " + this.zipCode.toString() + newline;
str += "municipality: " + this.municipality.toString() + newline;
str += "country: " + this.country.toString() + newline;
if (this.picture !== null) {
str += "A picture is available.";
} else {
str += "No picture available.";
}
return str;
};
/*
* Setters and Getters
*/
be.belgium.eid.EIDCard.prototype.setChipNumber = function(chipNumber) {
if (chipNumber instanceof String)
this.chipNumber = chipNumber;
else
this.chipNumber = new String(chipNumber);
};
/**
* Return chip number.
* @public
* @method getChipNumber
* @return a String object containing chip number.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getChipNumber = function() {
return this.chipNumber;
};
be.belgium.eid.EIDCard.prototype.setIssuingMunicipality = function(municipality) {
if (municipality instanceof String)
this.issuingMunicipality = municipality;
else
this.issuingMunicipality = new String(municipality);
};
/**
* Return issuing municipality.
* @public
* @method getIssuingMunicipality
* @return a String object containing issuing municipality.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getIssuingMunicipality = function() {
return this.issuingMunicipality;
};
be.belgium.eid.EIDCard.prototype.setNationalNumber = function(nationalNumber) {
if (nationalNumber instanceof Number)
this.nationalNumber = nationalNumber;
else
this.nationalNumber = new Number(nationalNumber);
};
/**
* Return national number.
* @public
* @method getNationalNumber
* @return a primitive number containing national number.
* @type primitive number
*/
be.belgium.eid.EIDCard.prototype.getNationalNumber = function() {
return this.nationalNumber.valueOf();
};
be.belgium.eid.EIDCard.prototype.setSurname = function(surname) {
if (surname instanceof String)
this.surname = surname;
else
this.surname = new String(surname);
};
/**
* Return surname.
* @public
* @method getSurname
* @return a String object containing surname.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getSurname = function() {
return this.surname;
};
be.belgium.eid.EIDCard.prototype.setFirstName1 = function(firstName1) {
if (firstName1 instanceof String)
this.firstName1 = firstName1;
else
this.firstName1 = new String(firstName1);
};
/**
* Return all first names.
* @public
* @method getFirstName1
* @return a String object containing all first names.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getFirstName1 = function() {
return this.firstName1;
};
be.belgium.eid.EIDCard.prototype.setFirstName2 = function(firstName2) {
if (firstName2 instanceof String)
this.firstName2 = firstName2;
else
this.firstName2 = new String(firstName2);
};
/**
* Return first name part 2.
* @public
* @method getFirstName2
* @return an empty String object.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getFirstName2 = function() {
return this.firstName2;
};
be.belgium.eid.EIDCard.prototype.setFirstName3 = function(firstName3) {
if (firstName3 instanceof String)
this.firstName3 = firstName3;
else
this.firstName3 = new String(firstName3);
};
/**
* Return first name part 3.
* @public
* @method getFirstName3
* @return an empty String object.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getFirstName3 = function() {
return this.firstName3;
};
be.belgium.eid.EIDCard.prototype.setNationality = function(nationality) {
if (nationality instanceof String)
this.nationality = nationality;
else
this.nationality = new String(nationality);
};
/**
* Return nationality.
* @public
* @method getNationality
* @return a String object containing nationality.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getNationality = function() {
return this.nationality;
};
be.belgium.eid.EIDCard.prototype.setBirthLocation = function(birthLocation) {
if (birthLocation instanceof String)
this.birthLocation = birthLocation;
else
this.birthLocation = new String(birthLocation);
};
/**
* Return birth location.
* @public
* @method getBirthLocation
* @return a String object containing birth location.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getBirthLocation = function() {
return this.birthLocation;
};
be.belgium.eid.EIDCard.prototype.setBirthDate = function(birthDate) {
this.birthDate = birthDate;
};
/**
* Return birth date.
* @public
* @method getBirthDate
* @return a Date object containing birth date.
* @type Date
*/
be.belgium.eid.EIDCard.prototype.getBirthDate = function() {
return this.birthDate;
};
/*
* @param sex value of type be.belgium.eid.sex
*/
be.belgium.eid.EIDCard.prototype.setSex = function(sex) {
this.sex = sex;
};
/**
* Return sex.
* @public
* @method getSex
* @return "F" for female, "M" for male
* @type be.belgium.eid.sex
*/
be.belgium.eid.EIDCard.prototype.getSex = function() {
return this.sex;
};
/**
* Return female sex status.
* @public
* @method getFemale
* @return true if female, false if male.
* @type primitive boolean
*/
be.belgium.eid.EIDCard.prototype.getFemale = function() {
return (this.sex === be.belgium.eid.sex.FEMALE);
};
/**
* Return male sex status.
* @public
* @method getMale
* @return true if male, false if female.
* @type primitive boolean
*/
be.belgium.eid.EIDCard.prototype.getMale = function() {
return (this.sex === be.belgium.eid.sex.MALE);
};
be.belgium.eid.EIDCard.prototype.setNobleCondition = function(nobleCondition) {
if (nobleCondition instanceof String)
this.nobleCondition = nobleCondition;
else
this.nobleCondition = new String(nobleCondition);
};
/**
* Return noble condition.
* @public
* @method getNobleCondition
* @return a String object containing noble condition.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getNobleCondition = function() {
return this.nobleCondition;
};
/*
* @param documentType value of type be.belgium.eid.documentType
*/
be.belgium.eid.EIDCard.prototype.setDocumentType = function(documentType) {
this.documentType = documentType;
};
/**
* Return document type.
* @public
* @method getDocumentType
* @return document type
* @type be.belgium.eid.documentType
*/
be.belgium.eid.EIDCard.prototype.getDocumentType = function() {
return this.documentType;
};
/*
* @param specialStatus value of type be.belgium.eid.specialStatus
*/
be.belgium.eid.EIDCard.prototype.setSpecialStatus = function(specialStatus) {
this.specialStatus = specialStatus;
// be.belgium.eid.specialStatus.NO_STATUS
this.whiteCane = new Boolean(false);
this.yellowCane = new Boolean(false);
this.extendedMinority = new Boolean(false);
switch (this.specialStatus) {
case be.belgium.eid.specialStatus.WHITE_CANE :
this.whiteCane = new Boolean(true);
break;
case be.belgium.eid.specialStatus.EXTENDED_MINORITY :
this.extendedMinority = new Boolean(true);
break;
case be.belgium.eid.specialStatus.WHITE_CANE_AND_EXTENDED_MINORITY :
this.whiteCane = new Boolean(true);
this.extendedMinority = new Boolean(true);
break;
case be.belgium.eid.specialStatus.YELLOW_CANE :
this.yellowCane = new Boolean(true);
break;
case be.belgium.eid.specialStatus.YELLOW_CANE_AND_EXTENDED_MINORITY :
this.yellowCane = new Boolean(true);
this.extendedMinority = new Boolean(true);
break;
}
};
/**
* Return special status.
* @public
* @method getSpecialStatus
* @return special status
* @type be.belgium.eid.specialStatus
*/
be.belgium.eid.EIDCard.prototype.getSpecialStatus = function() {
return this.specialStatus;
};
/**
* Return white cane status (blind people).
* @public
* @method getWhiteCane
* @return a primitive boolean containing white cane status.
* @type primitive boolean
*/
be.belgium.eid.EIDCard.prototype.getWhiteCane = function() {
return this.whiteCane.valueOf();
};
/**
* Return yellow cane status (partially sighted people).
* @public
* @method getYellowCane
* @return a primitive boolean containing yellow cane status.
* @type primitive boolean
*/
be.belgium.eid.EIDCard.prototype.getYellowCane = function() {
return this.yellowCane.valueOf();
};
/**
* Return extended minority status.
* @public
* @method getExtendedMinority
* @return a primitive boolean containing extended minority status.
* @type primitive boolean
*/
be.belgium.eid.EIDCard.prototype.getExtendedMinority = function() {
return this.extendedMinority.valueOf();
};
be.belgium.eid.EIDCard.prototype.setStreet = function(street) {
if (street instanceof String)
this.street = street;
else
this.street = new String(street);
};
/**
* Return street (including street number and box number on some cards).
* @public
* @method getStreet
* @return a String object containing street.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getStreet = function() {
return this.street;
};
be.belgium.eid.EIDCard.prototype.setStreetNumber = function(streetNumber) {
if (streetNumber instanceof String)
this.streetNumber = streetNumber;
else
this.streetNumber = new String(streetNumber);
};
/**
* Return street number. Street number can contain letters. For example 32A.
* @public
* @method getStreetNumber
* @return a String object containing street number.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getStreetNumber = function() {
return this.streetNumber;
};
be.belgium.eid.EIDCard.prototype.setBoxNumber = function(boxNumber) {
if (boxNumber instanceof String)
this.boxNumber = boxNumber;
else
this.boxNumber = new String(boxNumber);
};
/**
* Return box number.
* @public
* @method getBoxNumber
* @return a String object containing box number.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getBoxNumber = function() {
return this.boxNumber;
};
be.belgium.eid.EIDCard.prototype.setZipCode = function(zipCode) {
if (zipCode instanceof Number)
this.zipCode = zipCode;
else
this.zipCode = new Number(zipCode);
};
/**
* Return zip code.
* @public
* @method getZipCode
* @return a primitive number containing zip code.
* @type primitive number
*/
be.belgium.eid.EIDCard.prototype.getZipCode = function() {
return this.zipCode.valueOf();
};
be.belgium.eid.EIDCard.prototype.setMunicipality = function(municipality) {
if (municipality instanceof String)
this.municipality = municipality;
else
this.municipality = new String(municipality);
};
/**
* Return municipality.
* @public
* @method getMunicipality
* @return a String object containing municipality.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getMunicipality = function() {
return this.municipality;
};
be.belgium.eid.EIDCard.prototype.setCountry = function(country) {
if (country instanceof String)
this.country = country;
else
this.country = new String(country);
};
/**
* Return country.
* @public
* @method getCountry
* @return a String object containing country.
* @type String
*/
be.belgium.eid.EIDCard.prototype.getCountry = function() {
return this.country;
};
be.belgium.eid.EIDCard.prototype.setPicture = function(pictureByteArray) {
this.picture = pictureByteArray;
};
/**
* Return picture.
* @public
* @method getPicture
* @return a byte Array object containing picture.
* @type byte Array
*/
be.belgium.eid.EIDCard.prototype.getPicture = function() {
return this.picture;
};
/**
* ForeignerEIDCard contains the public readable identity data of a foreigner eID card.
* @description
* A foreigner eID card contains the same data as an eID card for Belgian citizens.
* @extends be.belgium.eid.EIDCard
* @constructor
*/
be.belgium.eid.ForeignerEIDCard = function() {};
be.belgium.eid.ForeignerEIDCard.prototype = new be.belgium.eid.EIDCard; // extends EIDCard
/**
* Returns a string representation of public readable identity data of a foreigner eID card.
* @public
* @method toString
* @return a string representation of public readable identity data of a foreigner eID card.
* @type primitive string
*/
be.belgium.eid.ForeignerEIDCard.prototype.toString = function() {
var str = "foreigner " + be.belgium.eid.EIDCard.prototype.toString.call(this);
return str;
};
/**
* KidsEIDCard contains the public readable identity data of a kids eID card.
* @description
* A kids eID card contains the same data as an eID card for Belgian citizens.
* @extends be.belgium.eid.EIDCard
* @constructor
*/
be.belgium.eid.KidsEIDCard = function() {
this.documentType = be.belgium.eid.documentType.KIDS_EID;
};
be.belgium.eid.KidsEIDCard.prototype = new be.belgium.eid.EIDCard; // extends EIDCard
/**
* Returns a string representation of public readable identity data of a kids eID card.
* @public
* @method toString
* @return a string representation of public readable identity data of a kids eID card.
* @type primitive string
*/
be.belgium.eid.KidsEIDCard.prototype.toString = function() {
var str = "kids " + be.belgium.eid.EIDCard.prototype.toString.call(this);
return str;
};
/**
* SISCard contains the public readable identity data of a SIS card.
* @description
* Almost all the properties of this object are of type String, Number, Date or Boolean.
* Except property sex that has a type which is especially defined in this library.
*
* Formats of identity data on an SIS card are described in the following documents:
* @see http://www.ksz-bcss.fgov.be/nl/documentation/document_3.htm#document3_3
* @see http://www.ksz-bcss.fgov.be/documentation/nl/documentation/appareils%20de%20lecture%20carte%20SIS/td-002bis-nl.pdf
* @extends be.belgium.eid.Card
* @constructor
*/
be.belgium.eid.SISCard = function() {
this.socialSecurityNumber = new Number(0);
this.surname = new String("");
this.initials = new String("");
this.name = new String("");
this.sex = be.belgium.eid.sex.FEMALE;
this.birthDate = new Date(0);
};
be.belgium.eid.SISCard.prototype = new be.belgium.eid.Card; // extends Card
/**
* Returns a string representation of public readable identity data of a SIS card.
* @public
* @method toString
* @return a string representation of public readable identity data of a SIS card.
* @type primitive string
*/
be.belgium.eid.SISCard.prototype.toString = function() {
var dateFormatter = new be.belgium.eid.DateFormatter(be.belgium.eid.dateFormat.DD_MM_YYYY);
var newline = "\r\n";
var str = "SIS card" + newline;
str += be.belgium.eid.Card.prototype.toString.call(this) + newline;
str += "socialSecurityNumber: " + this.socialSecurityNumber.toString() + newline;
str += "surname: " + this.surname + newline;
str += "initials: " + this.initials + newline;
str += "name: " + this.name + newline;
str += "sex: " + this.sex + newline;
str += "birthDate: " + dateFormatter.format(this.birthDate);
return str;
};
/*
* Setters and Getters
*/
be.belgium.eid.SISCard.prototype.setSocialSecurityNumber = function(socialSecurityNumber) {
if (socialSecurityNumber instanceof Number)
this.socialSecurityNumber = socialSecurityNumber;
else
this.socialSecurityNumber = new Number(socialSecurityNumber);
};
/**
* Return social security number (= national number).
* @public
* @method getSocialSecurityNumber
* @return a primitive number containing social security number.
* @type primitive number
*/
be.belgium.eid.SISCard.prototype.getSocialSecurityNumber = function() {
return this.socialSecurityNumber.valueOf();
};
be.belgium.eid.SISCard.prototype.setSurname = function(surname) {
if (surname instanceof String)
this.surname = surname;
else
this.surname = new String(surname);
};
/**
* Return surname.
* @public
* @method getSurname
* @return a String object containing surname.
* @type String
*/
be.belgium.eid.SISCard.prototype.getSurname = function() {
return this.surname;
};
be.belgium.eid.SISCard.prototype.setInitials = function(initials) {
if (initials instanceof String)
this.initials = initials;
else
this.initials = new String(initials);
};
/**
* Return initials.
* @public
* @method getInitials
* @return a String object containing initials.
* @type String
*/
be.belgium.eid.SISCard.prototype.getInitials = function() {
return this.initials;
};
be.belgium.eid.SISCard.prototype.setName = function(name) {
if (name instanceof String)
this.name = name;
else
this.name = new String(name);
};
/**
* Return first names.
* @public
* @method getName
* @return a String object containing first names.
* @type String
*/
be.belgium.eid.SISCard.prototype.getName = function() {
return this.name;
};
/*
* @param sex value of type be.belgium.eid.sex
*/
be.belgium.eid.SISCard.prototype.setSex = function(sex) {
this.sex = sex;
};
/**
* Return sex.
* @public
* @method getSex
* @return "F" for female, "M" for male
* @type be.belgium.eid.sex
*/
be.belgium.eid.SISCard.prototype.getSex = function() {
return this.sex;
};
/**
* Return female sex status.
* @public
* @method getFemale
* @return true if female, false if male.
* @type primitive boolean
*/
be.belgium.eid.SISCard.prototype.getFemale = function() {
return (this.sex === be.belgium.eid.sex.FEMALE);
};
/**
* Return male sex status.
* @public
* @method getMale
* @return true if male, false if female.
* @type primitive boolean
*/
be.belgium.eid.SISCard.prototype.getMale = function() {
return (this.sex === be.belgium.eid.sex.MALE);
};
be.belgium.eid.SISCard.prototype.setBirthDate = function(birthDate) {
this.birthDate = birthDate;
};
/**
* Return birth date.
* @public
* @method getBirthDate
* @return a Date object containing birth date.
* @type Date
*/
be.belgium.eid.SISCard.prototype.getBirthDate = function() {
return this.birthDate;
};
/**
* Abstract object CardBuilder. No instance of this object should be created.
* @description
* @constructor
* @abstract
*/
be.belgium.eid.CardBuilder = function() {
this.card = null;
this.birthDateFormatter = null;
this.validityDateFormatter = null;
};
/**
* Returns a card (eID card or SIS card) object.
* @public
* @method getCard
* @return an card object
* @type EIDCard,SISCard
*/
be.belgium.eid.CardBuilder.prototype.getCard = function() {
return this.card;
};
be.belgium.eid.CardBuilder.prototype.setBirthDate = function(birthDate) {
try {
if (this.card && this.birthDateFormatter)
this.card.setBirthDate(this.birthDateFormatter.parse(be.belgium.eid.JavaObjectConvertor.toString(birthDate)));
} catch (e){}
};
/**
* EIDCardBuilder35 extends CardBuilder.
* EIDCardBuilder35, builds a EIDCard object step by step using data returned by the applet from eID middleware 3.5
*
* Format of validity dates: DD.MM.YYYY (DD and MM can be empty strings, in this case DD = 01 and MM = 01 is presumed)
* Format of birth dates: DD MMMM YYYY (Dutch, French) or DD.MMM.YYYY (German) (DD and MMMM can be empty strings, in this case DD = 1 and MMMM = JAN is presumed)
*
* Formats of identity data on an eID card are described in the following documents: * @see formaat_van_de_datums_04042006.pdf * @see belgian_electronic_identity_card_content_v2.8.a.pdf * @description * @constructor * @extends be.belgium.eid.CardBuilder */ be.belgium.eid.EIDCardBuilder35 = function(cardNumber) { var cardNumberString = new String(""); try { cardNumberString = be.belgium.eid.JavaObjectConvertor.toString(cardNumber); } catch (e){} if (cardNumberString.indexOf("B") == 0) { this.card = new be.belgium.eid.ForeignerEIDCard(); } else if (cardNumberString.indexOf("610") == 0) { this.card = new be.belgium.eid.KidsEIDCard(); } else { this.card = new be.belgium.eid.EIDCard(); } this.card.setCardNumber(cardNumberString); this.birthDateFormatter = new be.belgium.eid.DateFormatter(be.belgium.eid.dateFormat.EID_BIRTH_DATE); this.validityDateFormatter = new be.belgium.eid.DateFormatter(be.belgium.eid.dateFormat.DD_MM_YYYY); }; be.belgium.eid.EIDCardBuilder35.prototype = new be.belgium.eid.CardBuilder; // extends CardBuilder /* * Setters * @public All these methods are public */ be.belgium.eid.EIDCardBuilder35.prototype.setChipNumber = function(chipNumber) { try { this.card.setChipNumber(be.belgium.eid.JavaObjectConvertor.toString(chipNumber)); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setIssMunicipality = function(issMunicipality) { try { this.card.setIssuingMunicipality(be.belgium.eid.JavaObjectConvertor.toString(issMunicipality)); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setNationalNumber = function(nationalNumber) { try { var nationalNumberString = be.belgium.eid.JavaObjectConvertor.toString(nationalNumber); this.card.setNationalNumber(be.belgium.eid.JavaObjectConvertor.toNumber(nationalNumberString.valueOf())); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setSurname = function(surname) { try { this.card.setSurname(be.belgium.eid.JavaObjectConvertor.toString(surname)); } catch (e){} }; // Some people have a first name consisting of two words. For example Pieter Jan or Jean Marie // So it is impossible to determine the second firstname. be.belgium.eid.EIDCardBuilder35.prototype.setFirstName = function(firstName) { try { var firstnames = be.belgium.eid.JavaObjectConvertor.toString(firstName); var firstnamesArray = firstnames.split(" "); var length = firstnamesArray.length; if (length >= 3) { if (firstnamesArray[length - 1].length == 1) { // eID contains only first letter of 3rd name this.card.setFirstName3(firstnamesArray[length - 1]); firstnamesArray.pop(); // remove 3rd name if (firstnamesArray.length == 2) { // the first and second firstname does not contain a space this.card.setFirstName2(firstnamesArray[1]); firstnames = firstnamesArray[0]; } else { firstnames = firstnamesArray.join(" "); // rejoin 1st and 2nd name } } } this.card.setFirstName1(firstnames); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setNationality = function(nationality) { try { this.card.setNationality(be.belgium.eid.JavaObjectConvertor.toString(nationality)); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setBirthLocation = function(birthLocation) { try { this.card.setBirthLocation(be.belgium.eid.JavaObjectConvertor.toString(birthLocation)); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setSex = function(sex) { try { this.card.setSex(be.belgium.eid.GenderParser.parse(be.belgium.eid.JavaObjectConvertor.toString(sex))); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setNobleCondition = function(nobleCondition) { try { this.card.setNobleCondition(be.belgium.eid.JavaObjectConvertor.toString(nobleCondition)); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setSpecialStatus = function(specialStatus) { try { var specialStatusString = be.belgium.eid.JavaObjectConvertor.toString(specialStatus); specialStatus = be.belgium.eid.JavaObjectConvertor.toNumber(specialStatusString.valueOf()); this.card.setSpecialStatus(specialStatus.valueOf()); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setStreet = function(street) { try { this.card.setStreet(be.belgium.eid.JavaObjectConvertor.toString(street)); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setStreetNumber = function(streetNumber) { try { this.card.setStreetNumber(be.belgium.eid.JavaObjectConvertor.toString(streetNumber)); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setBoxNumber = function(boxNumber) { try { this.card.setBoxNumber(be.belgium.eid.JavaObjectConvertor.toString(boxNumber)); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setZip = function(zip) { try { var zipString = be.belgium.eid.JavaObjectConvertor.toString(zip); this.card.setZipCode(be.belgium.eid.JavaObjectConvertor.toNumber(zipString.valueOf())); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setMunicipality = function(municipality) { try { this.card.setMunicipality(be.belgium.eid.JavaObjectConvertor.toString(municipality)); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setCountry = function(country) { try { this.card.setCountry(be.belgium.eid.JavaObjectConvertor.toString(country)); } catch (e){} }; be.belgium.eid.EIDCardBuilder35.prototype.setPicture = function(pictureByteArray) { try { this.card.setPicture(pictureByteArray); } catch (e){} }; /** * SISCardBuilder35 extends CardBuilder. * SISCardBuilder35, builds a SISCard object step by step using data returned by the applet from eID middleware 3.5 *
* Format of validity dates and birth dates: DD/MM/YYYY *
* Formats of identity data on a SIS card are described in the following documents: * @see http://www.ksz-bcss.fgov.be/nl/documentation/document_3.htm#document3_3 * @see http://www.ksz-bcss.fgov.be/documentation/nl/documentation/appareils%20de%20lecture%20carte%20SIS/td-002bis-nl.pdf * @description * @constructor * @extends be.belgium.eid.CardBuilder */ be.belgium.eid.SISCardBuilder35 = function() { this.card = new be.belgium.eid.SISCard(); this.birthDateFormatter = new be.belgium.eid.DateFormatter(be.belgium.eid.dateFormat.DD_MM_YYYY); this.validityDateFormatter = new be.belgium.eid.DateFormatter(be.belgium.eid.dateFormat.DD_MM_YYYY); }; be.belgium.eid.SISCardBuilder35.prototype = new be.belgium.eid.CardBuilder; // extends CardBuilder /** * Java String objects containing social security numbers returned by Java applets are converted into JavaObject objects. * This function converts these JavaObject objects into Javavascript Number Objects. * Format of social security number xxxxxx yyy zz *
* Format of social security number is described in the following documents: * @see http://www.ksz-bcss.fgov.be/Nl/faq/faq_5.htm * @see http://www.cla.be/Kort%20nieuws/2006/KN%20XIV-7-2.htm * @see http://www.cimire.fgov.be/siteindex.aspx?lng=nl&id=5 * * @private * @static * @method parseSocialSecurityNumber * @param appletNumberString a Javascript Object containing a social security number, returned by a Java applet * @throws NullPointerException if appletNumberString is null or undefined. * @throws IllegalArgumentException if appletNumberString does not contain a valid social security number. * @return a Javascript Number object * @type Number */ be.belgium.eid.SISCardBuilder35.parseSocialSecurityNumber = function(appletNumberString) { var str = be.belgium.eid.JavaObjectConvertor.toString(appletNumberString); if (str.length != 13) // format xxxxxx yyy zz throw new be.belgium.eid.IllegalArgumentException(); var numberStr = str.substr(0, 6) + str.substr(7, 3) + str.substr(11, 2); return be.belgium.eid.JavaObjectConvertor.toNumber(numberStr); }; /* * Setters * @public All these methods are public */ be.belgium.eid.SISCardBuilder35.prototype.setNationalNumber = function(nationalNumber) { try { this.card.setSocialSecurityNumber(be.belgium.eid.SISCardBuilder35.parseSocialSecurityNumber(nationalNumber)); } catch (e){} }; be.belgium.eid.SISCardBuilder35.prototype.setSurname = function(surname) { try { this.card.setSurname(be.belgium.eid.JavaObjectConvertor.toString(surname)); } catch (e){} }; be.belgium.eid.SISCardBuilder35.prototype.setFirstName = function(firstName) { try { this.card.setName(be.belgium.eid.JavaObjectConvertor.toString(firstName)); } catch (e){} }; be.belgium.eid.SISCardBuilder35.prototype.setInitials = function(initials) { try { this.card.setInitials(be.belgium.eid.JavaObjectConvertor.toString(initials)); } catch (e){} }; be.belgium.eid.SISCardBuilder35.prototype.setSex = function(sex) { try { this.card.setSex(be.belgium.eid.GenderParser.parse(be.belgium.eid.JavaObjectConvertor.toString(sex))); } catch (e){} }; /** * CardReader, object that uses the applet from eID middleware 3.5 to read eID- or SIS cards. * @description * @constructor * @param {primitive string|String} [readerName=""] Name of reader which is used to read eID- or SIS-cards (optional). */ be.belgium.eid.CardReader = function(readerName) { this.readerName = ""; this.setReaderName(readerName); this.appletLauncherId = "BEIDAppletLauncher"; this.noCardPresentHandler = null; this.noReaderDetectedHandler = null; this.appletNotFoundHandler = null; this.appletExceptionHandler = null; this.BEIDApplet = null; }; /** * Return BEID applet (which is the applet downloaded by the applet launcher). * @public * @method getBEIDApplet * @throws NullPointerException if no BEID applet is found. * @return BEID applet. * @type Object */ be.belgium.eid.CardReader.prototype.getBEIDApplet = function() { if (!this.BEIDApplet) { if (document.getElementById(this.appletLauncherId)) { // check if applet is loaded as sub applet (using applet-launcher) or as main applet (using Next-Generation Java Plug-in). if (document.getElementById(this.appletLauncherId).getSubApplet) { this.BEIDApplet = document.getElementById(this.appletLauncherId).getSubApplet(); } else { this.BEIDApplet = document.getElementById(this.appletLauncherId); } } if (!this.BEIDApplet) throw new be.belgium.eid.NullPointerException(); } return this.BEIDApplet; }; /** * Set name of reader which is used to read eID- or SIS-cards. * @public * @method setReaderName * @param {primitive string|String} readerName */ be.belgium.eid.CardReader.prototype.setReaderName = function(readerName) { if (readerName === null || typeof(readerName) == "undefined") this.readerName = ""; else if (readerName instanceof String) this.readerName = readerName.valueOf(); else this.readerName = readerName; }; /** * Return name of reader which is used to read eID- or SIS-cards. * @public * @method getReaderName * @return reader name * @type primitive string */ be.belgium.eid.CardReader.prototype.getReaderName = function() { return this.readerName; }; /** * Set id of the applet launcher APPLET-TAG. * @public * @method setAppletLauncherId * @param {primitive string} appletLauncherId */ be.belgium.eid.CardReader.prototype.setAppletLauncherId = function(appletLauncherId) { this.appletLauncherId = appletLauncherId; this.BEIDApplet = null; }; /** * Return id of the applet launcher APPLET-TAG. * @public * @method getAppletLauncherId * @return id of the applet launcher * @type primitive string */ be.belgium.eid.CardReader.prototype.getAppletLauncherId = function() { return this.appletLauncherId; }; /** * Set handler function that is called when no card is present. * @public * @method setNoCardPresentHandler * @param {function|Function Object} handler reference to a function or a Function object. */ be.belgium.eid.CardReader.prototype.setNoCardPresentHandler = function(handler) { if (handler !== null && typeof(handler) != "undefined" && (typeof(handler) == "function" || handler instanceof Function)) this.noCardPresentHandler = handler; else this.noCardPresentHandler = null; }; /** * Set handler function that is called when no reader is detected. * @public * @method setNoReaderDetectedHandler * @param {function|Function Object} handler reference to a function or a Function object. */ be.belgium.eid.CardReader.prototype.setNoReaderDetectedHandler = function(handler) { if (handler !== null && typeof(handler) != "undefined" && (typeof(handler) == "function" || handler instanceof Function)) this.noReaderDetectedHandler = handler; else this.noReaderDetectedHandler = null; }; /** * Set handler function that is called when BEID applet is not found. * @public * @method setAppletNotFoundHandler * @param {function|Function Object} handler reference to a function or a Function object. */ be.belgium.eid.CardReader.prototype.setAppletNotFoundHandler = function(handler) { if (handler !== null && typeof(handler) != "undefined" && (typeof(handler) == "function" || handler instanceof Function)) this.appletNotFoundHandler = handler; else this.appletNotFoundHandler = null; }; /** * Set handler function that is called when the BEID applet throws an exception. * @public * @method setAppletExceptionHandler * @param {function|Function Object} handler reference to a function or a Function object. */ be.belgium.eid.CardReader.prototype.setAppletExceptionHandler = function(handler) { if (handler !== null && typeof(handler) != "undefined" && (typeof(handler) == "function" || handler instanceof Function)) this.appletExceptionHandler = handler; else this.appletExceptionHandler = null; }; /** * Return a array of reader names. * @public * @method getReaderNames * @return an array of reader names, an zero length array is returned if no readers are detected. * @type Array of primitive strings */ be.belgium.eid.CardReader.prototype.getReaderNames = function() { var readerNames = new Array(0); try { this.getBEIDApplet().InitLib(null); var nbrReaders = this.BEIDApplet.readerCount(); readerNames = new Array(nbrReaders); for (var i = 0; i < nbrReaders; i++) { readerNames[i] = "" + this.BEIDApplet.getReaderByNum(i); } } catch (e){} // catch Javascript and Java exceptions try { this.getBEIDApplet().exitLib(); } catch (e){} // catch Javascript and Java exceptions return readerNames; }; /** * Return default reader name (= first reader name in list of reader names) * @public * @method getDefaultReaderName * @return the default reader name or an empty string if no reader is detected. * @type primitive string */ be.belgium.eid.CardReader.prototype.getDefaultReaderName = function() { var defaultReaderName = ""; try { this.getBEIDApplet().InitLib(null); defaultReaderName = "" + this.BEIDApplet.getReaderByNum(0); } catch (e){} // catch Javascript and Java exceptions try { this.getBEIDApplet().exitLib(); } catch (e){} // catch Javascript and Java exceptions return defaultReaderName; }; /** * determine reader name (default reader name or reader name defined as applet parameter) * @private * @method determineReaderName */ be.belgium.eid.CardReader.prototype.determineReaderName = function() { // No reader name provided, use default reader name or reader name defined as applet parameter if (this.readerName === null || this.readerName === "") { var parameterReaderName = "" + this.getBEIDApplet().getParameter("Reader"); if (parameterReaderName === null || parameterReaderName === "") { // Reader name is not defined as applet parameter this.readerName = this.getDefaultReaderName(); } else { this.readerName = parameterReaderName; } } }; /** * Check if card is present. * @public * @method isCardPresent * @return true if card is present, false if no card is present or if failed to detect. * @type primitive boolean */ be.belgium.eid.CardReader.prototype.isCardPresent = function() { var cardPresent = false; this.determineReaderName(); if (this.readerName !== "") { // reader name is determined try { cardPresent = this.BEIDApplet.isCardPresent(this.readerName); } catch (e){} // catch Javascript and Java exceptions } return cardPresent; }; /** * @private * @method validChipNumber * @return true if valid chipnumber, false if no valid chipnumber * @type primitive boolean */ be.belgium.eid.CardReader.validChipNumber = function(chipNumber) { try { chipNumber = be.belgium.eid.JavaObjectConvertor.toString(chipNumber); if (chipNumber.length == 0) { return false; } else { return true; } } catch (e) { return false; } }; /** * Read eID card or SIS card * @public * @method read * @return a EIDCard or SISCard object or null if no card is present or there was a failure to read the card. * @type EIDCard,SISCard,null */ be.belgium.eid.CardReader.prototype.read = function() { var card = null; var cardBuilder = null; try { // Reset all objects and previous read card values this.getBEIDApplet().InitLib(null); this.determineReaderName(); // Still no reader name ... if (this.readerName === "") { if (this.noReaderDetectedHandler) this.noReaderDetectedHandler(); try { this.getBEIDApplet().exitLib(); } catch (e){} return null; } this.getBEIDApplet().InitLib(this.readerName); if (this.BEIDApplet.isCardPresent(this.readerName)) { if (be.belgium.eid.CardReader.validChipNumber(this.BEIDApplet.getChipNumber())) { cardBuilder = new be.belgium.eid.EIDCardBuilder35(this.BEIDApplet.getCardNumber()); cardBuilder.setIssMunicipality(this.BEIDApplet.getIssMunicipality()); cardBuilder.setNationalNumber(this.BEIDApplet.getNationalNumber()); cardBuilder.setSurname(this.BEIDApplet.getSurname()); cardBuilder.setFirstName(this.BEIDApplet.getFirstName()); cardBuilder.setNationality(this.BEIDApplet.getNationality()); cardBuilder.setBirthLocation(this.BEIDApplet.getBirthLocation()); cardBuilder.setBirthDate(this.BEIDApplet.getBirthDate()); cardBuilder.setSex(this.BEIDApplet.getSex()); cardBuilder.setNobleCondition(this.BEIDApplet.getNobleCondition()); cardBuilder.setSpecialStatus(this.BEIDApplet.getSpecialStatus()); cardBuilder.setStreet(this.BEIDApplet.getStreet()); cardBuilder.setStreetNumber(this.BEIDApplet.getStreetNumber()); cardBuilder.setBoxNumber(this.BEIDApplet.getBoxNumber()); cardBuilder.setZip(this.BEIDApplet.getZip()); cardBuilder.setMunicipality(this.BEIDApplet.getMunicipality()); cardBuilder.setCountry(this.BEIDApplet.getCountry()); cardBuilder.setPicture(this.BEIDApplet.GetPicture()); } else { // The applet does not return a chip number for SIS cards. cardBuilder = new be.belgium.eid.SISCardBuilder35(); cardBuilder.setCardNumber(this.BEIDApplet.getCardNumber()); cardBuilder.setValidityDateBegin(this.BEIDApplet.getValidityDateBegin()); cardBuilder.setValidityDateEnd(this.BEIDApplet.getValidityDateEnd()); cardBuilder.setNationalNumber(this.BEIDApplet.getNationalNumber()); cardBuilder.setSurname(this.BEIDApplet.getSurname()); cardBuilder.setFirstName(this.BEIDApplet.getFirstName()); cardBuilder.setInitials(this.BEIDApplet.getInitials()); cardBuilder.setBirthDate(this.BEIDApplet.getBirthDate()); cardBuilder.setSex(this.BEIDApplet.getSex()); } card = cardBuilder.getCard(); } else { if (this.noCardPresentHandler) this.noCardPresentHandler(); } } catch (e) { if (e instanceof be.belgium.eid.NullPointerException) { if (this.appletNotFoundHandler) { this.appletNotFoundHandler(); } else { window.alert("BEID Applet not found."); } } else { if (this.appletExceptionHandler) { if (this.appletExceptionHandler.length > 0) this.appletExceptionHandler(e); else this.appletExceptionHandler(); } else { window.alert("BEID Applet throw exception: " + e); } } } try { this.getBEIDApplet().exitLib(); } catch (e){} return card; }; /** * Reset applet. The picture shown in the applet will be cleared. * @public * @method reset */ be.belgium.eid.CardReader.prototype.reset = function() { try { this.getBEIDApplet().InitLib(null); } catch (e){} // catch Javascript and Java exceptions try { this.getBEIDApplet().exitLib(); } catch (e){} // catch Javascript and Java exceptions };