【转】D365 FO第三方集成(三)---服务实现
D365 FO的Custom?Service的實現比AX2012簡單了很多。
AX2012服務方法要用屬性SysEntryPointAttribute標記,添加到Services以后,還要發布服務并在系統管理入站端口添加操作,服務運行在CIL下,所以每次改動服務方法的代碼都要增量生成CIL。
AX2012只支持SOAP,不支持Restful,個人偏愛Restful,主要是SOAP的代理類在不同的平臺有說不清道不明的問題,在AX2012的時候,我是通過.NET?WCF封裝了一下,把SOAP封裝成了Restful的服務。
在D365?FO這些問題都不是問題了,任何類都可以直接添加到Services節點,服務方法不需要再用SysEntryPointAttribute標記。只要把Services節點添加到Service Groups,D365?FO就直接把類里的方法
暴露成SOAP和Json-Based服務。
D365?FO沒有稱呼Restful服務而是稱為json-based服務。
Restful和json-based這兩個東西不是一個層面的東西,Restful是一種網絡應用程序的設計風格和開發方式,Restful的數據傳輸既可以用json也可以用xml,也可以用其他格式。
在.NET WCF?Restful實現里是通過Content-Type來識別的。根據Content-Type來決定調用方傳過來的數據是什么格式的,可以是xml,json,也可以是text/plain。
D365?FO里的服務稱為Json-base服務,顧名思義調用服務方法的時候入參和返回值都必須是合法的json格式。
這個跟WCF Restful的RequestFormat和ResponseFormat格式指定Json,http?request的ContentType指定為json是一樣的。
框架負責反序列化和序列化,個人不是很喜歡這種方式,異常不是很容易捕獲,如果第三方傳入的數據有問題,序列化失敗會內部錯誤500,不好排錯。
另外第三方提供的入參也不一定就是合法的json格式,可能就是一堆沒有規律的字符串,傳入以后再作分析可能更方便。
WCF?Restful可以直接接收text/plain,方法入參用System.IO.Stream,接收以后再做分析。
既然D365?FO只支持Json格式,我覺得把第三方提供的數據都作為一個字符串,封裝到json里,作為一個入參傳入,方法接收以后再根據數據情況分析可能更靈活。
當然這個每個人都有自己的偏好,怎么實現都可以。
以D365提供的示例代碼為例說明步驟:
1.創建類Class1,添加方法
?
1 class Class12 {3 public str EchoString(str input)4 {5 return input;6 }7 8 public ComplexContract1 GetComplexContract()9 { 10 ComplexContract1 complexContract = new ComplexContract1(); 11 List contractList = new List(Types::Class); 12 Contract1 contract = new Contract1(); 13 contract.parmStringMember("SomeString"); 14 contractList.addEnd(contract); 15 contract = new Contract1(); 16 contract.parmStringMember("SomeString2"); 17 contractList.addEnd(contract); 18 complexContract.parmContractList(contractList); 19 return complexContract; 20 } 21 22 public ComplexContract1 EchoComplexContract(ComplexContract1 input) 23 { 24 return input; 25 } 26 27 [AifCollectionTypeAttribute('return', Types::Class, classStr(Contract1))] 28 public List GetContractList() 29 { 30 List contractList = new List(Types::Class); 31 Contract1 contract = new Contract1(); 32 contract.parmStringMember("SomeString"); 33 contractList.addEnd(contract); 34 contract = new Contract1(); 35 contract.parmStringMember("SomeString2"); 36 contractList.addEnd(contract); 37 return contractList; 38 } 39 40 [AifCollectionTypeAttribute('return', Types::Class, classStr(Contract1)), 41 AifCollectionTypeAttribute('input', Types::Class, classStr(Contract1))] 42 public List EchoContractList(List input) 43 { 44 return input; 45 } 46 47 }?
因為D365?FO目前(10.0.0.10)還不支持泛型,所以List作為入參和返回值的時候,需要用屬性指定List里class的類型,這樣通知序列化框架應該用哪個類進行序列化和反序列化。
試了一下,D365?FO(10.0.0.10)的服務方法已經支持返回.NET的類型了,所以在C#里定義一個繼承泛型List的類,用來做入參和返回值,這樣也就不用List了。
不過正如前文說的,個人不是很喜歡直接返回實體,入參和返回值直接用字符串更直接。
所以我自己封裝的話,都會是這樣的方法
至于序列化和反序化還是在方法體內進行吧。
2.定義Service
在Project里新增Service,然后關聯Class1
?
?3.新增Service?Group,把Service1添加到Service?Group
編譯程序,服務器端的代碼就這么簡單。
下一篇blog介紹一下客戶端如何調用服務器端方法。
總結
以上是生活随笔為你收集整理的【转】D365 FO第三方集成(三)---服务实现的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 1万元存一年多少利息?2020年银行存款
- 下一篇: 【转】01Teams的前世今生