001/* 002 * Copyright 2011 Anyware Services 003 * 004 * Licensed under the Apache License, Version 2.0 (the "License"); 005 * you may not use this file except in compliance with the License. 006 * You may obtain a copy of the License at 007 * 008 * http://www.apache.org/licenses/LICENSE-2.0 009 * 010 * Unless required by applicable law or agreed to in writing, software 011 * distributed under the License is distributed on an "AS IS" BASIS, 012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 013 * See the License for the specific language governing permissions and 014 * limitations under the License. 015 */ 016package org.ametys.plugins.survey.data; 017 018import java.util.ArrayList; 019import java.util.Date; 020import java.util.List; 021 022import org.ametys.core.user.UserIdentity; 023 024/** 025 * Class representing a survey session, i.e. all the responses of a user to a survey. 026 */ 027public class SurveySession 028{ 029 030 /** The session ID. */ 031 protected int _id; 032 033 /** The survey ID. */ 034 protected String _surveyId; 035 036 /** The login of the person who answered the survey. */ 037 protected String _login; 038 039 /** The population of the person who answered the survey. */ 040 protected String _population; 041 042 /** The IP address of the person who answered the survey. */ 043 protected String _ipAddress; 044 045 /** The date and time at which the person completed the survey. */ 046 protected Date _submittedAt; 047 048 /** The list of answers. */ 049 protected List<SurveyAnswer> _answers; 050 051 /** 052 * Build a SurveySession object. 053 */ 054 public SurveySession() 055 { 056 this(Integer.MIN_VALUE, null, null, null, null, new ArrayList<SurveyAnswer>()); 057 } 058 059 /** 060 * Build a SurveySession object. 061 * @param id the session ID. 062 * @param surveyId the survey ID. 063 * @param user the user. 064 * @param ipAddress the user IP address. 065 * @param submittedAt the date of completion. 066 * @param answers the list of answers. 067 */ 068 public SurveySession(int id, String surveyId, UserIdentity user, String ipAddress, Date submittedAt, List<SurveyAnswer> answers) 069 { 070 this._id = id; 071 this._surveyId = surveyId; 072 this._login = user != null ? user.getLogin() : null; 073 this._population = user != null ? user.getPopulationId() : null; 074 this._ipAddress = ipAddress; 075 this._submittedAt = submittedAt; 076 this._answers = answers; 077 } 078 079 /** 080 * Get the id. 081 * @return the id 082 */ 083 public int getId() 084 { 085 return _id; 086 } 087 088 /** 089 * Set the id. 090 * @param id the id to set 091 */ 092 public void setId(int id) 093 { 094 this._id = id; 095 } 096 097 /** 098 * Get the surveyId. 099 * @return the surveyId 100 */ 101 public String getSurveyId() 102 { 103 return _surveyId; 104 } 105 106 /** 107 * Set the surveyId. 108 * @param surveyId the surveyId to set 109 */ 110 public void setSurveyId(String surveyId) 111 { 112 this._surveyId = surveyId; 113 } 114 115 /** 116 * Get the login of the user answering the survey 117 * @return the user login 118 */ 119 public String getLogin() 120 { 121 return _login; 122 } 123 124 /** 125 * Set the login of the user answering the survey 126 * @param login the login 127 */ 128 public void setLogin(String login) 129 { 130 _login = login; 131 } 132 133 /** 134 * Get the population of the user answering the survey 135 * @return the user identity 136 */ 137 public String getPopulation() 138 { 139 return _population; 140 } 141 142 /** 143 * Set the population of the user answering the survey 144 * @param population the population 145 */ 146 public void setPopulation(String population) 147 { 148 _population = population; 149 } 150 151 /** 152 * Set the identity of the user answering the survey 153 * @param user the user identity 154 */ 155 public void setUser(UserIdentity user) 156 { 157 this._login = user != null ? user.getLogin() : ""; 158 this._population = user != null ? user.getPopulationId() : ""; 159 } 160 161 /** 162 * Get the identity of the user answering the survey 163 * @return the user identity 164 */ 165 public UserIdentity getUser() 166 { 167 if (this._login != null) 168 { 169 return new UserIdentity(this._login, this._population); 170 } 171 return null; 172 } 173 174 /** 175 * Get the ipAddress. 176 * @return the ipAddress 177 */ 178 public String getIpAddress() 179 { 180 return _ipAddress; 181 } 182 183 /** 184 * Set the ipAddress. 185 * @param ipAddress the ipAddress to set 186 */ 187 public void setIpAddress(String ipAddress) 188 { 189 this._ipAddress = ipAddress; 190 } 191 192 /** 193 * Get the submittedAt. 194 * @return the submittedAt 195 */ 196 public Date getSubmittedAt() 197 { 198 return _submittedAt; 199 } 200 201 /** 202 * Set the submittedAt. 203 * @param submittedAt the submittedAt to set 204 */ 205 public void setSubmittedAt(Date submittedAt) 206 { 207 this._submittedAt = submittedAt; 208 } 209 210 /** 211 * Get the answers. 212 * @return the answers 213 */ 214 public List<? extends SurveyAnswer> getAnswers() 215 { 216 return _answers; 217 } 218 219 /** 220 * Set the answers. 221 * @param answers the answers to set 222 */ 223 public void setAnswers(List<SurveyAnswer> answers) 224 { 225 this._answers = answers; 226 } 227 228}