簡(jiǎn)介這份文檔面向使用鼎捷T100 ERP系統(tǒng)的開發(fā)與實(shí)施人員聚焦于在T100環(huán)境中導(dǎo)入外部jar包并調(diào)用其中方法這一常見需求。內(nèi)容圍繞Java與4GL混合開發(fā)場(chǎng)景展開適合具備一定T100二次開發(fā)基礎(chǔ)、需要擴(kuò)展系統(tǒng)功能的工程師參考。資源包內(nèi)僅含1個(gè)docx文檔大小約500KB以圖文步驟形式記錄關(guān)鍵操作要點(diǎn)便于對(duì)照實(shí)踐。文檔涉及通過XFTP上傳jar包、調(diào)整CLASSPATH參數(shù)、重新連接ERP系統(tǒng)后import引入、實(shí)例化對(duì)象并調(diào)用方法等環(huán)節(jié)并特別記錄了create方式報(bào)錯(cuò)后改用jar包內(nèi)靜態(tài)getInstance方法返回實(shí)例的替代思路同時(shí)附有jar包內(nèi)容說明與執(zhí)行結(jié)果驗(yàn)證。目前已有1223人學(xué)習(xí)可為遇到同類調(diào)用問題的開發(fā)者提供排錯(cuò)方向與實(shí)現(xiàn)參考。1. T100 引入 jar 包這件事版本和路徑先對(duì)齊再動(dòng)手第一次在 T100 里掛 jar 包我踩的坑不是代碼寫錯(cuò)而是路徑和 CLASSPATH 沒對(duì)齊。T100 是鼎捷 tiptop 體系里跑 4GL 的那一層底層還是 JAVA 在扛所以想在 4GL 里調(diào)一個(gè)現(xiàn)成的 jar 方法本質(zhì)上就是讓 T100 的 JAVA 運(yùn)行時(shí)能“看見”這個(gè)包。聽起來簡(jiǎn)單但 T100 的環(huán)境不像普通 Tomcat 項(xiàng)目你把 jar 往 lib 里一丟就完事——它有自己的 CLASSPATH 參數(shù)、有自己的服務(wù)重連機(jī)制還有 4GL 那邊 import 的寫法約束。裝不好會(huì)怎樣輕則 import 報(bào)找不到類重則整個(gè) ERP 連接起不來業(yè)務(wù)那邊直接炸鍋。這篇適合兩類人一類是剛接手 T100 二次開發(fā)、第一次往里面塞 jar 的開發(fā)者另一類是老手但換了個(gè) T100 版本發(fā)現(xiàn)以前那套路徑不靈了想找一份能照著走的落地記錄。下面按“放包 → 改 CLASSPATH → 重連 → import → 調(diào)用 → 驗(yàn)證”的順序拆開講中間會(huì)重點(diǎn)說那個(gè) create 出錯(cuò)的玄學(xué)問題以及我最后怎么繞過去的。2. 放包與改 CLASSPATHT100 識(shí)別 jar 的兩步硬操作2.1 用 XFTP 把 jar 傳到 T100 的指定路徑T100 跑在 Linux 環(huán)境里傳文件最順手的就是 XFTP。我一般會(huì)先確認(rèn)目標(biāo)路徑常見做法是放在 T100 的lib或者classes同級(jí)目錄下具體看你們那套 tiptop 的部署結(jié)構(gòu)。別隨便丟/tmp因?yàn)榉?wù)重連后不一定掃得到。操作步驟打開 XFTP連上 T100 所在的那臺(tái)服務(wù)器。左側(cè)本地找到你編譯好的 jar右側(cè)切到 T100 的 JAVA 擴(kuò)展目錄比如/u1/tiptop/lib這種層級(jí)以你們實(shí)際部署為準(zhǔn)。直接拖過去或者用上傳按鈕。傳完在 XFTP 里看一眼文件大小對(duì)不對(duì)別傳了個(gè) 0 字節(jié)的上去。# 傳完后登錄服務(wù)器確認(rèn)文件在位順便看權(quán)限 ls -l /u1/tiptop/lib/your-tool.jar # 常見做法是把屬主和權(quán)限對(duì)齊同目錄其他 jar chown tiptop:tiptop /u1/tiptop/lib/your-tool.jar chmod 644 /u1/tiptop/lib/your-tool.jar邏輯說明ls -l是確認(rèn)文件真的落地了不是 XFTP 顯示成功就完事。chown和chmod這兩步很多人會(huì)漏結(jié)果服務(wù)重連后讀不到報(bào)的卻是“類找不到”方向直接跑偏。參數(shù)上屬主一般跟同目錄其他 jar 保持一致權(quán)限 644 足夠別給 777沒必要也不安全。提示傳之前先確認(rèn) jar 是用哪個(gè) JDK 版本編譯的。T100 那邊如果是 JDK 1.8你拿 JDK 17 編出來的包放進(jìn)去也是白放重連直接給你顏色看。2.2 修改 CLASSPATH 參數(shù)讓 T100 的 JAVA 認(rèn)得這個(gè)包包放進(jìn)去了但 T100 的 JAVA 運(yùn)行時(shí)不一定知道去那兒找。這時(shí)候要改 CLASSPATH。T100 里這個(gè)參數(shù)通常在啟動(dòng)腳本或者環(huán)境配置文件里常見做法是找setenv或者tiptop相關(guān)的 profile 文件。你要做的是把剛才那個(gè) jar 的完整路徑追加進(jìn)去。# 先找到當(dāng)前 CLASSPATH 是在哪個(gè)文件里定義的 grep -r CLASSPATH /u1/tiptop/ --include*.sh --include*.profile 2/dev/null # 假設(shè)定位到 /u1/tiptop/bin/setenv.sh編輯它 vi /u1/tiptop/bin/setenv.sh # 在 CLASSPATH 那一行末尾追加 jar 路徑注意用冒號(hào)分隔 # 改前export CLASSPATH$CLASSPATH:/u1/tiptop/lib/existing.jar # 改后export CLASSPATH$CLASSPATH:/u1/tiptop/lib/existing.jar:/u1/tiptop/lib/your-tool.jar邏輯說明grep -r是為了不靠記憶瞎找T100 不同版本放 CLASSPATH 的位置不一樣有的在setenv有的在profile搜一遍最穩(wěn)。追加的時(shí)候注意是冒號(hào)分隔Linux 下 CLASSPATH 用:Windows 才用;這個(gè)搞反了就是經(jīng)典翻車現(xiàn)場(chǎng)。改完保存別急著重啟整個(gè) ERP先往下走重連步驟。參數(shù)說明$CLASSPATH是保留原有配置別直接覆蓋覆蓋了原有 jar 全失效那就不只是你的包調(diào)不到整個(gè) T100 都可能出問題。追加的路徑必須是絕對(duì)路徑相對(duì)路徑在服務(wù)啟動(dòng)時(shí)的工作目錄下大概率找不到。注意改配置文件前先備份一份cp setenv.sh setenv.sh.bak改壞了還能滾回來。這是血淚經(jīng)驗(yàn)別問我是怎么知道的。3. 重連 ERP 與 import讓 4GL 那邊能認(rèn)出你的類3.1 重新連接 ERP 系統(tǒng)觸發(fā) CLASSPATH 重新加載CLASSPATH 改完T100 不會(huì)自動(dòng)感知你得讓它重新連一次。常見做法是重啟 T100 的 JAVA 服務(wù)或者通過 ERP 的管理界面做一次重連。具體命令看你們部署方式有的用tiptop restart有的直接kill掉進(jìn)程再拉起來。# 先看 T100 相關(guān)進(jìn)程 ps -ef | grep tiptop | grep -v grep # 常見做法是走服務(wù)腳本重啟別直接 kill -9 /u1/tiptop/bin/tiptop restart # 重啟后確認(rèn)進(jìn)程起來了 ps -ef | grep tiptop | grep -v grep邏輯說明ps -ef先確認(rèn)進(jìn)程名別對(duì)著一個(gè)不存在的服務(wù)瞎重啟。用服務(wù)腳本 restart 比 kill -9 溫和kill -9 有時(shí)候會(huì)留下鎖文件或者半截狀態(tài)下次啟動(dòng)反而起不來。重啟完再ps一遍確認(rèn)進(jìn)程真的在不是腳本執(zhí)行完就完事了。重連之后T100 的 JAVA 運(yùn)行時(shí)才會(huì)重新讀 CLASSPATH這時(shí)候你的 jar 才算真正被“掛”上去。如果這步跳過后面 import 報(bào)找不到類你會(huì)以為是 jar 沒傳對(duì)其實(shí)是 CLASSPATH 沒生效。3.2 在 4GL 里 import jar 包并實(shí)例化對(duì)象環(huán)境層面搞定后進(jìn)到 4GL 代碼里。T100 的 4GL 調(diào) JAVA 類寫法上跟標(biāo)準(zhǔn) JAVA 不太一樣但 import 的邏輯是一致的先聲明你要用哪個(gè)包再實(shí)例化再調(diào)方法。// 4GL 里 import 的寫法包名跟你 jar 里的 package 一致 import com.yourcompany.tool.YourClass; // 然后實(shí)例化 DEFINE obj YourClass LET obj YourClass.create()邏輯說明import那行必須跟 jar 里實(shí)際的 package 路徑完全對(duì)上大小寫敏感。DEFINE是 4GL 里聲明變量YourClass就是你 jar 里的類名。create()是 T100 4GL 里常見的實(shí)例化方式但這里就是那個(gè)玄學(xué)坑——我這邊create會(huì)出錯(cuò)報(bào)的錯(cuò)還特別模糊不是“找不到方法”就是“實(shí)例化失敗”查半天查不出所以然。3.3 create 出錯(cuò)后的繞行方案static getInstancecreate走不通我最后是在 jar 包里加了一個(gè) static 的getInstance方法返回一個(gè)實(shí)例化好的對(duì)象。這個(gè)做法相當(dāng)于把實(shí)例化的活兒從 4GL 那邊挪到 JAVA 那邊4GL 只負(fù)責(zé)拿現(xiàn)成的。// jar 包里的 JAVA 代碼加一個(gè)靜態(tài)工廠方法 public class YourClass { private static YourClass instance; public static YourClass getInstance() { if (instance null) { instance new YourClass(); } return instance; } // 你原本要調(diào)用的業(yè)務(wù)方法 public String yourMethod(String input) { return processed: input; } }邏輯說明getInstance是 static 的4GL 那邊不需要先實(shí)例化就能直接調(diào)。instance用懶加載第一次調(diào)用時(shí)才 new后面復(fù)用同一個(gè)對(duì)象。這樣 4GL 里就變成// 4GL 里改成這樣調(diào) DEFINE obj YourClass LET obj YourClass.getInstance() DISPLAY obj.yourMethod(test)參數(shù)說明getInstance返回的是YourClass類型4GL 那邊DEFINE的類型要對(duì)上。yourMethod是你實(shí)際要用的業(yè)務(wù)方法參數(shù)和返回值按你 jar 原本的設(shè)計(jì)來。這個(gè)繞行方案的好處是避開了 4GLcreate那個(gè)不確定的行為壞處是如果你的類需要帶參構(gòu)造得在getInstance里把參數(shù)處理好或者再加一個(gè)帶參的靜態(tài)方法。提示改完 jar 記得重新編譯重新用 XFTP 傳上去再走一遍重連。別改了本地沒傳然后對(duì)著舊包調(diào)半天。4. 避坑與排查T100 掛 jar 最常見的五個(gè)翻車點(diǎn)4.1 現(xiàn)象import 報(bào)找不到類但 jar 明明在原因CLASSPATH 沒生效或者 jar 路徑寫錯(cuò)了。T100 重連后才會(huì)重新讀 CLASSPATH改完不重連等于沒改。另一個(gè)可能是 jar 傳上去了但權(quán)限不對(duì)JAVA 進(jìn)程讀不到。解決先ps -ef確認(rèn)服務(wù)真的重啟了再ls -l看 jar 權(quán)限最后grep CLASSPATH確認(rèn)路徑拼寫。三步走完基本能定位。4.2 現(xiàn)象create 實(shí)例化報(bào)錯(cuò)錯(cuò)誤信息模糊原因T100 4GL 的create對(duì)某些類構(gòu)造方式支持不好尤其是帶參構(gòu)造或者依賴注入的類。這個(gè)坑我查了很久最后放棄create走 static 工廠。解決在 jar 里加getInstance靜態(tài)方法4GL 那邊改成YourClass.getInstance()。如果類必須帶參就再加一個(gè)getInstanceWithParams(String p1)這種靜態(tài)方法。4.3 現(xiàn)象重連后 T100 起不來業(yè)務(wù)全斷原因CLASSPATH 改錯(cuò)了比如覆蓋了原有配置或者路徑里多了空格、少了冒號(hào)。JAVA 啟動(dòng)時(shí)解析 CLASSPATH 失敗整個(gè)服務(wù)拉不起來。解決立刻用備份的setenv.sh.bak還原重啟服務(wù)。改 CLASSPATH 時(shí)養(yǎng)成習(xí)慣先echo $CLASSPATH看當(dāng)前值改完再echo一遍確認(rèn)拼接正確。4.4 現(xiàn)象jar 傳上去了但 4GL 里 import 的包名對(duì)不上原因jar 里的 package 路徑和 4GL 里 import 的寫法不一致。比如 jar 里是com.company.tool4GL 里寫成com.company.Tool大小寫一差就找不到。解決用jar tf your-tool.jar看一眼包結(jié)構(gòu)確認(rèn) package 全小寫還是駝峰4GL 里嚴(yán)格照抄。# 查看 jar 內(nèi)部結(jié)構(gòu)確認(rèn)包名和類名 jar tf /u1/tiptop/lib/your-tool.jar | head -204.5 現(xiàn)象調(diào)用方法時(shí)參數(shù)類型不匹配運(yùn)行時(shí)報(bào)錯(cuò)原因4GL 和 JAVA 的類型系統(tǒng)不一樣比如 JAVA 那邊要int4GL 傳了個(gè)字符串或者 JAVA 返回List4GL 那邊不知道怎么接。解決在 jar 那層做一層適配把復(fù)雜類型轉(zhuǎn)成 String 或者基本類型再返回。4GL 調(diào) JAVA 盡量走簡(jiǎn)單類型別直接傳集合或者自定義對(duì)象容易出玄學(xué)問題。5. 裝完怎么驗(yàn)證從 import 到執(zhí)行結(jié)果走一遍閉環(huán)驗(yàn)證這件事我一般不走“看起來沒問題”這種主觀判斷而是走一個(gè)最小閉環(huán)傳包 → 改 CLASSPATH → 重連 → import → 調(diào)方法 → 看輸出。每一步都有可觀察的結(jié)果哪一步斷了立刻能定位。先確認(rèn) jar 在位且權(quán)限正確ls -l /u1/tiptop/lib/your-tool.jar # 期望輸出類似-rw-r--r-- 1 tiptop tiptop 12345 Jan 1 10:00 your-tool.jar再看 CLASSPATH 里有沒有你的包# 在 T100 的環(huán)境里執(zhí)行或者 source 一下 setenv 再 echo source /u1/tiptop/bin/setenv.sh echo $CLASSPATH | tr : \n | grep your-tool # 期望輸出/u1/tiptop/lib/your-tool.jar然后進(jìn) 4GL 寫一段最小調(diào)用代碼別一上來就調(diào)業(yè)務(wù)方法先調(diào)一個(gè)返回固定字符串的方法確認(rèn)鏈路通了// 4GL 最小驗(yàn)證代碼 import com.yourcompany.tool.YourClass; DEFINE obj YourClass DEFINE result STRING LET obj YourClass.getInstance() LET result obj.yourMethod(hello) DISPLAY result期望輸出是processed: hello這種你能預(yù)期的結(jié)果。如果DISPLAY出來了說明從 jar 加載到方法調(diào)用整條鏈路是通的。如果報(bào)錯(cuò)按第 4 章的排查順序倒著查先看 import 有沒有報(bào)錯(cuò)再看getInstance能不能拿到對(duì)象最后看方法調(diào)用。我還會(huì)額外做一步把 T100 服務(wù)重啟一次再跑一遍上面的驗(yàn)證。因?yàn)橛行┉h(huán)境是“當(dāng)前會(huì)話能調(diào)重啟后就失效”根因還是 CLASSPATH 沒寫進(jìn)持久化配置只是臨時(shí) export 了一下。重啟后還能跑通才算真的裝好了。下面這張表是我自己排查時(shí)用的對(duì)照貼在工位上省得每次重新想驗(yàn)證步驟命令/操作期望結(jié)果失敗時(shí)先看jar 在位ls -l目標(biāo)路徑文件存在權(quán)限 644XFTP 是否傳完CLASSPATH 包含echo $CLASSPATH路徑在列表里setenv 是否保存服務(wù)重連ps -ef進(jìn)程存在重啟腳本是否報(bào)錯(cuò)import 通過4GL 編譯無報(bào)錯(cuò)包名大小寫實(shí)例化通過getInstance()返回對(duì)象非空靜態(tài)方法是否編譯進(jìn) jar方法調(diào)用DISPLAY輸出預(yù)期字符串參數(shù)類型是否匹配從那以后我每次往 T100 里掛新 jar都強(qiáng)制走一遍這個(gè)閉環(huán)不跳步。跳一步當(dāng)時(shí)省兩分鐘后面排查花兩小時(shí)不劃算。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取