Source for file Part.php

Documentation is available at Part.php

  1. <?php
  2. /**
  3. * Each Asset has one of the AssetType supported by the Repository. There are
  4. * also zero or more RecordStructures required by the Repository for each
  5. * AssetType. RecordStructures provide structural information. The values for
  6. * a given Asset's RecordStructure are stored in a Record. RecordStructures
  7. * can contain sub-elements which are referred to as PartStructures. The
  8. * structure defined in the RecordStructure and its PartStructures is used in
  9. * for any Records for the Asset. Records have Parts which parallel
  10. * PartStructures.
  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.repository
  22. */
  23. class Part
  24. {
  25. /**
  26. * Update the display name for this Part.
  27. *
  28. * @param string $displayName
  29. *
  30. * @throws object RepositoryException An exception with one of
  31. * the following messages defined in
  32. * org.osid.repository.RepositoryException may be thrown: {@link }
  33. * org.osid.repository.RepositoryException#OPERATION_FAILED
  34. * OPERATION_FAILED}, {@link }
  35. * org.osid.repository.RepositoryException#PERMISSION_DENIED
  36. * PERMISSION_DENIED}, {@link }
  37. * org.osid.repository.RepositoryException#CONFIGURATION_ERROR
  38. * CONFIGURATION_ERROR}, {@link }
  39. * org.osid.repository.RepositoryException#UNIMPLEMENTED
  40. * UNIMPLEMENTED}, {@link }
  41. * org.osid.repository.RepositoryException#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. * Get the unique Id for this Part.
  52. *
  53. * @return object Id
  54. *
  55. * @throws object RepositoryException An exception with one of
  56. * the following messages defined in
  57. * org.osid.repository.RepositoryException may be thrown: {@link }
  58. * org.osid.repository.RepositoryException#OPERATION_FAILED
  59. * OPERATION_FAILED}, {@link }
  60. * org.osid.repository.RepositoryException#PERMISSION_DENIED
  61. * PERMISSION_DENIED}, {@link }
  62. * org.osid.repository.RepositoryException#CONFIGURATION_ERROR
  63. * CONFIGURATION_ERROR}, {@link }
  64. * org.osid.repository.RepositoryException#UNIMPLEMENTED
  65. * UNIMPLEMENTED}
  66. *
  67. * @access public
  68. */
  69. function getId () {
  70. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  71. }
  72.  
  73. /**
  74. * Get the display name for this Part.
  75. *
  76. * @return string
  77. *
  78. * @throws object RepositoryException An exception with one of
  79. * the following messages defined in
  80. * org.osid.repository.RepositoryException may be thrown: {@link }
  81. * org.osid.repository.RepositoryException#OPERATION_FAILED
  82. * OPERATION_FAILED}, {@link }
  83. * org.osid.repository.RepositoryException#PERMISSION_DENIED
  84. * PERMISSION_DENIED}, {@link }
  85. * org.osid.repository.RepositoryException#CONFIGURATION_ERROR
  86. * CONFIGURATION_ERROR}, {@link }
  87. * org.osid.repository.RepositoryException#UNIMPLEMENTED
  88. * UNIMPLEMENTED}
  89. *
  90. * @access public
  91. */
  92. function getDisplayName () {
  93. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  94. }
  95.  
  96. /**
  97. * Get the PartStructure associated with this Part.
  98. *
  99. * @return object PartStructure
  100. *
  101. * @throws object RepositoryException An exception with one of
  102. * the following messages defined in
  103. * org.osid.repository.RepositoryException may be thrown: {@link }
  104. * org.osid.repository.RepositoryException#OPERATION_FAILED
  105. * OPERATION_FAILED}, {@link }
  106. * org.osid.repository.RepositoryException#PERMISSION_DENIED
  107. * PERMISSION_DENIED}, {@link }
  108. * org.osid.repository.RepositoryException#CONFIGURATION_ERROR
  109. * CONFIGURATION_ERROR}, {@link }
  110. * org.osid.repository.RepositoryException#UNIMPLEMENTED
  111. * UNIMPLEMENTED}
  112. *
  113. * @access public
  114. */
  115. function getPartStructure () {
  116. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  117. }
  118.  
  119. /**
  120. * Create a Part. Records are composed of Parts. Parts can also contain
  121. * other Parts. Each Record is associated with a specific RecordStructure
  122. * and each Part is associated with a specific PartStructure.
  123. *
  124. * @param object Id $partStructureId
  125. * @param object mixed $value (original type: java.io.Serializable)
  126. *
  127. * @return object Part
  128. *
  129. * @throws object RepositoryException An exception with one of
  130. * the following messages defined in
  131. * org.osid.repository.RepositoryException may be thrown: {@link }
  132. * org.osid.repository.RepositoryException#OPERATION_FAILED
  133. * OPERATION_FAILED}, {@link }
  134. * org.osid.repository.RepositoryException#PERMISSION_DENIED
  135. * PERMISSION_DENIED}, {@link }
  136. * org.osid.repository.RepositoryException#CONFIGURATION_ERROR
  137. * CONFIGURATION_ERROR}, {@link }
  138. * org.osid.repository.RepositoryException#UNIMPLEMENTED
  139. * UNIMPLEMENTED}, {@link }
  140. * org.osid.repository.RepositoryException#NULL_ARGUMENT
  141. * NULL_ARGUMENT}, {@link }
  142. * org.osid.repository.RepositoryException#UNKNOWN_ID UNKNOWN_ID}
  143. *
  144. * @access public
  145. */
  146. function createPart ( $partStructureId, $value ) {
  147. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  148. }
  149.  
  150. /**
  151. * Delete a Part and all its Parts.
  152. *
  153. * @param object Id $partId
  154. *
  155. * @throws object RepositoryException An exception with one of
  156. * the following messages defined in
  157. * org.osid.repository.RepositoryException may be thrown: {@link }
  158. * org.osid.repository.RepositoryException#OPERATION_FAILED
  159. * OPERATION_FAILED}, {@link }
  160. * org.osid.repository.RepositoryException#PERMISSION_DENIED
  161. * PERMISSION_DENIED}, {@link }
  162. * org.osid.repository.RepositoryException#CONFIGURATION_ERROR
  163. * CONFIGURATION_ERROR}, {@link }
  164. * org.osid.repository.RepositoryException#UNIMPLEMENTED
  165. * UNIMPLEMENTED}, {@link }
  166. * org.osid.repository.RepositoryException#NULL_ARGUMENT
  167. * NULL_ARGUMENT}, {@link }
  168. * org.osid.repository.RepositoryException#UNKNOWN_ID UNKNOWN_ID}
  169. *
  170. * @access public
  171. */
  172. function deletePart ( $partId ) {
  173. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  174. }
  175.  
  176. /**
  177. * Get all the Parts in this Part. Iterators return a set, one at a time.
  178. *
  179. * @return object PartIterator
  180. *
  181. * @throws object RepositoryException An exception with one of
  182. * the following messages defined in
  183. * org.osid.repository.RepositoryException may be thrown: {@link }
  184. * org.osid.repository.RepositoryException#OPERATION_FAILED
  185. * OPERATION_FAILED}, {@link }
  186. * org.osid.repository.RepositoryException#PERMISSION_DENIED
  187. * PERMISSION_DENIED}, {@link }
  188. * org.osid.repository.RepositoryException#CONFIGURATION_ERROR
  189. * CONFIGURATION_ERROR}, {@link }
  190. * org.osid.repository.RepositoryException#UNIMPLEMENTED
  191. * UNIMPLEMENTED}
  192. *
  193. * @access public
  194. */
  195. function getParts () {
  196. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  197. }
  198.  
  199. /**
  200. * Get the value for this Part.
  201. *
  202. * @return object mixed (original type: java.io.Serializable)
  203. *
  204. * @throws object RepositoryException An exception with one of
  205. * the following messages defined in
  206. * org.osid.repository.RepositoryException may be thrown: {@link }
  207. * org.osid.repository.RepositoryException#OPERATION_FAILED
  208. * OPERATION_FAILED}, {@link }
  209. * org.osid.repository.RepositoryException#PERMISSION_DENIED
  210. * PERMISSION_DENIED}, {@link }
  211. * org.osid.repository.RepositoryException#CONFIGURATION_ERROR
  212. * CONFIGURATION_ERROR}, {@link }
  213. * org.osid.repository.RepositoryException#UNIMPLEMENTED
  214. * UNIMPLEMENTED}
  215. *
  216. * @access public
  217. */
  218. function getValue () {
  219. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  220. }
  221.  
  222. /**
  223. * Update the value for this Part.
  224. *
  225. * @param object mixed $value (original type: java.io.Serializable)
  226. *
  227. * @throws object RepositoryException An exception with one of
  228. * the following messages defined in
  229. * org.osid.repository.RepositoryException may be thrown: {@link }
  230. * org.osid.repository.RepositoryException#OPERATION_FAILED
  231. * OPERATION_FAILED}, {@link }
  232. * org.osid.repository.RepositoryException#PERMISSION_DENIED
  233. * PERMISSION_DENIED}, {@link }
  234. * org.osid.repository.RepositoryException#CONFIGURATION_ERROR
  235. * CONFIGURATION_ERROR}, {@link }
  236. * org.osid.repository.RepositoryException#UNIMPLEMENTED
  237. * UNIMPLEMENTED}, {@link }
  238. * org.osid.repository.RepositoryException#NULL_ARGUMENT
  239. * NULL_ARGUMENT}
  240. *
  241. * @access public
  242. */
  243. function updateValue ( $value ) {
  244. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  245. }
  246. }
  247.  
  248. ?>

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