1. Cordra服务端下载使用（windows系统下）

  1. 下载地址：cordra-2.3.0
  2. 部署Cordra时有很多选项可配置。最简单的是一个独立的Cordra服务，它使用本地文件系统存储bdbje和一个嵌入式索引器lucene。同时也是默认的模式配置，默认模式方便用来测试Cordra功能或使用Cordra构建任何应用程序。

  3. 解压下载的zip文件，进入cordra-2.3.0\data路径下，修改repoInit.json初始配置文件，设置初始的密码和标识句柄前缀，从该前缀将生成唯一标识符；如果不设置前缀，则默认情况下将使用测试用前缀来创建对象。

    1. {
    2.  "adminPassword": "admin123",
    3.  "prefix": "86.1234.abc.TEST"
    4. }

  4. 回退到cordra-2.3.0路径下，点击startup.bat启动服务，可以看到服务的访问路径http://127.0.0.1:8080/和https协议的访问路径https://127.0.0.1:8443

1626142570565_5B3E2155-BF3C-402a-B640-6F5E590F0602.png

  1. 写一个java测试项目，springboot框架工具下导入pom依赖。因cordra包内的httpclient需要较高版本，最好带上对应的httpclient依赖，避免和spring-boot-starter-web依赖起冲突；gson依赖同理

    1. <dependency>
    2. <groupId>net.cnri.cordra</groupId>
    3. <artifactId>cordra-client</artifactId>
    4. <version>2.2.0</version>
    5. </dependency>
    6. <dependency>
    7. <groupId>org.apache.httpcomponents</groupId>
    8. <artifactId>httpclient</artifactId>
    9. <version>4.5.12</version>
    10. </dependency>
    11. <dependency>
    12. <groupId>com.google.code.gson</groupId>
    13. <artifactId>gson</artifactId>
    14. <version>2.8.6</version>
    15. </dependency>

  2. application.properties配置启动端口号，因为8080被cordra服务占用，改用其它端口号，如8081；另外因为使用了gson，所以需要配置对应的spring转换配置

    1. server.port=8081
    2. spring.http.converters.preferred-json-mapper=gson
    3. #Spring Boot >= 2.3.0.RELEASE情况下用下面配置
    4. #spring.mvc.converters.preferred-json-mapper=gson

  3. 写一段Restful风格测试代码，CRUD数字对象 ```java package com.dtdream.test.cordra;

import net.cnri.cordra.api.CordraClient; import net.cnri.cordra.api.CordraException; import net.cnri.cordra.api.CordraObject; import net.cnri.cordra.api.SearchResults; import net.cnri.cordra.api.TokenUsingHttpCordraClient; import org.springframework.web.bind.annotation.DeleteMapping; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.PutMapping; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController;

import java.util.List; import java.util.stream.Collectors;

@RestController public class CordraController {

  1. static CordraClient cordra;
  3. static {
  4.     try {
  5.         cordra = new TokenUsingHttpCordraClient("https://127.0.0.1:8443", "admin", "admin123");
  6.     } catch (CordraException e) {
  7.         e.printStackTrace();
  8.     }
  9. }
  11. /**
  12.  * 新增
  13.  *
  14.  * @param
  15.  * @return
  16.  */
  17. @PostMapping
  18. public CordraObject create(@RequestBody CordraObject cordraObject) throws CordraException {
  19.     return cordra.create(cordraObject);
  20. }
  22. /**
  23.  * 获取单个对象
  24.  *
  25.  * @param
  26.  * @return
  27.  */
  28. @GetMapping
  29. public CordraObject get(@RequestParam String id) throws CordraException {
  30.     return cordra.get(id);
  31. }
  33. /**
  34.  * 获取所有对象
  35.  *
  36.  * @param
  37.  * @return
  38.  */
  39. @GetMapping("all")
  40. public List<CordraObject> getAll() throws CordraException {
  41.     SearchResults<CordraObject> results = cordra.search("*:*");
  42.     return results.stream().collect(Collectors.toList());
  43. }
  45. /**
  46.  * 更新单个对象
  47.  *
  48.  * @param
  49.  * @return
  50.  */
  51. @PutMapping
  52. public CordraObject update(@RequestBody CordraObject cordraObject) throws CordraException {
  53.     return cordra.update(cordraObject);
  54. }
  56. /**
  57.  * 删除单个对象
  58.  *
  59.  * @param
  60.  * @return
  61.  */
  62. @DeleteMapping
  63. public CordraObject delete(@RequestParam String id) throws CordraException {
  64.     cordra.delete(id);
  65.     return cordra.get(id);
  66. }

}

  2. 8. postman访问接口进行结果验证
  4. #新建对象<br />![image.png](https://cdn.nlark.com/yuque/0/2021/png/22093066/1626156148262-e29082d7-b68d-4d1e-ae26-a7db03d6b48e.png#clientId=u07e33d78-6b25-4&from=paste&height=706&id=uffce7a28&margin=%5Bobject%20Object%5D&name=image.png&originHeight=706&originWidth=610&originalType=binary&ratio=1&size=47752&status=done&style=none&taskId=u8ff0a6be-8441-49b3-bcc5-9a48d02de1b&width=610)<br />#获取单个对象<br />![image.png](https://cdn.nlark.com/yuque/0/2021/png/22093066/1626156207591-dddc8c65-9326-4f58-809e-c11042aadb8d.png#clientId=u07e33d78-6b25-4&from=paste&height=693&id=u097246bb&margin=%5Bobject%20Object%5D&name=image.png&originHeight=693&originWidth=607&originalType=binary&ratio=1&size=42681&status=done&style=none&taskId=u25ba3dc9-827d-40c3-a27a-4a56218ecef&width=607)<br />#更新对象<br />![image.png](https://cdn.nlark.com/yuque/0/2021/png/22093066/1626156284115-a1db6fa6-b060-45dd-8e6e-fb897eaf059b.png#clientId=u07e33d78-6b25-4&from=paste&height=681&id=u8b8ae7db&margin=%5Bobject%20Object%5D&name=image.png&originHeight=681&originWidth=613&originalType=binary&ratio=1&size=46592&status=done&style=none&taskId=uae6b3bda-b60b-4570-a3e9-9fd9cc44e74&width=613)<br />#删除对象<br />![image.png](https://cdn.nlark.com/yuque/0/2021/png/22093066/1626156340161-42532c81-5b40-4631-ad34-81da6eb5ba9e.png#clientId=u07e33d78-6b25-4&from=paste&height=448&id=u61cdc279&margin=%5Bobject%20Object%5D&name=image.png&originHeight=448&originWidth=610&originalType=binary&ratio=1&size=26515&status=done&style=none&taskId=u1f4ce95a-e0e5-49cd-91b6-d6701fb4c23&width=610)<br />#获取所有对象http://localhost:8081/all，结果包含几个建立的系统数据对象，【id=test/123】的是另一个测试数据
  5. ```json
  6. [
  7.     {
  8.         "id": "86.1234.abc.TEST/0cbd3f8ad53a8f1d8209",
  9.         "type": "Schema",
  10.         "content": {
  11.             "identifier": "86.1234.abc.TEST/0cbd3f8ad53a8f1d8209",
  12.             "name": "Document",
  13.             "schema": {
  14.                 "type": "object",
  15.                 "title": "Document",
  16.                 "required": [
  17.                     "id"
  18.                 ],
  19.                 "properties": {
  20.                     "id": {
  21.                         "type": "string",
  22.                         "cordra": {
  23.                             "type": {
  24.                                 "autoGeneratedField": "handle"
  25.                             }
  26.                         }
  27.                     },
  28.                     "name": {
  29.                         "type": "string",
  30.                         "title": "Name",
  31.                         "cordra": {
  32.                             "preview": {
  33.                                 "showInPreview": true,
  34.                                 "isPrimary": true
  35.                             }
  36.                         }
  37.                     },
  38.                     "description": {
  39.                         "type": "string",
  40.                         "format": "textarea",
  41.                         "title": "Description",
  42.                         "cordra": {
  43.                             "preview": {
  44.                                 "showInPreview": true
  45.                             }
  46.                         }
  47.                     },
  48.                     "creationDate": {
  49.                         "type": "string",
  50.                         "title": "Creation Date",
  51.                         "cordra": {
  52.                             "type": {
  53.                                 "autoGeneratedField": "creationDate"
  54.                             }
  55.                         }
  56.                     },
  57.                     "modificationDate": {
  58.                         "type": "string",
  59.                         "title": "Modification Date",
  60.                         "cordra": {
  61.                             "preview": {
  62.                                 "showInPreview": true
  63.                             },
  64.                             "type": {
  65.                                 "autoGeneratedField": "modificationDate"
  66.                             }
  67.                         }
  68.                     },
  69.                     "createdBy": {
  70.                         "type": "string",
  71.                         "title": "Created By",
  72.                         "cordra": {
  73.                             "type": {
  74.                                 "autoGeneratedField": "createdBy"
  75.                             }
  76.                         }
  77.                     },
  78.                     "modifiedBy": {
  79.                         "type": "string",
  80.                         "title": "Modified By",
  81.                         "cordra": {
  82.                             "type": {
  83.                                 "autoGeneratedField": "modifiedBy"
  84.                             }
  85.                         }
  86.                     }
  87.                 }
  88.             }
  89.         },
  90.         "metadata": {
  91.             "createdOn": 1626142554573,
  92.             "createdBy": "admin",
  93.             "modifiedOn": 1626142554573,
  94.             "modifiedBy": "admin",
  95.             "txnId": 1626142554541005
  96.         }
  97.     },
  98.     {
  99.         "id": "86.1234.abc.TEST/fe13890f0aed2e634da6",
  100.         "type": "Schema",
  101.         "content": {
  102.             "identifier": "86.1234.abc.TEST/fe13890f0aed2e634da6",
  103.             "name": "User",
  104.             "schema": {
  105.                 "type": "object",
  106.                 "required": [
  107.                     "id",
  108.                     "username",
  109.                     "password"
  110.                 ],
  111.                 "properties": {
  112.                     "id": {
  113.                         "type": "string",
  114.                         "cordra": {
  115.                             "type": {
  116.                                 "autoGeneratedField": "handle"
  117.                             }
  118.                         }
  119.                     },
  120.                     "username": {
  121.                         "type": "string",
  122.                         "title": "Username",
  123.                         "cordra": {
  124.                             "preview": {
  125.                                 "showInPreview": true,
  126.                                 "isPrimary": true
  127.                             },
  128.                             "auth": "username"
  129.                         }
  130.                     },
  131.                     "password": {
  132.                         "type": "string",
  133.                         "format": "password",
  134.                         "title": "Password",
  135.                         "cordra": {
  136.                             "auth": "password"
  137.                         }
  138.                     },
  139.                     "requirePasswordChange": {
  140.                         "type": "boolean",
  141.                         "title": "Require Password Change",
  142.                         "description": "If true a new password must be set on next authentication.",
  143.                         "cordra": {
  144.                             "auth": "requirePasswordChange"
  145.                         }
  146.                     }
  147.                 }
  148.             },
  149.             "javascript": "exports.beforeSchemaValidation = beforeSchemaValidation;\n\nfunction beforeSchemaValidation(obj, context) {\n    if (!context.useLegacyContentOnlyJavaScriptHooks) {\n        obj.content = beforeSchemaValidationLegacy(obj.content, context);\n        return obj;\n    } else {\n        return beforeSchemaValidationLegacy(obj, context);\n    }\n}\n\nfunction beforeSchemaValidationLegacy(obj, context) {\n    if (!obj.id) obj.id = \"\";\n    if (!obj.password) obj.password = \"\";\n    var password = obj.password;\n    if (context.isNew || password) {\n        if (password.length < 8) {\n            throw \"Password is too short. Min length 8 characters\";\n        }\n    }\n    return obj;\n}\n"
  150.         },
  151.         "metadata": {
  152.             "createdOn": 1626142554295,
  153.             "createdBy": "admin",
  154.             "modifiedOn": 1626142554295,
  155.             "modifiedBy": "admin",
  156.             "txnId": 1626142554262003
  157.         }
  158.     },
  159.     {
  160.         "id": "86.1234.abc.TEST/fec9da465d2c680caf42",
  161.         "type": "Schema",
  162.         "content": {
  163.             "identifier": "86.1234.abc.TEST/fec9da465d2c680caf42",
  164.             "name": "Group",
  165.             "schema": {
  166.                 "type": "object",
  167.                 "required": [
  168.                     "id",
  169.                     "groupName",
  170.                     "description"
  171.                 ],
  172.                 "properties": {
  173.                     "id": {
  174.                         "type": "string",
  175.                         "cordra": {
  176.                             "type": {
  177.                                 "autoGeneratedField": "handle"
  178.                             }
  179.                         }
  180.                     },
  181.                     "groupName": {
  182.                         "type": "string",
  183.                         "title": "Group Name",
  184.                         "cordra": {
  185.                             "preview": {
  186.                                 "showInPreview": true,
  187.                                 "isPrimary": true
  188.                             }
  189.                         }
  190.                     },
  191.                     "description": {
  192.                         "type": "string",
  193.                         "format": "textarea",
  194.                         "maxLength": 2048,
  195.                         "title": "Description",
  196.                         "cordra": {
  197.                             "preview": {
  198.                                 "showInPreview": true,
  199.                                 "excludeTitle": true
  200.                             }
  201.                         }
  202.                     },
  203.                     "users": {
  204.                         "type": "array",
  205.                         "format": "table",
  206.                         "title": "Users",
  207.                         "uniqueItems": true,
  208.                         "items": {
  209.                             "type": "string",
  210.                             "title": "User",
  211.                             "cordra": {
  212.                                 "type": {
  213.                                     "handleReference": {
  214.                                         "types": [
  215.                                             "User",
  216.                                             "Group"
  217.                                         ]
  218.                                     }
  219.                                 }
  220.                             }
  221.                         },
  222.                         "cordra": {
  223.                             "auth": "usersList"
  224.                         }
  225.                     }
  226.                 }
  227.             }
  228.         },
  229.         "metadata": {
  230.             "createdOn": 1626142554462,
  231.             "createdBy": "admin",
  232.             "modifiedOn": 1626142554462,
  233.             "modifiedBy": "admin",
  234.             "txnId": 1626142554429004
  235.         }
  236.     },
  237.     {
  238.         "id": "test/123",
  239.         "type": "Document",
  240.         "content": {
  241.             "id": "test/123",
  242.             "name": "first example name",
  243.             "description": "The first test data"
  244.         },
  245.         "metadata": {
  246.             "createdOn": 1626154301602,
  247.             "createdBy": "admin",
  248.             "modifiedOn": 1626154301602,
  249.             "modifiedBy": "admin",
  250.             "txnId": 1626154301607000
  251.         }
  252.     }
  253. ]