目錄前言 范圍 規(guī)范性引用文 術(shù)語(yǔ)與定義 系統(tǒng)說(shuō)明 數(shù)據(jù)交互方 訪問(wèn)形式 接口概述 接口列表 接口常用數(shù)據(jù)類 接口規(guī)范 文件（數(shù)據(jù)）傳輸接 算法插件封裝接 附錄 接口狀態(tài)代 文件類型代碼 接口參數(shù)類型 數(shù)字孿生可視化平臺(tái)算法接口規(guī)范范圍本標(biāo)準(zhǔn)規(guī)定了數(shù)字孿生可視化平臺(tái)的算法接口規(guī)范要求，包括算法的封裝標(biāo)準(zhǔn)、接口定義形式等內(nèi)容。規(guī)范性引用文件GB/T39334.1- 機(jī)械產(chǎn)品制造過(guò)程數(shù)字化仿真第1部分：通用要求術(shù)語(yǔ)與定義RestfulRESTfulAPI是利用HTTP請(qǐng)求訪問(wèn)或使用數(shù)據(jù)的應(yīng)用程序接口（API）的體系結(jié)構(gòu)樣式。這些數(shù)據(jù)可用于GET，PUT，POSTDELETE數(shù)據(jù)類型，這些數(shù)據(jù)類型指的是與資源相關(guān)的操作讀取、更新、創(chuàng)建和刪除。XML(eXtensibleMarkupLanguage)是一種可擴(kuò)展標(biāo)記語(yǔ)言，用于描述和傳輸數(shù)據(jù)。它使用自定義標(biāo)簽來(lái)定義數(shù)據(jù)的結(jié)構(gòu)和內(nèi)容，被廣泛應(yīng)用于數(shù)據(jù)交換、配置文件、Web服務(wù)等領(lǐng)域。同步、異步同步是指一個(gè)進(jìn)程在執(zhí)行某個(gè)請(qǐng)求的時(shí)候，如果該請(qǐng)求需要一段時(shí)間才能返回信息，那么進(jìn)程會(huì)一直等待直到收到返回信息才會(huì)繼續(xù)執(zhí)行下去。異步是指進(jìn)程不需要一直等待，而是繼續(xù)執(zhí)行下面的操作，當(dāng)有信息返回的時(shí)候后通知進(jìn)程進(jìn)行處理。系統(tǒng)說(shuō)明文檔中接口字段：空白或者N表示“非必傳”，Y表示“必傳”、CY表示“條件必傳”。數(shù)據(jù)交互方式異步方式commitrollback。文件交互：各方提供的數(shù)據(jù)文件通過(guò)文件方式上傳到信息平臺(tái)的FTP服務(wù)器的指定目錄。實(shí)時(shí)接口數(shù)據(jù)交互TCP/IP協(xié)議的信息交互：約定報(bào)文格式，性能較高。如ISO8583報(bào)文國(guó)際標(biāo)準(zhǔn)的包格式的通訊協(xié)議。HTTP協(xié)議的信息交互：如SOAP協(xié)議。WebService協(xié)議的信息交互：比較通用的接口協(xié)議。數(shù)據(jù)文件的格式FTPFTP服務(wù)器目錄下。接口文件：上傳xml、txt、xls、csv等接口中任意文件內(nèi)容編碼格式統(tǒng)一采用UTF-8或GBK標(biāo)準(zhǔn)；訪問(wèn)形式例如：http://ip:端口/服務(wù)名IP:服務(wù)平臺(tái)對(duì)外提供的IP地址端口：服務(wù)平臺(tái)對(duì)外提供給的端口服務(wù)名：服務(wù)平臺(tái)提供接口規(guī)范中的服務(wù)名接口概述系統(tǒng)提供數(shù)據(jù)異步上傳的處理模式，為了兼顧上傳效率和數(shù)據(jù)質(zhì)量控制的目的，調(diào)用接口請(qǐng)求傳輸數(shù)據(jù)，數(shù)據(jù)接收方接到數(shù)據(jù)并處理后同步返回給數(shù)據(jù)傳送方相應(yīng)的處理結(jié)果。傳輸文件編碼集為GBK或UTF-8。接口列表信息描述如下。接口列表序號(hào)分類算法項(xiàng)描述時(shí)間系統(tǒng)轉(zhuǎn)換時(shí)間系統(tǒng)轉(zhuǎn)換儒略日、UTC、北京時(shí)、星上時(shí)之間的相互轉(zhuǎn)換坐標(biāo)系統(tǒng)轉(zhuǎn)換坐標(biāo)系統(tǒng)轉(zhuǎn)換ICRF、J2000、固定系、當(dāng)?shù)叵?、軌道系之間的相互轉(zhuǎn)換，擴(kuò)展至目標(biāo)小行星慣性系和固定系天體星歷計(jì)算天體星歷計(jì)算DE405文件插值生成高精度天體坐標(biāo)近地軌道預(yù)報(bào)二體軌道預(yù)報(bào)橢圓、雙曲線軌道計(jì)算J2考慮地球不規(guī)則形狀帶諧項(xiàng)攝動(dòng)軌道計(jì)算J4考慮地球不規(guī)則形狀帶諧項(xiàng)、田諧項(xiàng)攝動(dòng)軌道計(jì)算SGP4綜合考慮地球形狀、大氣阻力、日月引力等攝動(dòng)軌道計(jì)算HPOP綜合考慮各種攝動(dòng)力的高精度軌道計(jì)算深空軌道預(yù)報(bào)二體軌道預(yù)報(bào)橢圓、雙曲線軌道計(jì)算J2考慮中心天體不規(guī)則形狀帶諧項(xiàng)攝動(dòng)軌道計(jì)算SDP4SDP4深空攝動(dòng)項(xiàng)的軌道預(yù)報(bào)SDP8SDP8深空攝動(dòng)項(xiàng)的軌道預(yù)報(bào)任務(wù)策略規(guī)劃任務(wù)策略規(guī)劃探測(cè)器姿態(tài)指向計(jì)算、探測(cè)器可運(yùn)動(dòng)機(jī)構(gòu)指向計(jì)算等，主要為根據(jù)目標(biāo)在探測(cè)器本體下的方位進(jìn)行相應(yīng)運(yùn)動(dòng)規(guī)劃可見(jiàn)性計(jì)算星地、中繼可見(jiàn)性計(jì)算探測(cè)器對(duì)地面、探測(cè)器對(duì)中繼衛(wèi)星、探測(cè)器對(duì)天體等可見(jiàn)時(shí)間弧段計(jì)算選配計(jì)算物理參數(shù)計(jì)算實(shí)時(shí)計(jì)算質(zhì)心、質(zhì)量、慣性張量等參數(shù)變化情況各專業(yè)參數(shù)計(jì)根據(jù)選配的分系統(tǒng)產(chǎn)品參數(shù)匯總到整器任務(wù)能力參數(shù)資源計(jì)算根據(jù)選配的分系統(tǒng)產(chǎn)品參數(shù)匯總到整器資源參數(shù)軌道機(jī)動(dòng)計(jì)算根據(jù)推進(jìn)產(chǎn)品技術(shù)參數(shù)計(jì)算推進(jìn)速度增量及對(duì)軌道影響動(dòng)力學(xué)計(jì)算根據(jù)姿控產(chǎn)品技術(shù)參數(shù)求解動(dòng)力學(xué)方程功率輸出計(jì)算根據(jù)電源產(chǎn)品技術(shù)參數(shù)計(jì)算輸出功率數(shù)據(jù)傳輸計(jì)算根據(jù)測(cè)控?cái)?shù)傳產(chǎn)品技術(shù)參數(shù)計(jì)算數(shù)據(jù)傳輸覆蓋區(qū)域計(jì)算根據(jù)載荷產(chǎn)品技術(shù)參數(shù)計(jì)算星下覆蓋區(qū)應(yīng)用性能分析成像性能計(jì)算研究成像性能指標(biāo)及其計(jì)算方法機(jī)動(dòng)性能計(jì)算研究機(jī)動(dòng)性能指標(biāo)及其計(jì)算方法能源平衡性能計(jì)算研究能源平衡性能指標(biāo)及其計(jì)算方法通信性能計(jì)算研究通信性能指標(biāo)及其計(jì)算方法任務(wù)約束分析任務(wù)約束分析通過(guò)規(guī)則引擎對(duì)約束規(guī)則進(jìn)行維護(hù)，自動(dòng)應(yīng)用到任務(wù)過(guò)程接口常用數(shù)據(jù)類型在接口參數(shù)中涉及到的數(shù)據(jù)類型有以下幾種，例如：類型說(shuō)明字符1、文本信息，標(biāo)明的大小表示最大長(zhǎng)度。2、該長(zhǎng)度是按單字節(jié)進(jìn)行計(jì)算的，對(duì)于雙字節(jié)數(shù)據(jù)按照長(zhǎng)度為計(jì)。數(shù)值1、正負(fù)號(hào)可以有也可以沒(méi)有，如果有正負(fù)號(hào)就必須出現(xiàn)在最左邊的位置，如果沒(méi)有，默認(rèn)為正值。2、有正負(fù)符號(hào)的整數(shù)和小數(shù)兩種：（1）、整數(shù)，標(biāo)明最大的位數(shù)。（2）p精度（位數(shù)）s等級(jí)（小數(shù)點(diǎn)后位數(shù)）。如：(3,2)表明[-9.99,+9.99]。日期1、泛指日期（Date）和時(shí)間（Time），采用24小時(shí)制，使用“年月日時(shí)分秒”格式（即YYYY-MM-DDHH:MM:SS）。2、若數(shù)據(jù)產(chǎn)生的信息中對(duì)于時(shí)間無(wú)法精確到“時(shí)分秒”，則傳輸數(shù)據(jù)的“時(shí)分秒”可默認(rèn)為“000000秒”或“240000秒”。具體見(jiàn)相關(guān)字段的備注欄說(shuō)明。3、臨界值說(shuō)明：根據(jù)業(yè)務(wù)數(shù)據(jù)的含義，當(dāng)出現(xiàn)024時(shí)的情況下，起始時(shí)間的描述采用0時(shí)，終止時(shí)間的描述采用24時(shí)。布爾10，代表假或否。上傳數(shù)據(jù)時(shí)以WSDL的描述為準(zhǔn)，采用字符串類型，即“0”。21，代表真或是。上傳數(shù)據(jù)時(shí)以WSDL的描述為準(zhǔn)，采用字符串類型，即“1”。枚舉1、枚舉型是字符型的擴(kuò)展類型，通常用于限制元素的取值。枚舉型數(shù)據(jù)類型可以分為開(kāi)放式枚舉（OpenEnum）和封閉式枚舉（CloseEnum）。本規(guī)范中的枚舉默認(rèn)代表封閉式枚舉，即已經(jīng)對(duì)所有有效的枚舉值進(jìn)行了定義，任何未包含在定義范圍內(nèi)的值都是無(wú)效的。對(duì)象1、當(dāng)需要使用多個(gè)簡(jiǎn)單屬性描述一個(gè)結(jié)構(gòu)化復(fù)雜對(duì)象的時(shí)候，使用對(duì)象名稱進(jìn)行說(shuō)明。接口規(guī)范文件（數(shù)據(jù)）傳輸接口詳見(jiàn)5.2：文件命名處理規(guī)則算法插件封裝接口算法將全部以JavaAPI接口來(lái)進(jìn)行注冊(cè)和調(diào)用。注冊(cè)需要算法提供者根據(jù)提供的XML根據(jù)注冊(cè)的算法信息進(jìn)行動(dòng)態(tài)封裝參數(shù)調(diào)用。XMLAPI信息，主要包括：算法名稱、算法調(diào)用地址、算法調(diào)用類型、算法輸入輸出參數(shù)以及算法的描述，作者，版本等。具體規(guī)范要求如下。算法注冊(cè)在彈出的界面中通過(guò)導(dǎo)入按鈕將編輯好的算法xmlxml檢查沒(méi)有問(wèn)題后確認(rèn)上傳，完成算法注冊(cè)操作。具體如下圖：算法總要求算法服務(wù)如果依賴特殊環(huán)境，需要提供依賴的環(huán)境以及對(duì)應(yīng)環(huán)境安裝包；算法服務(wù)盡量承擔(dān)單一算法，減少外部耦合；算法支持Java、C++、Pythonexe文件的調(diào)用并提供封裝為Java的API技術(shù)支持；算法返回結(jié)果以key-value形式返回，包括狀態(tài)碼、結(jié)果、message三類信息；算法中文件的輸入和輸出盡量不出現(xiàn)絕對(duì)路徑，路徑可以配置，輸出結(jié)果可以讓其他算法訪問(wèn)（可以約定一個(gè)目錄，在配置文件中體現(xiàn)）；算法不能通過(guò)命令行打開(kāi)、運(yùn)行，需要符合RestfulAPI的接口規(guī)范；算法的輸入輸出是完整的，不能出現(xiàn)運(yùn)行一段時(shí)間后，彈框再設(shè)置參數(shù)的情況。序號(hào)字段名類型是否必傳備注狀態(tài)碼：參照附錄信息：記錄成功、失敗的原因算法結(jié)果，沒(méi)有結(jié)果可不傳算法返回結(jié)果結(jié)構(gòu)示例如下：“code”:0，“message”:“成功”，“result”:“算法結(jié)果”算法封裝要求算法對(duì)外全部以JavaRestful風(fēng)格接口對(duì)外提供服務(wù)，其他語(yǔ)言或格式的算法需要封裝成Java的API。封裝要求具體如下：環(huán)境要求：Java統(tǒng)一使用jdk8環(huán)境；請(qǐng)求方式：GET、POSTPOST輸入輸出采用json進(jìn)行序列化；參數(shù)結(jié)構(gòu)：輸入輸出參數(shù)結(jié)構(gòu)參照XML規(guī)范（后續(xù)有說(shuō)明）中規(guī)定的三種結(jié)構(gòu)；返回結(jié)果：要包括狀態(tài)碼、message以及算法調(diào)用結(jié)果；打包要求：算法全部以jar包形式提供以備調(diào)用，非Java語(yǔ)言的算法需要算法開(kāi)發(fā)人員自行將其封裝為JavaAPI接口并打成jar包提供。算法參數(shù)結(jié)構(gòu)規(guī)范參數(shù)類型支持String、int、boolean、char、double、float、long，算法注冊(cè)支持的參數(shù)結(jié)構(gòu)有如下三種（防止多層嵌套），具體示例如下表：序號(hào)參數(shù)類型參數(shù)示例單值“name”:”張三單值數(shù)組“age”:對(duì)象/結(jié)構(gòu)體的數(shù)組“user”:“name”:”張三“name”:”李四XMLXML結(jié)構(gòu)XML標(biāo)簽說(shuō)明1）Fixed_Header標(biāo)簽<Fixed_Header>標(biāo)簽定義算法的基本信息，具體如下圖：<Mod_Name>標(biāo)簽定義算法的名稱；<Mod_Version>標(biāo)簽定義算法的版本；<Mod_Author>標(biāo)簽定義算法的作者；<Mod_url>標(biāo)簽定義算法的API請(qǐng)求地址，可以不填<Mod_type>標(biāo)簽定義算法的調(diào)用方式：POST或<Mod_Description>標(biāo)簽定義算法的描述或中文名。2）Data_Block塊Data_Blok塊中包含輸入<InputParams>和輸出<OutPutParams>標(biāo)簽。輸入和輸出標(biāo)簽中的數(shù)據(jù)定義分為三類，如2算法輸入輸出參數(shù)規(guī)范。算法參數(shù)傳遞時(shí)三種結(jié)構(gòu)都是整體傳遞，所以請(qǐng)根據(jù)參數(shù)傳遞和使用的便利性選擇參數(shù)類型。具體輸入輸出參數(shù)標(biāo)簽如下：輸入標(biāo)簽下圖為輸入標(biāo)簽的示例，其中單值類型以<InputParam>標(biāo)簽為標(biāo)識(shí)，單值數(shù)組類型以<InputArrayParam>/<InputArrayList>為標(biāo)簽。<InputParam>標(biāo)簽中包含如下屬性：序號(hào)字段名類型是否必傳備注（數(shù)組參數(shù)非同一類需要填參數(shù)單位默認(rèn)值最大值數(shù)字類型才有最小值數(shù)字類型才有參數(shù)類型（參照文檔枚舉值），如果存在數(shù)據(jù)文件，改屬性必傳（參照接口參數(shù)類型如果存在數(shù)據(jù)文件，改屬性必傳輸出標(biāo)簽下圖為輸出標(biāo)簽的示例，其中單值類型以<OutputParam>標(biāo)簽為標(biāo)識(shí)，單值數(shù)組類型以<OutputArrayParam>為標(biāo)簽，含有對(duì)象結(jié)構(gòu)體的數(shù)組以<OutputArrayLi