服務(wù)器接口參考手冊(cè)

?1993-2014科技保護(hù)說明商?1993-2014科技。TongTech、TongLINK/Q、TongEASY、TongWeb、TongIntegrator、TongSEC、TongWorkflow、GTP、MBP是科技的商標(biāo)。其他所有的公司和產(chǎn)品名稱可能為第所有。前閱讀對(duì)象TongIntegrator系統(tǒng)的產(chǎn)品手冊(cè)，面向使用TongIntegrator系統(tǒng)的用戶，及任何對(duì)文檔約定TIETL：TongIntegratorETLTIETLStudio：TongIntegratorETLStudio的縮寫，TongIntegratorETL系統(tǒng)集成開第1 基于HTTP+XML方式接口調(diào)用示 基于JavaAPI方式接口調(diào)用示 第2 接 2.2.1 工具 第1章TongIntegratorETLTongIntegratorETL為用戶提供服務(wù)器的管理接口，用戶可以通過調(diào)用這些接口，按照自己的意愿，定制開發(fā)對(duì)TongIntegratorETL系統(tǒng)的管理頁面，并且集成到自TongIntegratorETL服務(wù)器的接口以網(wǎng)絡(luò)協(xié)議接口的方式開放，使用HTTP作為傳輸協(xié)議，使用XML作為傳送消息的格式?；贖TTP+XMLHTTP應(yīng)答消息的XML基于JavaAPIXMLJavaJavaAPI的方式供用戶調(diào)用。需的工具類。這些都是基于HTTP+XML的方式的接口調(diào)用必須要了解的。接口使用指南基本概念為了幫助理解后面的內(nèi)容，下面對(duì)TongIntegratorETLETL服務(wù)器是運(yùn)行TIETL的任務(wù)和轉(zhuǎn)換的容器，任務(wù)和轉(zhuǎn)換可以部署到服務(wù)或轉(zhuǎn)換的操作都將需要對(duì)象ID。TIETL使用任務(wù)和轉(zhuǎn)換的定義，在TIETL服務(wù)器中，將從 名+名稱，和中的ID。Preparing

10接口功能介紹√√√√√√√√√√√√接口形式輸協(xié)議，使用XML作為傳送消息的格式?；贘avaAPI的方式，這種方式是TIETL針對(duì)上面式的不便利之處，對(duì)生成請(qǐng)求XML數(shù)據(jù)包，解析應(yīng)答XML數(shù)據(jù)包進(jìn)行了Java封裝，直接提供JavaAPI接口使用HTTP協(xié)議來進(jìn)行網(wǎng)絡(luò)通訊。主要使用GETPOSTXML不帶名字空間，使用的類型也不是XMLSchema中定義的標(biāo)準(zhǔn)類型。使用的主要數(shù)據(jù)()10進(jìn)制雙精度浮點(diǎn)數(shù)，可用java.lang.Double()使用該接口需要HTTP客戶端HTTP服務(wù)器，使用XML工具生成和解析XML。在下面示例中，將以Java平臺(tái)為例，說明具體如何使用?；?方式接口調(diào)用示HTTP客戶端工具，用于以HTTP形式提供的接口，本示例使用了ApacheCommons的HTTPClient（）XMLJavaJavaDOM類（org.w3c.dom包）或其的xstream，很方便將XML元素和Java對(duì)象進(jìn)行序列化和反序列化。（TIETL服務(wù)器工具類所需要的包。如果使用TIETL新的版本，則需要從TIETL安裝下的 和 TIETL服務(wù)器工具類所需要的包。如果使用TIETL新的版本，則需要從TIETL安裝下的 和 所有的屬性都提供getter和setter。1通過接口調(diào)用，進(jìn)行啟動(dòng)已經(jīng)部署在TIETL服務(wù)器上的某一轉(zhuǎn)換。可參見privateprivateWebResultstartTrans(StringtransName,String{WebResultwebResult=SimpleHTTPClientclient=newtryStringservice="/tietl/startTrans"+"/""?xml=Y""&name="+"UTF-8")"&id="+Stringxml=client.executeHTTPGet(service);System.out.println("xml:"+xml);webResult=(WebResult)xstream.fromXML(xml);}catch(Exceptione)//TODOAuto-generatedcatchblock}returnreturn}?xml=Y，指定返回結(jié)果為XML&id=…，指定轉(zhuǎn)換在服務(wù)器中的ID。3、執(zhí)行HTTPGet方法，獲得返回的XML字符串。4、通過XstreamXML轉(zhuǎn)換為WebResult類。2privateTransStatusprivateTransStatusgetTransStatus(StringtransName,String{TransStatustranStatus=SimpleHTTPClientclient=newtryStringurl="/tietl/transStatus"+"/"+"?xml=Y"+ "UTF-8")"&id="+Stringxml=client.executeHTTPGet(url);System.out.println("xml:"+xml);tranStatus=}catch(Exceptione)//TODOAuto-generatedcatchblock}return}?xml=Y，指定返回結(jié)果為XML&id=…，指定轉(zhuǎn)換在服務(wù)器中的ID。3、執(zhí)行HTTPGet方法，獲得返回的XML字符串。4、通過XstreamXML轉(zhuǎn)換為TransStatus類。StringgzippedLogString=StringlogStringStringgzippedLogString=StringlogString3publicpublictransConfig){WebResultwebResult=SimpleHTTPClientclient=newtryStringservice="/tietl/addTrans"+"/"+=webResult=}catch(Exception{}return}在 ?xml=Y，指定返回結(jié)果為XML3、執(zhí)行HTTPPost方法，獲得返回的XML4XstreamXMLWebResultTransConfigtransConfig=newTransReftransRef=newTransRef();TransConfigtransConfig=newTransReftransRef=newTransRef();TransExecConfigexecConfig=newTransExecConfig();Repositoryrepository=newRepository();; Repository，信息，包括名稱、用戶名和。這里采取為Java對(duì)象。這些方法的返回值為XML字符串。NoNameCodernameCoderNoNameCodernameCoder=newxstream=newXStream(newDomDriver("UTF-8",nameCoder));（AnnoationJavaAPI方式接口調(diào)用示例基于JavaAPI的方式的接口調(diào)用比較簡(jiǎn)單，只需要?jiǎng)?chuàng)建一個(gè)TIETLServerClient實(shí)例，publicstaticvoidmain(String[]args)throwsIOException//創(chuàng)建TIETLServerClientTIETLServerClientpublicstaticvoidmain(String[]args)throwsIOException//創(chuàng)建TIETLServerClientTIETLServerClienttietlServerClient=//部署轉(zhuǎn)換流//首先構(gòu)造transConfigTransConfigtransConfig=newWebResultaddWebResult=////WebResultstartWebResult=//TransStatustransStatus=StringstatusDesc=}2addTrans方法部署轉(zhuǎn)換（transConfigHTTP+XML方式HTTP+XML方式的“部署轉(zhuǎn)換”部分WebResult獲返回的WebResult獲取是否成功啟動(dòng)的信息。TIETL服務(wù)器工具類所需要的包。如果使用TIETL新的版本，則需要從TIETL安裝 和TIETL服務(wù)器工具類所需要的包。如果使用TIETL新的版本，則需要從TIETL安裝 和 TIETL安 基于JavaAPIjar第2章TongIntegratorETL本章詳細(xì)介紹基于HTTP+XMLHTTP命令格式、各個(gè)命令對(duì)應(yīng)的HTTP請(qǐng)求/XML類型、以及所需的工具類?；贘avaAPI方式的接口詳細(xì)說明，請(qǐng)參見安裝路徑下的javadoc。接TongIntegratorETL服務(wù)器的接口所管理的資源對(duì)象，主要分為三類：服務(wù)器、任務(wù)和GETPOSTGETGETGETGETPOSTGETGETGETGETGET獲取服務(wù)器狀NY/NXML元素，參見部署任務(wù)NY/NXML>刪除任務(wù)NY/NXMLYN啟動(dòng)任務(wù)NY/NXMLYN停止任務(wù)NY/NXMLYN獲取任務(wù)狀態(tài)NY/NXMLYNN部署轉(zhuǎn)換NY/NXML>刪除轉(zhuǎn)換NY/NXMLYN啟動(dòng)轉(zhuǎn)換NY/NXMLYN停止轉(zhuǎn)換NY/NXMLYN暫停/恢NY/NXMLYN獲取轉(zhuǎn)換狀態(tài)NY/NXMLYNN獲取所有用戶新增用戶YY。修改用戶的YY刪除用戶Y查詢服務(wù)器配置信息>修改服務(wù)器配置信息YYYNNNNNNNNNYNRowlevel。缺省值為Basic。NN添加主服務(wù)器YYYNYY修改主服務(wù)器YYYYNYY刪除主服務(wù)器Y消息格基于HTTP協(xié)議的管理接口，各個(gè)接口的請(qǐng)求/XML格式進(jìn)行封裝。本小節(jié)介紹各個(gè)接口涉及到的XM