Source for file Section.php

Documentation is available at Section.php

  1. <?php
  2. /**
  3. * Section includes zero or more Items and can also contain other Sections.
  4. * The Items added to a Section are returned first in, first out (FIFO).
  5. * Items can be ordered explicitly using the orderItems method. The Sections
  6. * added to a Section are returned first in, first out (FIFO). Sections can
  7. * be ordered explicitly using the orderSections method. SectionType is
  8. * meaningful to an application and not specifcally defined in the OSID. The
  9. * unique Id is set by the AssessmentManager's createSection method's
  10. * implementation.
  11. *
  12. * <p>
  13. * OSID Version: 2.0
  14. * </p>
  15. *
  16. * <p>
  17. * Licensed under the {@link org.osid.SidImplementationLicenseMIT MIT}
  18. * O.K.I&#46; OSID Definition License}.
  19. * </p>
  20. *
  21. * @package org.osid.assessment
  22. */
  23. class Section
  24. {
  25. /**
  26. * Update the display name for this Section.
  27. *
  28. * @param string $displayName
  29. *
  30. * @throws object AssessmentException An exception with one of
  31. * the following messages defined in
  32. * org.osid.assessment.AssessmentException may be thrown: {@link }
  33. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  34. * OPERATION_FAILED}, {@link }
  35. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  36. * PERMISSION_DENIED}, {@link }
  37. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  38. * CONFIGURATION_ERROR}, {@link }
  39. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  40. * UNIMPLEMENTED}, {@link }
  41. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  42. * NULL_ARGUMENT}
  43. *
  44. * @access public
  45. */
  46. function updateDisplayName ( $displayName ) {
  47. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  48. }
  49.  
  50. /**
  51. * Update the description for this Section.
  52. *
  53. * @param string $description
  54. *
  55. * @throws object AssessmentException An exception with one of
  56. * the following messages defined in
  57. * org.osid.assessment.AssessmentException may be thrown: {@link }
  58. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  59. * OPERATION_FAILED}, {@link }
  60. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  61. * PERMISSION_DENIED}, {@link }
  62. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  63. * CONFIGURATION_ERROR}, {@link }
  64. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  65. * UNIMPLEMENTED}, {@link }
  66. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  67. * NULL_ARGUMENT}
  68. *
  69. * @access public
  70. */
  71. function updateDescription ( $description ) {
  72. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  73. }
  74.  
  75. /**
  76. * Update the data for this Section. The structure of the Data is not
  77. * defined in the OSID. .
  78. *
  79. * @param object mixed $data (original type: java.io.Serializable)
  80. *
  81. * @throws object AssessmentException An exception with one of
  82. * the following messages defined in
  83. * org.osid.assessment.AssessmentException may be thrown: {@link }
  84. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  85. * OPERATION_FAILED}, {@link }
  86. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  87. * PERMISSION_DENIED}, {@link }
  88. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  89. * CONFIGURATION_ERROR}, {@link }
  90. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  91. * UNIMPLEMENTED}, {@link }
  92. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  93. * NULL_ARGUMENT}
  94. *
  95. * @access public
  96. */
  97. function updateData ( $data ) {
  98. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  99. }
  100.  
  101. /**
  102. * Get the display name for this Section.
  103. *
  104. * @return string
  105. *
  106. * @throws object AssessmentException An exception with one of
  107. * the following messages defined in
  108. * org.osid.assessment.AssessmentException may be thrown: {@link }
  109. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  110. * OPERATION_FAILED}, {@link }
  111. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  112. * PERMISSION_DENIED}, {@link }
  113. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  114. * CONFIGURATION_ERROR}, {@link }
  115. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  116. * UNIMPLEMENTED}
  117. *
  118. * @access public
  119. */
  120. function getDisplayName () {
  121. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  122. }
  123.  
  124. /**
  125. * Get the description for this Section.
  126. *
  127. * @return string
  128. *
  129. * @throws object AssessmentException An exception with one of
  130. * the following messages defined in
  131. * org.osid.assessment.AssessmentException may be thrown: {@link }
  132. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  133. * OPERATION_FAILED}, {@link }
  134. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  135. * PERMISSION_DENIED}, {@link }
  136. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  137. * CONFIGURATION_ERROR}, {@link }
  138. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  139. * UNIMPLEMENTED}
  140. *
  141. * @access public
  142. */
  143. function getDescription () {
  144. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  145. }
  146.  
  147. /**
  148. * Get the unique Id for this Item.
  149. *
  150. * @return object Id
  151. *
  152. * @throws object AssessmentException An exception with one of
  153. * the following messages defined in
  154. * org.osid.assessment.AssessmentException may be thrown: {@link }
  155. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  156. * OPERATION_FAILED}, {@link }
  157. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  158. * PERMISSION_DENIED}, {@link }
  159. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  160. * CONFIGURATION_ERROR}, {@link }
  161. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  162. * UNIMPLEMENTED}
  163. *
  164. * @access public
  165. */
  166. function getId () {
  167. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  168. }
  169.  
  170. /**
  171. * Get the SectionType for this Section. is meaningful to an application
  172. * and not specifcally defined in the OSID
  173. *
  174. * @return object Type
  175. *
  176. * @throws object AssessmentException An exception with one of
  177. * the following messages defined in
  178. * org.osid.assessment.AssessmentException may be thrown: {@link }
  179. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  180. * OPERATION_FAILED}, {@link }
  181. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  182. * PERMISSION_DENIED}, {@link }
  183. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  184. * CONFIGURATION_ERROR}, {@link }
  185. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  186. * UNIMPLEMENTED}
  187. *
  188. * @access public
  189. */
  190. function getSectionType () {
  191. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  192. }
  193.  
  194. /**
  195. * Get the Data for this Section. The structure of the Data is not defined
  196. * in the OSID.
  197. *
  198. * @return object mixed (original type: java.io.Serializable)
  199. *
  200. * @throws object AssessmentException An exception with one of
  201. * the following messages defined in
  202. * org.osid.assessment.AssessmentException may be thrown: {@link }
  203. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  204. * OPERATION_FAILED}, {@link }
  205. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  206. * PERMISSION_DENIED}, {@link }
  207. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  208. * CONFIGURATION_ERROR}, {@link }
  209. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  210. * UNIMPLEMENTED}
  211. *
  212. * @access public
  213. */
  214. function getData () {
  215. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  216. }
  217.  
  218. /**
  219. * Get all the Property Types for Section.
  220. *
  221. * @return object TypeIterator
  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}
  234. *
  235. * @access public
  236. */
  237. function getPropertyTypes () {
  238. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  239. }
  240.  
  241. /**
  242. * Get the Properties associated with this Section.
  243. *
  244. * @return object PropertiesIterator
  245. *
  246. * @throws object AssessmentException An exception with one of
  247. * the following messages defined in
  248. * org.osid.assessment.AssessmentException may be thrown: {@link }
  249. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  250. * OPERATION_FAILED}, {@link }
  251. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  252. * PERMISSION_DENIED}, {@link }
  253. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  254. * CONFIGURATION_ERROR}, {@link }
  255. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  256. * UNIMPLEMENTED}
  257. *
  258. * @access public
  259. */
  260. function getProperties () {
  261. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  262. }
  263.  
  264. /**
  265. * Add an Item to this Section. The Items added to a Section are returned
  266. * first in, first out (FIFO). Items can be ordered explicitly using the
  267. * orderItems method.
  268. *
  269. * @param object Item $item
  270. *
  271. * @throws object AssessmentException An exception with one of
  272. * the following messages defined in
  273. * org.osid.assessment.AssessmentException may be thrown: {@link }
  274. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  275. * OPERATION_FAILED}, {@link }
  276. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  277. * PERMISSION_DENIED}, {@link }
  278. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  279. * CONFIGURATION_ERROR}, {@link }
  280. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  281. * UNIMPLEMENTED}, {@link }
  282. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  283. * NULL_ARGUMENT}, {@link }
  284. * org.osid.assessment.AssessmentException#ALREADY_ADDED
  285. * ALREADY_ADDED}
  286. *
  287. * @access public
  288. */
  289. function addItem ( $item ) {
  290. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  291. }
  292.  
  293. /**
  294. * Remove an Item from this Section.
  295. *
  296. * @param object Id $itemId
  297. *
  298. * @throws object AssessmentException An exception with one of
  299. * the following messages defined in
  300. * org.osid.assessment.AssessmentException may be thrown: {@link }
  301. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  302. * OPERATION_FAILED}, {@link }
  303. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  304. * PERMISSION_DENIED}, {@link }
  305. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  306. * CONFIGURATION_ERROR}, {@link }
  307. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  308. * UNIMPLEMENTED}, {@link }
  309. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  310. * NULL_ARGUMENT}, {@link }
  311. * org.osid.assessment.AssessmentException#UNKNOWN_ID UNKNOWN_ID}
  312. *
  313. * @access public
  314. */
  315. function removeItem ( $itemId ) {
  316. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  317. }
  318.  
  319. /**
  320. * Get all the Items in this Section. The Items added to a Section are
  321. * returned first in, first out (FIFO). Items can be ordered explicitly
  322. * using the orderItems method. Only the Items directly associated with
  323. * this Section are returned.
  324. *
  325. * @return object ItemIterator
  326. *
  327. * @throws object AssessmentException An exception with one of
  328. * the following messages defined in
  329. * org.osid.assessment.AssessmentException may be thrown: {@link }
  330. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  331. * OPERATION_FAILED}, {@link }
  332. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  333. * PERMISSION_DENIED}, {@link }
  334. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  335. * CONFIGURATION_ERROR}, {@link }
  336. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  337. * UNIMPLEMENTED}
  338. *
  339. * @access public
  340. */
  341. function getItems () {
  342. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  343. }
  344.  
  345. /**
  346. * Change the order of the Items in the Section. Items normally are
  347. * returned first in, first out (FIFO). This ordering, which has
  348. * important pedagogical implications, is changed to match the order in
  349. * the Items array. Additional added Items are returned first in, first
  350. * out (FIFO) after the ordered Items.
  351. *
  352. * @param object Item[] $items
  353. *
  354. * @throws object AssessmentException An exception with one of
  355. * the following messages defined in
  356. * org.osid.assessment.AssessmentException may be thrown: {@link }
  357. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  358. * OPERATION_FAILED}, {@link }
  359. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  360. * PERMISSION_DENIED}, {@link }
  361. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  362. * CONFIGURATION_ERROR}, {@link }
  363. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  364. * UNIMPLEMENTED}, {@link }
  365. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  366. * NULL_ARGUMENT}, {@link }
  367. * org.osid.assessment.AssessmentException#UNKNOWN_ITEM
  368. * UNKNOWN_ITEM}
  369. *
  370. * @access public
  371. */
  372. function orderItems ( $items ) {
  373. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  374. }
  375.  
  376. /**
  377. * Add a Section to this Section. The Sections added to a Section are
  378. * returned first in, first out (FIFO). Sections can be ordered
  379. * explicitly using the orderSections method.
  380. *
  381. * @param object Section $section
  382. *
  383. * @throws object AssessmentException An exception with one of
  384. * the following messages defined in
  385. * org.osid.assessment.AssessmentException may be thrown: {@link }
  386. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  387. * OPERATION_FAILED}, {@link }
  388. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  389. * PERMISSION_DENIED}, {@link }
  390. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  391. * CONFIGURATION_ERROR}, {@link }
  392. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  393. * UNIMPLEMENTED}, {@link }
  394. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  395. * NULL_ARGUMENT}, {@link }
  396. * org.osid.assessment.AssessmentException#ALREADY_ADDED
  397. * ALREADY_ADDED}
  398. *
  399. * @access public
  400. */
  401. function addSection ( $section ) {
  402. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  403. }
  404.  
  405. /**
  406. * Remove a Section from this Section.
  407. *
  408. * @param object Id $sectionId
  409. *
  410. * @throws object AssessmentException An exception with one of
  411. * the following messages defined in
  412. * org.osid.assessment.AssessmentException may be thrown: {@link }
  413. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  414. * OPERATION_FAILED}, {@link }
  415. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  416. * PERMISSION_DENIED}, {@link }
  417. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  418. * CONFIGURATION_ERROR}, {@link }
  419. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  420. * UNIMPLEMENTED}, {@link }
  421. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  422. * NULL_ARGUMENT}, {@link }
  423. * org.osid.assessment.AssessmentException#UNKNOWN_ID UNKNOWN_ID}
  424. *
  425. * @access public
  426. */
  427. function removeSection ( $sectionId ) {
  428. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  429. }
  430.  
  431. /**
  432. * Get all the Sections in this Section. The Sections added to a Section
  433. * are returned first in, first out (FIFO). Sections can be ordered
  434. * explicitly using the orderSections method. Only the Sections directly
  435. * associated with this Section are returned.
  436. *
  437. * @return object SectionIterator
  438. *
  439. * @throws object AssessmentException An exception with one of
  440. * the following messages defined in
  441. * org.osid.assessment.AssessmentException may be thrown: {@link }
  442. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  443. * OPERATION_FAILED}, {@link }
  444. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  445. * PERMISSION_DENIED}, {@link }
  446. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  447. * CONFIGURATION_ERROR}, {@link }
  448. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  449. * UNIMPLEMENTED}
  450. *
  451. * @access public
  452. */
  453. function getSections () {
  454. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  455. }
  456.  
  457. /**
  458. * Change the order of the Sections in the Section. Sections normally are
  459. * returned first in, first out (FIFO). This ordering, which has
  460. * important pedagogical implications, is changed to match the order in
  461. * the Sections array. Additional added Sections are returned first in,
  462. * first out (FIFO) after the ordered Sections.
  463. *
  464. * @param object Section[] $sections
  465. *
  466. * @throws object AssessmentException An exception with one of
  467. * the following messages defined in
  468. * org.osid.assessment.AssessmentException may be thrown: {@link }
  469. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  470. * OPERATION_FAILED}, {@link }
  471. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  472. * PERMISSION_DENIED}, {@link }
  473. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  474. * CONFIGURATION_ERROR}, {@link }
  475. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  476. * UNIMPLEMENTED}, {@link }
  477. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  478. * NULL_ARGUMENT}, {@link }
  479. * org.osid.assessment.AssessmentException#UNKNOWN_SECTION
  480. * UNKNOWN_SECTION}
  481. *
  482. * @access public
  483. */
  484. function orderSections ( $sections ) {
  485. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  486. }
  487.  
  488. /**
  489. * Get the Properties of this Type associated with this Section.
  490. *
  491. * @param object Type $propertiesType
  492. *
  493. * @return object Properties
  494. *
  495. * @throws object AssessmentException An exception with one of
  496. * the following messages defined in
  497. * org.osid.assessment.AssessmentException may be thrown: {@link }
  498. * org.osid.assessment.AssessmentException#OPERATION_FAILED
  499. * OPERATION_FAILED}, {@link }
  500. * org.osid.assessment.AssessmentException#PERMISSION_DENIED
  501. * PERMISSION_DENIED}, {@link }
  502. * org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
  503. * CONFIGURATION_ERROR}, {@link }
  504. * org.osid.assessment.AssessmentException#UNIMPLEMENTED
  505. * UNIMPLEMENTED}, {@link }
  506. * org.osid.assessment.AssessmentException#NULL_ARGUMENT
  507. * NULL_ARGUMENT}, {@link }
  508. * org.osid.assessment.AssessmentException#UNKNOWN_TYPE
  509. * UNKNOWN_TYPE}
  510. *
  511. * @access public
  512. */
  513. function getPropertiesByType ( $propertiesType ) {
  514. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  515. }
  516. }
  517.  
  518. ?>

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