org.universAAL.ontology.questionnaire
Class AnsweredQuestionnaire

java.lang.Object
  org.universAAL.middleware.rdf.Resource
      org.universAAL.middleware.rdf.FinalizedResource
          org.universAAL.middleware.owl.ManagedIndividual
              org.universAAL.ontology.questionnaire.AnsweredQuestionnaire

public class AnsweredQuestionnaire
extends ManagedIndividual

This class describes the concept of AnswerQuestionnaire, its properties and its associated methods. An answered questionnaire is the questionnaire when a user starts completing it. It can be fully answer, partially answered or not answered at all.

Author:

mdelafuente

Field Summary

static int	CORRECT_ANSWERS
static int	INCORRECT_ANSWERS
static String	MY_URI
static int	NO_CORRECT_ANSWERS
static String	PROP_COMPLETENESS
static String	PROP_IS_ANSWERED_BY
static String	PROP_IS_ASSOCIATED_TO
static String	PROP_IS_COMPOSED_BY

Fields inherited from class org.universAAL.middleware.owl.ManagedIndividual

OWL_NAMESPACE, TYPE_OWL_INDIVIDUAL, TYPE_OWL_THING

Fields inherited from class org.universAAL.middleware.rdf.Resource

ANON_URI_PREFIX, blockAddingTypes, isXMLLiteral, ns_delim_index, PROP_RDF_FIRST, PROP_RDF_REST, PROP_RDF_TYPE, PROP_RDFS_COMMENT, PROP_RDFS_LABEL, PROP_SERIALIZATION_FULL, PROP_SERIALIZATION_OPTIONAL, PROP_SERIALIZATION_REDUCED, PROP_SERIALIZATION_UNDEFINED, PROP_uAAL_INVOLVED_HUMAN_USER, props, RDF_EMPTY_LIST, RDF_NAMESPACE, RDFS_NAMESPACE, TYPE_RDF_LIST, TYPE_RDFS_CLASS, uAAL_NAMESPACE_PREFIX, uAAL_SERVICE_NAMESPACE, uAAL_VOCABULARY_NAMESPACE, uri

Constructor Summary

AnsweredQuestionnaire()

AnsweredQuestionnaire(Questionnaire questionnaire, Answer[] answers, User examinedUser)

AnsweredQuestionnaire(Questionnaire questionnaire, Answer answer, User examinedUser)

AnsweredQuestionnaire(Questionnaire q, User examinedUser)

AnsweredQuestionnaire(String uri)

Method Summary

void	addAnswer(Answer answer) The following method sets the answers that composes the answered questionnaire.
void	answeredToQuestion(Question q, Object answerContent) The following method stores the answer given by the user for a specific question.
void	answeredToQuestion(Question q, Object[] answerContent) The following method stores the answer given by the user for a specific question.
double	calculateCompleteness() The following method calculates the completeness of a questionnaire, given in percentage.
Answer[]	getAnswers() The following method gets the answers that composes the answered questionnaire.
Questionnaire	getAssociatedQuestionnaire() The following method gets the associated questionnaire to an answered questionnaire The name automatically-generated by the modeling tool has been changed to be clearer, from "getIsAssociatedTo" to "getAssociatedQuestionnaire"
Question[]	getAssociatedQuestions(Answer[] answers) The following method gets the associated questions associated to the answers array given, within an answered questionnaire.
String	getClassURI() Get the class URI for this ManagedIndividual.
double	getCompleteness() The following method gets the completeness of an answered questionnaire, given in percentage.
Answer[]	getCorrectAnswers() The following method gets the correct answers given by the user, within an answered questionnaire.
double	getCorrectAnswersPercentage() The following method returns the percentage of correct answers within the answered questionnaire.
Answer[]	getIncorrectAnswers() The following method gets the incorrect answers given by the user, within an answered questionnaire.
double	getIncorrectAnswersPercentage() The following method returns the percentage of incorrect answers within the answered questionnaire.
User	getIsAnsweredBy() The following method gets the user who answers the questionnaire
Answer[]	getNoCorrectAnswers() The following method gets the no-correct answers, that is all the answers that have no correct answer associated, given by the user, within an answered questionnaire.
int	getNumberOfCorrectAnswers() The following method gets the number of correct answers.
int	getNumberOfIncorrectAnswers() The following method gets the number of incorrect answers.
int	getNumberOfNoCorrectAnswers() The following method gets the number of questions within the questionnaire that don't have a correct answer associated.
int	getPropSerializationType(String arg0) Answers if the given property has to be considered when serializing this individual in a minimized way, and if not ignore-able, whether its value should be presented in its full form or can be reduced.
boolean	isWellFormed() Returns true, if the state of the resource is valid, otherwise false.
Question	nextQuestion() The following method returns the next question of a questionnaire
void	setAnswers(Answer[] answers) The following method sets the answers that composes the answered questionnaire.
void	setAssociatedQuestionnaire(Questionnaire questionnaire) The following method sets the associated questionnaire to an answered questionnaire The name automatically-generated by the modeling tool has been changed to be clearer, from "setIsAssociatedTo" to "setAssociatedQuestionnaire"
void	setCompleteness(double completeness) The following method sets the completeness of an answered questionnaire, given in percentage.
void	setIsAnsweredBy(User user) The following method sets the user who answers the questionnaire

Methods inherited from class org.universAAL.middleware.owl.ManagedIndividual

checkCompatibility, checkMembership, copy, deepCopy, getClassRestrictionsOnProperty, getInstance, getNonAbstractSuperClasses, getNonabstractSuperClasses, getOntClassInfo, getTypeURI, isRegisteredClassURI, setProperty, setPropertyPathFromOffset, toManagedIndividual

Methods inherited from class org.universAAL.middleware.rdf.FinalizedResource

addType, getLocalName, getNamespace, getProperty, getPropertyURIs, getType, getTypes, getURI, hasQualifiedName, isAnon, numberOfProperties

Methods inherited from class org.universAAL.middleware.rdf.Resource

addMultiLangProp, asList, asList, asRDFList, changeProperty, equals, generateAnonURI, getDefaultLang, getFilename, getMultiLangProp, getOrConstructLabel, getResource, getResourceComment, getResourceLabel, getStaticFieldValue, hashCode, hasProperty, isAnon, isBlockingAddingTypes, isClosedCollection, isQualifiedName, literal, representsQualifiedURI, serializesAsXMLLiteral, setPropertyPath, setPropertyPath, setResourceComment, setResourceLabel, toString, toStringRecursive, toStringRecursive, unliteral

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

MY_URI

public static final String MY_URI

See Also:

Constant Field Values

PROP_IS_ASSOCIATED_TO

public static final String PROP_IS_ASSOCIATED_TO

See Also:

Constant Field Values

PROP_IS_COMPOSED_BY

public static final String PROP_IS_COMPOSED_BY

See Also:

Constant Field Values

PROP_IS_ANSWERED_BY

public static final String PROP_IS_ANSWERED_BY

See Also:

Constant Field Values

PROP_COMPLETENESS

public static final String PROP_COMPLETENESS

See Also:

Constant Field Values

CORRECT_ANSWERS

public static final int CORRECT_ANSWERS

See Also:

Constant Field Values

INCORRECT_ANSWERS

public static final int INCORRECT_ANSWERS

See Also:

Constant Field Values

NO_CORRECT_ANSWERS

public static final int NO_CORRECT_ANSWERS

See Also:

Constant Field Values

Constructor Detail

AnsweredQuestionnaire

public AnsweredQuestionnaire()

AnsweredQuestionnaire

public AnsweredQuestionnaire(String uri)

AnsweredQuestionnaire

public AnsweredQuestionnaire(Questionnaire questionnaire,
                             Answer[] answers,
                             User examinedUser)

AnsweredQuestionnaire

public AnsweredQuestionnaire(Questionnaire questionnaire,
                             Answer answer,
                             User examinedUser)

AnsweredQuestionnaire

public AnsweredQuestionnaire(Questionnaire q,
                             User examinedUser)

Method Detail

getClassURI

public String getClassURI()

Description copied from class: ManagedIndividual

Get the class URI for this ManagedIndividual. All non-abstract subclasses MUST overwrite this method!

Overrides:

getClassURI in class ManagedIndividual

Returns:

The class URI.

getPropSerializationType

public int getPropSerializationType(String arg0)

Description copied from class: ManagedIndividual

Answers if the given property has to be considered when serializing this individual in a minimized way, and if not ignore-able, whether its value should be presented in its full form or can be reduced. The return value must be one of Resource.PROP_SERIALIZATION_OPTIONAL, Resource.PROP_SERIALIZATION_REDUCED, or Resource.PROP_SERIALIZATION_FULL. It can be assumed that the given property is one of those returned by FinalizedResource.getPropertyURIs(). Decision criterion should be if the value of this property is absolutely necessary when this resource is being sent to a remote node. If the subclass rates it as unlikely that the receiver side would need this info, the answer should be PROP_SERIALIZATION_OPTIONAL in favor of lower communication traffic and higher performance even at risk of a possible additional query on the receiver side for fetching this info. With the same rationale, if a property should be included in the process of serialization, it is preferable to include it in a reduced form; in this case the return value should be PROP_SERIALIZATION_REDUCED, otherwise PROP_SERIALIZATION_FULL can be returned.

Specified by:

getPropSerializationType in class ManagedIndividual

isWellFormed

public boolean isWellFormed()

Description copied from class: Resource

Returns true, if the state of the resource is valid, otherwise false.

Subclasses should overwrite this methods as the default implementation returns always true.

Overrides:

isWellFormed in class ManagedIndividual

See Also:

Resource.isWellFormed()

getIsAnsweredBy

public User getIsAnsweredBy()

The following method gets the user who answers the questionnaire

Returns:

User

See Also:

User

setIsAnsweredBy

public void setIsAnsweredBy(User user)

The following method sets the user who answers the questionnaire

Parameters:

user - User

See Also:

User

getAnswers

public Answer[] getAnswers()

The following method gets the answers that composes the answered questionnaire. The name automatically-generated by the modeling tool has been changed to be clearer, from "isComposedBy" to "getAnswers"

Returns:

Answer[], the array in which the answers will be given ( Answer)

See Also:

Answer

addAnswer

public void addAnswer(Answer answer)

The following method sets the answers that composes the answered questionnaire.

Parameters:

answer - , the answer that will be added to the answered questionnaire. (Answer)

See Also:

Answer

setAnswers

public void setAnswers(Answer[] answers)

The following method sets the answers that composes the answered questionnaire.

Parameters:

Answer - , the answer that will be added to the answered questionnaire. (Answer)

See Also:

Answer

getAssociatedQuestionnaire

public Questionnaire getAssociatedQuestionnaire()

The following method gets the associated questionnaire to an answered questionnaire The name automatically-generated by the modeling tool has been changed to be clearer, from "getIsAssociatedTo" to "getAssociatedQuestionnaire"

Returns:

Questionnaire (Questionnaire)

setAssociatedQuestionnaire

public void setAssociatedQuestionnaire(Questionnaire questionnaire)

The following method sets the associated questionnaire to an answered questionnaire The name automatically-generated by the modeling tool has been changed to be clearer, from "setIsAssociatedTo" to "setAssociatedQuestionnaire"

Parameters:

questionnaire - (Questionnaire)

getCompleteness

public double getCompleteness()

The following method gets the completeness of an answered questionnaire, given in percentage.

Returns:

completeness (Double)

setCompleteness

public void setCompleteness(double completeness)

The following method sets the completeness of an answered questionnaire, given in percentage.

Parameters:

completeness - (Double)

getCorrectAnswersPercentage

public double getCorrectAnswersPercentage()

The following method returns the percentage of correct answers within the answered questionnaire.

Returns:

the percentage of the correct answers within the answered questionnaire (Double)

getIncorrectAnswersPercentage

public double getIncorrectAnswersPercentage()

The following method returns the percentage of incorrect answers within the answered questionnaire.

Returns:

the percentage of the incorrect answers within the answered questionnaire (Double)

getNumberOfIncorrectAnswers

public int getNumberOfIncorrectAnswers()

The following method gets the number of incorrect answers. Can be useful if we don't want this parameter given as a percentage

Returns:

the number of incorrect answers (Integer)

getNumberOfCorrectAnswers

public int getNumberOfCorrectAnswers()

The following method gets the number of correct answers. Can be useful if we don't want this parameter given as a percentage

Returns:

the number of correct answers (Integer)

getNumberOfNoCorrectAnswers

public int getNumberOfNoCorrectAnswers()

The following method gets the number of questions within the questionnaire that don't have a correct answer associated.

Returns:

number of questions with no-correct/correct answer associated ( Integer)

getIncorrectAnswers

public Answer[] getIncorrectAnswers()

The following method gets the incorrect answers given by the user, within an answered questionnaire.

Returns:

an array filled with the incorrect answers (Answer)

See Also:

Answer

getCorrectAnswers

public Answer[] getCorrectAnswers()

The following method gets the correct answers given by the user, within an answered questionnaire.

Returns:

an array filled with the correct answers (Answer)

See Also:

Answer

getNoCorrectAnswers

public Answer[] getNoCorrectAnswers()

The following method gets the no-correct answers, that is all the answers that have no correct answer associated, given by the user, within an answered questionnaire.

Returns:

an array filled with the no-correct answers (Answer)

See Also:

Answer

getAssociatedQuestions

public Question[] getAssociatedQuestions(Answer[] answers)

The following method gets the associated questions associated to the answers array given, within an answered questionnaire.

Returns:

an array filled with the questions, associated to the answers array given (Question)

See Also:

Question, Answer

nextQuestion

public Question nextQuestion()

The following method returns the next question of a questionnaire

Returns:

questionnaire's next question (Question)

See Also:

Question

calculateCompleteness

public double calculateCompleteness()

The following method calculates the completeness of a questionnaire, given in percentage.

Returns:

the completed percentage of the questionnaire (Double)

answeredToQuestion

public void answeredToQuestion(Question q,
                               Object answerContent)

The following method stores the answer given by the user for a specific question.

Parameters:

q - (Question)

answerContent - , just one Resource (Object)

See Also:

Answer

answeredToQuestion

public void answeredToQuestion(Question q,
                               Object[] answerContent)

The following method stores the answer given by the user for a specific question.

Parameters:

q - (Question)

answerContent - , more than one Resource (Object)

See Also:

Answer