剥开比原看代码(十七):比原是如何显示交易的详细信息的?
作者:freewind
比原項目倉庫:
Github地址:https://github.com/Bytom/bytom
Gitee地址:https://gitee.com/BytomBlockchain/bytom
在上上篇文章里,我們還剩下一個小問題沒有解決,即前端是如何顯示一個交易的詳細信息的。
先看對應的圖片:
這個圖片由于太長,分成了兩個,實際上可以看作一個。
那么這個頁面是怎么來的呢?這是在前面以列表的方式顯示交易摘要信息后,可以點擊摘要信息右上角的“查看詳情”鏈接打開。
那我們在本文看一下,比原是如何顯示這個交易的詳細信息的。
由于它分成了前后兩端,那么我們跟以前一樣,把它再分成兩個小問題:
需要說明的是,這個表格中包含了很多信息,但是我們在本文并不打算去解釋。因為能看懂的一看就能明白,看不懂的就需要準確的了解了比原的核心之后才能解釋清楚,而這一塊等到我們晚點再專門研究。
前端是怎么向后臺發送請求,并顯示數據的
首先我們看一下顯示交易詳細信息頁面的路由path是多少。當我們把鼠標放在交易摘要頁面右上角的“查看詳情”時,會發現url類似于:
http://localhost:9888/dashboard/transactions/2d94709749dc59f69cad4d6aea666586d9f7e86b96c9ee81d06f66d4afb5d6dd 復制代碼其中http://localhost:9888/dashboard/可以看作是這個應用的根路徑,那么路由path應該就是/transactions/2d94709749dc59f69cad4d6aea666586d9f7e86b96c9ee81d06f66d4afb5d6dd,后面那么長的顯然是一個id,所以我們應該到代碼中尋找類似于/transactions/:id這樣的字符串,哦,遺憾的是沒有找到。。。
那只能從頭開始了,先找到前端路由的定義:
src/routes.js#L15-L35
// ... import { routes as transactions } from 'features/transactions'// ...const makeRoutes = (store) => ({path: '/',component: Container,childRoutes: [// ...transactions(store),// ...] }) 復制代碼其中的transactions就是我們需要的,而它對應了features/transactions/routes.js:
src/features/transactions/routes.js#L1-L21
import { List, New, AssetShow, AssetUpdate } from './components' import { makeRoutes } from 'features/shared'export default (store) => {return makeRoutes(store,'transaction',List,New,Show,// ...) } 復制代碼這個函數將會為transactions生成很多相關的路由路徑。當我們把一些組件,比如列表顯示List,新建New,顯示詳情Show等等傳進去之后,makeRoutes就會按照預先定義好的路徑規則去添加相關的path。我們看一下makeRoutes:
src/features/shared/routes.js#L1-L44
import { RoutingContainer } from 'features/shared/components' import { humanize } from 'utility/string' import actions from 'actions'const makeRoutes = (store, type, List, New, Show, options = {}) => {const loadPage = () => {store.dispatch(actions[type].fetchAll())}const childRoutes = []if (New) {childRoutes.push({path: 'create',component: New})}if (options.childRoutes) {childRoutes.push(...options.childRoutes)}// 1. if (Show) {childRoutes.push({path: ':id',component: Show})}return {// 2. path: options.path || type + 's',component: RoutingContainer,name: options.name || humanize(type + 's'),name_zh: options.name_zh,indexRoute: {component: List,onEnter: (nextState, replace) => {loadPage(nextState, replace)},onChange: (_, nextState, replace) => { loadPage(nextState, replace) }},childRoutes: childRoutes} } 復制代碼這段代碼看起來眼熟,因為我們在之前研究余額和交易的列表顯示的時候,都見過它。而我們今天關注的是Show,即標記為第1處的代碼。
可以看到,當傳進來了Show組件時,就需要為其生成相關的路由path。具體是在childRouters中添加一個path為:id,而它本身的路由path是在第2處定義的,默認為type + 's',而對于本例來說,type的值就是transaction,所以Show所對應的完整path就是/transactions/:id,正是我們所需要的。
再回到第1處代碼,可以看到Show組件是從外部傳進來的,從前面的函數可以看到它對應的是src/features/transactions/components/Show.jsx。
我們進去看一下這個Show.jsx,首先是定義html組件的函數render:
src/features/transactions/components/Show.jsx#L16-L96
class Show extends BaseShow {render() {// 1.const item = this.props.itemconst lang = this.props.langconst btmAmountUnit = this.props.btmAmountUnitlet viewif (item) {// ..view = <div><PageTitle title={title} /><PageContent>// ...<KeyValueTabletitle={lang === 'zh' ? '詳情' : 'Details'}items={[// ...]}/>{item.inputs.map((input, index) =><KeyValueTable// .../>)}{item.outputs.map((output, index) =><KeyValueTable// .../>)}</PageContent></div>}return this.renderIfFound(view)} } 復制代碼代碼被我進行了大量的簡化,主要是省略了很多數據的計算和一些顯示組件的參數。我把代碼分成了2部分:
那我們繼續去尋找connect,很快就在同一個頁面的后面,找到了如下的定義:
src/features/transactions/components/Show.jsx#L100-L117
import { actions } from 'features/transactions' import { connect } from 'react-redux'const mapStateToProps = (state, ownProps) => ({item: state.transaction.items[ownProps.params.id],lang: state.core.lang,btmAmountUnit: state.core.btmAmountUnit,highestBlock: state.core.coreData && state.core.coreData.highestBlock })// ...export default connect(mapStateToProps,// ... )(Show) 復制代碼我只留下了需要關注的mapStateToProps。可以看到,我們在前面第1處中看到的幾個變量的賦值,在這里都有定義,其中最重要的item,是從store的當前狀態state中的transaction中的items中取出來的。
那么state.transaction是什么呢?我開始以為它是我們從后臺取回來的一些數據,使用transaction這個名字放到了store里,結果怎么都搜不到,最后終于發現原來不是的。
實際情況是,在我們定義reducer的地方,有一個makeRootReducer:
src/reducers.js#L1-L62
// ... import { reducers as transaction } from 'features/transactions' // ...const makeRootReducer = () => (state, action) => {// ...return combineReducers({// ...transaction,// ...})(state, action) } 復制代碼原來它是在這里構建出來的。首先{ transaction }這種ES6的語法,換成平常的寫法,就是:
{transaction: transaction } 復制代碼另外,combineReducers這個方法,是用來把多個reducer合并起來(可能是因為store太大,所以把它拆分成多個reducer管理,每個reducer只需要處理自己感興趣的部分),并且合并以后,這個store就會變成大概這樣:
{"transaction": { ... },// ... } 復制代碼所以前面的state.transaction就是指的這里的{ ... }。
那么繼續,在前面的代碼中,可以從state.transaction.items[ownProps.params.id]看到,state.transaction還有一個items的屬性,它持有的是向后臺/list-transactions取回的一個transaction數組,它又是什么時候加上去的呢?
這個問題難倒了我,我花了幾個小時搜遍了比原的前后端倉庫,都沒找到,最后只好使出了Chrome的Redux DevTools大法,發現在一開始的時候,items就存在了:
在圖上有兩個紅框,左邊的表示我現在選擇的是初始狀態,右邊顯示最開始transaction就已經有了items,于是恍然大悟,這不跟前面是一樣的道理嘛!于是很快找到了定義:
src/features/transactions/reducers.js#L7-L16
export default combineReducers({items: reducers.itemsReducer(type),queries: reducers.queriesReducer(type),generated: (state = [], action) => {if (action.type == 'GENERATED_TX_HEX') {return [action.generated, ...state].slice(0, maxGeneratedHistory)}return state}, }) 復制代碼果然,這里也是用combineReducers把幾個reducer組合在了一起,所以store里就會有這里的幾個key,包括items,以及我們不關心的queries和generated。
花了一下午,終于把這塊弄清楚了。看來對于分析動態語言,一定要腦洞大開,不能預設原因,另外要利用各種調試工具,從不同的角度去查看數據。要不是Redux的Chrome插件,我不知道還要卡多久。
我個人更喜歡靜態類型的語言,對于JavaScript這種,除非萬不得以,能躲就躲,主要原因就是代碼中互相引用的線索太少了,很多時候必須看文檔、代碼甚至去猜,無法利用編輯器提供的跳轉功能。
知道了state.transaction.items的來歷以后,后面的事情就好說了。我們是從state.transaction.items[ownProps.params.id]拿到了當前需要的transaction,那么state.transaction.items里又是什么時候放進去數據的呢?
讓我們再回到前面的makeRoutes:
src/features/shared/routes.js#L1-L44
// ... import actions from 'actions'const makeRoutes = (store, type, List, New, Show, options = {}) => {// 2.const loadPage = () => {store.dispatch(actions[type].fetchAll())}// ...return {path: options.path || type + 's',component: RoutingContainer,name: options.name || humanize(type + 's'),name_zh: options.name_zh,indexRoute: {component: List,onEnter: (nextState, replace) => {loadPage(nextState, replace)},// 1. onChange: (_, nextState, replace) => { loadPage(nextState, replace) }},childRoutes: childRoutes} } 復制代碼在上面的第1處,對于indexRoute,有一個onChange的觸發器。它的意思是,當路由的path改變了,并且新的path屬于當前的這個index路由的path(或者子path),后面的函數將會觸發。而后面函數中的loadPage的定義在第2處代碼,它又會將actions[type].fetchAll()生成的action進行dispatch。由于type在本文中是transaction,通過一步步追蹤(這里稍有點麻煩,不過我們在之前的文章中已經走過),我們發現actions[type].fetchAll對應了src/features/shared/actions/list.js:
src/features/shared/actions/list.js#L4-L147
export default function(type, options = {}) {const listPath = options.listPath || `/${type}s`const clientApi = () => options.clientApi ? options.clientApi() : chainClient()[`${type}s`]// ...const fetchAll = () => {// ...}// ...return {// ...fetchAll,// ...} } 復制代碼如果我們還對這一段代碼有印象的話,就會知道它最后將會去訪問后臺的/list-transactions,并在拿到數據后調用dispatch("RECEIVED_TRANSACTION_ITEMS"),而它將會被下面的這個reducer處理:
src/features/shared/reducers.js#L6-L28
export const itemsReducer = (type, idFunc = defaultIdFunc) => (state = {}, action) => {if (action.type == `RECEIVED_${type.toUpperCase()}_ITEMS`) {// 1.const newObjects = {}// 2.const data = type.toUpperCase() !== 'TRANSACTION' ? action.param.data : action.param.data.map(data => ({...data,id: data.txId,timestamp: data.blockTime,blockId: data.blockHash,position: data.blockIndex}));// 3. (data || []).forEach(item => {if (!item.id) { item.id = idFunc(item) }newObjects[idFunc(item)] = item})return newObjects}// ...return state } 復制代碼依次講解這個函數中的三處代碼:
經過這些處理以后,我們才能使用state.transaction.items[ownProps.params.id]拿到合適的transaction對象,并且由Show.jsx顯示。
前端這塊基本上弄清楚了。我們繼續看后端
后端是如何拿到相應的數據發送給前臺的
前面我們說過,根據以往的經驗,我們可以推導出前端會訪問后端的/list-transactions這個接口。我們欣喜的發現,這個接口我們正好在前一篇文章中研究過,這里就可以完全跳過了。
到今天為止,我們終于把“比原是如何創建一個交易的”這件事的基本流程弄清楚了。雖然還有很多細節,以及觸及到核心的知道都被忽略了,但是感覺自己對于比原內部的運作似乎又多了一些。
也許現在積累的知識差不多了,該向比原的核心進發了。在下一篇,我將會嘗試理解和分析比原的核心,在學習的過程中,可能會采用跟目前探索流程分解問題不同的方式。另外,可能前期會花不少時間,所以下一篇出來得會晚一些。當然,如果失敗了,說明我目前積累的知識還是不夠,我還需要再回到當前的做法,想辦法再從不同的地方多剝一些比原的外殼,然后再嘗試。
總結
以上是生活随笔為你收集整理的剥开比原看代码(十七):比原是如何显示交易的详细信息的?的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: socket_基础2_传输大数据
- 下一篇: C语言错误处理方法、C++异常处理方法(