Java 的 ViewNavigator:讀大 view 要關 autoupdate、設 CacheSize

Java 的 ViewNavigator:讀大 view 要關 autoupdate、設 CacheSize

2026.11.14 約 952 字

一個十幾萬筆的 view,你在 Java 要走過每一列做點事。直覺是 view.getAllDocuments() 一把抓——然後大 view 直接把你的 heap 撐爆,因為它會先把整批文件拉進記憶體。

ViewNavigator 走的是另一條路。官方定義「Represents a view navigator. A view navigator provides access to all or a subset of the entries in a view.」——它沿著 view 的索引一列一列走,每一列是一個 ViewEntry,拿的是索引層的 row 資料,不必逐筆把 Document 開出來。對大 view,這是能走得完的那種讀法。

但「用了 ViewNavigator」不等於「快」。要它真的快,有三個旋鈕得自己調。這篇講怎麼建對走訪範圍、那三個效能旋鈕,以及走訪時的記憶體紀律。


先建對範圍

ViewNavigator 從 view 建,而且你可以只框住要的那一塊,不必每次都全表:

  • createViewNav()——整個 view。
  • createViewNavFromCategory("2026/Q4")——某個分類底下。
  • createViewNavFromChildren(entry) / createViewNavFromDescendants(entry)——某列的直接子代 / 所有後代(處理階層式 view 時用)。
  • createViewNavMaxLevel(n)——只到第 n 層,把深階層壓平。
  • createViewNavFromAllUnread()——所有未讀。

範圍框得越小,要走的 entry 越少。別動不動 createViewNav() 全表再自己過濾。

三個效能旋鈕

這是這篇的重點——預設設定對大 view 並不友善,三個地方要自己動手:

1. IsAutoUpdate 設成 false。 官方直說自動更新會「degrade performance and may invalidate entries in the navigator」。也就是:你一邊走訪、別人一邊改這個 view,預設的自動更新不只拖慢你,還可能讓你手上的 entry 失效。走訪前先關掉,需要最新資料時自己呼叫 refresh。這跟 Java 讀 View 那篇 關 setAutoUpdate(false) 是同一個道理。

2. 遠端操作設 CacheSize。 官方寫「ViewNavigator caches entries」,而且「You can set the cache size and should set it to try to minimize server access.」。當你的 Java 是透過遠端(IIOP)連 server,navigator 會快取 entry;把 CacheSize 設大一點,一次抓多列、減少來回的網路往返。本機 agent 跑在 server 上時這點影響小,遠端 client 時影響很大。

3. 只走訪就用 goto,別用 get。 這個很多人不知道:官方明寫「a goto method does not create a ViewEntry object」。getNext() 會幫你建一個 ViewEntry 物件(有成本、之後還要 recycle);但如果你只是要移動指標、算數量、找到某個位置,用 gotoNext() / gotoFirst() 就好,它只移動指標、不建物件。需要讀欄值時才用 get。

讀欄值與三種 entry

走訪拿到的 ViewEntry,它的 ColumnValues 官方定義是「The value of each column in the view entry.」——就是這一列在 view 裡每一欄的值,來自索引,讀它不必把背後的 Document 開出來。這正是 ViewNavigator 省事的地方:要顯示的資料如果 view 欄位裡都有,整趟走訪一份文件都不用開。

但有個要判斷的地方:view 裡的列不是只有文件。官方說 entry 有三種——document、category、total。走分類式 view 時,你會走到 category 列和 total 列;用 isDocument() / isCategory() 判斷,別把分類列當文件去抓它的 UNID。

每個 entry 都要 recycle

ViewNavigator 最容易爆記憶體的地方,正是你用 get 取出的那些 ViewEntry。走一個大 view,如果每個 getNext() 建出來的 entry 都不 recycle,C 層的 handle 會一路累積到爆。標準做法是在迴圈裡 recycle 掉上一個 entry:

ViewNavigator nav = view.createViewNav();
nav.setCacheSize(400);
view.setAutoUpdate(false);
ViewEntry entry = nav.getFirst();
while (entry != null) {
if (entry.isDocument()) {
java.util.Vector<?> cols = entry.getColumnValues(); // 索引層欄值,不開文件
// …用 cols…
}
ViewEntry next = nav.getNext(entry); // 先拿下一個
entry.recycle(); // 再回收這一個
entry = next;
}
nav.recycle();

完整的 recycle 紀律(為什麼要先拿 next 再 recycle current)見 改寫成 Java 後記憶體爆掉。

同類別在其他語言

同一個 ViewNavigator:

  • LotusScript:NotesViewNavigator,CreateViewNav 家族、GetFirst / GetNext、CacheSize、AutoUpdate 都在,行為一致但不用 recycle;完整用法見 NotesViewNavigator 那篇。
  • SSJS / XPages:NotesViewNavigator,同樣的建立與走訪;在 XPages 裡常拿來自己控制階層式資料的展開,生命週期由 request 管。
  • Java 專屬的不是 API(方法共用),而是:goto 不建 ViewEntry 物件這個效能差別,在強型別、要手動 recycle 的 Java 裡最有感——走大 view 時,該用 goto 卻用了 get,等於白白建了一堆要回收的物件。

參考來源

← 回到文章列表