日本综合一区二区|亚洲中文天堂综合|日韩欧美自拍一区|男女精品天堂一区|欧美自拍第6页亚洲成人精品一区|亚洲黄色天堂一区二区成人|超碰91偷拍第一页|日韩av夜夜嗨中文字幕|久久蜜综合视频官网|精美人妻一区二区三区

RELATEED CONSULTING
相關(guān)咨詢
選擇下列產(chǎn)品馬上在線溝通
服務(wù)時(shí)間:8:30-17:00
你可能遇到了下面的問題
關(guān)閉右側(cè)工具欄

新聞中心

這里有您想知道的互聯(lián)網(wǎng)營銷解決方案
前端元編程:使用注解加速你的前端開發(fā)

 無論你用React,Vue,還是Angular,你還是要一遍一遍寫相似的CRUD 頁面,一遍一遍,一遍一遍,一遍又一遍……

麻陽網(wǎng)站建設(shè)公司創(chuàng)新互聯(lián)公司,麻陽網(wǎng)站設(shè)計(jì)制作,有大型網(wǎng)站制作公司豐富經(jīng)驗(yàn)。已為麻陽1000+提供企業(yè)網(wǎng)站建設(shè)服務(wù)。企業(yè)網(wǎng)站搭建\外貿(mào)營銷網(wǎng)站建設(shè)要多少錢,請找那個(gè)售后服務(wù)好的麻陽做網(wǎng)站的公司定做!

“天下苦秦久矣”~~

前端開發(fā)的“痛點(diǎn)”在哪里?

img

現(xiàn)在的前端開發(fā),我們有了世界一流的UI庫React,Vue,Angular,有了樣式豐富的UI組件庫Tea (騰訊云UI組件庫,類似Antd Design), 有了方便強(qiáng)大的腳手架工具(例如,create react app)。但是我們在真正業(yè)務(wù)代碼之前,通常還免不了寫大量的樣板代碼。

現(xiàn)在的CRUD頁面代碼通常:

  1.  太輕的“Model”或著“Service”,大多時(shí)候只是一些API調(diào)用的封裝。
  2.  胖”View“,View頁面中有展示UI邏輯,生命周期邏輯,CRUD的串聯(lián)邏輯,然后還要塞滿業(yè)務(wù)邏輯代碼。
  3.  不同的項(xiàng)目業(yè)務(wù)邏輯不同,但是列表頁,表單,搜索這三板斧的樣板代碼,卻要一遍一遍占據(jù)著前端工程師的寶貴時(shí)間。

特別是CRUD類應(yīng)用的樣板代碼受限于團(tuán)隊(duì)風(fēng)格,后端API風(fēng)格,業(yè)務(wù)形態(tài)等,通常內(nèi)在邏輯相似書寫上卻略有區(qū)別,無法通過一個(gè)通用的庫或者框架來解決(上圖中背景越深,越不容易有一個(gè)通用的方案)。

說好的“數(shù)據(jù)驅(qū)動(dòng)的前端開發(fā)”呢?

對于這個(gè)“痛點(diǎn)”——怎么盡可能的少寫模版代碼,就是本文嘗試解決的問題。

我們嘗試使用JavaScript新特性 Decorator和 Reflect元編程來解決這個(gè)問題。

前端元編程

從ECMAScript 2015 開始,JavaScript 獲得了 Proxy 和 Reflect 對象的支持,允許你攔截并定義基本語言操作的自定義行為(例如,屬性查找,賦值,枚舉,函數(shù)調(diào)用等)。借助這兩個(gè)對象,你可以在 JavaScript 元級別進(jìn)行編程。

在正式開始之前,我們先復(fù)習(xí)下 Decorator和 Reflect。

Decorator

這里我們簡單介紹Typescript的 Decorator,ECMAScript中 Decorator尚未定稿,但是不影響我們?nèi)粘5臉I(yè)務(wù)開發(fā)(Angular同學(xué)就在使用Typescript的 Decorator)。

簡單來說, Decorator是可以標(biāo)注修改類及其成員的新語言特性,使用 @expression的形式,可以附加到,類、方法、訪問符、屬性、參數(shù)上。

TypeScript中需要在 tsconfig.json中增加 experimentalDecorators來支持:

 
 
 
 
  1.     "compilerOptions": { 
  2.         "target": "ES5", 
  3.         "experimentalDecorators": true 
  4.     } 
  5. }

比如可以使用類修飾器來為類擴(kuò)展方法。

 
 
 
 
  1. // offer type 
  2. abstract class Base { 
  3.   log() {} 
  4. function EnhanceClass() { 
  5.   return function(Target) { 
  6.     return class extends Target { 
  7.       log() { 
  8.         console.log('---log---') 
  9.       } 
  10.     } 
  11.   } 
  12. @EnhanceClass() 
  13. class Person extends Base { }
  14. const person = new Person() 
  15. person.log()  
  16. // ---log---

更多查看 typescript 官方的文檔:https://www.typescriptlang.org/docs/handbook/decorators.html

Reflect

Reflect 是ES6中就有的特性,大家可能對它稍微陌生,Vue3中依賴Reflect和Proxy來重寫它的響應(yīng)式邏輯。

簡單來說, Reflect是一個(gè)人內(nèi)置的對象,提供了攔截 JavaScript操作的方法。

 
 
 
 
  1. const _list  = [1,2,3] 
  2. const pList = new Proxy(_list,{ 
  3.   get(target, key,receiver) { 
  4.     console.log('get value reflect:', key) 
  5.     return Reflect.get(target, key, receiver)
  6.   }, 
  7.   set(target,key,value,receiver) { 
  8.     console.log('set value reflect',key,value) 
  9.     return Reflect.set(target,key,value,receiver) 
  10.   } 
  11. }) 
  12. pList.push(4) 
  13. // get value reflect:push 
  14. // get value reflect:length 
  15. // set value reflect 3 4 
  16. // set value reflect length 4

Reflect Metadata

Reflect Metadata 是ES7的一個(gè)提案,Typescript 1.5+就有了支持。要使用需要:

  •  npm i reflect-metadata--save
  •  在 tsconfig.json 里配置 emitDecoratorMetadata 選項(xiàng)

簡單來說,Reflect Metadata能夠?yàn)閷ο筇砑雍妥x取元數(shù)據(jù)。

如下可以使用內(nèi)置的 design:key拿到屬性類型:

 
 
 
 
  1. function Type(): PropertyDecorator { 
  2.   return function(target,key) { 
  3.     const type = Reflect.getMetadata('design:type',target,key) 
  4.     console.log(`${key} type: ${type.name}`); 
  5.   } 
  6. class Person extends Base { 
  7.   @Type() 
  8.   name:string = '' 
  9. // name type: String

使用Decorator,Reflect減少樣板代碼

回到正題——使用Decorator和Reflect來減少CRUD應(yīng)用中的樣板代碼。

什么是CRUD頁面?

img

CRUD頁面無需多言,列表頁展示,表單頁修改 ……包括API調(diào)用, 都是圍繞某個(gè)數(shù)據(jù)結(jié)構(gòu)(圖中 Person)展開,增、刪、改、查。

基本思路

基本思路很簡單,就像上圖,Model是中心,我們就是借助 Decorator和 Reflect將CRUD頁面所需的樣板類方法屬性元編程在Model上。進(jìn)一步延伸數(shù)據(jù)驅(qū)動(dòng)UI的思路。

img

  1.  借助Reflect Matadata綁定CRUD頁面信息到Model的屬性上
  2.  借助Decorator增強(qiáng)Model,生成CRUD所需的樣板代碼

Show Me The Code

下文,我們用TypeScript和React為例,組件庫使用騰訊Tea component 解說這個(gè)方案。

首先我們有一個(gè)函數(shù)來生成不同業(yè)務(wù)的屬性裝飾函數(shù)。

 
 
 
 
  1. function CreateProperDecoratorF() { 
  2.   const metaKey = Symbol(); 
  3.   function properDecoratorF(config:T): PropertyDecorator { 
  4.     return function (target, key) { 
  5.       Reflect.defineMetadata(metaKey, config, target, key); 
  6.     }; 
  7.   } 
  8.   return { metaKey, properDecoratorF} 
  9. }

一個(gè)類裝飾器,處理通過數(shù)據(jù)裝飾器收集上來的元數(shù)據(jù)。

 
 
 
 
  1. export function EnhancedClass(config: ClassConfig) { 
  2.   return function(Target) { 
  3.     return class EnhancedClass extends Target { 
  4.     } 
  5.   } 
  6. }

API Model 映射

TypeScript項(xiàng)目中第一步自然是將后端數(shù)據(jù)安全地轉(zhuǎn)換為 type, interface或者 Class,這里Class能在編譯后在JavaScript存在,我們選用 Class。

 
 
 
 
  1. export interface TypePropertyConfig { 
  2.   handle?: string | ServerHandle 
  3. const typeConfig = CreateProperDecoratorF() 
  4. export const Type = typeConfig.properDecoratorF; 
  5. @EnhancedClass({}) 
  6. export class Person extends Base {
  7.   static sexOptions = ['male' , 'female' , 'unknow']; 
  8.   @Type({ 
  9.     handle: 'ID' 
  10.   }) 
  11.   id: number = 0 
  12.   @Type({}) 
  13.   name:string = '' 
  14.   @Type({ 
  15.     handle(data,key)  { 
  16.       return parseInt(data[key] || '0') 
  17.     } 
  18.   }) 
  19.   age:number = 0 
  20.   @Type({ 
  21.     handle(data,key)  { 
  22.       return Person.sexOptions.includes(data[key]) ? data[key] : 'unknow' 
  23.     } 
  24.   }) 
  25.   sex: 'male' | 'female' | 'unknow' = 'unknow' 
  26. }

重點(diǎn)在 handle?:string|ServerHandle函數(shù),在這個(gè)函數(shù)處理API數(shù)據(jù)和前端數(shù)據(jù)的轉(zhuǎn)換,然后在 constructor中集中處理。

 
 
 
 
  1. export function EnhancedClass(config: ClassConfig) { 
  2.   return function(Target) { 
  3.     return class EnhancedClass extends Target { 
  4.       constructor(data) { 
  5.         super(data) 
  6.         Object.keys(this).forEach(key => { 
  7.           const config:TypePropertyConfig = Reflect.getMetadata(typeConfig.metaKey,this,key) 
  8.           this[key] = config.handle ? typeof config.handle === 'string' ? data[config.handle]:config.handle(data,key): data[key]; 
  9.         }) 
  10.       } 
  11.     } 
  12.   } 
  13. }

列表頁TablePage

列表頁中一般使用Table組件,無論是Tea Component還是Antd Design Component中,樣板代碼自然就是寫那一大堆Colum配置了,配置哪些key要展示,表頭是什么,數(shù)據(jù)轉(zhuǎn)化為顯示數(shù)據(jù)……

首先我們收集Tea Table 所需的 TableColumn類型的column元數(shù)據(jù)。

 
 
 
 
  1. import {TableColumn} from 'tea-component/lib/table' 
  2. export type EnhancedTableColumn = TableColumn;
  3. export type ColumnPropertyConfig = Partial>; 
  4. const columnConfig = CreateProperDecoratorF() 
  5. export const Column = columnConfig.properDecoratorF; 
  6. @EnhancedClass({}) 
  7. export class Person extends Base { 
  8.   static sexOptions = ['male' , 'female' , 'unknow'];
  9.   id: number = 0 
  10.   @Column({ 
  11.     header: 'person name' 
  12.   }) 
  13.   name:string = '' 
  14.   @Column({ 
  15.     header: 'person age'
  16.   }) 
  17.   age:number = 0 
  18.   @Column({}) 
  19.   sex: 'male' | 'female' | 'unknow' = 'unknow' 
  20. }

然后在EnhancedClass中收集,生成column列表。

 
 
 
 
  1. function getConfigMap(F: any, cachekey: symbol,metaKey: symbol): Map { 
  2.   if (F[cachekey]) { 
  3.     return F[cachekey]!; 
  4.   } 
  5.   const item = new F({}); 
  6.   F[cachekey] = Object.keys(item).reduce((pre,cur) => { 
  7.     const config: T = Reflect.getMetadata( 
  8.       metaKey, 
  9.       item, 
  10.       cur 
  11.     );
  12.     if (config) { 
  13.       pre.set(cur, config); 
  14.     } 
  15.     return pre 
  16.   }, new Map()); 
  17.   return F[cachekey]; 
  18. }  
  19. export function EnhancedClass(config: ClassConfig) { 
  20.   const cacheColumnConfigKey = Symbol('cacheColumnConfigKey'); 
  21.   return function(Target) { 
  22.     return class EnhancedClass extends Target { 
  23.       [cacheColumnConfigKey]: Map | null 
  24.       /** 
  25.        * table column config 
  26.        */ 
  27.       static get columnConfig(): Map { 
  28.         return getConfigMap(EnhancedClass, cacheColumnConfigKey,columnConfig.metaKey) 
  29.       } 
  30.       /** 
  31.        * get table colums 
  32.        */ 
  33.       static getColumns(): EnhancedTableColumn[] { 
  34.         const list : EnhancedTableColumn[] = [] 
  35.         EnhancedClass.columnConfig.forEach((config, key) => { 
  36.           list.push({ 
  37.             key, 
  38.             header: key,
  39.             ...config 
  40.           }) 
  41.         }) 
  42.         return list 
  43.       } 
  44.     } 
  45.   } 

Table數(shù)據(jù)一般是分頁,而且調(diào)用方式通常很通用,也可以在EnhancedClass中實(shí)現(xiàn)。

 
 
 
 
  1. export interface PageParams { 
  2.   pageIndex: number; 
  3.   pageSize: number; 
  4. export interface Paginabale { 
  5.   total: number; 
  6.   list: T[] 
  7. export function EnhancedClass(config: ClassConfig) { 
  8.   return function(Target) {
  9.     return class EnhancedClass extends Target { 
  10.        static async getList(params: PageParams): Promise> { 
  11.         const result = await getPersonListFromServer(params) 
  12.         return { 
  13.           total: result.count, 
  14.           list: result.data.map(item => new EnhancedClass(item)) 
  15.         } 
  16.       }
  17.     } 
  18.   } 
  19. }

自然我們封裝一個(gè)更簡易的Table 組件。

 
 
 
 
  1. import { Table as TeaTable } from "tea-component/lib/table"; 
  2. import React, { FC ,useEffect, useState} from "react"; 
  3. import { EnhancedTableColumn, Paginabale, PageParams } from './utils' 
  4. import { Person } from "./person.service"; 
  5. function Table(props: { 
  6.   columns: EnhancedTableColumn[];
  7.   getListFun: (param:PageParams) => Promise
  8. }) { 
  9.   const [isLoading,setIsLoading] = useState(false) 
  10.   const [recordData,setRecordData] = useState>() 
  11.   const [pageIndex, setPageIndex] = useState(1); 
  12.   const [pageSize, setPageSize] = useState(20); 
  13.   useEffect(() => { 
  14.     (async () => { 
  15.       setIsLoading(true) 
  16.       const result = await props.getListFun({ 
  17.         pageIndex, 
  18.         pageSize 
  19.       }) 
  20.       setIsLoading(false) 
  21.       setRecordData(result) 
  22.     })(); 
  23.   },[pageIndex,pageSize]);
  24.    return ( 
  25.     
  26.       columns={props.columns}  
  27.       records={recordData ? recordData.list : []}  
  28.       addons={[ 
  29.         TeaTable.addons.pageable({ 
  30.             recordCount:recordData ? recordData.total : 0,
  31.              pageIndex, 
  32.             pageSize, 
  33.             onPagingChange: ({ pageIndex, pageSize }) => { 
  34.               setPageIndex(pageIndex || 0); 
  35.               setPageSize(pageSize || 20); 
  36.             } 
  37.           }), 
  38.       ]} 
  39.     /> 
  40. export default Table
  1.  getConfigMap(F:any,cachekey:symbol,metaKey:symbol):Map 收集元數(shù)據(jù)到Map
  2.  staticgetColumns():EnhancedTableColumn[] 得到table可用column信息。
 
 
 
 
  1. const App = () => { 
  2.   const columns = Person.getColumns(); 
  3.   const getListFun = useCallback((param: PageParams) => { 
  4.     return Person.getList(param) 
  5.   }, []) 
  6.   return  columns={columns} getListFun={getListFun}/> 
  7. }

 效果很明顯,不是嗎?7行寫一個(gè)table page。

Form表單頁

表單,自然就是字段的name,label,require,validate,以及提交數(shù)據(jù)的轉(zhuǎn)換。

Form表單我們使用Formik + Tea Form Component + yup(數(shù)據(jù)校驗(yàn))。Formik 使用React Context來提供表單控件所需的各種方法數(shù)據(jù),然后借助提供的Field等組件,你可以很方便的封裝你的業(yè)務(wù)表單組件。

 
 
 
 
  1. import React, { FC } from 'react' 
  2. import { Field, Form, Formik, FormikProps } from 'formik'; 
  3. import { Form as TeaForm, FormItemProps } from "tea-component/lib/form"; 
  4. import { Input, InputProps } from "tea-component/lib/input"; 
  5. import { Select } from 'tea-component/lib/select'; 
  6. type CustomInputProps = Partial & Pick
  7. type CustomSelectProps = Partial & Pick & { 
  8.   options: string[] 
  9. export const CustomInput:FC = props => { 
  10.   return ( 
  11.      
  12.       { 
  13.         ({ 
  14.           field, // { name, value, onChange, onBlur } 
  15.           form: { touched, errors }, // also values, setXXXX, handleXXXX, dirty, isValid, status, etc. 
  16.           meta, 
  17.         }) => { 
  18.           return ( 
  19.              
  20.                { 
  21.                 field.onChange(ctx.event) 
  22.               }} /> 
  23.              
  24.           ) 
  25.         } 
  26.       } 
  27.      
  28.   ) 
  29. export const CustomSelect:FC = props => { 
  30.   return ( 
  31.      
  32.       { 
  33.         ({ 
  34.           field, // { name, value, onChange, onBlur }
  35.           form: { touched, errors }, // also values, setXXXX, handleXXXX, dirty, isValid, status, etc. 
  36.           meta, 
  37.         }) => { 
  38.           return ( 
  39.              
  40.               ({value}))} onChange={(value,ctx)=> { 
  41.                 field.onChange(ctx.event) 
  42.               }} /> 
  43.              
  44.           ) 
  45.         } 
  46.       } 
  47.      
  48.   ) 
  49. }

照貓畫虎,我們還是先收集form所需的元數(shù)據(jù)

 
 
 
 
  1. import * as Yup from 'yup'; 
  2. export interface FormPropertyConfig { 
  3.   validationSchema?: any; 
  4.   label?: string; 
  5.   handleSubmitData?: (data:any,key:string) => {[key:string]: any}, 
  6.   required?: boolean; 
  7.   initValue?: any; 
  8.   options?: string[] 
  9. const formConfig = CreateProperDecoratorF() 
  10. export const Form = formConfig.properDecoratorF; 
  11. @EnhancedClass({}) 
  12. export class Person extends Base { 
  13.   static sexOptions = ['male' , 'female' , 'unknow']; 
  14.   @Type({ 
  15.     handle: 'ID' 
  16.   }) 
  17.   id: number = 0 
  18.   @Form({ 
  19.     label:"Name", 
  20.     validationSchema: Yup.string().required('Name is required'), 
  21.     handleSubmitData(data,key) { 
  22.       return { 
  23.         [key]: (data[key] as string).toUpperCase()
  24.       } 
  25.     }, 
  26.     required: true, 
  27.     initValue:'test name' 
  28.   }) 
  29.   name:string = '' 
  30.   @Form({ 
  31.     label:"Age", 
  32.     validationSchema: Yup.string().required('Age is required'), 
  33.     handleSubmitData(data,key) { 
  34.       return { 
  35.         [key]: parseInt(data[key] || '0')
  36.       } 
  37.     }, 
  38.     required: true, 
  39.   }) 
  40.   age:number = 0 
  41.   @Form({ 
  42.     label:"Sex", 
  43.     options: Person.sexOptions 
  44.   }) 
  45.   sex: 'male' | 'female' | 'unknow' = 'unknow' 
  46. }

有了元數(shù)據(jù),我們可以在EnhancedClass中生成form所需:

  •  initialValues
  •  數(shù)據(jù)校驗(yàn)的validationSchema
  •  各個(gè)表單組件所需的,name,label,required等
  •  提交表單的數(shù)據(jù)轉(zhuǎn)換handle函數(shù)
 
 
 
 
  1. export type FormItemConfigType = { 
  2.   [key in keyof T]: { 
  3.     validationSchema?: any; 
  4.     handleSubmitData?: FormPropertyConfig['handleSubmitData']; 
  5.     form: { 
  6.       label: string; 
  7.       name: string; 
  8.       required: boolean; 
  9.       message?: string; 
  10.       options: string[]; 
  11.     }; 
  12.   }; 
  13. }; 
  14. export function EnhancedClass(config: ClassConfig) { 
  15.   return function(Target) { 
  16.     return class EnhancedClass extends Target {
  17.       [cacheTypeConfigkey]: Map | null 
  18.       /** 
  19.        * table column config 
  20.        */ 
  21.       static get formConfig(): Map {
  22.         return getConfigMap(EnhancedClass, cacheTypeConfigkey,formConfig.metaKey) 
  23.       } 
  24.       /** 
  25.        * get form init value 
  26.        */ 
  27.       static getFormInitValues(item?: T): Partial { 
  28.         const data:any  = {}; 
  29.         const _item = new EnhancedClass({}); 
  30.         EnhancedClass.formConfig.forEach((config,key) => { 
  31.           if (item && key in item) { 
  32.             data[key]  = item[key] 
  33.           } else if ('initValue' in config) { 
  34.             data[key]  = config.initValue 
  35.           } else { 
  36.             data[key] = _item[key] || '' 
  37.           } 
  38.         }); 
  39.         return data as Partial 
  40.       }  
  41.       static getFormItemConfig(overwriteConfig?: { 
  42.         [key: string]: any; 
  43.       }): FormItemConfigType { 
  44.         const formConfig: any = {}; 
  45.         EnhancedClass.formConfig.forEach((config,key) => { 
  46.           formConfig[key] = { 
  47.             form: { 
  48.               label: String(config.label || key), 
  49.               name: String(key), 
  50.               required: !!config.validationSchema, 
  51.               options: config.options || [], 
  52.               ...overwriteConfig
  53.             } 
  54.           }; 
  55.           if (config.validationSchema) { 
  56.             formConfig[key].validationSchema = config.validationSchema; 
  57.           } 
  58.           if (config.handleSubmitData) { 
  59.             formConfig[key].handleSubmitData = config.handleSubmitData; 
  60.           } 
  61.         }) 
  62.         return formConfig as FormItemConfigType 
  63.       }
  64.       static handleToFormData(item: T) { 
  65.         let data = {} 
  66.         EnhancedClass.formConfig.forEach((config,key)=> { 
  67.           if (item.hasOwnProperty(key)) { 
  68.             data = { 
  69.               ...data,
  70.               ...(EnhancedClass.formConfig 
  71.                 .get(key).handleSubmitData ? EnhancedClass.formConfig 
  72.                 .get(key).handleSubmitData(item, key) : { 
  73.                 [key]: item[key] || '' 
  74.               }) 
  75.             }; 
  76.           }       
  77.          }) 
  78.         return data 
  79.       } 
  80.     } 
  81.   } 
  82. }

在FormPage中使用

 
 
 
 
  1. export const PersonForm:FC<{ 
  2.   onClose: () => void 
  3. }> = props => { 
  4.   const initialValues = Person.getFormInitValues() 
  5.   const formConfig = Person.getFormItemConfig(); 
  6.   const&nb
    網(wǎng)站題目:前端元編程:使用注解加速你的前端開發(fā)
    本文網(wǎng)址:http://www.dlmjj.cn/article/dhsjiii.html