@vtecx/vtecxnext 2.2.4 → 2.2.6

package/dist/vtecxnext.d.ts

@@ -396,9 +396,27 @@ export declare class VtecxNext {
      * @param uri key and conditions
      * @param num page number
      * @param targetService target service name (for service linkage)
-     * @return feed Maximum number of pages in the specified page range, and total count.
+     * @return feed (entry array)
      */
     getPage: (uri: string, num: number, targetService?: string) => Promise<any>;
+    /**
+     * practical paging
+     * If you specify page 1, a new cursor list will be created.
+     * @param uri key and conditions
+     * @param num page number
+     * @param targetService target service name (for service linkage)
+     * @return feed (entry array)
+     */
+    getPageWithPagination: (uri: string, num: number, targetService?: string) => Promise<any>;
+    /**
+     * ページングのカーソルリスト作成処理
+     * 続きがある場合、次のカーソルリスト作成処理を実行する
+     * @param vtecxnext
+     * @param uri キーとパラメータ
+     * @param prevLastPage 前回の最終ページ
+     * @param targetService 対象サービス
+     */
+    private nextPagination;
     /**
      * post data to bigquery
      * @param feed entries (JSON)
@@ -985,3 +1003,10 @@ export declare class VtecxNextError extends Error {
 export declare class FetchError extends VtecxNextError {
     constructor(message: string);
 }
+/**
+ * VtecxNextError型かどうかチェック
+ * インターフェースの判定には型ガード関数を使う
+ * @param value チェックオブジェクト
+ * @returns VtecxNextError型の場合true
+ */
+export declare const isVtecxNextError: (value: unknown) => value is VtecxNextError;

package/dist/vtecxnext.js

@@ -26,7 +26,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FetchError = exports.VtecxNextError = exports.VtecxResponse = exports.VtecxNext = exports.hello = void 0;
+exports.isVtecxNextError = exports.FetchError = exports.VtecxNextError = exports.VtecxResponse = exports.VtecxNext = exports.hello = void 0;
 const sqlstring_1 = __importDefault(require("sqlstring"));
 const url_1 = __importStar(require("url"));
 /**
@@ -45,6 +45,8 @@ const SERVLETPATH_PROVIDER = '/p';
 const SERVLETPATH_OAUTH = '/o';
 /** header : nextpage */
 const HEADER_NEXTPAGE = 'x-vtecx-nextpage';
+/** The number of cursors to create (for practical paging) */
+const PAGINATION_NUM = 7;
 class VtecxNext {
     /** Request */
     req;
@@ -1395,7 +1397,7 @@ class VtecxNext {
      * @param uri key and conditions
      * @param num page number
      * @param targetService target service name (for service linkage)
-     * @return feed Maximum number of pages in the specified page range, and total count.
+     * @return feed (entry array)
      */
     getPage = async (uri, num, targetService) => {
         //console.log(`[vtecxnext getPage] start. uri=${uri} num=${num}`)
@@ -1420,6 +1422,60 @@ class VtecxNext {
         // 戻り値
         return await getJson(response);
     };
+    /**
+     * practical paging
+     * If you specify page 1, a new cursor list will be created.
+     * @param uri key and conditions
+     * @param num page number
+     * @param targetService target service name (for service linkage)
+     * @return feed (entry array)
+     */
+    getPageWithPagination = async (uri, num, targetService) => {
+        //console.log(`[getPageWithPagination] start. uri=${uri} num=${num} ${targetService ? 'targetService=' + targetService : ''}`)
+        // ページ数が1の場合、カーソルリスト作成処理を行う
+        if (num === 1) {
+            //console.log(`[getPageWithPagination] pagination start. uri=${uri}`)
+            const paginationInfo = await this.pagination(uri, `1,${String(PAGINATION_NUM)}`, targetService);
+            if (paginationInfo.hasNext) {
+                // 次のカーソルリスト作成 (非同期のまま)
+                this.nextPagination(uri, PAGINATION_NUM, targetService);
+            }
+            if (paginationInfo.lastPageNumber === 0) {
+                // データが存在しない場合終了
+                return undefined;
+            }
+        }
+        // ページ取得
+        //console.log(`[getPageWithPagination] getPage start. uri=${uri} num=${num}`)
+        try {
+            return await this.getPage(uri, num, targetService);
+        }
+        catch (error) {
+            if ((0, exports.isVtecxNextError)(error)) {
+                // ステータス400で「There is no designated page. The last page: ページ数」の場合、空データを返す。
+                if (error.status === 400 && error.message.startsWith('There is no designated page.')) {
+                    return undefined;
+                }
+            }
+            throw error;
+        }
+    };
+    /**
+     * ページングのカーソルリスト作成処理
+     * 続きがある場合、次のカーソルリスト作成処理を実行する
+     * @param vtecxnext
+     * @param uri キーとパラメータ
+     * @param prevLastPage 前回の最終ページ
+     * @param targetService 対象サービス
+     */
+    nextPagination = async (uri, prevLastPage, targetService) => {
+        const firstPage = prevLastPage + 1;
+        const lastPage = prevLastPage + prevLastPage;
+        const paginationInfo = await this.pagination(uri, `${String(firstPage)},${String(lastPage)}`, targetService);
+        if (paginationInfo.hasNext) {
+            await this.nextPagination(uri, lastPage, targetService);
+        }
+    };
     /**
      * post data to bigquery
      * @param feed entries (JSON)
@@ -4011,6 +4067,29 @@ class FetchError extends VtecxNextError {
     }
 }
 exports.FetchError = FetchError;
+/**
+ * VtecxNextError型かどうかチェック
+ * インターフェースの判定には型ガード関数を使う
+ * @param value チェックオブジェクト
+ * @returns VtecxNextError型の場合true
+ */
+const isVtecxNextError = (value) => {
+    // 値がオブジェクトであるかの判定
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const { status, message } = value;
+    // statusプロパティーが数値型かを判定
+    if (typeof status !== "number") {
+        return false;
+    }
+    // messageプロパティーが文字列型かを判定
+    if (typeof message !== "string") {
+        return false;
+    }
+    return true;
+};
+exports.isVtecxNextError = isVtecxNextError;
 //---------------------------------------------
 /**
  * vte.cxへリクエスト

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vtecx/vtecxnext",
-  "version": "2.2.4",
+  "version": "2.2.6",
   "description": "vte.cx Next.js api",
   "main": "dist/index.js",
   "files": [