nami

NAMI：專為微信小程式服務端開發而生

面向前端開發人員的後端邏輯容器.

什麼是NAMI

微信小程式的前端框架，官方命名為MINA；那我們的非官方後端就呼應一下，姑且命名為NAMI（奈米）。
NAMI提供了一個小程式服務端所需所有服務的支持，包括但不僅限於處理request請求、接收和處理websocket、與微信服務端互動並維護access_token、處理微信服務端登入鑑權、發送範本訊息、接收微信支付事件，等等。

對於小應用：你只需要找一台電腦（無論windows、mac還是linux），一台雲端虛擬機，甚至一個docker實例，就可以安裝NAMI；NAMI提供了一整套完整的小程式後端解決方案，替你包辦有關小程式後端開發的所有問題。

對於大應用：可能小程式只是你整個IT架構的其中一部分；可能你還需要考慮負載平衡，考慮多執行個體部署，考慮快取；NAMI可以作為純粹的JAVA開源框架，簡化你的JAVA開發，幫你更有效率解決與小程式有關的問題。

更多精美介紹（感謝公司前端小夥伴做的頁面）：http://riversoft.com.cn/nami.html

NAMI受眾

前端開發工程師

不需了解JAVA、PHP或其他後端語言；
不需要安裝TOMCAT，不需要LAMP；
用你最熟悉的javascript語言寫後端邏輯，用命令式的語句直接操作資料庫，呼叫微信後台服務（你試過用javascript發送模板訊息嗎？ ）

專注於業務實現，而不想糾結於技術的小程式後端開發者

也許你是有經驗的JAVA或PHP程式設計師，但leader給你開發小程式的時間不多了；
面對鑑權登入、付款、範本訊息、用unionid打通服務號，看著微信官方文件的access token心跳維持、加密解密，你頭都大了；
或許你比較擅長需求建模、業務邏輯開發，但不想糾結於技術細節；
NAMI採用腳本式開發，只要會寫if（判斷）會寫for-each（循環） ，你的問題都可以快速且有效率地解決。

JAVA程式設計師

NAMI採用純粹的JAVA語言開發，擁有清晰的封裝和外部API；
NAMI內建動態腳本引擎，對微信官方服務端API進行全封裝；
NAMI也可以成為你JAVA計畫的其中一個開源獨立JAR包，幫助你更有效率快速解決問題。

NAMI特性

• 可直接運行於任意主流IAAS或PAAS或docker容器,如阿里雲、網易蜂巢
• 內建JDK,內建tomcat,支援跨平台(windows/linux/macOS)
• 內建https解決方案，快速申請免費證書並自動維持永久生效
• javaEE技術架構，成熟的橫向擴展方案，支援高並發、高可用系統需求，能支援大型/超大型系統
• 傻瓜化腳本開發模式,只關注業務邏輯,不糾結技術實現
• 支援javascript,groovy,java語言開發業務邏輯,總有一款合你意
• 微信API封裝,訊息、支付、鑑權簡單實現

NAMI關鍵模組

• 簡潔的request門面
• 配置化websocket
• 內建腳本邏輯引擎(可選語言：groovy/javascript/el)
• 全量微信API封裝
• 解壓縮即可運作的容器式封裝
• 小程式檔案上傳下載體系封裝
• 內建的https解決方案封裝

一個例子

1. 前端發起一個request 前端原始碼：

    //==================NAMI HELLO WORLD begin =================
    //第一个NAMI小程序调用
    wx . request ( {
      url : 'http://localhost:8080/request/hello.js' ,
      data : {
        a : 'hello' ,
        b : 2
      } ,
      complete : function ( res ) {
        console . log ( "调用完成" ) ;
        console . log ( res . data ) ;
      }
    } )
    //==================NAMI HELLO WORLD end =================

2. 啟動NAMI後,在request目錄中增加腳本後端原始碼：

 ( function ( ) {
	var a = request . getString ( "a" ) || 'none' ;
	var b = request . getInteger ( "b" ) || 0 ;

	return {
		a : a ,
		b : b
	}

} ) ( ) ;

3. 前端回呼結果

開發規範

事務管理

NAMI採用函數式開發，無論function抑或request，一個檔案代表一個函數（或請求）。 NAMI約定：

• 檔案名稱以execute_，create_，update_，delete_開頭的邏輯，會限定在一個交易中執行，交易支援巢狀。
• 檔案名稱以get_，find_，query_開頭的邏輯，以唯讀方式執行，也就是說在這種邏輯中執行的寫入操作，最終都會被NAMI回滾。
• 採用其他名稱開頭的，則認為每次執行db函數的exec，save等操作時交易都會自動提交。

資源

下載

下載運行版（百度雲端碟盤）: http://pan.baidu.com/s/1bJmUtg

文件

線上文件：https://hyhcoder.gitbooks.io/namiapi/content/

系列文章

• NAMI來了！第一個NAMI小程式Hello World！ (含影片)
• NAMI來了！五分鐘讓微信小程式接上資料庫（含影片）
• NAMI讚賞案例分析：引子（一）
• NAMI欣賞案例分析：代碼實戰（二）

如何打包

用maven構建，根目錄執行：

 mvn clean install

打包結果在/package/target/nami-pack-<platform>.zip, platform = nojdk|win32|win64|linux32|linux64

關於我們

• woden（http://github.com/wodenwang） BPMT微信快速開發平台核心開發，微信公眾號:全端生薑頭。

• borball（http://github.com/borball） 開源專案微信JavaSDK(https://github.com/borball/weixin-sdk)發起人。