Национален регистър на Единните Граждански Номера

В петтата подсистема за избрана дата се сверява хартиеният каталог с електронният му вариант. В подсистема шест се въвеждат бележки от каталога на ЕГН. В седмата подсистема при възникването на грешка може да се коригира или освободи даден ЕГН. Във всяко от 28-те териториални звена на ГД “ГРАО”, се сверяват чрез модул 2.5 хартиените каталози от предходни години и техните електронни еквиваленти. Когато каталозите за дадена година са напълно сверени, в подсистема 2.8 се отбелязва че дадената година е сверена, и така свободните ЕГН-та от тази година могат да бъдат заявявани при необходимост чрез модул 2.3. Моулът 2.9 извежда списък на годините които са със сверен каталог на ЕГН. Следващата подсистема 2.10 извежда списък на заявените ЕГН, без запис в НБД, което означава че тези ЕГН-та са запазени но за тези лица все още не е попълнен Личен регистрационен картон (ЛРК).

В “Информационната система на Национална База Данни - Население”, моята задача се състои в разработката на две точки от Web базираното приложение.

Старата система, която работеше преди завършването на новата система се базира на клиентски Java Script, който служи за проверка и обработка на входните данни и сървърен Java Script, който се свързва с базата данни, обработва избраните и въведени данни и извежда в HTML страница изходните резултати от направените в него SQL заявки.

Необходимостта да се разработи нова уеб-базирана информационна система се появи от моралното остаряване на използваните за достъп до националната база данни сървъри, които бяха в процес на подмяна. Това от своя страна доведе зползването на HTML в комбинация със сървърен Java Script неприемливо и нерационално, поради моралното остаряване на тази технология.

След обмисляне и консултации със специалисти, ръководството на Главна дирекция “ГРАО” се спира на използването на JAVA. Причините за това са, че тя е мултиплатформена и лесно преносима. JAVA е обезпечена с драйвъри за огромна част от софтуера за СУБД, което увеличава преносимостта и на различни платформи и работата и с голямо разнообразие продукти за СУБД. Също така друго удобство е, че самите среди за разработка на JAVA, предлагат огромен набор от библиотеки, и помощни средства, с които работата върху системата се улеснява. JAVA кодът е по-подреден, което също е важно при работа по голями проекти. За JAVA има голямо разнообразие от редактиращ софтуер. И не на последно място JAVA е по-лесна, и същевременно по-евтина като решение от другите алтернативни среди за разработка.

Двете подсистеми които разработвах от “Информационна система Национална База Данни - Население”, са: “3. Национален адресен регистър” и “5. Заявки за списъци, таблици и файлове”. В първата подсистема се извършват различни видове справки в националния адресен регистър на България. Втората подсистема е нещо като генератор на справки. В нея може да се направят такива справки, която другите програмни модули не позволяват, заради обема на връщаните резултати. Но в тази подсистема резултатите се връщат под формата на файл и това позволява създаването на по-мощни справки.

1. 
   JSP страница, служеща за входящите данни, които ще се обработват от програмата. Обикновено тази страница съдържа в името си стринга - “index”. В нея се извършват основните проверки на входящите данни, за което в HTML - кода се използват и Java Script функции. При натискането на HTML бутон от тип “Submit”, тази страница препраща към:
   
2. 
   Java HttpServlet - логиката на модула. Сървлетът извършва някои проверки на входящите данни, обработва тези входящи данни, правейки SQL заявки към базата. Изходните данни, обработени от сървлета се въвеждат в масив от тип “ArrayList”. Всеки запис от масива представлява HTML ред, показван с цикъл в изходната страница. Информацията най-често е изведена от базата, обработена и съчетана с подходящите HTML тагове, за да бъде показана на потребителя по подходящ начин. След като сървлетът се изпълни, ако информацията е въведена коректно на входа, масивът е зареден с изходните данни и се въвежда в рекуеста на страницата.
   
3. 
   Динамична JSP страница, служеща за извеждане на крайните, обработени данни. След като сървлетът е пренасочил браузъра към нея, тя взема масива от рекуеста и с цикъл от тип for извежда резултатите в нея.
   

Ако потребителят е намерен в базата и паролата отговаря на него, тогава в обект от тип “app.util.UserInfo”, който представлява “JavaBean” клас, се въвеждат всички полета от таблицата, отговарящи на дадения потребител. Този обект се използва в цялаото приложение, като от него се взимат различните права на потребителя. Служи и за защита, когато някой се опита да извика дадена страница, без да е минал през страницата за вход, този обект се проверява и тъй като в този случай той е празен - управлението се препраща към страницата за вход със съответно съобщение за грешка. Това съобщение или съобщението, получаващо се при неуспешно връзване към базата, се съхраняват в обект от тип “app.util.Message”. В този обект се съхранява и името на потребителя с цел проверка дали е влязъл в системата или се опитва директно да стартира сървлета. Таблицата, която се използва при проверката на потребителя в “app.validate.java” е:

--- --------- ----- ---------------------------------------

1 usid 6 Идентификатор на потребител (кирилица голяма, цифри)

2 usan 1 Активен потребител =1, неактивен =0

3 usobl 2 КОД на област

4 usob 2 КОД на община - празно за ТЗ “ГРАО”

5 usrn 2 КОД на район - само за градове с райони

6 usnm 5 КОД на населено място

7 usgr 6 Група потребители (идентификатор на началника)

8 usegn 10 ЕГН на потребител

9 usname 36 Име на потребител (кирилица)

10 usodel 12 Отдел, звено (кирилица)

11 usdlj 12 Длъжност (кирилица)

12 usidl V 55 Адрес на електронната поща

13 uspwd 8 Парола

14 uspwdn 8 Парола-нова

15 usvp 1 Идентификатор на служебната длъжност(поста) на потребителя.

16 usds 1 Достъп до информ. с-ма: 0-без достъп, 1-има достъп

17 uskegn 1 Достъп до каталог ЕГН:0-без достъп,1-получава нов ЕГН

18 usapon 1 Достъп до АПОН и ГС: 0 - без достъп, 1 - има достъп

19 usas 1 Актуалицация с АС: 0 - не въвежда АС и корекции

1 - въвежда АС и корекции

20 usatd 1 Актуалицация с АТД: 0- не въвежда АТД, 1- въвежда АТД

21 usft 4

1–ва позиция: 0=не, 1=да изпраща файлове с АС и АТД в НБД;

2–ра позиция: 0=не, 1=да получава файлове за ТЗ и община от НБД;

3–та позиция: 0=не, 1=да получава файлове съдържащи актуализираните записи на лицата АЗЛ, променени ЕГН и променени пътни артерии (други нац. с-ми);

4–та позиция: 0=не, 1=да получава файлове за обратна връзка автоматично

22 usdataz D 8 Дата, на която е започнал работа или 01.01.1800

23 usdatap D 8 Дата, на която е прекратил работа или 01.01.2222

24 usdata D 8 ДАТА на актуализация на данните за потребителя

ipotr1 УHИKAЛEH usid

ipotr2 УHИKAЛEH usegn
След като потребителят е влязал успешно в системата, обектът с данните на потребителя е запълнен и управлението се прехвърля на “Web Content\M_Menu.jsp” (Фигура 0.2), което представлява главната страница на системата. Тя представлява HTML страница, съдържаща следните смислови фрагменти: заглавието и логото на информационната система. основното меню на информационната система, състоящо се от 6 менюта. След като бъде избрано дадено меню, в средата на страницата се разтягат/визуализират подменютата му. Страницата “ M_Menu.jsp” съдържа всички основни менюта и техните подменюта. При стартиране първото меню е разгънато, а другите менюта са свити, като това се контролира от JavaScript функцията “collapseAll”.

III.4. Общи класове, използвани в целият проект, които можем да наречем условно библиотеки на проекта са класовете от пакета “app.util.classes” - 6 класа и класовете от пакета “Log” – 5 класа. В точки от III.4.1 до III.4.4 ще опиша класовете от първия пакет, а в точка от III.4.5 ще опиша накратко класовете от втория пакет - “Log”. След това в точка III.4.6 ще опиша 4-те класа от пакета “app.util”, които са важни за проекта, и служат като контейнери на информация. Те са JAVA Beans. И накрая в точка III.4.7 ще обясня за какво служат 2-та класа от пакета “ExServlets”.

III.4.1. Клас “app.util.classes.DBConnection.java” (Код. VII.3.6.). В този клас чрез методъд public synchronized Connection getConnection() throws SQLException се образува връзката между приложението и базата. Важно е да се отбележи използването на драйвърът “org.logicalcobwebs.proxool.ProxoolDriver” за образуване на Connection Pooling на връзките към базата, с цел по ефективно използване на ресурсите на Application Server-а, и с цел да е по-малко натоварен.

III.4.2. Клас “app.util.classes.lib.java”. Вторият клас е “app.util.classes.lib .java”. В него са методи, които се използват на много места в проекта и за това са обособени в отделен статичен клас, който е достъпен в целия проект. Тези методи или правят проверка на някои променливи, или обработват определени входни данни. Всички методи на класа са публични и статични:

1. public static String adres (Connection conn,String vnm,String vpa,String vnom,String vvh,String vet,String vap,Date vdata) throws SQLException,IOException – методът връща стойност от тип “String”, която представлява пълен адрес на дадено лице. Като параметри му се подават връзката “conn” от тип “Connection”, от тип “String” обектите “vnm”, “vpa”, “vnom”, “vvh”, “vet”, “vap”, представляващи населеното място, пътната артерия, номер на адреса, вход, етаж и апартамент. Последният обект е “vdata” от тип “Date”.

2. public static String srav_Date(String date1,String date2) – методът сравнява променливите date1 и date2 от тип “String”, представляващи дати с формат “dd.MM.yyyy”, като връща “String”, като ако първата дата е по-голяма - връща “greater”, ако е по-малка - “smaller”, а ако двете са равни - връща “equal”.

3. public static String ret_grime(Connection conn,String vhp) throws SQLException, IOException - връща от базата името на държавата по нейния код, задаван като параметър. Таблицата, в която е класификатора на държавите е “t_kgr” - таблица номер 6 в списъка с приложените таблици.

4. public static String get_brday (String wegn) – връща тип “String” “Роден/а на:” + “dd.MM.yyyy” по подадена променлива wegn от тип “String”, представляваща век + егн. Подаваният стринг се образува от метода:

5. public static String viegn(String egn) – връща String - век + егн при входен параметър egn от тип “String”, представляваща дадено ЕГН.

6. public static String get_Now(String timeFormat) – връща тип “String” с текущата дата, форматирана по формата, зададен като параметър с променливата timeFormat от тип “String”.

7. public static ResultSet RunSQL_B1(Connection conn, String SQL_S1) throws SQLException, IOException – методът връща обект тип ResultSet с намерените в базата резултати по зададени: променливата conn от тип “Connection”, която съдържа връзката с базата и променливата SQL_S1 от тип “String”, в която е зададена SQL заявката.

8. public static boolean valid_egn(String str) – връща резултат от тип “boolean”, в който се записва “True”, ако в подадения като параметър “String” str има непозволени символи. Стрингът трябва да е ЕГН.

9. public static boolean valid_ime(String str) – връща резултат от тип boolean, в който се записва “True”, ако в подадения като параметър “String” str има непозволени символи. Тук стрингът е име на човек.

10. public static boolean valid_danni(String str) – връща резултат от тип “boolean”, в който се записва “True”, ако в подадения като параметър “String” str има непозволени символи. Подаваният параметър може да е име, ЕГН, като този метод служи за по-обща проверка на данните.

11. public static boolean valid_nm(String str) – връща резултат от тип boolean, в който се записва “True”, ако в подадения като параметър “String” str има непозволени символи. Тук стрингът е име на населено място.

12. public static boolean valid_drj(String str) – връща резултат от тип boolean, в който се записва “True”, ако в подадения като параметър “String” str има непозволени символи. Тук стрингът е име на държава.

13. public static boolean valid_pa(String str) – връща резултат от тип boolean, в който се записва “True”, ако в подадения като параметър “String” str има непозволени символи. Тук стрингът е име на пътна артерия.

14. public static boolean valid_nom(String str) – връща резултат от тип boolean, в който се записва “True”, ако в подадения като параметър “String” str има непозволени символи. Тук стрингът е номера от адреса, в който може освен числа да има и буква.

15. public static boolean valid_vh(String str) – връща резултат от тип boolean, в който се записва “True”, ако в подадения като параметър “String” str има непозволени символи. Тук стрингът е входа от адреса, в който може освен числа да има и букви.

16. public static boolean isValidSqlVariable(String testStr) – връща “boolean” - “True”, ако в подадената променлива testStr от тип “String” има непозволени за SQL заявка символи. Използва се в случаите когато условията за образуването на заявката и нейните параметри са много и става логически трудно да се използва вградената(подсигурена) JAVA функционалност за добавяне на променливи в заявката.

17. public static boolean has_slash(String str) – връща “boolean” - “True”, ако в подадената променлива str от тип “String” има символа “_”.

18. public static boolean has_percent (String str) – връща “boolean” - “True”, ако в подадената променлива str от тип “String” има символа “%”.

19. public static boolean valid_data(String str) – връща резултат от тип boolean, в който се записва “True”, ако в подадения като параметър “String” str има непозволени символи. Тук стрингът е дата.

20. public static boolean intNumBooleanValue(int number) – връща “boolean” - “True”, ако подадената променлива number от тип “int” е равна на “0” и връща “False”,.при всички останали стойности на number.

21. public static int sel_pol(String inp) – методът връща пола по деветата цифра от подаденото и като параметър ЕГН. Типът който връща е “int”, като може да приема стойности: “0” – мъж и “1” – жена.

22. public static String sel_who(String inp, String pol) – по подадени тип на лицето и пол съответно в променливите inp и pol от тип “String”, методът връща роднинството на лицето на лицето. Например: “баща”, “майка”, “брат”, “съпруга” и т.н.

23. public static String egnk_tip(String tip) – методът връща в “String” типа на ЕГН. Дали е: “Даден”, “Изтрит”, “Коригиран”, “Освободен”, “Дублиран”, ако няма данни за това ЕГН, връща "Даден ЕГН, за който няма запис в НБД ЕСГРАОН".

24. public static boolean isadigits(String str) – връща “True”, ако в подадената му променлива str от тип “String” има символи, различни от цифра.

25. методите public static void GoToError_Page(HttpServletRequest request, HttpServletResponse response,String ErrMessage) и GoToError_Page_UNI– пренасочват браузъра към страницата, показваща съобщение за грешка, като това съобщение се подава като параметър ErrMessage от тип “String” на метода, а на вторият метод може да се подава и URL на страница за грешка. Втората се използва предимно при възникване на системни грешки, а първата при грешно въведени от потребителя параметри. Понякога при други обстоятелства се използва и методът JSP_Redirect.

26. методите public static void Redirect_ToPage(HttpServletRequest request, HttpServletResponse response,String URL_P) и Redirect_ToPage2 – пренасочват браузъра към страница от тип “JSP”, чийто адрес(път) е зададен като параметър на метода в променливата URL_P от тип “String”.

27. public static void Redirect_ToServlet(HttpServletRequest request, HttpServletResponse response, ServletContext SC,String URL_P) – пренасочва браузъра към Сървлет, чийто адрес е зададен като параметър на метода в променливата URL_P от тип “String”.

28. public static String Sub_String (String in1, int b1, int e1) – връща “String”. Отрязва подадения и като параметър in1 от тип String от начална позиция b1 от тип int, до крайна позиция e1 от тип “int”.

29. public static String god_s (String igod) – създава “HTML Select” – поле с подходяшата дата, като резултатът се бръща от тип “String” във формата на HTML код.

30. public static boolean isDigit(String s) – проверява дали някой от символите на подадения стринг s цифра, и ако не е, връща резултат “False”. Прилича на метода “isadigits”, но начинът, по който връща резултата е различен.

31. public static String DATE_FOR_SQL (String Date_S) – като параметър се подава “String” с дата с формат “dd.MM.yyyy” и се връша “String” с дата с формат “yyyy-MM-dd”, тъй като драйвърът за “Informix” я изисква в такъв формат при SQL заявките.

32. public static String srav_Date_1(String date1,String date2) – методът сравнява променливите date1 и date2 от тип “String”, представляващи дати с формат “dd.MM.yyyy”, като връща “String”, като ако първата дата е по-голяма връща “1”, ако е по-малка “-1”, а ако двете са равни, връща “0”.

33. public static String Get_MAIL_User(String fullMail) – връща потребителя (символния низ в Е-мейла, който е до знака “@”) на зададен като параметър в fullMail от тип “String” Е-мейл към метода.

34. public static String add_symbol(String InStr, int len, String symbol) – добавя към началото на подаденият в параметъра InStr символен низ символен низ с дължина len образуван от повтарящият се символ подаден в параметъра symbol.

35. public static String error_akt(String code) – извежда подходящото съобщение за грешка според подадения и в параметъра code от тип “String” код за грешка.

36. public static String ch_type(int num) – извежда типът на акта според подадения и в параметъра num от тип “int” код.

37. public static String sel_construct (HttpServletRequest request, HttpServletResponse response, ServletContext sc) throws ServletException, IOException – взимат се от обекта подаден като параметър-request въведените от потребителят параметри и се образува SQL-заявката, която извежда пълните данни за дадено лице.

38. public static boolean spec_sym(String str) – връща “True”, ако в подаденият в параметъра str символен низ има символ двойни кавички или литерал.

39. public static String Oblasti_List(HttpServletRequest request) throws SQLException, NamingException, ClassNotFoundException – връща символен низ със списък на областите на България, оформен с подходящите HTML тагове за да се получи комбо поле-SELECT.

40. public static String sel_smp(String smp, String pol) – връща стринг със семейното положение на лицето по подадени параметри код на семейното положение и пол подадени съответно в параметрите smp и pol от тип “String” /например: женен(а).

41. public static String p_egnb(Connection conn, String egnp) throws SQLException, IOException – образува хипервръзки към сървлетите които извеждат съответно данни от Националния Регистър на ЕГН (НРЕГН) и пълните данни за лицето с ЕГН подадено в параметъра egnp от тип “String”. Подава се и обектът служещ за връзка с базата - conn.

42. public static String valgod(String egn) – изчислява датата на раждане от ЕГН-то което е подадено в параметъра egn от тип “String”, проверява датата и връща съобщение ако лицето е под 18 или над 65 години.

43. public static boolean gpswd() – генерира парола от произволни символи, като тя трябва да е от български малки букви и цифри. Методът подлежи на доразработка и преосмисляне на правилата и логиката в него.

44. public static boolean fcont2(String egn, String tz1) – при подадени ЕГН и код на област съответно в параметрите egn и tz1 от тип “String”, методът връща “True” ако ЕГН е с контингент от областта и “False” ако ЕГН е с контингент от друга област.

45. public static String completeString(String str, int len) – методът добавя към подаденият в параметъра str символен низ толкова интервали на колкото е равна разликата между дължината подадена в параметъра len от тип “int” и дължината на символния низ str (len - str.length()).

46. public static String statut_cod(String cod) – връща типът статут по подаден в параметъра cod от тип “String” код на статута.

47. public static String fgr12(Connection conn, String gr, String gr2) throws SQLException, IOException – подава се обекта служещ за връзка с базата conn и кодовете за първо и второ гражданство – gr и gr2. Методът образува и връща символен низ в който са добавени имената на гражданствата.

48. public static boolean hasAdminRights(String usrid) – по подадено в параметъра usrid от тип “String” потребителско име връща “True” ако потребителят има административни права в системата и “False” ако потребителят няма такива права.

49. public static boolean isConnectionValid(Connection conn) – проверява дали връзката към базата е активна и валидна по подаден обект conn от тип “Connection”.

50. public static String fvzr(HttpServletRequest request, HttpServletResponse response, String datar, String datas) throws UnsupportedEncodingException, ServletException, IOException – проверява дали датата на раждане подадена в параметъра datar от тип “String”, е по малка от датата на смърт подадена в параметъра datas от тип “String”. Ако параметъра datas е празен вместо него се използва текущата дата. Ако има грешки например датата на раждане е след датата на смърт/текущата дата, функцията връща съобщение за грешка. Ако няма грешка с датите методът връща възрастта изчислена от двете подадени дати.

51. public static String grajd(Connection conn,String gr,String gr2) throws SQLException – на този метод се подават като параметри обектите: “conn” от тип “Connection” - връзката с базата, “gr” и “gr2” от тип “String”, които са съответно кодовете за първо и второ гражданство. Методът връща “String”, в който са изведени имената на двете гражданства във вид /"първо: " +gr1 +", второ: " + gr2/.

52. public static String ret_ob(Connection conn,String kod) throws SQLException. По подаден с параметъра “kod” от тип “String” код на населено място, методът връща “String” с името на областта и населеното място.

53. public static String ret_obl(Connection conn,String kobl) throws SQLException. По подаден с параметъра “kobl” от тип “String” код на област, методът връща “String” с името на областта.

54. public static String ret_oblt (Connection conn, String kod1) throws SQLException. По подаден с параметъра “kod1” от тип “String” код на област - латиница, методът връща “String” с името на областта.

55. public static String ret_nmName(Connection conn,String nm_kod) throws SQLException. По подаден с параметъра “nm_kod” от тип “String” код на населено място, методът връща “String” с името на населеното място.