Rails、OpenLaszlo 與 Eclipse 打造富網際網路應用 (RIA) 完整開發指南

Ruby on Rails 以「約定優於配置」與極速開發聞名，OpenLaszlo (LZX) 則提供開源的富網際網路應用呈現層，兩者結合可構建「後端 Rails REST API + 前端 Laszlo Flash/DHTML 客戶端」的現代化架構。本教學完整記錄從環境建置 (MySQL、OpenLaszlo Server、Ruby、Rails、Eclipse WTP、RDT、IDEforLaszlo) 到專案建立、資料庫設計、Scaffold 自動生成、REST 控制器、Laszlo Applet 編譯部署的全流程，並展示 Eclipse 外部工具自動化指令碼技巧。

一、系統需求與版本鎖定 (關鍵)

記憶體建議：≥ 512 MB RAM

二、Eclipse 環境自動化配置：External Tools 指令碼化

將 Rails 常用指令封裝為 Eclipse External Tools，避免切換命令列，專注開發：

2.1 核心指令對照表

所有工具勾選 Refresh resources upon completion 並加入 Favorites 選單，單擊即執行。

三、專案實戰：電影清單應用

3.1 建立資料庫與資料表

mysql> CREATE DATABASE movies;
mysql> GRANT ALL ON movies.* TO 'youruser'@'localhost';
mysql> USE movies;
mysql> CREATE TABLE Movies (
    id MEDIUMINT NOT NULL AUTO_INCREMENT,
    movie_name CHAR(30) NOT NULL,
    movie_genre CHAR(30) NOT NULL,
    movie_description TEXT NOT NULL,
    movie_rating MEDIUMINT,
    PRIMARY KEY (id)
);

3.2 Rails 專案建立與配置

1. Eclipse 新建 Ruby 專案 movies
2. 執行 Create Rails Project 外部工具
3. 編輯 config/database.yml：三環境 (development/test/production) 皆指向 movies 資料庫，填入帳號密碼與 socket 路徑
4. 執行 Setup OpenLaszlo Plugin 安裝生成器
5. 執行 Generate REST Controllers 產生 Model 與 Controller

3.3 自動生成的核心程式碼

Model: app/models/movie.rb

class Movie < ActiveRecord::Base
end

兩行程式碼即完成 ORM 映射：Rails 依慣例將單數 Movie 映射至複數 movies 資料表，自動提供 CRUD 方法。

Controller: app/controllers/movie_controller.rb

class MovieController < ApplicationController
  rest_scaffold :movie
end

rest_scaffold 宏 (由 OpenLaszlo Plugin 提供) 自動展開為完整的 REST XML API：

• records/index：列表查詢 (支援分頁 Range)
• page/pages：分頁查詢
• schema：回傳欄位定義 XML (供 Laszlo 客戶端動態建構表單)
• create/update/delete：寫入操作，回傳 XML 結果

啟動 Start WEBrick，瀏覽 https://localhost:3000/movie 即可看到 XML 輸出。

3.4 明式 Scaffold 程式碼展開 (參考)

執行 script/generate rest_scaffold movie 可產生明式方法版本 (清單 4)，包含 records、page、schema、create、update、delete 完整實作，方便客製化。

3.5 Laszlo 客戶端生成與部署

1. 執行 Create Laszlo Applets，輸入 Applet 名稱 movie
2. 產生檔案於 app/applets/applet/：applet.lzx、datamanager.lzx、modelcontroller.lzx、modelgrid.lzx
3. Eclipse 新建 Laszlo 專案 MovieClient，工作區指向 C:\OpenLaszloServer3.2\server\lps-3.2\my-apps
4. 將 applets 資料夾複製至 Laszlo 專案 \src
5. 瀏覽 https://127.0.0.1:8080/lps-3.2/my-apps/movieclient/bin/applets/applet/ 點擊 applet.swf

3.6 執行畫面功能

• 資料網格顯示電影清單
• 雙擊儲存格直接編輯，離焦自動送出 update 請求，資料庫即時更新
• 捲動至底部新增列，填寫後自動送出 create 請求
• 支援刪除、排序、分頁

四、架構圖解與資料流

[瀏覽器] ←SWF→ [OpenLaszlo Server:8080] ←HTTP/XML→ [Rails WEBrick:3000] ←SQL→ [MySQL]
     ↑                                                                      |
     |---- Laszlo Applet (LZX 編譯為 SWF)                                   |
     |---- REST XML API (schema/records/create/update/delete)               |
     |---- ActiveRecord ORM (Movie 模型)                                    |

五、關鍵技術亮點總結

六、遷移至現代技術棧的對照建議

七、結語

本教學展示了 2006 年前後「Rails + OpenLaszlo + Eclipse」構建 RIA 的完整工程實踐：從零建置環境、自動化指令碼、零配置 Scaffold、REST XML 契約、宣告式 UI 編譯部署。雖然具體技術棧已歷史性退場，但其核心思想——後端專注領域邏輯與 REST 契約、前端專注呈現與互動、工具鏈自動化樣板代碼、約定減少決策疲勞——在現代全端開發 (Rails API + React/Vue、Next.js、Remix 等) 中依然熠熠生輝。理解這段技術演進史，有助於把握全端架構設計的不變本質。

1. 上一篇文章： Flash Remoting 整合 Java Servlet：JRun 4 環境下的遠端服務呼叫實戰
2. 下一篇文章： RadRails 與 Eclipse：輕鬆打造 Ruby on Rails 開發環境

Java 相關知識

Spring Boot 整合 MyBatis 完整教程：兩種方式詳解與最佳實踐

前言 Spring Boot 以「約定優於配置」簡化 Spr

從 JAR 到 EXE：Java 桌面應用打包與發佈完整指南

前言 開發完 Java 桌面應用後，如何將其打包成用戶可直接

Eclipse 插件依賴解析神器：Dependency Walker 自動發現未解析依賴

問題背景 Manifest 中聲明依賴，但插件未加載。PDE

Struts 從零開始 (五)：資料驗證完整指南 (手動驗證與 Validator 框架)

一、ActionForm 手動表單驗證 validate(