Source for file Function.php

Documentation is available at Function.php

  1. <?php
  2. /**
  3. * Function is composed of Id, a displayName, a description, a category, and a
  4. * QualifierType. Ids in Authorization are externally defined and their
  5. * uniqueness is enforced by the implementation.
  6. *
  7. * <p>
  8. * OSID Version: 2.0
  9. * </p>
  10. *
  11. * <p>
  12. * Licensed under the {@link org.osid.SidImplementationLicenseMIT MIT}
  13. * O.K.I&#46; OSID Definition License}.
  14. * </p>
  15. *
  16. * @package org.osid.authorization
  17. */
  18. class FunctionInterface
  19. {
  20. /**
  21. * Get the unique Id for this Function.
  22. *
  23. * @return object Id
  24. *
  25. * @throws object AuthorizationException An exception with
  26. * one of the following messages defined in
  27. * org.osid.authorization.AuthorizationException may be thrown:
  28. * {@link }
  29. * org.osid.authorization.AuthorizationException#OPERATION_FAILED
  30. * OPERATION_FAILED}, {@link }
  31. * org.osid.authorization.AuthorizationException#PERMISSION_DENIED
  32. * PERMISSION_DENIED}, {@link }
  33. * org.osid.authorization.AuthorizationException#CONFIGURATION_ERROR
  34. * CONFIGURATION_ERROR}, {@link }
  35. * org.osid.authorization.AuthorizationException#UNIMPLEMENTED
  36. * UNIMPLEMENTED}
  37. *
  38. * @access public
  39. */
  40. function getId () {
  41. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  42. }
  43.  
  44. /**
  45. * Get the permanent reference name for this Function.
  46. *
  47. * @return string
  48. *
  49. * @throws object AuthorizationException An exception with
  50. * one of the following messages defined in
  51. * org.osid.authorization.AuthorizationException may be thrown:
  52. * {@link }
  53. * org.osid.authorization.AuthorizationException#OPERATION_FAILED
  54. * OPERATION_FAILED}, {@link }
  55. * org.osid.authorization.AuthorizationException#PERMISSION_DENIED
  56. * PERMISSION_DENIED}, {@link }
  57. * org.osid.authorization.AuthorizationException#CONFIGURATION_ERROR
  58. * CONFIGURATION_ERROR}, {@link }
  59. * org.osid.authorization.AuthorizationException#UNIMPLEMENTED
  60. * UNIMPLEMENTED}
  61. *
  62. * @access public
  63. */
  64. function getReferenceName () {
  65. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  66. }
  67.  
  68. /**
  69. * Get the description for this Function.
  70. *
  71. * @return string
  72. *
  73. * @throws object AuthorizationException An exception with
  74. * one of the following messages defined in
  75. * org.osid.authorization.AuthorizationException may be thrown:
  76. * {@link }
  77. * org.osid.authorization.AuthorizationException#OPERATION_FAILED
  78. * OPERATION_FAILED}, {@link }
  79. * org.osid.authorization.AuthorizationException#PERMISSION_DENIED
  80. * PERMISSION_DENIED}, {@link }
  81. * org.osid.authorization.AuthorizationException#CONFIGURATION_ERROR
  82. * CONFIGURATION_ERROR}, {@link }
  83. * org.osid.authorization.AuthorizationException#UNIMPLEMENTED
  84. * UNIMPLEMENTED}
  85. *
  86. * @access public
  87. */
  88. function getDescription () {
  89. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  90. }
  91.  
  92. /**
  93. * Get the FunctionType for this Function.
  94. *
  95. * @return object Type
  96. *
  97. * @throws object AuthorizationException An exception with
  98. * one of the following messages defined in
  99. * org.osid.authorization.AuthorizationException may be thrown:
  100. * {@link }
  101. * org.osid.authorization.AuthorizationException#OPERATION_FAILED
  102. * OPERATION_FAILED}, {@link }
  103. * org.osid.authorization.AuthorizationException#PERMISSION_DENIED
  104. * PERMISSION_DENIED}, {@link }
  105. * org.osid.authorization.AuthorizationException#CONFIGURATION_ERROR
  106. * CONFIGURATION_ERROR}, {@link }
  107. * org.osid.authorization.AuthorizationException#UNIMPLEMENTED
  108. * UNIMPLEMENTED}
  109. *
  110. * @access public
  111. */
  112. function getFunctionType () {
  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 QualifierHierarchyId for this Function.
  118. *
  119. * @return object Id
  120. *
  121. * @throws object AuthorizationException An exception with
  122. * one of the following messages defined in
  123. * org.osid.authorization.AuthorizationException may be thrown:
  124. * {@link }
  125. * org.osid.authorization.AuthorizationException#OPERATION_FAILED
  126. * OPERATION_FAILED}, {@link }
  127. * org.osid.authorization.AuthorizationException#PERMISSION_DENIED
  128. * PERMISSION_DENIED}, {@link }
  129. * org.osid.authorization.AuthorizationException#CONFIGURATION_ERROR
  130. * CONFIGURATION_ERROR}, {@link }
  131. * org.osid.authorization.AuthorizationException#UNIMPLEMENTED
  132. * UNIMPLEMENTED}
  133. *
  134. * @access public
  135. */
  136. function getQualifierHierarchyId () {
  137. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  138. }
  139.  
  140. /**
  141. * Update the description for this Function.
  142. *
  143. * @param string $description
  144. *
  145. * @throws object AuthorizationException An exception with
  146. * one of the following messages defined in
  147. * org.osid.authorization.AuthorizationException may be thrown:
  148. * {@link }
  149. * org.osid.authorization.AuthorizationException#OPERATION_FAILED
  150. * OPERATION_FAILED}, {@link }
  151. * org.osid.authorization.AuthorizationException#PERMISSION_DENIED
  152. * PERMISSION_DENIED}, {@link }
  153. * org.osid.authorization.AuthorizationException#CONFIGURATION_ERROR
  154. * CONFIGURATION_ERROR}, {@link }
  155. * org.osid.authorization.AuthorizationException#UNIMPLEMENTED
  156. * UNIMPLEMENTED}, {@link }
  157. * org.osid.authorization.AuthorizationException#NULL_ARGUMENT
  158. * NULL_ARGUMENT}
  159. *
  160. * @access public
  161. */
  162. function updateDescription ( $description ) {
  163. die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class.");
  164. }
  165. }
  166.  
  167. ?>

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