Source for file ItemTaken.php

Documentation is available at ItemTaken.php

  1. <?php
  2. /**
  3. * ItemTaken includes the Item, the Submitted Response, and any Evaluation of
  4. * the SubmittedResponse. There is also any supporting data.
  5. *
  6. * <p>
  7. * OSID Version: 2.0
  8. * </p>
  9. *
  10. * <p>
  11. * Licensed under the {@link org.osid.SidImplementationLicenseMIT MIT}
  12. * O.K.I&#46; OSID Definition License}.
  13. * </p>
  14. *
  15. * @package org.osid.assessment
  16. */
  17. class ItemTaken
  18. {
  19. /**
  20. * Update the display name for this ItemTaken.
  21. *
  22. * @param string $displayName
  23. *
  24. * @throws object AssessmentException An exception with one of
  25. * the following messages defined in
  26. * org.osid.assessment.AssessmentException may be thrown: {@link }
  27. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  28. * OPERATION_FAILED}, {@link }
  29. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  30. * PERMISSION_DENIED}, {@link }
  31. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  32. * CONFIGURATION_ERROR}, {@link }
  33. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  34. * UNIMPLEMENTED}, {@link }
  35. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  36. * NULL_ARGUMENT}
  37. *
  38. * @access public
  39. */
  40. function updateDisplayName ( $displayName ) {
  41. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  42. }
  43.  
  44. /**
  45. * Update the data for this ItemTaken. The structure of the Data is not
  46. * defined in the OSID.
  47. *
  48. * @param object mixed $data (original type: java.io.Serializable)
  49. *
  50. * @throws object AssessmentException An exception with one of
  51. * the following messages defined in
  52. * org.osid.assessment.AssessmentException may be thrown: {@link }
  53. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  54. * OPERATION_FAILED}, {@link }
  55. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  56. * PERMISSION_DENIED}, {@link }
  57. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  58. * CONFIGURATION_ERROR}, {@link }
  59. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  60. * UNIMPLEMENTED}, {@link }
  61. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  62. * NULL_ARGUMENT}
  63. *
  64. * @access public
  65. */
  66. function updateData ( $data ) {
  67. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  68. }
  69.  
  70. /**
  71. * Get the display name for this ItemTaken.
  72. *
  73. * @return string
  74. *
  75. * @throws object AssessmentException An exception with one of
  76. * the following messages defined in
  77. * org.osid.assessment.AssessmentException may be thrown: {@link }
  78. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  79. * OPERATION_FAILED}, {@link }
  80. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  81. * PERMISSION_DENIED}, {@link }
  82. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  83. * CONFIGURATION_ERROR}, {@link }
  84. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  85. * UNIMPLEMENTED}
  86. *
  87. * @access public
  88. */
  89. function getDisplayName () {
  90. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  91. }
  92.  
  93. /**
  94. * Get the unique Id for this ItemTaken.
  95. *
  96. * @return object Id
  97. *
  98. * @throws object AssessmentException An exception with one of
  99. * the following messages defined in
  100. * org.osid.assessment.AssessmentException may be thrown: {@link }
  101. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  102. * OPERATION_FAILED}, {@link }
  103. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  104. * PERMISSION_DENIED}, {@link }
  105. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  106. * CONFIGURATION_ERROR}, {@link }
  107. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  108. * UNIMPLEMENTED}
  109. *
  110. * @access public
  111. */
  112. function getId () {
  113. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  114. }
  115.  
  116. /**
  117. * Get the Item for this Item taken.
  118. *
  119. * @return object Item
  120. *
  121. * @throws object AssessmentException An exception with one of
  122. * the following messages defined in
  123. * org.osid.assessment.AssessmentException may be thrown: {@link }
  124. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  125. * OPERATION_FAILED}, {@link }
  126. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  127. * PERMISSION_DENIED}, {@link }
  128. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  129. * CONFIGURATION_ERROR}, {@link }
  130. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  131. * UNIMPLEMENTED}
  132. *
  133. * @access public
  134. */
  135. function getItem () {
  136. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  137. }
  138.  
  139. /**
  140. * Get the Data for this ItemTaken. The structure of the Data is not
  141. * defined in the OSID.
  142. *
  143. * @return object mixed (original type: java.io.Serializable)
  144. *
  145. * @throws object AssessmentException An exception with one of
  146. * the following messages defined in
  147. * org.osid.assessment.AssessmentException may be thrown: {@link }
  148. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  149. * OPERATION_FAILED}, {@link }
  150. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  151. * PERMISSION_DENIED}, {@link }
  152. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  153. * CONFIGURATION_ERROR}, {@link }
  154. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  155. * UNIMPLEMENTED}
  156. *
  157. * @access public
  158. */
  159. function getData () {
  160. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  161. }
  162.  
  163. /**
  164. * Create an Evaluation of the specified Type for this Item.
  165. *
  166. * @param object Type $evaluationType
  167. *
  168. * @throws object AssessmentException An exception with one of
  169. * the following messages defined in
  170. * org.osid.assessment.AssessmentException may be thrown: {@link }
  171. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  172. * OPERATION_FAILED}, {@link }
  173. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  174. * PERMISSION_DENIED}, {@link }
  175. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  176. * CONFIGURATION_ERROR}, {@link }
  177. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  178. * UNIMPLEMENTED}, {@link }
  179. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  180. * NULL_ARGUMENT}, {@link }
  181. * org.osid.assessment.AssessmentException#UNKNOWN_TYPE
  182. * UNKNOWN_TYPE}
  183. *
  184. * @access public
  185. */
  186. function createEvaluation ( $evaluationType ) {
  187. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  188. }
  189.  
  190. /**
  191. * Delete this Evaluation from this Item.
  192. *
  193. * @param object Id $evaluationId
  194. *
  195. * @throws object AssessmentException An exception with one of
  196. * the following messages defined in
  197. * org.osid.assessment.AssessmentException may be thrown: {@link }
  198. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  199. * OPERATION_FAILED}, {@link }
  200. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  201. * PERMISSION_DENIED}, {@link }
  202. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  203. * CONFIGURATION_ERROR}, {@link }
  204. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  205. * UNIMPLEMENTED}, {@link }
  206. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  207. * NULL_ARGUMENT}, {@link }
  208. * org.osid.assessment.AssessmentException#UNKNOWN_ID UNKNOWN_ID}
  209. *
  210. * @access public
  211. */
  212. function deleteEvaluation ( $evaluationId ) {
  213. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  214. }
  215.  
  216. /**
  217. * Get the Evaluations of the specified Type for this Item.
  218. *
  219. * @param object Type $evaluationType
  220. *
  221. * @return object EvaluationIterator
  222. *
  223. * @throws object AssessmentException An exception with one of
  224. * the following messages defined in
  225. * org.osid.assessment.AssessmentException may be thrown: {@link }
  226. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  227. * OPERATION_FAILED}, {@link }
  228. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  229. * PERMISSION_DENIED}, {@link }
  230. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  231. * CONFIGURATION_ERROR}, {@link }
  232. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  233. * UNIMPLEMENTED}, {@link }
  234. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  235. * NULL_ARGUMENT}, {@link }
  236. * org.osid.assessment.AssessmentException#UNKNOWN_TYPE
  237. * UNKNOWN_TYPE}
  238. *
  239. * @access public
  240. */
  241. function getEvaluationsByType ( $evaluationType ) {
  242. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  243. }
  244.  
  245. /**
  246. * Get all the Evaluations for this Item.
  247. *
  248. * @return object EvaluationIterator
  249. *
  250. * @throws object AssessmentException An exception with one of
  251. * the following messages defined in
  252. * org.osid.assessment.AssessmentException may be thrown: {@link }
  253. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  254. * OPERATION_FAILED}, {@link }
  255. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  256. * PERMISSION_DENIED}, {@link }
  257. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  258. * CONFIGURATION_ERROR}, {@link }
  259. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  260. * UNIMPLEMENTED}
  261. *
  262. * @access public
  263. */
  264. function getEvaluations () {
  265. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  266. }
  267.  
  268. /**
  269. * Get the SectionTaken to which this ItemTaken belongs.
  270. *
  271. * @return object SectionTaken
  272. *
  273. * @throws object AssessmentException An exception with one of
  274. * the following messages defined in
  275. * org.osid.assessment.AssessmentException may be thrown: {@link }
  276. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  277. * OPERATION_FAILED}, {@link }
  278. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  279. * PERMISSION_DENIED}, {@link }
  280. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  281. * CONFIGURATION_ERROR}, {@link }
  282. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  283. * UNIMPLEMENTED}
  284. *
  285. * @access public
  286. */
  287. function getSectionTaken () {
  288. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  289. }
  290. }
  291.  
  292. ?>

Documentation generated on Wed, 19 Sep 2007 10:24:43 -0400 by phpDocumentor 1.3.0RC3