kotkabeans
Class PistelaskuTools

java.lang.Object
  |
  +--kotkabeans.PistelaskuTools

public class PistelaskuTools
extends java.lang.Object

Provides methods to EcmaScripts.

See Also:
Course, Student

Field Summary
protected  java.util.ArrayList allowedGrades
           
protected  CourseInstance course
           
protected static int DIVIDER
           
protected  java.lang.String kentat
           
protected  Error msgs
           
protected  java.util.Date now
           
protected  java.util.ArrayList opiskelijat
           
protected  int studentID
           
protected  java.util.Hashtable students
           
protected  int teacherID
           
 
Constructor Summary
PistelaskuTools()
          Just dummy constructor.
 
Method Summary
 void addStudent(int id, Student student)
          Adds new Student with his Fields to students
 int checkOrganisationHierarchy(int userOrgID, int courseOrgID)
          Returns a flag if the user's organisation and course's organisation are close in org. hierarchy.
 void clearPrints()
           
 int compareGrade(java.lang.String grade1, java.lang.String grade2)
           
protected  boolean containsField(java.lang.String field)
          Checks if attribute kentat already contains field.
 void deleteGrade()
           
 double getAverage(java.lang.String s, int i1, int i2)
          Kenttien s+i1 - s+i2 keskiarvo tai 0.0
 CourseInstance getCourse()
           
 int getCourseOrganisationID()
           
static long getCourseTime()
          Returns an origo for comparing and evaluating the student ranks.
 double getCredits()
           
 double getCredits(double defaultValue)
          Gets student's credits in the course if it has been set else returns defaultValue.
 double getCreditsInMajorSubject()
           
 double getCreditsInMinorSubjects()
           
 double getDefaultCredits()
          Returns course's default credits.
 double getDefaultCredits(double defaultValue)
          Returns course's default credits or defaultValue set by user.
 double getDefaultGredits()
          Returns course's default credits.
 java.lang.String getDepartment()
           
 int getDepartmentAsOrganisationID()
           
 double getDouble(java.lang.String fieldName)
           
 double getDouble(java.lang.String fieldName, double defaultValue)
           
 boolean getFields()
          Hakee tietokannasta kurssin opiskelijoiden fieldsit ja tallentaa ne Tätä pitäisi kutsua Pistelasku:sta, kun pre-skripti on ajettu (eli kun kaikki kentät on asetettu setFields:llä)
 int getFirstYearAtUniversity()
           
 java.lang.String getGrade(double points)
           
 int getHomeOrganisationID()
           
 int getInt(java.lang.String fieldName)
           
 int getInt(java.lang.String fieldName, int defaultValue)
           
 java.lang.String getMajorSubject()
           
 double getMax(java.lang.String s, int i1, int i2)
          Kenttien s+i1 - s+i2 maksimi tai 0.0
 double getMin(java.lang.String s, int i1, int i2)
          Kenttien s+i1 - s+i2 minimi tai 0.0
 int getOrganisationWeight(int userOrgID, int courseOrgID)
           
 java.util.ArrayList getPrints()
           
 long getRank()
           
 double getSelfInformedCredits()
           
 java.lang.String getString(java.lang.String fieldName)
           
 java.lang.String getString(java.lang.String fieldName, java.lang.String defaultValue)
           
 Student getStudent(int id)
          Returns wanted Student
 java.lang.String getStudentGrade()
          Returns student's grade in course if it has been set.
 int getStudentID()
           
 java.lang.String getStudentName()
          Returns student's whole name.
 java.util.Hashtable getStudents()
           
 java.lang.String getStudyingLocation()
           
 double getSum(java.lang.String s, int i1, int i2)
          Kenttien s+i1 - s+i2 summa tai 0.0
 int getTeacherID()
           
 long getTime()
           
 double getTotalCredits()
           
 java.lang.String getValue(java.lang.String fieldName)
           
 java.lang.String getValue(java.lang.String fieldName, java.lang.String defaultValue)
          The method that all other get-methods use for getting student's Field's value.
 double gradeValue(int gradeid)
           
 double gradeValue(java.lang.String grade)
           
 void init(java.lang.String ciID, int teachID, java.util.ArrayList ops)
          Inits these tools to be used in selected course to one student.
 void init(java.lang.String ciID, int teachID, java.util.ArrayList ops, int eventGroupID)
           
 java.lang.String maxGrade(java.lang.String grade1, java.lang.String grade2)
           
 java.lang.String maxGrade(java.lang.String grade1, java.lang.String grade2, java.lang.String grade3)
           
 java.lang.String maxGrade(java.lang.String grade1, java.lang.String grade2, java.lang.String grade3, java.lang.String grade4)
           
 void print(double d)
           
 void print(int i)
           
 void print(java.lang.String text)
           
 void removeGrade()
           
 void saveCredits(double credits)
          Saves student's credits in the course.
 void saveGrade(java.lang.String grade)
           
 void saveGrade(java.lang.String grade, double credits)
          Saves student's grade in the course.
 void setDouble(java.lang.String fieldName, double fieldValue)
           
protected  void setFields(java.lang.String fields)
           
 void setInt(java.lang.String fieldName, double fieldValue)
           
 void setRank(long r)
           
 void setString(java.lang.String fieldName, double fieldValue)
           
 void setString(java.lang.String fieldName, int fieldValue)
           
 void setString(java.lang.String fieldName, java.lang.String fieldValue)
           
 void setStudentID(int id)
           
 void setTeacherID(int id)
           
 void setTime(java.lang.String timeStamp)
          Sets the course participant registration time into use.
protected  void setValue(java.lang.String fieldName, double fieldValue)
          It is not possible to use this straight from ecma-script
protected  void setValue(java.lang.String fieldName, java.lang.String fieldValue)
          Updates field's value to student.
 void use(java.lang.String fields)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

studentID

protected int studentID

teacherID

protected int teacherID

course

protected CourseInstance course

students

protected java.util.Hashtable students

opiskelijat

protected java.util.ArrayList opiskelijat

kentat

protected java.lang.String kentat

msgs

protected Error msgs

DIVIDER

protected static final int DIVIDER
See Also:
Constant Field Values

now

protected java.util.Date now

allowedGrades

protected java.util.ArrayList allowedGrades
Constructor Detail

PistelaskuTools

public PistelaskuTools()
Just dummy constructor. Needed attributes (course, studentID, teachID) must be set later if this constructor is used.

See Also:
init(java.lang.String, int, java.util.ArrayList)
Method Detail

setStudentID

public void setStudentID(int id)

setTeacherID

public void setTeacherID(int id)

getStudentID

public int getStudentID()

getTeacherID

public int getTeacherID()

getCourse

public CourseInstance getCourse()

getStudents

public java.util.Hashtable getStudents()

init

public void init(java.lang.String ciID,
                 int teachID,
                 java.util.ArrayList ops)
Inits these tools to be used in selected course to one student.

Parameters:
ciID - courseinstanceID
teachID - teacher's personID who is making evaluation

init

public void init(java.lang.String ciID,
                 int teachID,
                 java.util.ArrayList ops,
                 int eventGroupID)

addStudent

public void addStudent(int id,
                       Student student)
Adds new Student with his Fields to students

Parameters:
id - student's personID
student - Student including Fields

getStudent

public Student getStudent(int id)
Returns wanted Student

Parameters:
id - student's personID
Returns:
Student including Fields.

getStudentName

public java.lang.String getStudentName()
Returns student's whole name.


getDefaultCredits

public double getDefaultCredits()
Returns course's default credits.


setValue

protected void setValue(java.lang.String fieldName,
                        java.lang.String fieldValue)
Updates field's value to student. It is not possible to use this straight from ecma-script

Parameters:
fieldName - wanted field's genericname
fieldValue - value to set

setValue

protected void setValue(java.lang.String fieldName,
                        double fieldValue)
It is not possible to use this straight from ecma-script


setInt

public void setInt(java.lang.String fieldName,
                   double fieldValue)

setDouble

public void setDouble(java.lang.String fieldName,
                      double fieldValue)

setString

public void setString(java.lang.String fieldName,
                      java.lang.String fieldValue)

setString

public void setString(java.lang.String fieldName,
                      int fieldValue)

setString

public void setString(java.lang.String fieldName,
                      double fieldValue)

getValue

public java.lang.String getValue(java.lang.String fieldName,
                                 java.lang.String defaultValue)
The method that all other get-methods use for getting student's Field's value.

Parameters:
fieldName - wanted Field's name
defaultValue - if wanted Field doesn't exist then this is returned
Returns:
wanted Field's value or defaultValue

getValue

public java.lang.String getValue(java.lang.String fieldName)

getInt

public int getInt(java.lang.String fieldName)

getInt

public int getInt(java.lang.String fieldName,
                  int defaultValue)

getDouble

public double getDouble(java.lang.String fieldName)

getDouble

public double getDouble(java.lang.String fieldName,
                        double defaultValue)

getString

public java.lang.String getString(java.lang.String fieldName)

getString

public java.lang.String getString(java.lang.String fieldName,
                                  java.lang.String defaultValue)

getMin

public double getMin(java.lang.String s,
                     int i1,
                     int i2)
Kenttien s+i1 - s+i2 minimi tai 0.0


getMax

public double getMax(java.lang.String s,
                     int i1,
                     int i2)
Kenttien s+i1 - s+i2 maksimi tai 0.0


getAverage

public double getAverage(java.lang.String s,
                         int i1,
                         int i2)
Kenttien s+i1 - s+i2 keskiarvo tai 0.0


getSum

public double getSum(java.lang.String s,
                     int i1,
                     int i2)
Kenttien s+i1 - s+i2 summa tai 0.0


getStudentGrade

public java.lang.String getStudentGrade()
Returns student's grade in course if it has been set.


saveGrade

public void saveGrade(java.lang.String grade,
                      double credits)
Saves student's grade in the course.


saveGrade

public void saveGrade(java.lang.String grade)

deleteGrade

public void deleteGrade()

removeGrade

public void removeGrade()

getGrade

public java.lang.String getGrade(double points)

gradeValue

public double gradeValue(java.lang.String grade)

gradeValue

public double gradeValue(int gradeid)

compareGrade

public int compareGrade(java.lang.String grade1,
                        java.lang.String grade2)

maxGrade

public java.lang.String maxGrade(java.lang.String grade1,
                                 java.lang.String grade2)

maxGrade

public java.lang.String maxGrade(java.lang.String grade1,
                                 java.lang.String grade2,
                                 java.lang.String grade3)

maxGrade

public java.lang.String maxGrade(java.lang.String grade1,
                                 java.lang.String grade2,
                                 java.lang.String grade3,
                                 java.lang.String grade4)

getCredits

public double getCredits(double defaultValue)
Gets student's credits in the course if it has been set else returns defaultValue.


getCredits

public double getCredits()

saveCredits

public void saveCredits(double credits)
Saves student's credits in the course.


getDefaultCredits

public double getDefaultCredits(double defaultValue)
Returns course's default credits or defaultValue set by user.

Parameters:
defaultValue -
Returns:

getDefaultGredits

public double getDefaultGredits()
Returns course's default credits. If nothing has been set then returns 0.0.

Returns:

getCourseTime

public static long getCourseTime()
Returns an origo for comparing and evaluating the student ranks. Time is returned in seconds.


getCourseOrganisationID

public int getCourseOrganisationID()

setTime

public void setTime(java.lang.String timeStamp)
             throws java.lang.Exception
Sets the course participant registration time into use. If timeStamp == null or blank, a current time will be used.

java.lang.Exception

getTime

public long getTime()

getSelfInformedCredits

public double getSelfInformedCredits()

getCreditsInMinorSubjects

public double getCreditsInMinorSubjects()

getCreditsInMajorSubject

public double getCreditsInMajorSubject()

getTotalCredits

public double getTotalCredits()

getFirstYearAtUniversity

public int getFirstYearAtUniversity()

getMajorSubject

public java.lang.String getMajorSubject()

getStudyingLocation

public java.lang.String getStudyingLocation()

getHomeOrganisationID

public int getHomeOrganisationID()

getDepartment

public java.lang.String getDepartment()

getDepartmentAsOrganisationID

public int getDepartmentAsOrganisationID()

getRank

public long getRank()

setRank

public void setRank(long r)

checkOrganisationHierarchy

public int checkOrganisationHierarchy(int userOrgID,
                                      int courseOrgID)
Returns a flag if the user's organisation and course's organisation are close in org. hierarchy.


getOrganisationWeight

public int getOrganisationWeight(int userOrgID,
                                 int courseOrgID)

print

public void print(java.lang.String text)

print

public void print(int i)

print

public void print(double d)

getPrints

public java.util.ArrayList getPrints()

clearPrints

public void clearPrints()

containsField

protected boolean containsField(java.lang.String field)
Checks if attribute kentat already contains field.

Parameters:
field - fieldname to check
Returns:
true if kentat contains field, false if not.

setFields

protected void setFields(java.lang.String fields)

getFields

public boolean getFields()
Hakee tietokannasta kurssin opiskelijoiden fieldsit ja tallentaa ne Tätä pitäisi kutsua Pistelasku:sta, kun pre-skripti on ajettu (eli kun kaikki kentät on asetettu setFields:llä)


use

public void use(java.lang.String fields)
         throws java.lang.Exception
Parameters:
fields -
java.lang.Exception