/*==========================================================================*\
| _StudentAnswer.java
|*-------------------------------------------------------------------------*|
| Created by eogenerator
| DO NOT EDIT. Make changes to StudentAnswer.java instead.
|*-------------------------------------------------------------------------*|
| Copyright (C) 2006-2009 Virginia Tech
|
| This file is part of Web-CAT.
|
| Web-CAT is free software; you can redistribute it and/or modify
| it under the terms of the GNU Affero General Public License as published
| by the Free Software Foundation; either version 3 of the License, or
| (at your option) any later version.
|
| Web-CAT is distributed in the hope that it will be useful,
| but WITHOUT ANY WARRANTY; without even the implied warranty of
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
| GNU General Public License for more details.
|
| You should have received a copy of the GNU Affero General Public License
| along with Web-CAT; if not, see <http://www.gnu.org/licenses/>.
\*==========================================================================*/
package org.webcat.outcomesmeasurement;
import com.webobjects.eoaccess.*;
import com.webobjects.eocontrol.*;
import com.webobjects.foundation.*;
import er.extensions.eof.ERXEOControlUtilities;
import er.extensions.eof.ERXKey;
import org.apache.log4j.Logger;
// -------------------------------------------------------------------------
/**
* An automatically generated EOGenericRecord subclass. DO NOT EDIT.
* To change, use EOModeler, or make additions in
* StudentAnswer.java.
*
* @author Generated by eogenerator
* @version version suppressed to control auto-generation
*/
public abstract class _StudentAnswer
extends er.extensions.eof.ERXGenericRecord
{
//~ Constructors ..........................................................
// ----------------------------------------------------------
/**
* Creates a new _StudentAnswer object.
*/
public _StudentAnswer()
{
super();
}
// ----------------------------------------------------------
/**
* A static factory method for creating a new
* StudentAnswer object given required
* attributes and relationships.
* @param editingContext The context in which the new object will be
* inserted
* @param percentEarnedValue
* @param pointsEarnedValue
* @param courseworkValue
* @param userValue
* @return The newly created object
*/
public static StudentAnswer create(
EOEditingContext editingContext,
Double percentEarnedValue,
Double pointsEarnedValue,
org.webcat.outcomesmeasurement.Coursework courseworkValue,
org.webcat.core.User userValue
)
{
StudentAnswer eoObject = (StudentAnswer)
EOUtilities.createAndInsertInstance(
editingContext,
_StudentAnswer.ENTITY_NAME);
eoObject.setPercentEarned(percentEarnedValue);
eoObject.setPointsEarned(pointsEarnedValue);
eoObject.setCourseworkRelationship(courseworkValue);
eoObject.setUserRelationship(userValue);
return eoObject;
}
// ----------------------------------------------------------
/**
* Get a local instance of the given object in another editing context.
* @param editingContext The target editing context
* @param eo The object to import
* @return An instance of the given object in the target editing context
*/
public static StudentAnswer localInstance(
EOEditingContext editingContext, StudentAnswer eo)
{
return (eo == null)
? null
: (StudentAnswer)EOUtilities.localInstanceOfObject(
editingContext, eo);
}
// ----------------------------------------------------------
/**
* Look up an object by id number. Assumes the editing
* context is appropriately locked.
* @param ec The editing context to use
* @param id The id to look up
* @return The object, or null if no such id exists
*/
public static StudentAnswer forId(
EOEditingContext ec, int id )
{
StudentAnswer obj = null;
if (id > 0)
{
NSArray<StudentAnswer> results =
objectsMatchingValues(ec, "id", new Integer(id));
if (results != null && results.count() > 0)
{
obj = results.objectAtIndex(0);
}
}
return obj;
}
// ----------------------------------------------------------
/**
* Look up an object by id number. Assumes the editing
* context is appropriately locked.
* @param ec The editing context to use
* @param id The id to look up
* @return The object, or null if no such id exists
*/
public static StudentAnswer forId(
EOEditingContext ec, String id )
{
return forId( ec, er.extensions.foundation.ERXValueUtilities.intValue( id ) );
}
//~ Constants (for key names) .............................................
// Attributes ---
public static final String PERCENT_EARNED_KEY = "percentEarned";
public static final ERXKey<Double> percentEarned =
new ERXKey<Double>(PERCENT_EARNED_KEY);
public static final String POINTS_EARNED_KEY = "pointsEarned";
public static final ERXKey<Double> pointsEarned =
new ERXKey<Double>(POINTS_EARNED_KEY);
public static final String RESPONSE_KEY = "response";
public static final ERXKey<String> response =
new ERXKey<String>(RESPONSE_KEY);
// To-one relationships ---
public static final String COURSEWORK_KEY = "coursework";
public static final ERXKey<org.webcat.outcomesmeasurement.Coursework> coursework =
new ERXKey<org.webcat.outcomesmeasurement.Coursework>(COURSEWORK_KEY);
public static final String USER_KEY = "user";
public static final ERXKey<org.webcat.core.User> user =
new ERXKey<org.webcat.core.User>(USER_KEY);
// To-many relationships ---
// Fetch specifications ---
public static final String ENTITY_NAME = "StudentAnswer";
//~ Methods ...............................................................
// ----------------------------------------------------------
/**
* Get a local instance of this object in another editing context.
* @param editingContext The target editing context
* @return An instance of this object in the target editing context
*/
public StudentAnswer localInstance(EOEditingContext editingContext)
{
return (StudentAnswer)EOUtilities.localInstanceOfObject(
editingContext, this);
}
// ----------------------------------------------------------
/**
* Get a list of changes between this object's current state and the
* last committed version.
* @return a dictionary of the changes that have not yet been committed
*/
@SuppressWarnings("unchecked")
public NSDictionary<String, Object> changedProperties()
{
return changesFromSnapshot(
editingContext().committedSnapshotForObject(this) );
}
// ----------------------------------------------------------
/**
* Retrieve this object's <code>id</code> value.
* @return the value of the attribute
*/
public Number id()
{
try
{
return (Number)EOUtilities.primaryKeyForObject(
editingContext() , this ).objectForKey( "id" );
}
catch (Exception e)
{
return er.extensions.eof.ERXConstant.ZeroInteger;
}
}
// ----------------------------------------------------------
/**
* Retrieve this object's <code>percentEarned</code> value.
* @return the value of the attribute
*/
public Double percentEarned()
{
return (Double)storedValueForKey( "percentEarned" );
}
// ----------------------------------------------------------
/**
* Change the value of this object's <code>percentEarned</code>
* property.
*
* @param value The new value for this property
*/
public void setPercentEarned( Double value )
{
if (log.isDebugEnabled())
{
log.debug( "setPercentEarned("
+ value + "): was " + percentEarned() );
}
takeStoredValueForKey( value, "percentEarned" );
}
// ----------------------------------------------------------
/**
* Retrieve this object's <code>pointsEarned</code> value.
* @return the value of the attribute
*/
public Double pointsEarned()
{
return (Double)storedValueForKey( "pointsEarned" );
}
// ----------------------------------------------------------
/**
* Change the value of this object's <code>pointsEarned</code>
* property.
*
* @param value The new value for this property
*/
public void setPointsEarned( Double value )
{
if (log.isDebugEnabled())
{
log.debug( "setPointsEarned("
+ value + "): was " + pointsEarned() );
}
takeStoredValueForKey( value, "pointsEarned" );
}
// ----------------------------------------------------------
/**
* Retrieve this object's <code>response</code> value.
* @return the value of the attribute
*/
public String response()
{
return (String)storedValueForKey( "response" );
}
// ----------------------------------------------------------
/**
* Change the value of this object's <code>response</code>
* property.
*
* @param value The new value for this property
*/
public void setResponse( String value )
{
if (log.isDebugEnabled())
{
log.debug( "setResponse("
+ value + "): was " + response() );
}
takeStoredValueForKey( value, "response" );
}
// ----------------------------------------------------------
/**
* Retrieve the entity pointed to by the <code>coursework</code>
* relationship.
* @return the entity in the relationship
*/
public org.webcat.outcomesmeasurement.Coursework coursework()
{
return (org.webcat.outcomesmeasurement.Coursework)storedValueForKey( "coursework" );
}
// ----------------------------------------------------------
/**
* Set the entity pointed to by the <code>coursework</code>
* relationship (DO NOT USE--instead, use
* <code>setCourseworkRelationship()</code>.
* This method is provided for WebObjects use.
*
* @param value The new entity to relate to
*/
public void setCoursework( org.webcat.outcomesmeasurement.Coursework value )
{
if (log.isDebugEnabled())
{
log.debug( "setCoursework("
+ value + "): was " + coursework() );
}
takeStoredValueForKey( value, "coursework" );
}
// ----------------------------------------------------------
/**
* Set the entity pointed to by the <code>coursework</code>
* relationship. This method is a type-safe version of
* <code>addObjectToBothSidesOfRelationshipWithKey()</code>.
*
* @param value The new entity to relate to
*/
public void setCourseworkRelationship(
org.webcat.outcomesmeasurement.Coursework value )
{
if (log.isDebugEnabled())
{
log.debug( "setCourseworkRelationship("
+ value + "): was " + coursework() );
}
if ( value == null )
{
org.webcat.outcomesmeasurement.Coursework object = coursework();
if ( object != null )
removeObjectFromBothSidesOfRelationshipWithKey( object, "coursework" );
}
else
{
addObjectToBothSidesOfRelationshipWithKey( value, "coursework" );
}
}
// ----------------------------------------------------------
/**
* Retrieve the entity pointed to by the <code>user</code>
* relationship.
* @return the entity in the relationship
*/
public org.webcat.core.User user()
{
return (org.webcat.core.User)storedValueForKey( "user" );
}
// ----------------------------------------------------------
/**
* Set the entity pointed to by the <code>user</code>
* relationship (DO NOT USE--instead, use
* <code>setUserRelationship()</code>.
* This method is provided for WebObjects use.
*
* @param value The new entity to relate to
*/
public void setUser( org.webcat.core.User value )
{
if (log.isDebugEnabled())
{
log.debug( "setUser("
+ value + "): was " + user() );
}
takeStoredValueForKey( value, "user" );
}
// ----------------------------------------------------------
/**
* Set the entity pointed to by the <code>user</code>
* relationship. This method is a type-safe version of
* <code>addObjectToBothSidesOfRelationshipWithKey()</code>.
*
* @param value The new entity to relate to
*/
public void setUserRelationship(
org.webcat.core.User value )
{
if (log.isDebugEnabled())
{
log.debug( "setUserRelationship("
+ value + "): was " + user() );
}
if ( value == null )
{
org.webcat.core.User object = user();
if ( object != null )
removeObjectFromBothSidesOfRelationshipWithKey( object, "user" );
}
else
{
addObjectToBothSidesOfRelationshipWithKey( value, "user" );
}
}
// ----------------------------------------------------------
/**
* Retrieve objects using a fetch specification.
*
* @param context The editing context to use
* @param fspec The fetch specification to use
*
* @return an NSArray of the entities retrieved
*/
@SuppressWarnings("unchecked")
public static NSArray<StudentAnswer> objectsWithFetchSpecification(
EOEditingContext context,
EOFetchSpecification fspec)
{
return context.objectsWithFetchSpecification(fspec);
}
// ----------------------------------------------------------
/**
* Retrieve all objects of this type.
*
* @param context The editing context to use
*
* @return an NSArray of the entities retrieved
*/
public static NSArray<StudentAnswer> allObjects(
EOEditingContext context)
{
return objectsMatchingQualifier(context, null, null);
}
// ----------------------------------------------------------
/**
* Retrieve objects using a qualifier.
*
* @param context The editing context to use
* @param qualifier The qualifier to use
*
* @return an NSArray of the entities retrieved
*/
public static NSArray<StudentAnswer> objectsMatchingQualifier(
EOEditingContext context,
EOQualifier qualifier)
{
return objectsMatchingQualifier(context, qualifier, null);
}
// ----------------------------------------------------------
/**
* Retrieve objects using a qualifier and sort orderings.
*
* @param context The editing context to use
* @param qualifier The qualifier to use
* @param sortOrderings The sort orderings to use
*
* @return an NSArray of the entities retrieved
*/
public static NSArray<StudentAnswer> objectsMatchingQualifier(
EOEditingContext context,
EOQualifier qualifier,
NSArray<EOSortOrdering> sortOrderings)
{
EOFetchSpecification fspec = new EOFetchSpecification(
ENTITY_NAME, qualifier, sortOrderings);
fspec.setUsesDistinct(true);
return objectsWithFetchSpecification(context, fspec);
}
// ----------------------------------------------------------
/**
* Retrieve the first object that matches a qualifier, when
* sorted with the specified sort orderings.
*
* @param context The editing context to use
* @param qualifier The qualifier to use
* @param sortOrderings the sort orderings
*
* @return the first entity that was retrieved, or null if there was none
*/
public static StudentAnswer firstObjectMatchingQualifier(
EOEditingContext context,
EOQualifier qualifier,
NSArray<EOSortOrdering> sortOrderings)
{
NSArray<StudentAnswer> results =
objectsMatchingQualifier(context, qualifier, sortOrderings);
return (results.size() > 0)
? results.get(0)
: null;
}
// ----------------------------------------------------------
/**
* Retrieve a single object using a list of keys and values to match.
*
* @param context The editing context to use
* @param qualifier The qualifier to use
*
* @return the single entity that was retrieved
*
* @throws EOUtilities.MoreThanOneException
* if there is more than one matching object
*/
public static StudentAnswer uniqueObjectMatchingQualifier(
EOEditingContext context,
EOQualifier qualifier) throws EOUtilities.MoreThanOneException
{
NSArray<StudentAnswer> results =
objectsMatchingQualifier(context, qualifier);
if (results.size() > 1)
{
throw new EOUtilities.MoreThanOneException(null);
}
return (results.size() > 0)
? results.get(0)
: null;
}
// ----------------------------------------------------------
/**
* Retrieve objects using a list of keys and values to match.
*
* @param context The editing context to use
* @param keysAndValues a list of keys and values to match, alternating
* "key", "value", "key", "value"...
*
* @return an NSArray of the entities retrieved
*/
public static NSArray<StudentAnswer> objectsMatchingValues(
EOEditingContext context,
Object... keysAndValues)
{
if (keysAndValues.length % 2 != 0)
{
throw new IllegalArgumentException("There should a value " +
"corresponding to every key that was passed.");
}
NSMutableDictionary<String, Object> valueDictionary =
new NSMutableDictionary<String, Object>();
for (int i = 0; i < keysAndValues.length; i += 2)
{
Object key = keysAndValues[i];
Object value = keysAndValues[i + 1];
if (!(key instanceof String))
{
throw new IllegalArgumentException("Keys should be strings.");
}
valueDictionary.setObjectForKey(value, key);
}
return objectsMatchingValues(context, valueDictionary);
}
// ----------------------------------------------------------
/**
* Retrieve objects using a dictionary of keys and values to match.
*
* @param context The editing context to use
* @param keysAndValues a dictionary of keys and values to match
*
* @return an NSArray of the entities retrieved
*/
@SuppressWarnings("unchecked")
public static NSArray<StudentAnswer> objectsMatchingValues(
EOEditingContext context,
NSDictionary<String, Object> keysAndValues)
{
return EOUtilities.objectsMatchingValues(context, ENTITY_NAME,
keysAndValues);
}
// ----------------------------------------------------------
/**
* Retrieve the first object that matches a set of keys and values, when
* sorted with the specified sort orderings.
*
* @param context The editing context to use
* @param sortOrderings the sort orderings
* @param keysAndValues a list of keys and values to match, alternating
* "key", "value", "key", "value"...
*
* @return the first entity that was retrieved, or null if there was none
*/
public static StudentAnswer firstObjectMatchingValues(
EOEditingContext context,
NSArray<EOSortOrdering> sortOrderings,
Object... keysAndValues)
{
if (keysAndValues.length % 2 != 0)
{
throw new IllegalArgumentException("There should a value " +
"corresponding to every key that was passed.");
}
NSMutableDictionary<String, Object> valueDictionary =
new NSMutableDictionary<String, Object>();
for (int i = 0; i < keysAndValues.length; i += 2)
{
Object key = keysAndValues[i];
Object value = keysAndValues[i + 1];
if (!(key instanceof String))
{
throw new IllegalArgumentException("Keys should be strings.");
}
valueDictionary.setObjectForKey(value, key);
}
return firstObjectMatchingValues(
context, sortOrderings, valueDictionary);
}
// ----------------------------------------------------------
/**
* Retrieves the first object that matches a set of keys and values, when
* sorted with the specified sort orderings.
*
* @param context The editing context to use
* @param sortOrderings the sort orderings
* @param keysAndValues a dictionary of keys and values to match
*
* @return the first entity that was retrieved, or null if there was none
*/
public static StudentAnswer firstObjectMatchingValues(
EOEditingContext context,
NSArray<EOSortOrdering> sortOrderings,
NSDictionary<String, Object> keysAndValues)
{
EOFetchSpecification fspec = new EOFetchSpecification(
ENTITY_NAME,
EOQualifier.qualifierToMatchAllValues(keysAndValues),
sortOrderings);
fspec.setFetchLimit(1);
NSArray<StudentAnswer> result =
objectsWithFetchSpecification( context, fspec );
if ( result.count() == 0 )
{
return null;
}
else
{
return result.objectAtIndex(0);
}
}
// ----------------------------------------------------------
/**
* Retrieve a single object using a list of keys and values to match.
*
* @param context The editing context to use
* @param keysAndValues a list of keys and values to match, alternating
* "key", "value", "key", "value"...
*
* @return the single entity that was retrieved, or null if there was none
*
* @throws EOUtilities.MoreThanOneException
* if there is more than one matching object
*/
public static StudentAnswer uniqueObjectMatchingValues(
EOEditingContext context,
Object... keysAndValues) throws EOUtilities.MoreThanOneException
{
if (keysAndValues.length % 2 != 0)
{
throw new IllegalArgumentException("There should a value " +
"corresponding to every key that was passed.");
}
NSMutableDictionary<String, Object> valueDictionary =
new NSMutableDictionary<String, Object>();
for (int i = 0; i < keysAndValues.length; i += 2)
{
Object key = keysAndValues[i];
Object value = keysAndValues[i + 1];
if (!(key instanceof String))
{
throw new IllegalArgumentException("Keys should be strings.");
}
valueDictionary.setObjectForKey(value, key);
}
return uniqueObjectMatchingValues(context, valueDictionary);
}
// ----------------------------------------------------------
/**
* Retrieve an object using a dictionary of keys and values to match.
*
* @param context The editing context to use
* @param keysAndValues a dictionary of keys and values to match
*
* @return the single entity that was retrieved, or null if there was none
*
* @throws EOUtilities.MoreThanOneException
* if there is more than one matching object
*/
public static StudentAnswer uniqueObjectMatchingValues(
EOEditingContext context,
NSDictionary<String, Object> keysAndValues)
throws EOUtilities.MoreThanOneException
{
try
{
return (StudentAnswer)EOUtilities.objectMatchingValues(
context, ENTITY_NAME, keysAndValues);
}
catch (EOObjectNotAvailableException e)
{
return null;
}
}
// ----------------------------------------------------------
/**
* Retrieve the count of all objects of this type.
*
* @param context The editing context to use
*
* @return the count of all objects
*/
public static int countOfAllObjects(EOEditingContext context)
{
return countOfObjectsMatchingQualifier(context, null);
}
// ----------------------------------------------------------
/**
* Retrieve the count of objects that match a qualifier.
*
* @param context The editing context to use
* @param qualifier The qualifier to use
*
* @return the count of objects matching the qualifier
*/
public static int countOfObjectsMatchingQualifier(
EOEditingContext context, EOQualifier qualifier)
{
return ERXEOControlUtilities.objectCountWithQualifier(
context, ENTITY_NAME, qualifier);
}
// ----------------------------------------------------------
/**
* Retrieve the count of objects using a list of keys and values to match.
*
* @param context The editing context to use
* @param keysAndValues a list of keys and values to match, alternating
* "key", "value", "key", "value"...
*
* @return the count of objects that match the specified values
*/
public static int countOfObjectsMatchingValues(
EOEditingContext context,
Object... keysAndValues)
{
if (keysAndValues.length % 2 != 0)
{
throw new IllegalArgumentException("There should a value " +
"corresponding to every key that was passed.");
}
NSMutableDictionary<String, Object> valueDictionary =
new NSMutableDictionary<String, Object>();
for (int i = 0; i < keysAndValues.length; i += 2)
{
Object key = keysAndValues[i];
Object value = keysAndValues[i + 1];
if (!(key instanceof String))
{
throw new IllegalArgumentException("Keys should be strings.");
}
valueDictionary.setObjectForKey(value, key);
}
return countOfObjectsMatchingValues(context, valueDictionary);
}
// ----------------------------------------------------------
/**
* Retrieve the count of objects using a dictionary of keys and values to
* match.
*
* @param context The editing context to use
* @param keysAndValues a dictionary of keys and values to match
*
* @return the count of objects that matched the specified values
*/
@SuppressWarnings("unchecked")
public static int countOfObjectsMatchingValues(
EOEditingContext context,
NSDictionary<String, Object> keysAndValues)
{
return countOfObjectsMatchingQualifier(context,
EOQualifier.qualifierToMatchAllValues(keysAndValues));
}
// ----------------------------------------------------------
/**
* Produce a string representation of this object. This implementation
* calls UserPresentableDescription(), which uses WebObjects' internal
* mechanism to print out the visible fields of this object. Normally,
* subclasses would override userPresentableDescription() to change
* the way the object is printed.
*
* @return A string representation of the object's value
*/
public String toString()
{
return userPresentableDescription();
}
//~ Instance/static variables .............................................
static Logger log = Logger.getLogger( StudentAnswer.class );
}