hapi node js (開発者向けのしくみ)

プラグインシステムと豊かなエコシステム

Hapi.js用の豊富なプラグインコミュニティは、その基本機能を拡張しています。 そのモジュール性により、Hapi開発者が入力検証、認証、キャッシュなどの機能のためにビジネスロジックを追加しても、基本フレームワークが膨れ上がることはありません。 プラグインシステムは、管理可能で再利用可能なプログラミングを奨励します。

ルーティング

Hapi.jsは、強力で柔軟なルーティングシステムを提供しています。 これは、ハピルートに特有の構成オプション、例えば検証、認証、レスポンスフォーマットを提供し、いくつかのHTTPプロトコルをサポートします。 この柔軟性により、複雑なルーティングロジックを簡単に作成できます。

設定ベースの方法論

Hapi.jsの設定駆動方式により、開発者は設定オブジェクトを介してサーバーの動作を指定できます。 サーバーの動作の変更は、アプリケーションやビジネスロジックコードを変更することなく頻繁に実装できるため、コードを少なくし、クリーンなコードを残し、簡単に保守できるコードベースを持つことができます。

入力検証とペイロードの解析

Joiは、Hapi.jsと簡単に統合できる効果的なデータベーススキーマ記述言語およびデータバリデーターです。 この統合により、強力な入力検証が可能になり、リクエストデータが処理される前に所定の基準を満たしていることが保証されます。 JSONやフォームデータなどのさまざまなデータ型のペイロード解析もHapi.jsでサポートされています。

認証と認可の仕組み

hapi-authプラグインで、Hapi.jsはスケーラブルなウェブアプリケーションのための完全な認証と認可の仕組みを提供します。 この統合された認可システムは、基本、JWT、OAuth、カスタムスキームなどのいくつかの認証技術をサポートしています。 ルートレベルでの権限管理が可能であることで、リソースアクセスと安全なフレームワークが最小限のオーバーヘッドで保証されます。 Hapi.jsは、複雑なエンタープライズ環境で動作するように設計されています。 Hapiを使えば、ウェブサイト、サーバー、HTTPプロキシアプリケーションなど、様々なアプリケーションを構築することができます。

エラーハンドリング

Hapi.jsは豊富なエラーハンドリング機能を提供します。 カスタムエラーハンドラーは、開発者によってグローバルまたは各プロジェクトのルートレベルで問題を処理するために定義できます。 これにより、問題が一貫して処理され、顧客が洞察に満ちたエラー応答を受け取ることが保証されます。

ロギングとデバッグ

Hapiエコシステムには、バグを修正するための強力なロギングとデバッグ機能が含まれています。 サーバーアクティビティ、障害、リクエストライフサイクルイベントなど、多くの種類のイベントを記録してログに残すことができるよう構成できます。 このロギングは、アプリケーションのトラブルシューティングとパフォーマンス監視に非常に役立ちます。

拡張性

Hapi.jsのデザインは非常に拡張可能であり、たとえば、カスタムプラグインを作成して既存の動作を変更したり追加したりすることができます。 その拡張性により、Hapi.jsはあらゆるプロジェクトの特定の要件を満たすためにカスタマイズできます。

セキュリティ

入力検証、コンテンツセキュリティポリシー、HTTPヘッダー構成などの広く使用されているセキュリティ手順、スケーラブルなアプリケーションやフレームワークの統合サポートを提供することによって、Hapi.jsはセキュリティを高く優先しています。 セキュリティに重点を置くことで、開発者は一般的な脆弱性に耐性のあるアプリとフレームワークを作成できます。

Hapi.jsをインストールする

Hapi.jsとその他の必要な依存関係をインストールします。

npm install @hapi/hapi

npm install @hapi/hapi

サーバーを作成する

基本的なHapi.jsサーバーを作成するには、server.jsというファイルを作成し、次のコードを追加します。

const Hapi = require('@hapi/hapi');

// Initialize the server
const init = async () => {
    const server = Hapi.server({
        port: 3000,
        host: 'localhost'
    });

    // Define a simple GET route
    server.route({
        method: 'GET',
        path: '/',
        handler: (request, h) => {
            return 'Hello world!';
        }
    });

    // Start the server
    await server.start();
    console.log('Server running on %s', server.info.uri);
};

// Handle unhandled rejections
process.on('unhandledRejection', (err) => {
    console.log(err);
    process.exit(1);
});

// Call the initialization function
init();

const Hapi = require('@hapi/hapi');

// Initialize the server
const init = async () => {
    const server = Hapi.server({
        port: 3000,
        host: 'localhost'
    });

    // Define a simple GET route
    server.route({
        method: 'GET',
        path: '/',
        handler: (request, h) => {
            return 'Hello world!';
        }
    });

    // Start the server
    await server.start();
    console.log('Server running on %s', server.info.uri);
};

// Handle unhandled rejections
process.on('unhandledRejection', (err) => {
    console.log(err);
    process.exit(1);
});

// Call the initialization function
init();

ルート設定を追加する

const Hapi = require('@hapi/hapi');

// Initialize the server
const init = async () => {
    const server = Hapi.server({
        port: 3000,
        host: 'localhost'
    });

    // Define a GET route with path parameter
    server.route({
        method: 'GET',
        path: '/user/{id}',
        handler: (request, h) => {
            const userId = request.params.id;
            return `User ID: ${userId}`;
        }
    });

    // Start the server
    await server.start();
    console.log('Server running on %s', server.info.uri);
};

// Handle unhandled rejections
process.on('unhandledRejection', (err) => {
    console.log(err);
    process.exit(1);
});

// Call the initialization function
init();

const Hapi = require('@hapi/hapi');

// Initialize the server
const init = async () => {
    const server = Hapi.server({
        port: 3000,
        host: 'localhost'
    });

    // Define a GET route with path parameter
    server.route({
        method: 'GET',
        path: '/user/{id}',
        handler: (request, h) => {
            const userId = request.params.id;
            return `User ID: ${userId}`;
        }
    });

    // Start the server
    await server.start();
    console.log('Server running on %s', server.info.uri);
};

// Handle unhandled rejections
process.on('unhandledRejection', (err) => {
    console.log(err);
    process.exit(1);
});

// Call the initialization function
init();

const Hapi = require('@hapi/hapi');

// Initialize the server
const init = async () => {
    const server = Hapi.server({
        port: 3000,
        host: 'localhost'
    });

    // Define a GET route with query parameter
    server.route({
        method: 'GET',
        path: '/search',
        handler: (request, h) => {
            const query = request.query.q;
            return `Search query: ${query}`;
        }
    });

    // Start the server
    await server.start();
    console.log('Server running on %s', server.info.uri);
};

// Handle unhandled rejections
process.on('unhandledRejection', (err) => {
    console.log(err);
    process.exit(1);
});

// Call the initialization function
init();

const Hapi = require('@hapi/hapi');

// Initialize the server
const init = async () => {
    const server = Hapi.server({
        port: 3000,
        host: 'localhost'
    });

    // Define a GET route with query parameter
    server.route({
        method: 'GET',
        path: '/search',
        handler: (request, h) => {
            const query = request.query.q;
            return `Search query: ${query}`;
        }
    });

    // Start the server
    await server.start();
    console.log('Server running on %s', server.info.uri);
};

// Handle unhandled rejections
process.on('unhandledRejection', (err) => {
    console.log(err);
    process.exit(1);
});

// Call the initialization function
init();

サーバーを実行する

サーバーを起動するために次のコマンドを実行します。

node server.js

node server.js

ターミナルで、http://localhost:3000でサーバーが運行しているというメッセージを見るべきです。 http://localhost:3000を訪れたとき、「こんにちは、Hapi！」がブラウザに表示されます。

IronPDFとは何ですか？

IronPDFは、PDFの作成、編集、管理を簡単にするために設計されたアプリケーションライブラリです。 このツールは、HTMLドキュメントからテキストと画像を抽出したり、複数のPDFドキュメントを結合したり、ヘッダーや透かしを適用したりすることができます。 IronPDFのユーザーフレンドリーなAPIと豊富なドキュメントを使用して、開発者はプログラムで高品質のPDFドキュメントを簡単に作成でき、PDFの処理を簡素化します。 IronPDFは、請求書、レポート、またはドキュメントの作成目的にかかわらず、ドキュメントワークフローを改善し、さまざまな状況で優れたユーザー体験を提供するために必要なすべての機能と能力を備えています。

IronPDFの機能

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

Hapi.jsとIronPDFの統合

まず、シンプルなHapi.jsサーバーを設定してウェブ上のリクエストに対応できるようにします。 このサーバーは、PDFファイルを生成するためのリクエストを受け取る準備ができています。

const Hapi = require('@hapi/hapi');
const IronPdf = require("@ironsoftware/ironpdf");

// Configure the IronPDF setup
const document = IronPdf.PdfDocument;
var config = IronPdf.IronPdfGlobalConfig;
config.setConfig({licenseKey: ''});

// Initialize the server
const init = async () => {
    const server = Hapi.server({
        port: 3000,
        host: 'localhost'
    });

    // Define a route for PDF generation
    server.route({
        method: 'GET',
        path: '/',
        handler: async (request, h) => {
            // Generate PDF here
            console.log('Connected');
            await generatePdf();
            return h.file('demo.pdf');
        }
    });

    // Start the server
    await server.start();
    console.log('Server running on %s', server.info.uri);
};

// Handle unhandled rejections
process.on('unhandledRejection', (err) => {
    console.log(err);
    process.exit(1);
});

// Function to generate PDF from HTML using IronPDF
const generatePdf = async () => {
    const htmlContent = '<html><body><h1>Hello, IronPDF!</h1></body></html>';
    (await document.fromHtml(htmlContent)).saveAs('demo.pdf');
};

// Call the initialization function
init();

const Hapi = require('@hapi/hapi');
const IronPdf = require("@ironsoftware/ironpdf");

// Configure the IronPDF setup
const document = IronPdf.PdfDocument;
var config = IronPdf.IronPdfGlobalConfig;
config.setConfig({licenseKey: ''});

// Initialize the server
const init = async () => {
    const server = Hapi.server({
        port: 3000,
        host: 'localhost'
    });

    // Define a route for PDF generation
    server.route({
        method: 'GET',
        path: '/',
        handler: async (request, h) => {
            // Generate PDF here
            console.log('Connected');
            await generatePdf();
            return h.file('demo.pdf');
        }
    });

    // Start the server
    await server.start();
    console.log('Server running on %s', server.info.uri);
};

// Handle unhandled rejections
process.on('unhandledRejection', (err) => {
    console.log(err);
    process.exit(1);
});

// Function to generate PDF from HTML using IronPDF
const generatePdf = async () => {
    const htmlContent = '<html><body><h1>Hello, IronPDF!</h1></body></html>';
    (await document.fromHtml(htmlContent)).saveAs('demo.pdf');
};

// Call the initialization function
init();

HTTP呼び出しをポート3000で聞くためにサーバーを設定し、Hapi.jsをインポートします。 HTTP GETリクエストをルートパス/に処理するためのルートを定義します。 generatePdf関数をルートハンドラーで呼び出し、IronPDFを使用してPDFコンテンツを作成します。 HTML素材をPDFバッファとして非同期にレンダリングするためにIronPDFをインポートします。 生成後、関連するコンテンツタイプ（application/pdf）でPDFコンテンツがレスポンスとして返されます。 さらに、PDFを添付ファイルとしてダウンロードするか、ブラウザにインライン表示するか（オプション）を指定するためのContent-Dispositionヘッダーを設定します。