Java tutorial
/** * File ./src/main/java/de/lemo/dms/processing/questions/QPerformanceHistogram.java * Lemo-Data-Management-Server for learning analytics. * Copyright (C) 2013 * Leonard Kappe, Andreas Pursian, Sebastian Schwarzrock, Boris Wenzlaff * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * any later version. * * This program 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 General Public License * along with this program. If not, see <http://www.gnu.org/licenses/>. **/ /** * File ./main/java/de/lemo/dms/processing/questions/QPerformanceHistogram.java * Date 2013-01-24 * Project Lemo Learning Analytics */ package de.lemo.dms.processing.questions; import java.util.ArrayList; import java.util.Arrays; import java.util.Collections; import java.util.HashMap; import java.util.List; import java.util.Map; import javax.ws.rs.FormParam; import javax.ws.rs.POST; import javax.ws.rs.Path; import org.apache.log4j.Logger; import org.hibernate.Criteria; import org.hibernate.Session; import org.hibernate.criterion.Restrictions; import de.lemo.dms.core.config.ServerConfiguration; import de.lemo.dms.db.IDBHandler; import de.lemo.dms.db.mapping.abstractions.IRatedLogObject; import de.lemo.dms.processing.MetaParam; import de.lemo.dms.processing.Question; import de.lemo.dms.processing.StudentHelper; import de.lemo.dms.processing.resulttype.ResultListLongObject; import de.lemo.dms.processing.resulttype.ResultListStringObject; import de.lemo.dms.service.ServiceRatedObjects; /** * Results for the perfromance (test) of student * * @author Sebastian Schwarzrock */ @Path("performanceHistogram") public class QPerformanceHistogram extends Question { private Logger logger = Logger.getLogger(this.getClass()); /** * @param courses * (optional) List of course-ids that shall be included * @param users * (optional) List of user-ids * @param quizzes * (mandatory) List of learning object ids (the ids have to start with the type specific prefix (11 for * "assignment", 14 for "quiz", 17 for "scorm")) * @param resolution * (mandatory) * @param startTime * (mandatory) * @param endTime * (mandatory) * @return */ @SuppressWarnings("unchecked") @POST public ResultListLongObject compute(@FormParam(MetaParam.COURSE_IDS) final List<Long> courses, @FormParam(MetaParam.USER_IDS) List<Long> users, @FormParam(MetaParam.QUIZ_IDS) final List<Long> quizzes, @FormParam(MetaParam.RESOLUTION) final Long resolution, @FormParam(MetaParam.START_TIME) final Long startTime, @FormParam(MetaParam.END_TIME) final Long endTime, @FormParam(MetaParam.GENDER) final List<Long> gender) { validateTimestamps(startTime, endTime, resolution); if (logger.isDebugEnabled()) { if ((courses != null) && (courses.size() > 0)) { StringBuffer buffer = new StringBuffer(); buffer.append("Parameter list: Courses: " + courses.get(0)); for (int i = 1; i < courses.size(); i++) { buffer.append(", " + courses.get(i)); } logger.debug(buffer.toString()); } if ((users != null) && (users.size() > 0)) { StringBuffer buffer = new StringBuffer(); buffer.append("Parameter list: Users: " + users.get(0)); for (int i = 1; i < users.size(); i++) { buffer.append(", " + users.get(i)); } logger.debug(buffer.toString()); } logger.debug("Parameter list: Resolution: : " + resolution); logger.debug("Parameter list: Start time: : " + startTime); logger.debug("Parameter list: End time: : " + endTime); } final Map<Long, Integer> obj = new HashMap<Long, Integer>(); if (quizzes.size() > 0) { for (int i = 0; i < quizzes.size(); i++) { obj.put(quizzes.get(i), i); } } else { ServiceRatedObjects sro = new ServiceRatedObjects(); ResultListStringObject rso = sro.getRatedObjects(courses); String s = new String(); int count = 0; for (int i = 0; i < rso.getElements().size(); i++) { if ((i + 1) % 3 != 0) { s += rso.getElements().get(i); } else { obj.put(Long.valueOf(s), count); quizzes.add(Long.valueOf(s)); s = ""; count++; } } } // Determine length of result array final int objects = resolution.intValue() * quizzes.size(); final Long[] results = new Long[objects]; // Initialize result array for (int i = 0; i < results.length; i++) { results[i] = 0L; } final IDBHandler dbHandler = ServerConfiguration.getInstance().getMiningDbHandler(); final Session session = dbHandler.getMiningSession(); Criteria criteria; if (users == null || users.size() == 0) { users = new ArrayList<Long>(StudentHelper.getCourseStudentsAliasKeys(courses, gender).values()); } else { Map<Long, Long> userMap = StudentHelper.getCourseStudentsAliasKeys(courses, gender); List<Long> tmp = new ArrayList<Long>(); for (int i = 0; i < users.size(); i++) { tmp.add(userMap.get(users.get(i))); } users = tmp; } criteria = session.createCriteria(IRatedLogObject.class, "log"); criteria.add(Restrictions.between("log.timestamp", startTime, endTime)); if ((courses != null) && (courses.size() > 0)) { criteria.add(Restrictions.in("log.course.id", courses)); } if ((users != null) && (users.size() > 0)) { criteria.add(Restrictions.in("log.user.id", users)); } final ArrayList<IRatedLogObject> list = (ArrayList<IRatedLogObject>) criteria.list(); final Map<String, IRatedLogObject> singleResults = new HashMap<String, IRatedLogObject>(); Collections.sort(list); // This is for making sure there is just one entry per student and test for (int i = list.size() - 1; i >= 0; i--) { final IRatedLogObject log = list.get(i); final String key = log.getPrefix() + " " + log.getLearnObjId() + " " + log.getUser().getId(); if (log.getGrade() != null && (singleResults.get(key) == null || log.getGrade() > singleResults.get(key).getGrade())) { singleResults.put(key, log); } } for (final IRatedLogObject log : singleResults.values()) { if ((obj.get(Long.valueOf(log.getPrefix() + "" + log.getLearnObjId())) != null) && (log.getFinalGrade() != null) && (log.getMaxGrade() != null) && (log.getMaxGrade() > 0)) { // Determine size of each interval final Double step = log.getMaxGrade() / resolution; if (step > 0d) { // Determine interval for specific grade int pos = (int) (log.getFinalGrade() / step); if (pos > (resolution - 1)) { pos = resolution.intValue() - 1; } // Increase count of specified interval results[(resolution.intValue() * obj.get(Long.valueOf(log.getPrefix() + "" + log.getLearnObjId()))) + pos] = results[(resolution.intValue() * obj.get(Long.valueOf(log.getPrefix() + "" + log.getLearnObjId()))) + pos] + 1; } } } session.close(); return new ResultListLongObject(Arrays.asList(results)); } }