01: /**********************************************************************************
02: * $URL: https://source.sakaiproject.org/svn/sections/tags/sakai_2-4-1/sections-api/src/java/org/sakaiproject/section/api/coursemanagement/CourseSection.java $
03: * $Id: CourseSection.java 21967 2007-02-27 19:51:10Z jholtzman@berkeley.edu $
04: ***********************************************************************************
05: *
06: * Copyright (c) 2005, 2006 The Regents of the University of California and The Regents of the University of Michigan
07: *
08: * Licensed under the Educational Community License, Version 1.0 (the "License");
09: * you may not use this file except in compliance with the License.
10: * You may obtain a copy of the License at
11: *
12: * http://www.opensource.org/licenses/ecl1.php
13: *
14: * Unless required by applicable law or agreed to in writing, software
15: * distributed under the License is distributed on an "AS IS" BASIS,
16: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17: * See the License for the specific language governing permissions and
18: * limitations under the License.
19: *
20: **********************************************************************************/package org.sakaiproject.section.api.coursemanagement;
21:
22: import java.util.List;
23:
24: /**
25: * A subset of a Course that may meet at specific times during the week.
26: *
27: * @author <a href="mailto:jholtzman@berkeley.edu">Josh Holtzman</a>
28: *
29: */
30: public interface CourseSection extends LearningContext {
31: /**
32: * Gets the Course that this CourseSection belongs to
33: *
34: * @return
35: */
36: public Course getCourse();
37:
38: /**
39: * The enterprise ID of this CourseSection. CourseSections that model Sections from
40: * the CM service have enterprise IDs. Manually created CourseSections have an
41: * EID of null.
42: *
43: * @return The enterprise ID of the Section that this CourseSection models.
44: */
45: public String getEid();
46:
47: /**
48: * Gets the category ID of this CourseSection. Students may be enrolled in
49: * only one section of a given category per Course.
50: *
51: * @return
52: */
53: public String getCategory();
54:
55: /**
56: * Gets the maximum number of enrollments allowed in this CourseSection.
57: * Instructors and TAs may assign more than the maximum number of enrollments,
58: * but students may not self enroll in a section at or above the maximum
59: * number of enrollments.
60: *
61: * @return
62: */
63: public Integer getMaxEnrollments();
64:
65: /**
66: * Gets the meetings for this CourseSection.
67: *
68: * @return
69: */
70: public List<Meeting> getMeetings();
71: }
|