83 | * See the Android Training lesson Communicating with Other Fragments for more information.
86 | */
87 | interface OnFragmentInteractionListener {
88 | @SuppressWarnings({"FieldNever", "unused"})
89 | void onFragmentInteraction(Uri uri);
90 | }
91 |
92 | //region private methods
93 |
94 | /**
95 | * method to initialise components of the GUI
96 | *
97 | * @param view the view of the fragment
98 | */
99 | private void initGUI(View view) {
100 | GuiHelper.defineFloatingActionButtonOnClickListener(view, R.id.credits_buttonEmail, this);
101 | }
102 |
103 | /**
104 | * method to handle a click at the email button
105 | */
106 | private void onEmailClick() {
107 | sendEmail("Bug Report");
108 | }
109 |
110 | /**
111 | * method to send open a choosing dialog of email services to send a email to the dev team with the given subject
112 | *
113 | * @param subject the subject of the email
114 | */
115 | private void sendEmail(String subject) {
116 | Intent intent = new Intent(Intent.ACTION_SENDTO);
117 | intent.setType("text/plain");
118 | intent.putExtra(Intent.EXTRA_SUBJECT, subject);
119 | intent.setData(Uri.parse("mailto:projectschoolplanner17@gmail.com"));
120 | intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); // this will make sure that when user returns to the app, the app is displayed, instead of the email app.
121 | startActivity(intent);
122 | }
123 |
124 | /**
125 | * method to adjust appbar title for selected fragment
126 | */
127 |
128 | private void initToolbarTitle() {
129 | Toolbar toolbar = Objects.requireNonNull(getActivity()).findViewById(R.id.toolbar);
130 | toolbar.setTitle(R.string.string_credits);
131 | }
132 |
133 | //endregion
134 | }
135 |
--------------------------------------------------------------------------------
/app/src/main/java/schmitt_florian/schoolplanner/logic/Settings.java:
--------------------------------------------------------------------------------
1 | package schmitt_florian.schoolplanner.logic;
2 |
3 |
4 | import android.content.Context;
5 | import android.content.SharedPreferences;
6 |
7 | /**
8 | * Settings class represents all settings in the app. Settings are saved in {@link SharedPreferences}.
9 | * Use Factory Method {@link Settings#getInstance(Context)} to get current valid {@link Settings}.
10 | * Use {@link Settings#saveSettings()} to save this {@link Settings}-Object. Note that their is only
11 | * one {@link Settings}-Object saved in {@link SharedPreferences} at the same time.
12 | */
13 | public class Settings {
14 | /**
15 | * represents DD.MM.YYYY date format
16 | */
17 | public static final String DATE_FORMAT_DDMMYYYY = "DD.MM.YYYY";
18 | /**
19 | * represents MM.DD.YYYY date format
20 | */
21 | public static final String DATE_FORMAT_MMDDYYYY = "MM.DD.YYYY";
22 | /**
23 | * represents YYYY.MM.DD date format
24 | */
25 | public static final String DATE_FORMAT_YYYYMMDD = "YYYY.MM.DD";
26 |
27 | /**
28 | * represents HH:MM date format
29 | */
30 | public static final String TIME_FORMAT_HHMM = "HH:MM";
31 |
32 |
33 | /**
34 | * the key under which date format is saved to {@link SharedPreferences}
35 | */
36 | private static final String DATE_FORMAT = "dateFormat";
37 | /**
38 | * the key under which periodsAtDay are saved to {@link SharedPreferences}
39 | */
40 | private static final String PERIODS_AT_DAY = "periodsAtDay";
41 |
42 |
43 | /**
44 | * the context of the application
45 | */
46 | private final Context context;
47 | /**
48 | * the date format used in the app. One of {@link Settings#DATE_FORMAT_DDMMYYYY} ,
49 | * {@link Settings#DATE_FORMAT_MMDDYYYY} , {@link Settings#DATE_FORMAT_YYYYMMDD}
50 | */
51 | private String activeDateFormat;
52 |
53 | /**
54 | * number of periods at each day
55 | */
56 | private int periodsAtDay;
57 |
58 |
59 | /**
60 | * Factory method used to create a new {@link Settings} Object with current valid settings
61 | *
62 | * @param context the context of the application
63 | * @return {@link Settings} Object with current valid settings
64 | */
65 | public static Settings getInstance(Context context) {
66 | SharedPreferences preferences = context.getSharedPreferences(context.getApplicationContext().toString(), Context.MODE_PRIVATE);
67 |
68 | return new Settings(context,
69 | preferences.getString(DATE_FORMAT, DATE_FORMAT_DDMMYYYY),
70 | preferences.getInt(PERIODS_AT_DAY, 6)
71 | );
72 | }
73 |
74 | /**
75 | * standard c'tor, consider using of {@link Settings#getInstance(Context)} for current app settings
76 | *
77 | * @param context context of application
78 | * @param activeDateFormat One of {@link Settings#DATE_FORMAT_DDMMYYYY} ,
79 | * {@link Settings#DATE_FORMAT_MMDDYYYY} , {@link Settings#DATE_FORMAT_YYYYMMDD}
80 | * @param periodsAtDay number of periods at each day
81 | */
82 | private Settings(Context context, String activeDateFormat, int periodsAtDay) {
83 | this.context = context;
84 | this.activeDateFormat = activeDateFormat;
85 | this.periodsAtDay = periodsAtDay;
86 | }
87 |
88 | /**
89 | * saves the current {@link Settings} to {@link SharedPreferences}, overwrites old settings
90 | */
91 | public void saveSettings() {
92 | SharedPreferences.Editor preferences = context.getSharedPreferences(context.getApplicationContext().toString(), Context.MODE_PRIVATE).edit();
93 |
94 | preferences.putString(DATE_FORMAT, activeDateFormat);
95 | preferences.putInt(PERIODS_AT_DAY, periodsAtDay);
96 |
97 | preferences.apply();
98 | }
99 |
100 | //region getter & setter
101 |
102 | /**
103 | * gets the date format used in the app
104 | *
105 | * @return One of {@link Settings#DATE_FORMAT_DDMMYYYY} ,
106 | * {@link Settings#DATE_FORMAT_MMDDYYYY} , {@link Settings#DATE_FORMAT_YYYYMMDD}
107 | */
108 | public String getActiveDateFormat() {
109 | return activeDateFormat;
110 | }
111 |
112 | /**
113 | * sets the date format used in the app
114 | *
115 | * @param activeDateFormat One of {@link Settings#DATE_FORMAT_DDMMYYYY} ,
116 | * {@link Settings#DATE_FORMAT_MMDDYYYY} , {@link Settings#DATE_FORMAT_YYYYMMDD}
117 | */
118 | public void setActiveDateFormat(String activeDateFormat) {
119 | this.activeDateFormat = activeDateFormat;
120 | }
121 |
122 | /**
123 | * gets the number of periods at each day
124 | *
125 | * @return number of periods at each day
126 | */
127 | public int getPeriodsAtDay() {
128 | return periodsAtDay;
129 | }
130 |
131 | /**
132 | * sets the number of periods at each day
133 | *
134 | * @param periodsAtDay number of periods at each day
135 | */
136 | public void setPeriodsAtDay(int periodsAtDay) {
137 | this.periodsAtDay = periodsAtDay;
138 | }
139 | //endregion
140 |
141 |
142 | }
143 |
--------------------------------------------------------------------------------
/app/src/main/java/schmitt_florian/schoolplanner/logic/objects/Homework.java:
--------------------------------------------------------------------------------
1 | package schmitt_florian.schoolplanner.logic.objects;
2 |
3 |
4 | import java.util.Calendar;
5 | import java.util.GregorianCalendar;
6 |
7 | /**
8 | * The Homework Class represents an Object in the Homework SQL table and is usually returned by methods from the DatabaseHelper Interface
9 | */
10 | public class Homework {
11 | /**
12 | * numeric id of the homework (unique)
13 | */
14 | private final int id;
15 |
16 | /**
17 | * {@link Subject} the homework is for
18 | */
19 | private final Subject subject;
20 |
21 | /**
22 | * description/details of the homework
23 | */
24 | private final String description;
25 |
26 | /**
27 | * due date / deadline for the homework
28 | */
29 | private final GregorianCalendar deadline;
30 |
31 | /**
32 | * indicates whether the homework is done or not
33 | */
34 | private boolean done;
35 |
36 |
37 | /**
38 | * standard c'tor for Homework class
39 | *
40 | * @param id numeric id of the homework (unique)
41 | * @param subject {@link Subject} the homework is for
42 | * @param description description/details of the homework
43 | * @param deadline due date / deadline for the homework
44 | * @param done indicates whether the homework is done or not
45 | */
46 | public Homework(int id, Subject subject, String description, GregorianCalendar deadline, boolean done) {
47 | this.id = id;
48 | this.subject = subject;
49 | this.description = description;
50 | this.deadline = deadline;
51 | this.done = done;
52 | }
53 |
54 | /**
55 | * c'tor for Homework class using Sting for deadline field
56 | *
57 | * @param id numeric id of the homework (unique)
58 | * @param subject {@link Subject} the homework is for
59 | * @param description description/details of the homework
60 | * @param deadline due date / deadline for the homework as String in YYYY-MM-DD format
61 | * @param done indicates whether the homework is done or not
62 | */
63 | public Homework(int id, Subject subject, String description, String deadline, boolean done) {
64 | this.id = id;
65 | this.subject = subject;
66 | this.description = description;
67 | this.deadline = convertDateStringToGregorianCalendar(deadline);
68 | this.done = done;
69 | }
70 |
71 | /**
72 | * gets id of the homework
73 | *
74 | * @return unique numeric id of the homework
75 | */
76 | public int getId() {
77 | return id;
78 | }
79 |
80 | /**
81 | * gets {@link Subject} the homework is for
82 | *
83 | * @return subject the homework is for
84 | */
85 | public Subject getSubject() {
86 | return subject;
87 | }
88 |
89 | /**
90 | * gets description/details of the homework
91 | *
92 | * @return description/details of the homework
93 | */
94 | public String getDescription() {
95 | return description;
96 | }
97 |
98 | /**
99 | * gets deadline for the homework
100 | *
101 | * @return deadline for the homework
102 | */
103 | public GregorianCalendar getDeadline() {
104 | return deadline;
105 | }
106 |
107 | /**
108 | * gets the Deadline as String in YYYY-MM-DD format for use in databases
109 | *
110 | * @return Deadline as String
111 | */
112 | public String getDeadlineAsDatabaseString() {
113 | return deadline.get(Calendar.YEAR) + "-" + String.valueOf(deadline.get(Calendar.MONTH) + 1) + "-" + deadline.get(Calendar.DAY_OF_MONTH);
114 | }
115 |
116 |
117 | /**
118 | * indicates whether the homework is done or not
119 | *
120 | * @return true if the homework is done, else false
121 | */
122 | public boolean isDone() {
123 | return done;
124 | }
125 |
126 | /**
127 | * gets an int representation of the done-boolean
128 | *
129 | * @return 1 if done is true, else 0
130 | */
131 | public int getDone() {
132 | if (done) {
133 | return 1;
134 | } else {
135 | return 0;
136 | }
137 | }
138 |
139 |
140 | /**
141 | * builds a string from Homework's values
142 | *
143 | * @return Homework as String
144 | */
145 | @Override
146 | public String toString() {
147 | return "---Homework--- \n" +
148 | "Id: \t" + id + "\n" +
149 | subject.toString() + "\n" +
150 | "Description: \t" + description + "\n" +
151 | "Deadline: \t" + getDeadlineAsDatabaseString() + "\n" +
152 | "Done: \t" + done + "\n" +
153 | "---####---";
154 | }
155 |
156 | //region private methods
157 |
158 | /**
159 | * converts a date-string to a GregorianCalendar
160 | *
161 | * @param source date as string in YYYY-MM-DD format
162 | * @return date as GregorianCalendar
163 | */
164 | private GregorianCalendar convertDateStringToGregorianCalendar(String source) {
165 | String[] date = source.split("-");
166 |
167 | return new GregorianCalendar(
168 | Integer.parseInt(date[0]),
169 | Integer.parseInt(date[1]) - 1,
170 | Integer.parseInt(date[2])
171 | );
172 | }
173 | //endregion
174 | }
175 |
--------------------------------------------------------------------------------
/app/src/main/res/layout/fragment_home.xml:
--------------------------------------------------------------------------------
1 |
90 | * See the Android Training lesson Communicating with Other Fragments for more information.
93 | */
94 | public interface OnFragmentInteractionListener {
95 | @SuppressWarnings({"FieldNever", "unused"})
96 | void onFragmentInteraction(Uri uri);
97 | }
98 |
99 | //region private methods
100 |
101 | /**
102 | * method to initialise components of the GUI
103 | */
104 | private void initGUI() {
105 | GuiHelper.defineFloatingActionButtonOnClickListener(view, R.id.exams_floatingActionButton_add, this);
106 |
107 | allExamsInList = fillListView();
108 | defineExamListOnClick(view);
109 | }
110 |
111 | /**
112 | * method to fill the ListView, which shows the {@link Exam}s at the exams screen
113 | *
114 | * @return returns a array of all {@link Exam}s shown in the listView ordered by their position in the listView
115 | */
116 | private Exam[] fillListView() {
117 | DatabaseHelper dbHelper = new DatabaseHelperImpl(view.getContext());
118 |
119 | ArrayList
90 | * See the Android Training lesson Communicating with Other Fragments for more information.
93 | */
94 | interface OnFragmentInteractionListener {
95 | @SuppressWarnings({"FieldNever", "unused"})
96 | void onFragmentInteraction(Uri uri);
97 | }
98 |
99 | //region private methods
100 |
101 | /**
102 | * method to initialise components of the GUI
103 | *
104 | * @param view the view of the fragment
105 | */
106 | private void initGui(View view) {
107 | allSubjectsInList = fillListView(view);
108 | GuiHelper.defineFloatingActionButtonOnClickListener(view, R.id.subjects_floatingActionButton_add, this);
109 | defineSubjectListOnClick(view);
110 | }
111 |
112 | /**
113 | * method to fill the ListView, which shows the {@link Subject}s at the subject screen
114 | *
115 | * @param view the view of the fragment
116 | * @return returns a array of all {@link Subject}s shown in the listView ordered by their position in the listView
117 | */
118 | private Subject[] fillListView(View view) {
119 | DatabaseHelper dbHelper = new DatabaseHelperImpl(view.getContext());
120 |
121 | ArrayList
89 | * See the Android Training lesson Communicating with Other Fragments for more information.
92 | */
93 | public interface OnFragmentInteractionListener {
94 | @SuppressWarnings({"FieldNever", "unused"})
95 | void onFragmentInteraction(Uri uri);
96 | }
97 |
98 | //region private methods
99 |
100 | /**
101 | * method to initialise components of the GUI
102 | *
103 | * @param view the view of the fragment
104 | */
105 | private void initGui(View view) {
106 | allTeachersInList = fillListView(view);
107 | GuiHelper.defineFloatingActionButtonOnClickListener(view, R.id.teachers_floatingActionButton_add, this);
108 | defineTeacherListOnClick(view);
109 | }
110 |
111 | /**
112 | * method to fill the ListView, which shows the {@link Teacher}s at the teachers screen
113 | *
114 | * @param view the view of the fragment
115 | * @return returns a array of all {@link Teacher}s shown in the listView ordered by their position in the listView
116 | */
117 | private Teacher[] fillListView(View view) {
118 | DatabaseHelper dbHelper = new DatabaseHelperImpl(view.getContext());
119 |
120 | ArrayList
100 | * See the Android Training lesson Communicating with Other Fragments for more information.
103 | */
104 | public interface OnFragmentInteractionListener {
105 | @SuppressWarnings({"FieldNever", "unused"})
106 | void onFragmentInteraction(Uri uri);
107 | }
108 |
109 | //region private methods
110 |
111 | /**
112 | * method to initialise components of the GUI
113 | */
114 | private void initGui() {
115 | initSeekBar();
116 | initDateFormatSpinner();
117 | GuiHelper.defineButtonOnClickListener(view, R.id.settings_buttonSave, this);
118 |
119 | }
120 |
121 | /**
122 | * initialises the {@link SeekBar} which displays the {@link Settings#periodsAtDay}
123 | */
124 | private void initSeekBar() {
125 | GuiHelper.defineSeekBarOnChangeListener(view,
126 | new SeekBar.OnSeekBarChangeListener() {
127 | @Override
128 | public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
129 | GuiHelper.setTextToTextView(view, R.id.settings_textviewSeekbarPeriodsPos, String.valueOf(progress));
130 | }
131 |
132 | @Override
133 | public void onStartTrackingTouch(SeekBar seekBar) {
134 | //ignore
135 | }
136 |
137 | @Override
138 | public void onStopTrackingTouch(SeekBar seekBar) {
139 | //ignore
140 | }
141 | }
142 | ).setProgress(settings.getPeriodsAtDay());
143 | }
144 |
145 | /**
146 | * initialises the {@link Settings#DATE_FORMAT} {@link Spinner}
147 | */
148 | private void initDateFormatSpinner() {
149 | Spinner spinner = GuiHelper.fillSpinnerFromArray(view, R.id.settings_spinnerDate,
150 | new String[]{Settings.DATE_FORMAT_DDMMYYYY, Settings.DATE_FORMAT_MMDDYYYY, Settings.DATE_FORMAT_YYYYMMDD});
151 | switch (settings.getActiveDateFormat()) {
152 | case Settings.DATE_FORMAT_DDMMYYYY:
153 | spinner.setSelection(0);
154 | break;
155 | case Settings.DATE_FORMAT_MMDDYYYY:
156 | spinner.setSelection(1);
157 | break;
158 | case Settings.DATE_FORMAT_YYYYMMDD:
159 | spinner.setSelection(2);
160 | }
161 | }
162 |
163 | /**
164 | * updates {@link SettingsFragment#settings} with values in GUI
165 | */
166 | private void readGui() {
167 | SeekBar seekBar = view.findViewById(R.id.settings_seekbarPeriods);
168 | settings.setPeriodsAtDay(seekBar.getProgress());
169 |
170 | Spinner spinner = view.findViewById(R.id.settings_spinnerDate);
171 | settings.setActiveDateFormat((String) spinner.getSelectedItem());
172 | }
173 |
174 | /**
175 | * method to adjust appbar title for selected fragment
176 | */
177 |
178 | private void initToolbarTitle() {
179 | Toolbar toolbar = Objects.requireNonNull(getActivity()).findViewById(R.id.toolbar);
180 | toolbar.setTitle(R.string.string_settings);
181 | }
182 | //endregion
183 | }
184 |
--------------------------------------------------------------------------------
/app/src/main/res/layout/activity_subject_details.xml:
--------------------------------------------------------------------------------
1 |
2 |
102 | * See the Android Training lesson Communicating with Other Fragments for more information.
105 | */
106 | interface OnFragmentInteractionListener {
107 | @SuppressWarnings({"FieldNever", "unused"})
108 | void onFragmentInteraction(Uri uri);
109 | }
110 |
111 | //region private methods
112 |
113 | /**
114 | * method to initialise components of the GUI
115 | */
116 | private void initGUI() {
117 | GuiHelper.defineButtonOnClickListener(view, R.id.homework_buttonToDo, this);
118 | GuiHelper.defineButtonOnClickListener(view, R.id.homework_buttonDone, this);
119 | GuiHelper.defineFloatingActionButtonOnClickListener(view, R.id.homework_floatingActionButton_add, this);
120 |
121 | allHomeworkInList = changeTab();
122 | defineHomeworkListOnClick(view);
123 | }
124 |
125 | /**
126 | * method to change between the to-do tab and the done tab
127 | *
128 | * @return returns a array of all {@link Homework}s shown in the listView ordered by their position in the listView
129 | */
130 | private Homework[] changeTab() {
131 | if (tabIsToDo) {
132 | GuiHelper.setColorToButton(view, R.id.homework_buttonToDo, R.color.button_active);
133 | GuiHelper.setColorToButton(view, R.id.homework_buttonDone, R.color.button_passive);
134 | return fillListView();
135 | } else {
136 | GuiHelper.setColorToButton(view, R.id.homework_buttonToDo, R.color.button_passive);
137 | GuiHelper.setColorToButton(view, R.id.homework_buttonDone, R.color.button_active);
138 | return fillListView();
139 | }
140 | }
141 |
142 | /**
143 | * method to fill the ListView, which shows the {@link Homework}s at the homework screen, depending on the activated tab
144 | *
145 | * @return returns a array of all {@link Homework}s shown in the listView ordered by their position in the listView
146 | */
147 | private Homework[] fillListView() {
148 | DatabaseHelper dbHelper = new DatabaseHelperImpl(view.getContext());
149 |
150 | ArrayList
12 | * Note: this class has a natural ordering that is inconsistent with equals
13 | */
14 | public class Period implements Comparable