家譜開放數(shù)據(jù)接口培訓(xùn)

1、家譜開放數(shù)據(jù) 接口說(shuō)明 培訓(xùn)人：陳尚松 上海圖書館家譜開放數(shù)據(jù)接口目前提供以下兩種形式的數(shù)據(jù)接口一，家譜開放數(shù)據(jù)接口目前提供以下三種形式的數(shù)據(jù)接口1.通過(guò)訪問(wèn)資源URI獲取數(shù)據(jù)：根據(jù)標(biāo)準(zhǔn)API接口，通過(guò)訪問(wèn)單個(gè)資源的URI，獲得該資源的所有RDF三元組(屬性和值)數(shù)據(jù)接口形式12. 通過(guò)查詢接口獲取特定類型的數(shù)據(jù)：通過(guò)特定API接口，獲取“姓氏”、“先祖名人”、“地點(diǎn)”、“機(jī)構(gòu)”、“朝代”、“書目”的數(shù)據(jù)。（每次最多取得20條數(shù)據(jù)）數(shù)據(jù)接口形式23. 通過(guò)Sparql Endpoint獲取數(shù)據(jù)。數(shù)據(jù)接口形式3上海圖書館上海圖書館特別說(shuō)明 使用家譜開放數(shù)據(jù)接口時(shí)需要提供APIKey進(jìn)行驗(yàn)證。開發(fā)

2、人員請(qǐng)?jiān)谏虾D書館數(shù)據(jù)開放平臺(tái)進(jìn)行用戶注冊(cè)，并獲取獨(dú)立的APIKey。注冊(cè)網(wǎng)址：http:/ http:/ http:/ literial性別family URI家族URIchildOf URI父親URIspouseOf URI配偶URIgenealogyName literial譜名（人在家譜上記載的譜名。）courtesyName literial字pseudonym literial號(hào)orderOfSeniority literial排行g(shù)enerationCharacter literial字輩posthumousTitle literial謚號(hào)birthday literial生于d

3、eathday literial卒于descriptionliterial人物描述temporalValueliterial朝代描述temporalURI朝代URI返回屬性說(shuō)明：上海圖書館2.通過(guò)查詢接口獲取特定類型的數(shù)據(jù)（3）地名功能：輸入地名，獲取對(duì)應(yīng)的資源數(shù)據(jù)。數(shù)據(jù)匹配方式為完全匹配。API接口：http:/ result: data: 13681644, uri: http:/ 上海圖書館2.通過(guò)查詢接口獲取特定類型的數(shù)據(jù)輸入方式2：參數(shù)1：朝代紀(jì)年。參數(shù)2：用戶的APIKey輸出：公元年的JSON-LD數(shù)據(jù)（數(shù)組格式）例如：輸入：http:/ result: data: 1369,

4、uri: http:/ 上海圖書館2.通過(guò)查詢接口獲取特定類型的數(shù)據(jù)輸入方式3：參數(shù)1：公元年。參數(shù)2：用戶的APIKey輸出：朝代紀(jì)年的JSON-LD數(shù)據(jù)（數(shù)組格式）例如：輸入：http:/ result: data: 明,元至正29年,明2年,明洪武2年, uri: http:/ 上海圖書館2.通過(guò)查詢接口獲取特定類型的數(shù)據(jù)輸入方式4：參數(shù)1：朝代。參數(shù)2：用戶的APIKey輸出：朝代紀(jì)年的JSON-LD數(shù)據(jù)（數(shù)組格式）例如：輸入：http:/ http:/ data: uri: http:/ label: 夏, end: , begin: -1989 , uri: http:/ labe

5、l: 商, end: , begin: -1559 , . 上海圖書館返回屬性說(shuō)明：屬性類型說(shuō)明labelliterial朝代名稱beginliterial朝代開始時(shí)間endliterial朝代截止時(shí)間dynastyliterial朝代monarchliterial帝王monarchNameliterial帝王姓名reignTitleliterial年號(hào)上海圖書館2.通過(guò)查詢接口獲取特定類型的數(shù)據(jù)（6）書目數(shù)據(jù)功能：輸入題名、責(zé)任者、姓氏、先祖名人姓名、譜籍地名、堂號(hào)、館藏機(jī)構(gòu)、摘要中的關(guān)鍵詞的任意組合，返回所有匹配的家譜數(shù)據(jù)。數(shù)據(jù)匹配方式為模糊匹配。API接口：http:/ (http:/

6、(http:/ Endpoint獲取數(shù)據(jù)地址：http:/:8890/sparql輸入：SPARQL查詢語(yǔ)句輸出：HTML, RDF/XML, JSON, Turtle等如：graph：http:/ *where ?p ?o上海圖書館輸出結(jié)果上海圖書館三、JSON-LD解析（以 JAVA 為例）A、服務(wù)器端將數(shù)據(jù)轉(zhuǎn)換成json字符串 首先、服務(wù)器端項(xiàng)目要導(dǎo)入json的jar包和json所依賴的jar包至builtPath路徑下（這些可以到JSON-lib官網(wǎng)下載：http:/json- JAVA 為例）核心函數(shù)是： public static String createJsonString(S

7、tring key, Object value) JSONObject jsonObject = new JSONObject(); jsonObject.put(key, value); return jsonObject.toString(); B、客戶端將json字符串轉(zhuǎn)換為相應(yīng)的javaBean基本思路：1、客戶端獲取json字符串（HttpURLConnection ，GET方式）。核心代碼如下：上海圖書館三、JSON-LD解析（以 JAVA 為例）上海圖書館三、JSON-LD解析（以 JAVA 為例）上海圖書館三、JSON-LD解析（以 JAVA 為例）2、獲取javaBean上海圖書館綜述該數(shù)據(jù)平臺(tái)接口