Məqalə

Sıfıra bölmə, tapılmayan fayl, qəfil kəsilən şəbəkə bağlantısı: real proqramda xətalar qaçılmazdır. Problem xətanın baş verməsində deyil, ona hazır olmamaqdadır. 1C:Enterprise dilində istisnaların (exceptions) idarə edilməsi Попытка ... Исключение ... КонецПопытки konstruksiyası ilə aparılır. Bu məqalədə onun işləmə məntiqini, tipik səhvləri, ВызватьИсключение, ИнформацияОбОшибке() və tranzaksiyalarla düzgün birgə istifadəni araşdırırıq.

1. Konstruksiya necə işləyir?

Xəta riski olan kod Попытка blokuna yazılır. İcra ardıcıllığı belədir:

1. Təhlükəli kod Попытка blokunda icra olunur.
2. Hər hansı sətirdə xəta baş verərsə, blokun qalan sətirləri icra olunmur.
3. İdarəetmə dərhal Исключение blokuna keçir.
4. Xəta olmasa, Исключение bloku ümumiyyətlə işləmir.

Sifir = 0;

Попытка
    Netice = 10 / Sifir;                 // burada xəta baş verir
    Сообщить("Nəticə: " + Netice);       // bu sətir icra OLUNMUR
Исключение
    Сообщить("Xəta baş verdi: " + ОписаниеОшибки());
КонецПопытки;

Eyni kodun icra izi

Bənzətmə: təhlükəsizlik kəməri

Попытка təhlükəsizlik kəmərinə bənzəyir: qəza olsa da, sürücünü qoruyur. Lakin kəmər maşının zədələnməsini aradan qaldırmır. Eynilə, Попытка proqramın çökməsinin qarşısını alır, amma xətadan sonra məlumatın düzgün vəziyyətdə qalması üçün özünüz tədbir görməlisiniz.

2. Xətanı “udmaq” ən böyük günahdır

Yeni başlayanların ən tipik səhvi Исключение blokunu boş buraxmaqdır. Proqram çökmür, amma xəta da heç yerdə görünmür.

// PİS: xəta gizlədilir
Попытка
    SenediYaz(Sened);
Исключение
КонецПопытки;

Bu yanaşma gələcəkdə səbəbini tapmaq çətin olan “kabus” xətalara gətirir: məlumat natamam yazılır, hesablamalar sürüşür, istifadəçi isə əməliyyatın uğursuz olduğunu bilmir. Xəta ilə bağlı üç mümkün strategiya var:

Resursun bağlanması nümunəsi (Finally olmadığı üçün)

Oxuyucu = Неопределено;
Metn    = "";

Попытка
    Oxuyucu = Новый ЧтениеТекста(FaylinYolu, КодировкаТекста.UTF8);
    Metn = Oxuyucu.Прочитать();
Исключение
    Сообщить("Fayl oxuna bilmədi: " + КраткоеПредставлениеОшибки(ИнформацияОбОшибке()));
КонецПопытки;

// Bu hissə həm uğurlu, həm xətalı halda icra olunur
Если Oxuyucu <> Неопределено Тогда
    Oxuyucu.Закрыть();
КонецЕсли;

3. ВызватьИсключение: xətanı qəsdən yaratmaq və ötürmək

Funksiyaya yanlış və ya təhlükəli məlumat daxil olubsa, kod səssizcə işləməməlidir. ВызватьИсключение komandası məqsədli şəkildə istisna yaradır. Nəticə xətanı çağıran koda ötürülür.

Функция Bol(A, B)

    Если B = 0 Тогда
        ВызватьИсключение "Sıfıra bölmək olmaz!";
    КонецЕсли;

    Возврат A / B;

КонецФункции

Попытка
    Netice = Bol(10, 0);
Исключение
    Сообщить(КраткоеПредставлениеОшибки(ИнформацияОбОшибке()));
КонецПопытки;

Xətanı yuxarı ötürmək (re-throw)

Исключение bloku daxilində ВызватьИсключение; parametrsiz yazılsa, tutulmuş xəta olduğu kimi yuxarıya ötürülür. Bu halda əvvəlcə lazımi əməliyyat (məsələn, jurnala yazmaq) aparılır, qərarı isə çağıran səviyyə verir.

Попытка
    ServerdeEmal(Parametr);
Исключение
    // 1. Hadisələr jurnalına yazırıq
    ЗаписьЖурналаРегистрации("Emal.Xeta", УровеньЖурналаРегистрации.Ошибка,,,
        ПодробноеПредставлениеОшибки(ИнформацияОбОшибке()));

    // 2. Xətanı yuxarı ötürürük
    ВызватьИсключение;
КонецПопытки;

4. Xətanın “pasportu”: ИнформацияОбОшибке()

ИнформацияОбОшибке() cari xəta haqqında bütün texniki məlumatı özündə saxlayan xüsusi obyekt qaytarır (Структура deyil). Əsas xassələri:

Попытка
    Netice = 10 / 0;
Исключение
    Info = ИнформацияОбОшибке();

    Сообщить("Xətanın mətni: " + Info.Описание);
    Сообщить("Modul: " + Info.ИмяМодуля);
    Сообщить("Sətir: " + Info.НомерСтроки);
КонецПопытки;

Səbəb zənciri: əsl ilkin səbəbi necə tapmalı?

Xəta bir neçə çağırış səviyyəsindən keçəndə Причина xassəsi zəncir yaradır. Info.Причина yalnız növbəti səviyyəni göstərir, ilkin səbəb isə zəncirin sonundadır. Ona çatmaq üçün dövr lazımdır:

Info  = ИнформацияОбОшибке();
Koken = Info;

Пока Koken.Причина <> Неопределено Цикл
    Koken = Koken.Причина;
КонецЦикла;

Сообщить("İlkin səbəb: " + Koken.Описание);

Üç “təqdimat” funksiyası

İstifadəçi nəyi görməlidir?

İstifadəçiyə texniki sistem xətasını deyil, aydın və istiqamətləndirici mesajı göstərin. Texniki detalları isə Hadisələr jurnalına yazın.

5. Попытка və tranzaksiya: dəyişiklikləri geri qaytarmaq

Bir neçə obyekt ardıcıl yazılırsa (sənəd, hərəkətlər, qeydlər), ortada xəta baş verəndə bəziləri yazılmış, bəziləri yazılmamış qala bilər. Bunun qarşısını almaq üçün əməliyyatları tranzaksiyaya salın. Попытка özü bazadakı dəyişiklikləri geri qaytarmır, bunu ОтменитьТранзакцию() ilə siz etməlisiniz.

НачатьТранзакцию();

Попытка
    // bir neçə əlaqəli yazı əməliyyatı (obyekt adı nümunə üçündür)
    Sened = Документы.Realizasiya.СоздатьДокумент();
    Sened.Дата = ТекущаяДата();
    Sened.Записать(РежимЗаписиДокумента.Проведение);

    ZiyadeYazi(Sened.Ссылка);

    ЗафиксироватьТранзакцию();
Исключение
    ОтменитьТранзакцию();

    ЗаписьЖурналаРегистрации("Realizasiya.Yazma", УровеньЖурналаРегистрации.Ошибка,,,
        ПодробноеПредставлениеОшибки(ИнформацияОбОшибке()));

    ВызватьИсключение;
КонецПопытки;

6. Попытка nə vaxt lazımdır?

Попытка hər sətri bükmək üçün deyil, yoxlamaqla qarşısı alınmayan gözlənilməz hallar üçündür. Gözlənilən vəziyyəti isə sadə şərtlə yoxlamaq daha aydın və daha sürətlidir.

Etibarlılıq pilləkəni (konseptual)

Aşağıdakı diaqram konseptualdır, real ölçmə deyil: xətaya yanaşmanın keyfiyyət səviyyələrini göstərir.

Попытка yoxdur

1

Boş Исключение

0

Mesaj göstərir

2

Mesaj + jurnal

3

Jurnal + tranzaksiya + ötürmə

4

7. Hadisələr jurnalı: xətanın izi

ЗаписьЖурналаРегистрации() funksiyası hadisəni 1C Hadisələr jurnalına (Журнал регистрации) yazır. Bu, istifadəçi mesajından fərqli olaraq, sonradan analiz üçün qalan izdir.

Yekun: 6 qayda yadda saxlayın

1. Попытка yalnız icra zamanı xətalarını tutur və xətadan sonrakı kodu atır.
2. Boş Исключение yazmayın. Xətanı ya idarə edin, ya da yuxarı ötürün.
3. ВызватьИсключение ilə yanlış vəziyyəti dərhal bildirin; blokda parametrsiz yazılışı xətanı yuxarı ötürür.
4. ИнформацияОбОшибке() ilə sətir, modul və səbəb zəncirini toplayın; ilkin səbəb üçün dövrdən istifadə edin.
5. Tranzaksiyada xətada həmişə ОтменитьТранзакцию() çağırın.
6. Gözlənilən halı şərtlə, gözlənilməz halı Попытка ilə idarə edin; istifadəçiyə dost mesaj, jurnala texniki detal verin.

Tez-tez verilən suallar