Source for file FilingManager.php

Documentation is available at FilingManager.php

  1. <?php
  2. include_once(dirname(__FILE__)."/../OsidManager.php");
  3. /**
  4. * <p>
  5. * FilingManager:
  6. *
  7. * <ul>
  8. * <li>
  9. * creates root Cabinets,
  10. * </li>
  11. * <li>
  12. * deletes CabinetEntries,
  13. * </li>
  14. * <li>
  15. * gets root Cabinets and CabinetEntries.
  16. * </li>
  17. * </ul>
  18. * </p>
  19. *
  20. * <p>
  21. * All implementations of OsidManager (manager) provide methods for accessing
  22. * and manipulating the various objects defined in the OSID package. A manager
  23. * defines an implementation of an OSID. All other OSID objects come either
  24. * directly or indirectly from the manager. New instances of the OSID objects
  25. * are created either directly or indirectly by the manager. Because the OSID
  26. * objects are defined using interfaces, create methods must be used instead
  27. * of the new operator to create instances of the OSID objects. Create methods
  28. * are used both to instantiate and persist OSID objects. Using the
  29. * OsidManager class to define an OSID's implementation allows the application
  30. * to change OSID implementations by changing the OsidManager package name
  31. * used to load an implementation. Applications developed using managers
  32. * permit OSID implementation substitution without changing the application
  33. * source code. As with all managers, use the OsidLoader to load an
  34. * implementation of this interface.
  35. * </p>
  36. *
  37. * <p></p>
  38. *
  39. * <p>
  40. * OSID Version: 2.0
  41. * </p>
  42. *
  43. * <p>
  44. * Licensed under the {@link org.osid.SidImplementationLicenseMIT MIT}
  45. * O.K.I&#46; OSID Definition License}.
  46. * </p>
  47. *
  48. * @package org.osid.filing
  49. */
  50. class FilingManager
  51. extends OsidManager
  52. {
  53. /**
  54. * Get all the root Cabinets currently available in this Manager.
  55. *
  56. * @return object CabinetEntryIterator
  57. *
  58. * @throws object FilingException An exception with one of the
  59. * following messages defined in org.osid.filing.FilingException
  60. * may be thrown: {@link }
  61. * org.osid.filing.FilingException#PERMISSION_DENIED
  62. * PERMISSION_DENIED}, {@link }
  63. * org.osid.filing.FilingException#IO_ERROR IO_ERROR}
  64. *
  65. * @access public
  66. */
  67. function getRoots () {
  68. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  69. }
  70.  
  71. /**
  72. * Get a CabinetEntry by ID.
  73. *
  74. * @param object Id $id
  75. *
  76. * @return object CabinetEntry
  77. *
  78. * @throws object FilingException An exception with one of the
  79. * following messages defined in org.osid.filing.FilingException
  80. * may be thrown: {@link }
  81. * org.osid.filing.FilingException#PERMISSION_DENIED
  82. * PERMISSION_DENIED}, {@link }
  83. * org.osid.filing.FilingException#IO_ERROR IO_ERROR}, {@link }
  84. * org.osid.filing.FilingException#ITEM_DOES_NOT_EXIST
  85. * ITEM_DOES_NOT_EXIST}
  86. *
  87. * @access public
  88. */
  89. function getCabinetEntry ( $id ) {
  90. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  91. }
  92.  
  93. /**
  94. * Create a new root Cabinet with the given name. The name must not include
  95. * this Cabinet's separationCharacter.
  96. *
  97. * @param string $displayName
  98. *
  99. * @return object Cabinet
  100. *
  101. * @throws object FilingException An exception with one of the
  102. * following messages defined in org.osid.filing.FilingException
  103. * may be thrown: {@link }
  104. * org.osid.filing.FilingException#PERMISSION_DENIED
  105. * PERMISSION_DENIED}, {@link }
  106. * org.osid.filing.FilingException#IO_ERROR IO_ERROR}, {@link }
  107. * org.osid.filing.FilingException#ITEM_ALREADY_EXISTS
  108. * ITEM_ALREADY_EXISTS}, {@link }
  109. * org.osid.filing.FilingException#NAME_CONTAINS_ILLEGAL_CHARS
  110. * NAME_CONTAINS_ILLEGAL_CHARS}
  111. *
  112. * @access public
  113. */
  114. function createRootCabinet ( $displayName ) {
  115. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  116. }
  117.  
  118. /**
  119. * Deletes this CabinetEntry. If the CabinetEntry is a Cabinet it must be
  120. * empty, and the Owner of the Manager must have sufficient permissions to
  121. * perform this action.
  122. *
  123. * @param object Id $cabinetEntryId
  124. *
  125. * @throws object FilingException An exception with one of the
  126. * following messages defined in org.osid.filing.FilingException
  127. * may be thrown: {@link }
  128. * org.osid.filing.FilingException#PERMISSION_DENIED
  129. * PERMISSION_DENIED}, {@link }
  130. * org.osid.filing.FilingException#IO_ERROR IO_ERROR}, {@link }
  131. * org.osid.filing.FilingException#DELETE_FAILED DELETE_FAILED},
  132. * {@link org.osid.filing.FilingException#CABINET_NOT_EMPTY}
  133. * CABINET_NOT_EMPTY}, {@link }
  134. * org.osid.filing.FilingException#ITEM_DOES_NOT_EXIST
  135. * ITEM_DOES_NOT_EXIST}
  136. *
  137. * @access public
  138. */
  139. function delete ( $cabinetEntryId ) {
  140. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  141. }
  142. }
  143.  
  144. ?>

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