Retry Node.js (Geliştiriciler İçin Nasıl Çalışır)

Kullanıcı-Yeniden Deneme Nasıl Çalışır?

• İlk girişim: İşlemi gerçekleştirmek için bir girişimde bulunulur. Başarılı olursa, işler her zamanki gibi devam eder. Prosedür geçici bir hata nedeniyle başarısız olursa, yeniden deneme mekanizması devreye girer.

• Artan Gecikmelerle Yeniden Deneme: Sistem, başarısız olan işlemi tekrar denemeden önce duraklar. Her yeniden deneme girişimi, sonraki denemeler arasındaki gecikmeyi artırır. Bu yaklaşım, sistemin kaynakları aşırı yüklemeden geçici sorunlardan kurtulmasına olanak tanır.

• Üstel Geri Çekilme: Bu yöntem, her yeniden deneme denemesi arasında aralığın üstel olarak artırılmasını içerir. Örneğin, gecikme birkaç milisaniye ile başlayabilir ve her yeniden deneme girişimi ile ikiye katlanabilir. Bu üstel büyüme, kaynağın iyileşmesini sağlar ve sistemi sürekli yeniden denemelerle bunaltmaktan korur.

• Maksimum Yeniden Denemeler: Yeniden deneme süreci, işlem başarılı olana veya maksimum yeniden deneme sayısına ulaşılana kadar devam eder. Maksimum yeniden deneme sınırını dayatarak, aşırı istekler ve sonsuz yeniden denemeler önlenebilir, bu da kaynak tükenmesini veya uzun süreli kesintileri engeller.

Kullanıcı-Yeniden Denemenin Faydaları

• Artan Dayanıklılık: Kullanıcı-Yeniden Deneme modelini kullanan sistemler, geçici arızalara karşı daha dayanıklıdır ve insan müdahalesi olmadan zarif bir şekilde toparlanır.

• Kaynaklar Üzerinde Azaltılmış Yük: Yeniden denemeler arasında daha uzun aralıklar, hedef kaynak üzerindeki yükü ve başarısız deneme sayısını azaltarak sistem kararlılığını artırır.

• Daha Hızlı Kurtarma: Üstel geri çekilme, sistemlerin geçici sorunlardan daha hızlı kurtulmasına olanak tanır. Yeniden deneme aralıklarını ayarlayarak başarılı yeniden deneme şansının daha hızlı artmasını sağlar.

• Geliştirilmiş Kullanıcı Deneyimi: Kullanıcılar, geçici hataların şeffaf bir şekilde ele alınması nedeniyle daha az kesinti ve gecikme yaşar, böylece daha sorunsuz ve güvenilir bir kullanıcı deneyimi sağlanır.

Node.js'de Yeniden Deneme Oluşturma ve Kullanma

Node.js'nin ana modüllerinden biri olan retry modülü, Node.js'de görevlerin yeniden denenmesini basitleştirir. Bu modül, ağ istekleri veya diğer eşzamansız işlemler sırasında meydana gelebilecek geçici hataların yönetilmesini kolaylaştırır. Node.js'de yeniden deneme mantığını uygulama konusunda detaylı bir rehber:

Node.js Yükleme

Henüz Node.js yüklemediyseniz, resmi Node.js web sitesinden indirip yükleyin.

Node.js Projesi Oluştur

Projeniz için yeni bir dizin oluşturun ve terminal veya komut istemi aracılığıyla içine gidin:

mkdir retry-example
cd retry-example

mkdir retry-example
cd retry-example

Node.js projesi oluşturmaya şu şekilde başlayın:

npm init -y

npm init -y

Bu, proje dizininde bir package.json dosyasi oluşturacak.

Retry Modülünü Yükleme

Not: Yerel Node.js'den farkli olarak, tekrar deneme işlevselligi genellikle ekosistemdeki async-retry gibi npm paketleri tarafından saglanir.

Yeniden Deneme Mantığını Uygulama

Aşağıda async-retry modülünü kullanarak tekrar deneme mantiginin nasıl kurulacagini gösteren Node.js koduna bir örnek verilmiştir. Bu örnekte, kurgusal bir ağ isteği yapılır ve geçici bir sorun nedeniyle başarısız olursa, üstel geri çekilme ile yeniden denenir.

const retry = require('async-retry');

// Simulate a function that performs a network request with intermittent failures
function performNetworkRequest(callback) {
    // Simulate a network request that fails 50% of the time
    const isSuccess = Math.random() < 0.5;
    if (isSuccess) {
        callback(null, 'Request successful');
    } else {
        callback(new Error('Request failed'));
    }
}

// Define options for retrying the operation
const operationOptions = {
    retries: 3,             // Number of retry attempts
    factor: 2,              // Exponential backoff factor
    minTimeout: 1000,       // Initial retry delay in milliseconds
    maxTimeout: 60000,      // Maximum retry delay in milliseconds
    randomize: true         // Randomize retry delays
};

// Create a retry operation instance
const retryOperation = retry.operation(operationOptions);

// Execute the operation with retry logic
retryOperation.attempt(function(currentAttempt) {
    performNetworkRequest(function(err, result) {
        if (retryOperation.retry(err)) {
            // Retry the operation
            console.log(`Attempt ${currentAttempt}: Retrying operation...`);
            return;
        }
        // Operation succeeded or max retries reached
        if (err) {
            console.error('Operation failed after ' + currentAttempt + ' attempts:', err);
        } else {
            console.log('Operation succeeded:', result);
        }
    });
});

const retry = require('async-retry');

// Simulate a function that performs a network request with intermittent failures
function performNetworkRequest(callback) {
    // Simulate a network request that fails 50% of the time
    const isSuccess = Math.random() < 0.5;
    if (isSuccess) {
        callback(null, 'Request successful');
    } else {
        callback(new Error('Request failed'));
    }
}

// Define options for retrying the operation
const operationOptions = {
    retries: 3,             // Number of retry attempts
    factor: 2,              // Exponential backoff factor
    minTimeout: 1000,       // Initial retry delay in milliseconds
    maxTimeout: 60000,      // Maximum retry delay in milliseconds
    randomize: true         // Randomize retry delays
};

// Create a retry operation instance
const retryOperation = retry.operation(operationOptions);

// Execute the operation with retry logic
retryOperation.attempt(function(currentAttempt) {
    performNetworkRequest(function(err, result) {
        if (retryOperation.retry(err)) {
            // Retry the operation
            console.log(`Attempt ${currentAttempt}: Retrying operation...`);
            return;
        }
        // Operation succeeded or max retries reached
        if (err) {
            console.error('Operation failed after ' + currentAttempt + ' attempts:', err);
        } else {
            console.log('Operation succeeded:', result);
        }
    });
});

IronPDF Entegrasyonu

IronPDF ile retry mantığını birleştirmek, Node.js uygulamalarında güvenilir PDF oluşturmayı sağlar.

IronPDF Yükleyin

Öncelikle, npm kullanarak IronPDF kütüphanesini yükleyin:

 npm i @ironsoftware/ironpdf

IronPDF'i İçe Aktarma ve Yapılandırma

IronPDF'i kullanmak için önce içe aktarın ve lisans anahtarınızla (satın aldıysanız) yapılandırın:

const IronPdf = require("@ironsoftware/ironpdf");
const config = IronPdf.IronPdfGlobalConfig;
config.setConfig({ licenseKey: '' });
const PdfDocument = IronPdf.PdfDocument;

const IronPdf = require("@ironsoftware/ironpdf");
const config = IronPdf.IronPdfGlobalConfig;
config.setConfig({ licenseKey: '' });
const PdfDocument = IronPdf.PdfDocument;

PDF Oluşturma Fonksiyonu Tanımla

IronPDF kullanarak PDF oluşturmak için bir fonksiyon oluşturun:

async function generatePdf(htmlContent) {
    try {
        const pdf = await PdfDocument.fromHtml(htmlContent);
        return pdf;
    } catch (error) {
        // Log or handle the error
        console.error("Error occurred during PDF generation:", error);
        throw error;
    }
}

async function generatePdf(htmlContent) {
    try {
        const pdf = await PdfDocument.fromHtml(htmlContent);
        return pdf;
    } catch (error) {
        // Log or handle the error
        console.error("Error occurred during PDF generation:", error);
        throw error;
    }
}

PDF Oluşturma için Yeniden Deneme Mantığını Uygulayın

PDF oluşturma işlemi için async-retry kullanarak tekrar deneme mantigini dahil edin:

const retry = require('async-retry');

async function retryGeneratePdf(htmlContent) {
    return await retry(async (bail, attempt) => {
        console.log(`Attempt ${attempt} to generate PDF`);
        return await generatePdf(htmlContent);
    }, {
        retries: 3,          // Maximum number of retry attempts
        factor: 2,           // Exponential backoff factor
        minTimeout: 1000,    // Initial retry delay in milliseconds
        maxTimeout: 60000,   // Maximum retry delay in milliseconds
        randomize: true      // Randomize retry delays
    });
}

const retry = require('async-retry');

async function retryGeneratePdf(htmlContent) {
    return await retry(async (bail, attempt) => {
        console.log(`Attempt ${attempt} to generate PDF`);
        return await generatePdf(htmlContent);
    }, {
        retries: 3,          // Maximum number of retry attempts
        factor: 2,           // Exponential backoff factor
        minTimeout: 1000,    // Initial retry delay in milliseconds
        maxTimeout: 60000,   // Maximum retry delay in milliseconds
        randomize: true      // Randomize retry delays
    });
}

Yeniden Deneme Mantığı ile PDF Oluşturma

Artık retryGeneratePdf fonksiyonu kullanarak tekrar deneme mantigiyla PDF'ler oluşturabilirsiniz:

const htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";

retryGeneratePdf(htmlContent)
    .then(pdf => {
        // PDF generation succeeded
        await pdf.saveAs('output.pdf');
        console.log("PDF generated successfully");
        // Handle the generated PDF
    })
    .catch(error => {
        // PDF generation failed after retries
        console.error("Failed to generate PDF:", error);
    });

const htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";

retryGeneratePdf(htmlContent)
    .then(pdf => {
        // PDF generation succeeded
        await pdf.saveAs('output.pdf');
        console.log("PDF generated successfully");
        // Handle the generated PDF
    })
    .catch(error => {
        // PDF generation failed after retries
        console.error("Failed to generate PDF:", error);
    });

Özelleştirme Seçenekleri: Uygulamanız için gerekli yeniden deneme stratejileri ve hata yönetimini özelleştirin ve izleme ve hata ayıklama amaçları için loglama ekleyin.

IronPDF ileretry mantığını birleştirerek, Node.js uygulamanızda PDF oluşturma sırasında güvenilirliği artırabilir ve hatalarla zarif bir şekilde başa çıkabilirsiniz.