001: /*
002: The contents of this file are subject to the Common Public Attribution License
003: Version 1.0 (the "License"); you may not use this file except in compliance with
004: the License. You may obtain a copy of the License at
005: http://www.projity.com/license . The License is based on the Mozilla Public
006: License Version 1.1 but Sections 14 and 15 have been added to cover use of
007: software over a computer network and provide for limited attribution for the
008: Original Developer. In addition, Exhibit A has been modified to be consistent
009: with Exhibit B.
010:
011: Software distributed under the License is distributed on an "AS IS" basis,
012: WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the
013: specific language governing rights and limitations under the License. The
014: Original Code is OpenProj. The Original Developer is the Initial Developer and
015: is Projity, Inc. All portions of the code written by Projity are Copyright (c)
016: 2006, 2007. All Rights Reserved. Contributors Projity, Inc.
017:
018: Alternatively, the contents of this file may be used under the terms of the
019: Projity End-User License Agreeement (the Projity License), in which case the
020: provisions of the Projity License are applicable instead of those above. If you
021: wish to allow use of your version of this file only under the terms of the
022: Projity License and not to allow others to use your version of this file under
023: the CPAL, indicate your decision by deleting the provisions above and replace
024: them with the notice and other provisions required by the Projity License. If
025: you do not delete the provisions above, a recipient may use your version of this
026: file under either the CPAL or the Projity License.
027:
028: [NOTE: The text of this license may differ slightly from the text of the notices
029: in Exhibits A and B of the license at http://www.projity.com/license. You should
030: use the latest text at http://www.projity.com/license for your modifications.
031: You may not remove this license text from the source files.]
032:
033: Attribution Information: Attribution Copyright Notice: Copyright © 2006, 2007
034: Projity, Inc. Attribution Phrase (not exceeding 10 words): Powered by OpenProj,
035: an open source solution from Projity. Attribution URL: http://www.projity.com
036: Graphic Image as provided in the Covered Code as file: openproj_logo.png with
037: alternatives listed on http://www.projity.com/logo
038:
039: Display of Attribution Information is required in Larger Works which are defined
040: in the CPAL as a work which combines Covered Code or portions thereof with code
041: not governed by the terms of the CPAL. However, in addition to the other notice
042: obligations, all copies of the Covered Code in Executable and Source Code form
043: distributed must, as a form of attribution of the original author, include on
044: each user interface screen the "OpenProj" logo visible to all users. The
045: OpenProj logo should be located horizontally aligned with the menu bar and left
046: justified on the top left of the screen adjacent to the File menu. The logo
047: must be at least 100 x 25 pixels. When users click on the "OpenProj" logo it
048: must direct them back to http://www.projity.com.
049: */
050: package com.projity.pm.assignment.contour;
051:
052: import java.io.Serializable;
053:
054: import com.projity.configuration.CalculationPreference;
055:
056: /**
057: * @stereotype mi-detail
058: *
059: * An allocation biclet represents the finest grained detail for an assignment. The amount of work is determined
060: * by a value of effort during a duration.
061: * I do not store the absolute time value of the start/end because the allocation bucket can be shifted.
062: * This class is immutable.
063: *
064: * The basic formula Work = Units * Duration applies. See class SchedulingRule
065: *
066: */
067:
068: public class PersonalContourBucket extends AbstractContourBucket
069: implements Serializable {
070: static final long serialVersionUID = 99779271628737L;
071: private long duration = 0;
072:
073: /**
074: * @return Returns the duration.
075: */
076: public long getDuration() {
077: return duration;
078: }
079:
080: public long getBucketDuration(long assignmentDuration) {
081: return duration;
082: }
083:
084: protected PersonalContourBucket(long duration, double units) {
085: this .duration = duration;
086: this .units = units;
087: }
088:
089: public static PersonalContourBucket getInstance(long duration,
090: double units) {
091: if (duration < 0)
092: System.out.println("bug negative bucket"); //TODO get rid of in production
093: return new PersonalContourBucket(duration, units);
094: }
095:
096: private PersonalContourBucket(AbstractContourBucket standard,
097: long assignmentDuration) {
098: this .duration = standard.getBucketDuration(assignmentDuration);
099: this .units = standard.getUnits();
100: }
101:
102: public double getEffectiveUnits(double assignmentUnits) {
103: return units;
104: }
105:
106: /**
107: * Copy constructor. Class is immutable
108: * @param from
109: */
110: public PersonalContourBucket(PersonalContourBucket from) {
111: this (from.duration, from.units);
112: }
113:
114: /**
115: * @return Returns the work.
116: */
117: public long calcWork() {
118: return (long) (units * duration);
119: }
120:
121: public String toString() {
122: return "[duration] " + (duration / (1000 * 60 * 60)) + "h"
123: + "\n[units] " + units;
124: }
125:
126: public double weightedSum() {
127: return units * duration;
128: }
129:
130: /**
131: * Returns a new bucket which has its units multiplied by the multiplier
132: * @param multiplier
133: * @return A new bucket. Objects of this class are immutable
134: */
135: public PersonalContourBucket adjustUnits(double multiplier) {
136: return new PersonalContourBucket(duration, units * multiplier);
137: }
138:
139: /**
140: * Returns a new bucket which has its duration multiplied by the multiplier and its units divided by it
141: * @param multiplier
142: * @return A new bucket. Objects of this class are immutable
143: */
144: public PersonalContourBucket adjustWork(double multiplier) {
145: if (!CalculationPreference.getActive()
146: .isNonWorkContourPeriodsStayFixedLength()
147: || units != 0) { // in the case where units are 0, don't touch the bucket
148: return new PersonalContourBucket(
149: (long) (duration * multiplier), units / multiplier);
150: } else {
151: return this ;
152: }
153: }
154:
155: /**
156: * Returns a new bucket which has its duration increased decreased by the offset
157: * @param offset (positive to increase duration, negative to decrease it)
158: * @return A new bucket. Objects of this class are immutable
159: */
160: public PersonalContourBucket adjustDuration(long offset) {
161: return new PersonalContourBucket(duration + offset, units);
162: }
163:
164: public static PersonalContourBucket getInstance(
165: AbstractContourBucket standard, long assignmentDuration) {
166: return new PersonalContourBucket(standard, assignmentDuration);
167: }
168:
169: public Object clone() {
170: return super.clone();
171: }
172:
173: }
|