File Source for Item.php

<?php 
 
/**
 * Item includes the question, set of responses, answer, and any supporting
 * instructions and media.  These elements are all contained in a Data object
 * whose content is not specified in the OSID. Items are characterized by
 * their response type, for example multiple-choice.  ItemType is meaningful
 * to an application and not specifcally defined in the OSID. The unique Id
 * for an item is set by the AssessmentManager's createItem method's
 * implementation.
 * 
 * <p>
 * OSID Version: 2.0
 * </p>
 * 
 * <p>
 * Licensed under the {@link org.osid.SidImplementationLicenseMIT MIT}
 * O.K.I&#46; OSID Definition License}.
 * </p>
 * 
 * @package org.osid.assessment
 */
class Item
{
    /**
     * Update the display name for this Item.
     * 
     * @param string $displayName 
     * 
     * @throws object AssessmentException An exception with one of
     *          the following messages defined in
     *          org.osid.assessment.AssessmentException may be thrown:  {@link }
     *          org.osid.assessment.AssessmentException#OPERATION_FAILED
     *          OPERATION_FAILED}, {@link }
     *          org.osid.assessment.AssessmentException#PERMISSION_DENIED
     *          PERMISSION_DENIED}, {@link }
     *          org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
     *          CONFIGURATION_ERROR}, {@link }
     *          org.osid.assessment.AssessmentException#UNIMPLEMENTED
     *          UNIMPLEMENTED}, {@link }
     *          org.osid.assessment.AssessmentException#NULL_ARGUMENT
     *          NULL_ARGUMENT}
     * 
     * @access public
     */
    function updateDisplayName ( $displayName ) { 
        die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class."); 
    } 
 
    /**
     * Update the description for this Item.
     * 
     * @param string $description 
     * 
     * @throws object AssessmentException An exception with one of
     *          the following messages defined in
     *          org.osid.assessment.AssessmentException may be thrown:  {@link }
     *          org.osid.assessment.AssessmentException#OPERATION_FAILED
     *          OPERATION_FAILED}, {@link }
     *          org.osid.assessment.AssessmentException#PERMISSION_DENIED
     *          PERMISSION_DENIED}, {@link }
     *          org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
     *          CONFIGURATION_ERROR}, {@link }
     *          org.osid.assessment.AssessmentException#UNIMPLEMENTED
     *          UNIMPLEMENTED}, {@link }
     *          org.osid.assessment.AssessmentException#NULL_ARGUMENT
     *          NULL_ARGUMENT}
     * 
     * @access public
     */
    function updateDescription ( $description ) { 
        die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class."); 
    } 
 
    /**
     * Update the data for this Item. This may include the question, responses,
     * answer, instructions, media, etc.  The structure of the Data is not
     * defined in the OSID.
     * 
     * @param object mixed $data (original type: java.io.Serializable)
     * 
     * @throws object AssessmentException An exception with one of
     *          the following messages defined in
     *          org.osid.assessment.AssessmentException may be thrown:  {@link }
     *          org.osid.assessment.AssessmentException#OPERATION_FAILED
     *          OPERATION_FAILED}, {@link }
     *          org.osid.assessment.AssessmentException#PERMISSION_DENIED
     *          PERMISSION_DENIED}, {@link }
     *          org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
     *          CONFIGURATION_ERROR}, {@link }
     *          org.osid.assessment.AssessmentException#UNIMPLEMENTED
     *          UNIMPLEMENTED}, {@link }
     *          org.osid.assessment.AssessmentException#NULL_ARGUMENT
     *          NULL_ARGUMENT}
     * 
     * @access public
     */
    function updateData ( $data ) { 
        die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class."); 
    } 
 
    /**
     * Get the display name for this Item.
     *  
     * @return string 
     * 
     * @throws object AssessmentException An exception with one of
     *          the following messages defined in
     *          org.osid.assessment.AssessmentException may be thrown:  {@link }
     *          org.osid.assessment.AssessmentException#OPERATION_FAILED
     *          OPERATION_FAILED}, {@link }
     *          org.osid.assessment.AssessmentException#PERMISSION_DENIED
     *          PERMISSION_DENIED}, {@link }
     *          org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
     *          CONFIGURATION_ERROR}, {@link }
     *          org.osid.assessment.AssessmentException#UNIMPLEMENTED
     *          UNIMPLEMENTED}
     * 
     * @access public
     */
    function getDisplayName () { 
        die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class."); 
    } 
 
    /**
     * Get the description for this Item.
     *  
     * @return string 
     * 
     * @throws object AssessmentException An exception with one of
     *          the following messages defined in
     *          org.osid.assessment.AssessmentException may be thrown:  {@link }
     *          org.osid.assessment.AssessmentException#OPERATION_FAILED
     *          OPERATION_FAILED}, {@link }
     *          org.osid.assessment.AssessmentException#PERMISSION_DENIED
     *          PERMISSION_DENIED}, {@link }
     *          org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
     *          CONFIGURATION_ERROR}, {@link }
     *          org.osid.assessment.AssessmentException#UNIMPLEMENTED
     *          UNIMPLEMENTED}
     * 
     * @access public
     */
    function getDescription () { 
        die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class."); 
    } 
 
    /**
     * Get the unique Id for this Item.
     *  
     * @return object Id 
     * 
     * @throws object AssessmentException An exception with one of
     *          the following messages defined in
     *          org.osid.assessment.AssessmentException may be thrown:  {@link }
     *          org.osid.assessment.AssessmentException#OPERATION_FAILED
     *          OPERATION_FAILED}, {@link }
     *          org.osid.assessment.AssessmentException#PERMISSION_DENIED
     *          PERMISSION_DENIED}, {@link }
     *          org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
     *          CONFIGURATION_ERROR}, {@link }
     *          org.osid.assessment.AssessmentException#UNIMPLEMENTED
     *          UNIMPLEMENTED}
     * 
     * @access public
     */
    function getId () { 
        die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class."); 
    } 
 
    /**
     * Get the ItemType for this Item.
     *  
     * @return object Type 
     * 
     * @throws object AssessmentException An exception with one of
     *          the following messages defined in
     *          org.osid.assessment.AssessmentException may be thrown:  {@link }
     *          org.osid.assessment.AssessmentException#OPERATION_FAILED
     *          OPERATION_FAILED}, {@link }
     *          org.osid.assessment.AssessmentException#PERMISSION_DENIED
     *          PERMISSION_DENIED}, {@link }
     *          org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
     *          CONFIGURATION_ERROR}, {@link }
     *          org.osid.assessment.AssessmentException#UNIMPLEMENTED
     *          UNIMPLEMENTED}
     * 
     * @access public
     */
    function getItemType () { 
        die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class."); 
    } 
 
    /**
     * Get all the Property Types for  Item.
     *  
     * @return object TypeIterator 
     * 
     * @throws object AssessmentException An exception with one of
     *          the following messages defined in
     *          org.osid.assessment.AssessmentException may be thrown:  {@link }
     *          org.osid.assessment.AssessmentException#OPERATION_FAILED
     *          OPERATION_FAILED}, {@link }
     *          org.osid.assessment.AssessmentException#PERMISSION_DENIED
     *          PERMISSION_DENIED}, {@link }
     *          org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
     *          CONFIGURATION_ERROR}, {@link }
     *          org.osid.assessment.AssessmentException#UNIMPLEMENTED
     *          UNIMPLEMENTED}
     * 
     * @access public
     */
    function getPropertyTypes () { 
        die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class."); 
    } 
 
    /**
     * Get the Properties associated with this Item.
     *  
     * @return object PropertiesIterator 
     * 
     * @throws object AssessmentException An exception with one of
     *          the following messages defined in
     *          org.osid.assessment.AssessmentException may be thrown:  {@link }
     *          org.osid.assessment.AssessmentException#OPERATION_FAILED
     *          OPERATION_FAILED}, {@link }
     *          org.osid.assessment.AssessmentException#PERMISSION_DENIED
     *          PERMISSION_DENIED}, {@link }
     *          org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
     *          CONFIGURATION_ERROR}, {@link }
     *          org.osid.assessment.AssessmentException#UNIMPLEMENTED
     *          UNIMPLEMENTED}
     * 
     * @access public
     */
    function getProperties () { 
        die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class."); 
    } 
 
    /**
     * Get the Data for this Item. This may include the question, responses,
     * answer, instructions, media, etc.  The structure of the Data is not
     * defined in the OSID.
     *  
     * @return object mixed (original type: java.io.Serializable)
     * 
     * @throws object AssessmentException An exception with one of
     *          the following messages defined in
     *          org.osid.assessment.AssessmentException may be thrown:  {@link }
     *          org.osid.assessment.AssessmentException#OPERATION_FAILED
     *          OPERATION_FAILED}, {@link }
     *          org.osid.assessment.AssessmentException#PERMISSION_DENIED
     *          PERMISSION_DENIED}, {@link }
     *          org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
     *          CONFIGURATION_ERROR}, {@link }
     *          org.osid.assessment.AssessmentException#UNIMPLEMENTED
     *          UNIMPLEMENTED}
     * 
     * @access public
     */
    function getData () { 
        die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class."); 
    } 
 
    /**
     * Get the Properties of this Type associated with this Item.
     * 
     * @param object Type $propertiesType 
     *  
     * @return object Properties 
     * 
     * @throws object AssessmentException An exception with one of
     *          the following messages defined in
     *          org.osid.assessment.AssessmentException may be thrown:  {@link }
     *          org.osid.assessment.AssessmentException#OPERATION_FAILED
     *          OPERATION_FAILED}, {@link }
     *          org.osid.assessment.AssessmentException#PERMISSION_DENIED
     *          PERMISSION_DENIED}, {@link }
     *          org.osid.assessment.AssessmentException#CONFIGURATION_ERROR
     *          CONFIGURATION_ERROR}, {@link }
     *          org.osid.assessment.AssessmentException#UNIMPLEMENTED
     *          UNIMPLEMENTED}, {@link }
     *          org.osid.assessment.AssessmentException#NULL_ARGUMENT
     *          NULL_ARGUMENT}, {@link }
     *          org.osid.assessment.AssessmentException#UNKNOWN_TYPE
     *          UNKNOWN_TYPE}
     * 
     * @access public
     */
    function getPropertiesByType ( $propertiesType ) { 
        die ("Method <b>".__FUNCTION__."()</b> declared in interface<b> ".__CLASS__."</b> has not been overloaded in a child class."); 
    } 
}
 
?>
Source for file Item.php
