- Java 讀 MIME:不先 setConvertMIME(false),你讀到的就不是 MIME
現代 Domino 的郵件 Body 多半是 MIME(多段式、帶 headers),不是傳統的 composite rich text。你在 Java 用 getFirstItem("Body") 去讀,Domino 預設會把 MIME 自動轉成 rich text 再給你——結果你拿到的是轉換後的東西,原本的 MIME 結構、headers、編碼都在轉換裡被攤平了。要拿到真正的 MIME,得先呼叫 session.setConvertMIME(false) 關掉這個自動轉換,再 getMIMEEntity。這篇講讀 MIME 的正確順序、怎麼走訪 multipart 的每一段、怎麼讀 headers,以及一個很會咬人的失效規則:MIMEEntity 在你對 Document 做 save / computeWithForm / sign 之後就失效了。
2026.11.13 - XPages 的 Stream:用 getContents 產檔下載,charset 要自己給
在 XPages 你要讓使用者按一個按鈕、下載一份當場產生的報表檔,或是讀一個剛上傳的檔案來解析。後端 SSJS 的 NotesStream(session.createStream)就是做這件事的工具。它有一個在 XPages 特別好用的方法:getContents 可以把 stream 的內容直接倒進一個 java.io.OutputStream——也就是 HTTP response 的輸出串流,不用先在磁碟落一個暫存檔。這篇講在 XPages 怎麼用 Stream 產檔下載、怎麼讀 fileUpload 上傳的檔、writeText 預設不加行尾的小坑,以及 charset 預設是 System(不是 UTF-8)這個同樣會咬人的點——後者的深講留給 Java 那篇,這裡只給修法。
2026.11.12 - Java 的 Stream 讀寫檔案:預設 charset 不是 Unicode,是 System
在 Java 你要把一份文件的文字寫成檔案、或讀一個檔案進來。Domino 的 Stream(session.createStream)是跟 Domino 編碼體系整合的那條路,也是 MIMEEntity、附件底層在用的串流。但它有個會讓中文默默變亂碼的坑:新建的 Stream 回報 Charset 是 Unicode,可是 open(path) 沒帶 charset 參數時,預設卻是 System(伺服器的平台編碼)——不是 Unicode。這篇講怎麼拿到 Stream、open 的 charset 陷阱、writeText 預設不加行尾(EOL_NONE)的小坑、binary 模式與 getContents/setContents 怎麼接 java.io,以及 thread 限定和 recycle 兩個邊界。
2026.11.11 - Java 讀附件:用 getInputStream 不落地,還有兩個會咬你的坑
在 Java 你要一份附件的 bytes——串給瀏覽器、算雜湊、推去物件儲存。直覺是先 extractFile 存成暫存檔、再讀那個檔;但 EmbeddedObject 在 Java 有 getInputStream,直接把附件內容當串流讀出來、一個暫存檔都不用。這篇講 Java 讀附件的串流做法,以及兩個官方文件白紙黑字、但很容易中的坑:extractFile 對「不是附件」的 embedded object / object link 會丟例外;而 Document.getEmbeddedObjects 根本不回傳 file attachment——附件要從 RichTextItem 拿。順帶一個平台現實:UNIX/Mac 的 Domino 只支援 file attachment,沒有 embedded object。
2026.11.10 - SSJS 的 DocumentCollection:stampAll 一次改全部,removeAll 一次刪全部
在 SSJS 從 search、FTSearch、或 view 依 key 查,拿到的是一個 NotesDocumentCollection。要對這一堆文件做事,第一反應是 getFirstDocument / getNextDocument 迴圈;但 collection 本身有批次操作:stampAll 一次把某個欄位改成同一值、removeAll 一次把整批永久刪掉,一行搞定、不用迴圈。威力很大,removeAll 尤其——它會精準地照你說的刪,而且是永久的。這篇講在 SSJS 怎麼拿到並走訪 collection(含 Count 是屬性不是 getCount 的小坑)、stampAll / removeAll 兩個批次招式與它們的風險、怎麼用 FTSearch 和 intersect/merge/subtract 組合 collection,以及這些操作用誰的權限跑。
2026.11.09 - Java 讀 rich text:先 cast,再小心 MIME 和被丟掉的附件
在 Java 要碰一個 Body 這種 rich text 欄位,getFirstItem 回給你的是一個 Item,你得先 cast 成 RichTextItem 才能用——而這一步藏了兩個意外:這份 body 現在很可能是 MIME、不是傳統 rich text(那要走 getMIMEEntity);還有,你用 getFormattedText 把內容讀成純文字時,它會「順手」把附件和圖片這些非文字內容丟掉。這篇講 Java 怎麼取到(cast 與 MIME)、怎麼把 rich text 讀成純文字(getFormattedText 的三個參數與它丟掉的東西)、以及怎麼用 createRichTextItem 建立一個。
2026.11.08 - Java 讀 view:別為了一欄去開整份文件
要列出 view 裡每一筆的幾個欄位做報表,直覺會一路 getNextDocument、每份文件 getItemValue——在 Java 這等於把成千上萬份 NotesDocument 從後端拉出來、再一一 recycle。但那些欄位的值,view 的每一列(ViewEntry)本來就帶著:getColumnValues() 一次讀整列、一份文件都不開。這篇講 Java 怎麼取到 view(getView 的 view/folder 與 name/alias 兩個坑)、為什麼讀欄位要用 ViewEntry 而不是 Document、怎麼用 getAllEntriesByKey 依 key 查,以及迭代前為什麼要 setAutoUpdate(false)。
2026.11.07 - XPages 的 database 是現成的,問題在「用誰的權限開」
LotusScript 和 Java 要寫幾行才拿得到一個 Database;XPages SSJS 裡 database 直接就在那,指向當前這個 NSF,你連 getDatabase 都不用呼叫。所以 SSJS 的 Database 難點不在「怎麼拿」,而在一個 LS/Java 很少逼你想的問題——這段 code 是用誰的權限在跑?使用者自己?還是 XPage 的簽署者?這篇講 database 全域、怎麼開別的庫(session.getDatabase / getCurrentDatabase),以及 session vs sessionAsSigner vs sessionAsSignerWithFullAccess 這組 XPages 權限模型——什麼時候非用簽署者權限不可。
2026.11.06 - Notes client 的 eMudhra 憑證:難的不是哪張,是幾千台
伺服器端把那幾張被波及的 eMudhra / emSign / Comodo root 清掉,是一台一台、admin 自己操作;到了 Notes client,同一批憑證散在你公司每一台桌機上——你沒辦法 SSH 進五千台工作站。這篇接續 Domino Server 那篇,專講 client 端:憑證藏在哪幾個不一樣的信任庫(local names.nsf 的 Advanced > Certificates、程式目錄下的 Java cacerts、每台的 cacert.pem、macOS keychain)、為什麼沒有內建方法一次清完、怎麼用 MarvelClient 或你的軟體佈署工具把更新推到每一台,以及一個官方公告沒寫、但你最好自己查的角落:EOL 的 9.x。
2026.11.05