iuap開發(fā)手冊(編輯修改稿)

　

【文章內(nèi)容簡介】 皮膚1theme2皮膚2venderjquery、bootstrap等各種前端框架的存放位置，包括jquery,bootstrap等uuiiWeb前端框架js客戶端公共JS文件ponentsp1（公共應(yīng)用組件）css組件樣式文件js私有第三方框架images圖像文件themes組件皮膚，自己內(nèi)部處理res國際化資源目錄pagespage1（應(yīng)用頁面）style樣式目錄res國際化資源目錄image圖片目錄js私有第三方框架WEBINFlibjar包存放目錄classes類編譯輸出路徑conf配置文件預(yù)留目錄，采用Spring的配置文件方案，建議放在WEBINF的classes目錄|temps臨時(shí)生成文件的放置位置templates模板系統(tǒng)首頁static公共靜態(tài)資源目錄util公共工具類目錄. Maven配置iUAP開發(fā)工具使用Maven作為軟件項(xiàng)目管理工具。使用Maven構(gòu)建工程、管理各服務(wù)間的jar包依賴。同時(shí)配置本地倉庫統(tǒng)一管理外部依賴包和內(nèi)部依賴包。配置maven需要以下幾個(gè)步驟：確認(rèn)私服地址。如果項(xiàng)目內(nèi)部需要建立自己的私服。則可以參考《maven工具應(yīng)用》文檔創(chuàng)建。如果使用用友網(wǎng)絡(luò)內(nèi)部私服，則直接使用默認(rèn)地址即可。確認(rèn)項(xiàng)目需要應(yīng)用的組件jar包、版本等；配置本地jar包私有倉庫位置。 Maven有兩個(gè)重要的配置文件。 、構(gòu)建等jar包關(guān)系。使用iUAP工具新建的項(xiàng)目，本身項(xiàng)目的配置信息已經(jīng)完備。不需要修改，僅需要添加本項(xiàng)目依賴的jar包。配置文件解析：包含基礎(chǔ)配置信息、依賴信息、構(gòu)建信息等及部分組成，如下分別介紹216。 基礎(chǔ)配置信息： groupId：項(xiàng)目或者組織的唯一標(biāo)志，并且配置時(shí)生成路徑也是由此生成，：/org/myproject/mojo artifactId：項(xiàng)目的通用名稱 version：項(xiàng)目的版本 packaging：打包機(jī)制，如pom,jar,mavenplugin,ejb,war,ear,rar,par。 name：用戶描述項(xiàng)目的名稱，可選 description：對項(xiàng)目的描述，可選。 properties是為pom定義一些常量，在pom中的其它地方可以直接引用。如：配置/，則使用時(shí)為${ }216。 依賴關(guān)系 groupId、artifactId、version：這三個(gè)組合標(biāo)示依賴的具體工程的配置，這個(gè)依賴工程必需是maven中心包管理范圍內(nèi)的； type：默認(rèn)為jar類型，常用的類型有：jar,ejbclient,testjar...,可設(shè)置plugins中的extensions值為true后在增加新的類型； exclusions：如果X需要A，A包含B依賴，那么X可以聲明不要B依賴，只要在exclusions中聲明exclusion. Exclusion：是將B從依賴樹中刪除，如下圖所示，需要去掉springwebmvc依賴，所以就需要排除掉。216。 構(gòu)建插件 groupId、artifactId、version：這三個(gè)組合標(biāo)示依賴的具體插件工程的配置； configuration依賴插件的配置；216。 常見依賴包：使用iweb前端框架，比如datatable以及eventcontroller等；配置依賴iuapiweb持久化使用iuapjdbc， 。這個(gè)文件會存在于Maven的安裝目錄的conf子目錄下面。我們可以通過這個(gè)文件來定義本地倉庫、遠(yuǎn)程倉庫和聯(lián)網(wǎng)使用的代理信息等。：在iUAPStudio中菜單欄，窗口—首選項(xiàng)，選擇Maven—User Settings找到配置文件的目錄。，依賴包的地址。n 本地jar包倉庫位置的配置：216。 localRepository：表示Maven用來在本地儲存信息的本地倉庫的目錄。n Maven依賴包的地址：，并找到對應(yīng)的下載地址并下載對應(yīng)版本的jar包。216。 profiles：用于指定一系列的profile。profile元素由activation、repositories、pluginRepositories和properties四個(gè)元素組成。n id:該配置的唯一標(biāo)識符。n activation：自動觸發(fā)配置文件的邏輯定義。Activation的邏輯配置決定了是否開啟該profile。n properties：用于定義屬性鍵值對的。當(dāng)該profile是激活狀態(tài)的時(shí)候。u ID:遠(yuǎn)程倉庫唯一標(biāo)識u Name:遠(yuǎn)程倉庫名稱u URL：遠(yuǎn)程倉庫URLu Releases/Snapshots：是否使用這個(gè)資源庫下載releases的構(gòu)件默認(rèn)值：true；n pluginRepositories：在Maven中有兩種類型的倉庫，一種是存儲工件的倉庫，另一種就是存儲plugin插件的倉庫。pluginRepositories的定義和repositories的定義類似，它表示Maven在哪些地方可以找到所需要的插件。216。 activeProfiles：指定被激活的配置文件。216。 proxies：其下面可以定義一系列的proxy子元素，表示Maven在進(jìn)行聯(lián)網(wǎng)時(shí)需要使用到的代理。當(dāng)設(shè)置了多個(gè)代理的時(shí)候第一個(gè)標(biāo)記active為true的代理將會被使用。216。 servers：其下面可以定義一系列的server子元素，表示當(dāng)需要連接到一個(gè)遠(yuǎn)程服務(wù)器的時(shí)候需要使用到的驗(yàn)證方式。這主要有username/password和privateKey/passphrase這兩種方式。216。 mirrors：用于定義一系列的遠(yuǎn)程倉庫的鏡像。我們可以在pom中定義一個(gè)下載工件的時(shí)候所使用的遠(yuǎn)程倉庫。但是有時(shí)候這個(gè)遠(yuǎn)程倉庫會比較忙，所以這個(gè)時(shí)候人們就想著給它創(chuàng)建鏡像以緩解遠(yuǎn)程倉庫的壓力，也就是說會把對遠(yuǎn)程倉庫的請求轉(zhuǎn)換到對其鏡像地址的請求。每個(gè)遠(yuǎn)程倉庫都會有一個(gè)id，這樣我們就可以創(chuàng)建自己的mirror來關(guān)聯(lián)到該倉庫，那么以后需要從遠(yuǎn)程倉庫下載工件的時(shí)候Maven就可以從我們定義好的mirror站點(diǎn)來下載，這可以很好的緩解我們遠(yuǎn)程倉庫的壓力。在我們定義的mirror中每個(gè)遠(yuǎn)程倉庫都只能有一個(gè)mirror與它關(guān)聯(lián)，也就是說你不能同時(shí)配置多個(gè)mirror的mirrorOf指向同一個(gè)repositoryId。216。 pluginGroups：在pluginGroups元素下面可以定義一系列的pluginGroup元素。表示當(dāng)通過plugin的前綴來解析plugin的時(shí)候到哪里尋找。pluginGroup元素指定的是plugin的groupId。默認(rèn)情況下。 maven構(gòu)建選擇菜單欄，文件mavenUpdate Project點(diǎn)擊后出現(xiàn)如下界面：如上圖中的選項(xiàng)。Offline：打勾則表示從本地jar包構(gòu)建、取消勾則表示在線更新jar包并構(gòu)建。剩余幾個(gè)選項(xiàng)皆為構(gòu)建選項(xiàng)，一般默認(rèn)勾選，按需選擇。構(gòu)建成功后，可以看到項(xiàng)目依賴的jar包。. 服務(wù)器啟動調(diào)試服務(wù)器啟動調(diào)試有兩種方式j(luò)etty/tomcat。Tomcat的配置方式請參考技術(shù)網(wǎng)站。下面描述jetty服務(wù)器配置，iUAP使用了maven build插件快速啟動命令。1. 在啟動前，首先需要啟動服務(wù)器依賴的中間件，比如數(shù)據(jù)庫服務(wù)、Redis緩存。方法如下：、雙擊啟動startPgsqlbatPostgresql啟動成功，出現(xiàn)如下界面：如果有redis啟動不成功，一閃而過的情況，請按如下方式排查：252。 如果是32位操作系統(tǒng)，請下載redis針對32位操作系統(tǒng)的jar包，或者聯(lián)系開發(fā)部索取。252。 使用管理員權(quán)限打開。注意：如果服務(wù)bat啟動后不可關(guān)閉頁面，否則服務(wù)關(guān)閉。如果用戶使用了其他的數(shù)據(jù)庫，也務(wù)必在啟動中間件前，將對應(yīng)服務(wù)啟動起來。2. 工具欄選擇調(diào)試調(diào)試配置頁面3. 選擇maven_build頁簽在Maven Build上點(diǎn)擊右鍵，選擇新增。出現(xiàn)如下配置頁面Base directory選擇項(xiàng)目路徑，此處選擇我們剛才新建的項(xiàng)目。Goals：輸入jetty啟動命令，jetty:run。4. 點(diǎn)擊調(diào)試，服務(wù)器開始啟動。控制臺出現(xiàn)成功提示，則說明啟動成功。5. 啟動成功后，訪問服務(wù)器地址6. ，選擇web項(xiàng)目需要加載的配置項(xiàng)。配置文件詳解在第四章描述。此時(shí)僅按照簡單樣式修改并登錄到O2O站點(diǎn)。：此時(shí)的項(xiàng)目登錄頁面，只是最簡單的進(jìn)行頁面訪問 。現(xiàn)在可以通過如下步驟，修改啟動時(shí)加載的登錄頁面。此時(shí)需要的是需要配置Shiro，攔截頁面，跳轉(zhuǎn)到登陸頁面。本章節(jié)在登錄與認(rèn)證章節(jié)會有詳細(xì)描述。216。 ，配置文件設(shè)置，登錄，SpringMVC配置等全部放開。即把! 注解部分去掉，如下圖所示標(biāo)紅處刪除：最后修改完成的如下圖所示：216。 登錄的無狀態(tài)校驗(yàn)需要驗(yàn)證cookie數(shù)據(jù)，所以需要將cookie的域修改為當(dāng)前項(xiàng)目，如下圖配置文件 ： 216。 同時(shí)修改Indoxcontroller的返回值。216。 此時(shí)再訪問頁面，發(fā)現(xiàn)訪問首頁時(shí)，首先通過shiro的filter，跳轉(zhuǎn)到登陸頁面。此時(shí)，使用user/user登錄頁面，就可以看到新建項(xiàng)目中示例的登錄頁面、主頁面了。2. 前端工程搭建. NodeJS安裝首先去NodeJS官網(wǎng)下載NodeJS并安裝。官網(wǎng)地址：，下載V4版本。簡單的說 就是運(yùn)行在服務(wù)端的 JavaScript。 是一個(gè)基于Chrome JavaScript 運(yùn)行時(shí)建立的一個(gè)平臺。，基于Google的V8引擎，V8引擎執(zhí)行JavaScript的速度非常快，性能非常好。. npm安裝npm的全稱是Node Package Manager，是一個(gè)NodeJS包管理和分發(fā)工具，已經(jīng)成為了非官方的發(fā)布Node模塊（包）的標(biāo)準(zhǔn)。下載完成后直接運(yùn)行程序，npm會隨著安裝包一起安裝，稍后會用到它。為了確保Node已經(jīng)正確安裝，我們執(zhí)行幾個(gè)簡單的命令。node v回車（Enter），如果正確安裝的話，會看到所安裝的Node的版本號，接下來看看npm。npm v這同樣能得到npm的版本號。如果這兩行命令沒有得到返回，可能node就沒有安裝正確，嘗試重啟下命令行工具，如果還不行的話，只能回到第一步進(jìn)行重裝。在項(xiàng)目目錄中shift+右擊，選擇在此處打開命令窗口，在命令行中輸入npm install. 項(xiàng)目啟動啟動項(xiàng)目，在命令行中執(zhí)行命令：node 在瀏覽器中輸入地址：://localhost:8080/. 項(xiàng)目目錄代碼結(jié)構(gòu)：一級目錄二級目錄三級目錄含義style樣式文件目錄全局公共樣式文件default默認(rèn)皮膚樣式cssimagestheme1 皮膚1theme2皮膚2venderjquery、bootstrap等各種前端框架的存放位置，包括jquery,bootstrap等uuiiWeb前端框架js客戶端公共JS文件ponentsp1（公共應(yīng)用組件）css組件樣式文件js私有第三方框架images圖像文件themes組件皮膚，自己內(nèi)部處理res國際化資源目錄pagespage1（應(yīng)用頁面）style樣式目錄res國際化資源目錄image圖片目錄js私有第三方框架WEBINFlibjar包存放目錄classes類編譯輸出路徑conf配置文件預(yù)留目錄，采用Spring的配置文件方案，建議放在WEBINF的classes目錄|temps臨時(shí)生成文件的放置位置templates模板系統(tǒng)首頁static公共靜態(tài)資源目錄util公共工具類目錄3. 數(shù)據(jù)庫準(zhǔn)備在iUAPStudio中提供了示例產(chǎn)品，所以默認(rèn)安裝了postgresql數(shù)據(jù)庫，并且預(yù)置了ec數(shù)據(jù)庫，以及示例系統(tǒng)中的腳本。用戶在開發(fā)自己的產(chǎn)品時(shí)，可以依據(jù)自己企業(yè)應(yīng)用的實(shí)際情況，選擇不同的數(shù)據(jù)庫，安裝并生成數(shù)據(jù)庫實(shí)例。詳情可以參考不同數(shù)據(jù)庫的安裝文檔。安裝完成后，則需要在iuap Studio中配置數(shù)據(jù)源，開發(fā)過程可用。，位置如下圖所示：系統(tǒng)自帶的數(shù)據(jù)庫posrgresql配置為： 如果用戶選擇其他的數(shù)據(jù)庫，比較常見的如mysql，則數(shù)據(jù)庫配置可以參考： 注意，此處的url、username、root需要替換為自己的Mysql數(shù)據(jù)庫信息。4. 基礎(chǔ)資料獲取iUAP相關(guān)開發(fā)資源、開發(fā)示例、視頻等資料請參見如下網(wǎng)址獲取。三、 基礎(chǔ)開發(fā)本章節(jié)以一個(gè)O2O產(chǎn)品為原型，演示了幾個(gè)標(biāo)準(zhǔn)樣式節(jié)點(diǎn)的開發(fā)過程。以示例節(jié)點(diǎn)為維度，分別以列表卡片節(jié)點(diǎn)、主子類型的列表卡片節(jié)點(diǎn)（帶流程）的開發(fā)過程為例，演示了后端、前端的整個(gè)開發(fā)過程。案例中采用現(xiàn)在項(xiàng)目中最典型的方案。前后端分離，后端持久化使用iuapjdbc實(shí)現(xiàn)，前端使用ajax的方式調(diào)用后臺服務(wù)。iUAP節(jié)點(diǎn)開發(fā)的過程大概分為兩個(gè)步驟：后臺服務(wù)器端開發(fā)過程、前端頁面開發(fā)。后臺服務(wù)器端開發(fā)過程如下圖所示：數(shù)據(jù)庫表設(shè)計(jì)、實(shí)體