java - 如何通过 REST 在 Sakai 中获取作业的内容

Question

在Sakai中，我通过url成功获取到一个Assignemnt:http://xxx/direct/assignment/ASSIGNMENTID.xml。但是，在这个实体中，没有详细的上下文(我的意思是，老师对作业的指示)。 XML 中只有一个内容 contentReference 元素。

<contentReference>/assignment/c/mercury/b0de53c7-09b6-4ba0-964b-cb0a9e5a028d</contentReference>

当我访问此链接时，出现 404 错误:

试图访问不存在的实体 (/assignment/c) 的实体 URL 路径 (/assignment/c/mercury/b0de53c7-09b6-4ba0-964b-cb0a9e5a028d)

我尝试用 Google 搜索 Sakai 实体上的 API 文档，但结果发现它已过时(我的 Sakai 2.9.3 演示版中的某些 url 是错误的)。然后我尝试深入研究 Sakai 的源代码。然而，我发现的只是 rsmart 服务器上的一个文件:

• AssignmentEntityProvider.java :

  https://source.sakaiproject.org/websvn/filedetails.php?repname=sakai-svn&path=%2Fmsub%2Frsmart.com%2Fassignment%2Ftrunk%2Fassignment-tool%2Ftool%2Fsrc%2Fjava%2Forg%2Fsakaiproject%2Fassignment%2Fentityproviders%2FAssignmentEntityProvider.java&peg=131026

在里面我发现:

        throw new IllegalArgumentException(
                "Must include context and assignmentId in the path ("
                        + view
                        + "): e.g. /assignment/a/{context}/{assignmentId}");

我尝试在我的服务器上使用这个 URL 来获取详细的内容(尤其是老师的指导)。又是一个404错误，内容同上。

最后发现/assignment/a/可能是/assignment/annc/{context}/{assignmentId}的拼写错误。所以现在我发送:

http://localhost:8080/direct/assignment/annc/mercury/403d28b4-e152-463d-a615-972db97d34d3.xml

弹出另一个错误:

HTTP 状态 500 - EntityEncodingException:无法处理此路径的格式 xml 的输出请求 (/assignment/annc/mercury/403d28b4-e152-463d-a615-972db97d34d3.xml) 实体 (/assignment) 的前缀(赋值)/annc), 请求 url (/assignment/annc/mercury/403d28b4-e152-463d-a615-972db97d34d3.xml): 实体内部输出编码失败:/assignment/annc

关于通过 RESTful 获取教师教学数据的 url 有什么想法吗？谢谢。

---

作业的 XML 数据。

<assignment type='bean' size='29'>
  <access type='bean' size='0'>
  </access>
  <attachments type='collection' size='1'>
    <decoratedattachment type='bean' size='2'>
      <name>LC Circuit (show name).png</name>
      <url>http://localhost:8080/access/content/attachment/mercury/%E4%BD%9C%E4%B8%9A/a11ef34a-0578-433a-ba7e-9c3bad948bf5/1111.png</url>
    </decoratedattachment>
  </attachments>
  <authorLastModified>admin</authorLastModified>
  <authors type='collection' size='0'>
  </authors>
  <closeTime type='bean' size='2'>
    <display>2014-9-12 下午5:00</display>
    <time type='number'>1410512400000</time>
  </closeTime>
  <closeTimeString>2014-9-12 下午5:00</closeTimeString>
  <content/>
  <contentReference>/assignment/c/mercury/b0de53c7-09b6-4ba0-964b-cb0a9e5a028d</contentReference>
  <context>mercury</context>
  <creator>admin</creator>
  <dropDeadTime type='bean' size='2'>
    <display>2014-8-12 下午5:00</display>
    <time type='number'>1407834000000</time>
  </dropDeadTime>
  <dropDeadTimeString>2014-8-12 下午5:00</dropDeadTimeString>
  <dueTime type='bean' size='2'>
    <display>2014-8-12 下午5:00</display>
    <time type='number'>1407834000000</time>
  </dueTime>
  <dueTimeString>2014-8-12 下午5:00</dueTimeString>
  <groups type='collection' size='0'>
  </groups>
  <id>403d28b4-e152-463d-a615-972db97d34d3</id>
  <openTime type='bean' size='2'>
    <display>2014-5-5 下午12:00</display>
    <time type='number'>1399262400000</time>
  </openTime>
  <openTimeString>2014-5-5 下午12:00</openTimeString>
  <position_order type='number'>0</position_order>
  <section></section>
  <status>开始</status>
  <timeCreated type='bean' size='2'>
    <display>2014-5-5 上午11:33</display>
    <time type='number'>1399260782158</time>
  </timeCreated>
  <timeLastModified type='bean' size='2'>
    <display>2014-5-6 上午8:46</display>
    <time type='number'>1399337194163</time>
  </timeLastModified>
  <title>A test assign</title>
  <draft type='boolean'>false</draft>
  <entityReference>/assignment/403d28b4-e152-463d-a615-972db97d34d3</entityReference>
  <entityURL>http://localhost:8080/direct/assignment/403d28b4-e152-463d-a615-972db97d34d3</entityURL>
  <entityId>403d28b4-e152-463d-a615-972db97d34d3</entityId>
  <entityTitle>A test assign</entityTitle>
</assignment>

Answer 1

注意:此答案适用于 Sakai 10。如果您使用的是旧版本，则需要手动添加一些已在 Keitai 项目 (https://jira.sakaiproject.org/browse/SAK-23358) 中添加的新功能。

使用 Sakai 10.x 每晚服务器:

http://nightly2.sakaiproject.org:8081/portal

以及具有以下 ID 的站点:

61a1ebbd-e507-4ca3-8f88-65abca0803d9

此 URL 将获取类(class)中作业的列表:

http://nightly2.sakaiproject.org:8081/direct/assignment/site/61a1ebbd-e507-4ca3-8f88-65abca0803d9.json

(返回如下所示的 JSON)

{"entityPrefix": "assignment", "assignment_collection": [
{
  "access": {
  },
  "attachments": [],
  "authorLastModified": "admin",
  "authors": [],
  "closeTime": {
    "display": "Jun 11, 2014 5:00 pm",
    "time": 1402520400000
  },
  "closeTimeString": "Jun 11, 2014 5:00 pm",
  "content": null,
  "contentReference": "\/assignment\/c\/61a1ebbd-e507-4ca3-8f88-65abca0803d9\/1fd9f025-2974-48d1-bcb5-ef47c4e89a30",
  "context": "61a1ebbd-e507-4ca3-8f88-65abca0803d9",
  "creator": "admin",
  "dropDeadTime": {
    "display": "Jun 11, 2014 5:00 pm",
    "time": 1402520400000
  },
  "dropDeadTimeString": "Jun 11, 2014 5:00 pm",
  "dueTime": {
    "display": "Jun 11, 2014 5:00 pm",
    "time": 1402520400000
  },
  "dueTimeString": "Jun 11, 2014 5:00 pm",
  "groups": [],
  "id": "8d96871c-8dcb-4963-b74a-f478dee53142",
  "instructions": "<p>This is an assignment<\/p>",
  "openTime": {
    "display": "Jun 4, 2014 12:00 pm",
    "time": 1401897600000
  },
  "openTimeString": "Jun 4, 2014 12:00 pm",
  "position_order": 0,
  "section": "",
  "status": "Open",
  "timeCreated": {
    "display": "Jun 4, 2014 11:30 pm",
    "time": 1401939011264
  },
  "timeLastModified": {
    "display": "Jun 4, 2014 11:30 pm",
    "time": 1401939011286
  },
  "title": "AZ assignment",
  "draft": false,
  "entityReference": "\/assignment\/8d96871c-8dcb-4963-b74a-f478dee53142",
  "entityURL": "http:\/\/nightly2.sakaiproject.org:8081\/direct\/assignment\/8d96871c-8dcb-4963-b74a-f478dee53142",
  "entityId": "8d96871c-8dcb-4963-b74a-f478dee53142",
  "entityTitle": "AZ assignment"
}
]}

从那里你可以在列表中找到分配的 id(也可以通过其他方式获得)，然后像这样返回单个分配的数据:

http://nightly2.sakaiproject.org:8081/direct/assignment/item/8d96871c-8dcb-4963-b74a-f478dee53142.json

(返回如下所示的 JSON)

{
  "access": {
  },
  "attachments": [],
  "authorLastModified": "admin",
  "authors": [],
  "closeTime": {
    "display": "Jun 11, 2014 5:00 pm",
    "time": 1402520400000
  },
  "closeTimeString": "Jun 11, 2014 5:00 pm",
  "content": null,
  "contentReference": "\/assignment\/c\/61a1ebbd-e507-4ca3-8f88-65abca0803d9\/1fd9f025-2974-48d1-bcb5-ef47c4e89a30",
  "context": "61a1ebbd-e507-4ca3-8f88-65abca0803d9",
  "creator": "admin",
  "dropDeadTime": {
    "display": "Jun 11, 2014 5:00 pm",
    "time": 1402520400000
  },
  "dropDeadTimeString": "Jun 11, 2014 5:00 pm",
  "dueTime": {
    "display": "Jun 11, 2014 5:00 pm",
    "time": 1402520400000
  },
  "dueTimeString": "Jun 11, 2014 5:00 pm",
  "groups": [],
  "id": "8d96871c-8dcb-4963-b74a-f478dee53142",
  "instructions": "<p>This is an assignment<\/p>",
  "openTime": {
    "display": "Jun 4, 2014 12:00 pm",
    "time": 1401897600000
  },
  "openTimeString": "Jun 4, 2014 12:00 pm",
  "position_order": 0,
  "section": "",
  "status": "Open",
  "timeCreated": {
    "display": "Jun 4, 2014 11:30 pm",
    "time": 1401939011264
  },
  "timeLastModified": {
    "display": "Jun 4, 2014 11:30 pm",
    "time": 1401939011286
  },
  "title": "AZ assignment",
  "draft": false,
  "entityReference": "\/assignment\/8d96871c-8dcb-4963-b74a-f478dee53142",
  "entityURL": "http:\/\/nightly2.sakaiproject.org:8081\/direct\/assignment\/8d96871c-8dcb-4963-b74a-f478dee53142",
  "entityId": "8d96871c-8dcb-4963-b74a-f478dee53142",
  "entityTitle": "AZ assignment"
}